man/asciidoctor.adoc in asciidoctor-1.5.8 vs man/asciidoctor.adoc in asciidoctor-2.0.0.rc.1

- old
+ new

@@ -1,10 +1,10 @@ = asciidoctor(1) Dan Allen; Sarah White; Ryan Waldron :doctype: manpage :man manual: Asciidoctor Manual -:man source: Asciidoctor 1.5.8 +:man source: Asciidoctor 2.0.0.rc.1 :page-layout: base == NAME asciidoctor - converts AsciiDoc source files to HTML, DocBook and other formats @@ -13,11 +13,11 @@ *asciidoctor* [_OPTION_]... _FILE_... == DESCRIPTION -The asciidoctor(1) command converts the AsciiDoc source file(s) _FILE_ to HTML5, DocBook 5, DocBook 4.5, man(ual) page and other custom output formats. +The asciidoctor(1) command converts the AsciiDoc source file(s) _FILE_ to HTML5, DocBook 5, man(ual) page and other custom output formats. If _FILE_ is _-_ then the AsciiDoc source is read from standard input. == OPTIONS @@ -124,36 +124,38 @@ === Processing Information *--failure-level*=_LEVEL_:: The minimum logging level that triggers a non-zero exit code (failure). - If this option is not set (default: FATAL), the program exits with a status code zero even if warnings or errors have been logged. + If this option is not set (default: FATAL), the program exits with exit code zero even if warnings or errors have been logged. *-q, --quiet*:: - Silence warnings. + Silence application log messages and script warnings. *--trace*:: - Include backtrace information on errors. - Not enabled by default. + Include backtrace information when reporting errors. *-v, --verbose*:: - Verbosely print processing information and configuration file checks to stderr. + Verbosely print processing information to stderr, including debug-level log messages. +*-w, --warnings*:: + Turn on script warnings (applies to executed code). + *-t, --timings*:: - Display timings information (time to read, parse and convert). + Print timings report to stderr (time to read, parse and convert). === Program Information *-h, --help* [_TOPIC_]:: - Print the help message. - Show the command usage if _TOPIC_ is not specified (or not recognized). + Print a help message. + Show the command usage if _TOPIC_ is not specified or recognized. Dump the Asciidoctor man page (in troff/groff format) if _TOPIC_ is _manpage_. *-V, --version*:: Print program version number. + -`-v` can also be used if no other flags or arguments are present. +*-v* can also be used if no source files are specified. == ENVIRONMENT *Asciidoctor* honors the *SOURCE_DATE_EPOCH* environment variable. If this variable is assigned an integer value, that value is used as the epoch of all input documents and as the local date and time. @@ -187,7 +189,7 @@ *Discussion list / forum:* http://discuss.asciidoctor.org == COPYING -Copyright \(C) 2012-2018 Dan Allen, Ryan Waldron and the Asciidoctor Project. +Copyright \(C) 2012-2019 Dan Allen, Ryan Waldron and the Asciidoctor Project. Free use of this software is granted under the terms of the MIT License.