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.