man/asciidoctor.adoc in asciidoctor-1.5.6.2 vs man/asciidoctor.adoc in asciidoctor-1.5.7
- 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.6.2
+:man source: Asciidoctor 1.5.7
:page-layout: base
== NAME
asciidoctor - converts AsciiDoc source files to HTML, DocBook and other formats
@@ -63,16 +63,12 @@
The _book_ document type allows multiple level-0 section titles in a single document.
The _manpage_ document type enables parsing of metadata necessary to produce a man page.
The _inline_ document type allows the content of a single paragraph to be formatted and returned without wrapping it in a containing element.
Defaults to _article_.
-=== Rendering Control
+=== Document Conversion
-*-C, --compact*::
- Compact the output by removing blank lines.
- (No longer in use).
-
*-D, --destination-dir*=_DIR_::
Destination output directory.
Defaults to the directory containing the source file, or the working directory if the source is read from a stream.
If specified, the directory is resolved relative to the working directory.
@@ -91,19 +87,25 @@
Add the specified directory to the load path, so that _-r_ can load extensions from outside the default Ruby load path.
This option may be specified more than once.
*-n, --section-numbers*::
Auto-number section titles.
- Synonym for *--attribute numbered*.
+ Synonym for *--attribute sectnums*.
*-o, --out-file*=_OUT_FILE_::
Write output to file _OUT_FILE_.
Defaults to the base name of the input file suffixed with _backend_ extension.
The file is resolved relative to the working directory.
If the input is read from standard input or a named pipe (fifo), then the output file defaults to stdout.
If _OUT_FILE_ is _-_, then the output file is written to standard output.
+*-R, --source-dir*=_DIR_::
+ Source directory.
+ Currently only used if the destination directory is also specified.
+ Used to preserve the directory structure of files converted within this directory in the destination directory.
+ If specified, the directory is resolved relative to the working directory.
+
*-r, --require*=_LIBRARY_::
Require the specified library before executing the processor, using the standard Ruby require.
This option may be specified more than once.
*-s, --no-header-footer*::
@@ -119,10 +121,14 @@
This option may be specified more than once.
Matching templates found in subsequent directories override ones previously discovered.
=== 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.
+
*-q, --quiet*::
Silence warnings.
*--trace*::
Include backtrace information on errors.
@@ -170,10 +176,10 @@
*AsciiDoc* was written by Stuart Rackham and has received contributions from many other individuals.
== RESOURCES
-*Project web site:* http://asciidoctor.org
+*Project web site:* https://asciidoctor.org
*Git source repository on GitHub:* https://github.com/asciidoctor/asciidoctor
*GitHub organization:* https://github.com/asciidoctor