aboutsummaryrefslogtreecommitdiffstats
path: root/Library/Homebrew/cmd/style.rb
diff options
context:
space:
mode:
authorEricFromCanada2018-02-01 16:06:17 -0500
committerEricFromCanada2018-02-01 16:06:17 -0500
commit1d2b4ed321c55df609d69e3505e3d37ad28c6fb8 (patch)
tree72a5116eff4d631e28832a3adef59ee16cc03be4 /Library/Homebrew/cmd/style.rb
parent2020f382cb6cc51d58f7cf6c2895361129f11b5a (diff)
downloadbrew-1d2b4ed321c55df609d69e3505e3d37ad28c6fb8.tar.bz2
docs: add more missing option descriptions
and improve wording or formatting where necessary.
Diffstat (limited to 'Library/Homebrew/cmd/style.rb')
-rw-r--r--Library/Homebrew/cmd/style.rb22
1 files changed, 11 insertions, 11 deletions
diff --git a/Library/Homebrew/cmd/style.rb b/Library/Homebrew/cmd/style.rb
index 89484d67d..1f0d385de 100644
--- a/Library/Homebrew/cmd/style.rb
+++ b/Library/Homebrew/cmd/style.rb
@@ -1,19 +1,19 @@
-#: * `style` [`--fix`] [`--display-cop-names`] [`--only-cops=`[COP1,COP2..]|`--except-cops=`[COP1,COP2..]] [<files>|<taps>|<formulae>]:
+#: * `style` [`--fix`] [`--display-cop-names`] [`--only-cops=`<cops>|`--except-cops=`<cops>] [<files>|<taps>|<formulae>]:
#: Check formulae or files for conformance to Homebrew style guidelines.
#:
-#: <formulae> and <files> may not be combined. If both are omitted, style will run
-#: style checks on the whole Homebrew `Library`, including core code and all
-#: formulae.
+#: Lists of <files>, <taps> and <formulae> may not be combined. If none are
+#: provided, `style` will run style checks on the whole Homebrew library,
+#: including core code and all formulae.
#:
-#: If `--fix` is passed, style violations will be automatically fixed using
-#: RuboCop's `--auto-correct` feature.
+#: If `--fix` is passed, automatically fix style violations using RuboCop's
+#: auto-correct feature.
#:
-#: If `--display-cop-names` is passed, the RuboCop cop name for each violation
-#: is included in the output.
+#: If `--display-cop-names` is passed, include the RuboCop cop name for each
+#: violation in the output.
#:
-#: If `--only-cops` is passed, only the given Rubocop cop(s)' violations would be checked.
-#:
-#: If `--except-cops` is passed, the given Rubocop cop(s)' checks would be skipped.
+#: Passing `--only-cops=`<cops> will check for violations of only the listed
+#: RuboCop <cops>, while `--except-cops=`<cops> will skip checking the listed
+#: <cops>. For either option <cops> should be a comma-separated list of cop names.
#:
#: Exits with a non-zero status if any style violations are found.