From f133fdd00e1b74ad99a64a9517d740b1e734e27a Mon Sep 17 00:00:00 2001
From: bogdanvlviv <bogdanvlviv@gmail.com>
Date: Thu, 17 Jan 2019 18:45:30 +0000
Subject: Improve output of `rails encrypted(:edit/:show) --help`

With these simple examples, It will be easier for users to figure out how to use these commands.

Related to 68479d09ba6bbd583055672eb70518c1586ae534
---
 railties/lib/rails/commands/encrypted/USAGE        | 22 ++++++++++++++++++++++
 .../rails/commands/encrypted/encrypted_command.rb  |  1 +
 2 files changed, 23 insertions(+)
 create mode 100644 railties/lib/rails/commands/encrypted/USAGE

(limited to 'railties/lib/rails')

diff --git a/railties/lib/rails/commands/encrypted/USAGE b/railties/lib/rails/commands/encrypted/USAGE
new file mode 100644
index 0000000000..667af85cd8
--- /dev/null
+++ b/railties/lib/rails/commands/encrypted/USAGE
@@ -0,0 +1,22 @@
+=== Storing Encrypted Files in Source Control
+
+The Rails `encrypted` commands provide access to encrypted files.
+
+=== Editing Files
+
+`rails encrypted:edit config/encrypted_file.yml.enc` opens a temporary file
+in `$EDITOR` with the decrypted contents of `config/encrypted_file.yml.enc` to
+edit. The encrypted key is either stored in `config/master.key`
+or `ENV["RAILS_MASTER_KEY"]` is used, but you can provide relative path
+to the encryption key by using `--key` option:
+
+`rails encrypted:edit config/encrypted_file.yml.enc --key config/encrypted_file.key`.
+
+=== Viewing files
+
+`rails encrypted:show config/encrypted_file.yml.enc` prints the decrypted contents of
+`config/encrypted_file.yml.enc` file. The encrypted key is either stored in `config/master.key`
+or `ENV["RAILS_MASTER_KEY"]` is used, but you can provide relative path
+to the encryption key by using `--key` option:
+
+`rails encrypted:show config/encrypted_file.yml.enc --key config/encrypted_file.key`.
diff --git a/railties/lib/rails/commands/encrypted/encrypted_command.rb b/railties/lib/rails/commands/encrypted/encrypted_command.rb
index 8d5947652a..f10a07cdf8 100644
--- a/railties/lib/rails/commands/encrypted/encrypted_command.rb
+++ b/railties/lib/rails/commands/encrypted/encrypted_command.rb
@@ -16,6 +16,7 @@ module Rails
         def help
           say "Usage:\n  #{self.class.banner}"
           say ""
+          say self.class.desc
         end
       end
 
-- 
cgit v1.2.3