diff options
| author | Dan Allen <dan.j.allen@gmail.com> | 2021-04-07 23:59:15 -0600 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-04-07 23:59:15 -0600 |
| commit | 8b3ddf3268f49029fffeba0f5faecab514b23ed9 (patch) | |
| tree | 6a5d079dd6c75a2e4c8369abd9e9543760495ae6 | |
| parent | 413703b1717a47ab208cc5ac02eda8b2be13ef28 (diff) | |
revise description of -v CLI option; document in usage that application log messages are written to STDERR (PR #3872)
| -rw-r--r-- | lib/asciidoctor/cli/options.rb | 3 | ||||
| -rw-r--r-- | man/asciidoctor.adoc | 2 |
2 files changed, 3 insertions, 2 deletions
diff --git a/lib/asciidoctor/cli/options.rb b/lib/asciidoctor/cli/options.rb index 5ac74845..35225da8 100644 --- a/lib/asciidoctor/cli/options.rb +++ b/lib/asciidoctor/cli/options.rb @@ -41,6 +41,7 @@ module Asciidoctor Usage: asciidoctor [OPTION]... FILE... Convert the AsciiDoc input FILE(s) to the backend output format (e.g., HTML 5, DocBook 5, etc.) Unless specified otherwise, the output is written to a file whose name is derived from the input file. + Application log messages are printed to STDERR. Example: asciidoctor input.adoc EOS @@ -128,7 +129,7 @@ module Asciidoctor opts.on('--trace', 'include backtrace information when reporting errors (default: false)') do |trace| self[:trace] = true end - opts.on('-v', '--verbose', 'enable verbose mode (default: false)') do |verbose| + opts.on('-v', '--verbose', 'directs application messages logged at DEBUG or INFO level to STDERR (default: false)') do |verbose| self[:verbose] = 2 end opts.on('-w', '--warnings', 'turn on script warnings (default: false)') do |warnings| diff --git a/man/asciidoctor.adoc b/man/asciidoctor.adoc index c2fdb2f8..9eadda44 100644 --- a/man/asciidoctor.adoc +++ b/man/asciidoctor.adoc @@ -136,7 +136,7 @@ Matching templates found in subsequent directories override ones previously disc Include backtrace information when reporting errors. *-v, --verbose*:: - Verbosely print processing information to stderr, including debug-level log messages. + Sets log level to DEBUG so application messages logged at INFO or DEBUG level are printed to stderr. *-w, --warnings*:: Turn on script warnings (applies to executed code). |