From 8b3ddf3268f49029fffeba0f5faecab514b23ed9 Mon Sep 17 00:00:00 2001 From: Dan Allen Date: Wed, 7 Apr 2021 23:59:15 -0600 Subject: revise description of -v CLI option; document in usage that application log messages are written to STDERR (PR #3872) --- lib/asciidoctor/cli/options.rb | 3 ++- 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). -- cgit v1.2.3