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

- old
+ new

@@ -1,15 +1,15 @@ '\" t .\" Title: asciidoctor .\" Author: Dan Allen, Sarah White, Ryan Waldron -.\" Generator: Asciidoctor 1.5.8 -.\" Date: 2018-10-28 +.\" Generator: Asciidoctor 2.0.0.rc.1 +.\" Date: 2019-03-02 .\" Manual: Asciidoctor Manual -.\" Source: Asciidoctor 1.5.8 +.\" Source: Asciidoctor 2.0.0.rc.1 .\" Language: English .\" -.TH "ASCIIDOCTOR" "1" "2018-10-28" "Asciidoctor 1.5.8" "Asciidoctor Manual" +.TH "ASCIIDOCTOR" "1" "2019-03-02" "Asciidoctor 2.0.0.rc.1" "Asciidoctor Manual" .ie \n(.g .ds Aq \(aq .el .ds Aq ' .ss \n[.ss] 0 .nh .ad l @@ -32,11 +32,11 @@ .SH "SYNOPSIS" .sp \fBasciidoctor\fP [\fIOPTION\fP]... \fIFILE\fP... .SH "DESCRIPTION" .sp -The asciidoctor(1) command converts the AsciiDoc source file(s) \fIFILE\fP 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) \fIFILE\fP to HTML5, DocBook 5, man(ual) page and other custom output formats. .sp If \fIFILE\fP is \fI\-\fP then the AsciiDoc source is read from standard input. .SH "OPTIONS" .SS "Security Settings" .sp @@ -171,47 +171,51 @@ .SS "Processing Information" .sp \fB\-\-failure\-level\fP=\fILEVEL\fP .RS 4 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. .RE .sp \fB\-q, \-\-quiet\fP .RS 4 -Silence warnings. +Silence application log messages and script warnings. .RE .sp \fB\-\-trace\fP .RS 4 -Include backtrace information on errors. -Not enabled by default. +Include backtrace information when reporting errors. .RE .sp \fB\-v, \-\-verbose\fP .RS 4 -Verbosely print processing information and configuration file checks to stderr. +Verbosely print processing information to stderr, including debug\-level log messages. .RE .sp +\fB\-w, \-\-warnings\fP +.RS 4 +Turn on script warnings (applies to executed code). +.RE +.sp \fB\-t, \-\-timings\fP .RS 4 -Display timings information (time to read, parse and convert). +Print timings report to stderr (time to read, parse and convert). .RE .SS "Program Information" .sp \fB\-h, \-\-help\fP [\fITOPIC\fP] .RS 4 -Print the help message. -Show the command usage if \fITOPIC\fP is not specified (or not recognized). +Print a help message. +Show the command usage if \fITOPIC\fP is not specified or recognized. Dump the Asciidoctor man page (in troff/groff format) if \fITOPIC\fP is \fImanpage\fP. .RE .sp \fB\-V, \-\-version\fP .RS 4 Print program version number. .sp -\f(CR\-v\fP can also be used if no other flags or arguments are present. +\fB\-v\fP can also be used if no source files are specified. .RE .SH "ENVIRONMENT" .sp \fBAsciidoctor\fP honors the \fBSOURCE_DATE_EPOCH\fP 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. @@ -251,10 +255,10 @@ .sp \fBDiscussion list / forum:\fP \c .URL "http://discuss.asciidoctor.org" "" "" .SH "COPYING" .sp -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. .SH "AUTHORS" .sp Dan Allen .sp \ No newline at end of file