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