asciidoctor 2.0.16 → 2.0.18

data/man/asciidoctor.adoc

@@ -1,26 +1,26 @@
 = asciidoctor(1)
-Dan Allen; Sarah White; Ryan Waldron
+Dan Allen; Sarah White
 :doctype: manpage
-:release-version: 2.0.16
+:release-version: 2.0.17
 :man manual: Asciidoctor Manual
 :man source: Asciidoctor {release-version}
-:page-layout: base
+ifdef::backend-manpage[:!author:]
 
-== NAME
+== Name
 
 asciidoctor - converts AsciiDoc source files to HTML, DocBook, and other formats
 
-== SYNOPSIS
+== Synopsis
 
 *asciidoctor* [_OPTION_]... _FILE_...
 
-== DESCRIPTION
+== Description
 
 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
+== Options
 
 // tag::options[]
 === Security Settings
@@ -46,10 +46,11 @@ If _FILE_ is _-_ then the AsciiDoc source is read from standard input.
 *-a, --attribute*=_ATTRIBUTE_::
   Define, override, or unset a document attribute.
   Command-line attributes take precedence over attributes defined in the source file unless either the name or value ends in _@_.
+  No substitutions are applied to the value.
 +
 _ATTRIBUTE_ is normally formatted as a key-value pair, in the form _NAME=VALUE_.
 Alternate forms are _NAME_ (where the _VALUE_ defaults to an empty string), _NAME!_ (unsets the _NAME_ attribute), and _NAME=VALUE@_ (or _NAME@=VALUE_) (where _VALUE_ does not override the _NAME_ attribute if it's already defined in the source document).
-Values containing spaces should be enclosed in quotes.
+A value containing spaces must be enclosed in quotes, in the form _NAME="VALUE WITH SPACES"_.
 +
 This option may be specified more than once.
 
@@ -126,8 +127,8 @@ Matching templates found in subsequent directories override ones previously disc
 === 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 exit code zero even if warnings or errors have been logged.
+  Set the minimum logging level (default: FATAL) that yields a non-zero exit code (i.e., failure).
+  If this option is not set, the program exits with a zero exit code even if warnings or errors have been logged.
 
 *-q, --quiet*::
   Silence application log messages and script warnings.
@@ -150,6 +151,7 @@ Matching templates found in subsequent directories override ones previously disc
   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_.
+  Print an AsciiDoc syntax crib sheet (in AsciiDoc) if _TOPIC_ is _syntax_.
 
 *-V, --version*::
   Print program version number.
@@ -157,13 +159,13 @@ Matching templates found in subsequent directories override ones previously disc
 *-v* can also be used if no source files are specified.
 // end::options[]
 
-== ENVIRONMENT
+== 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.
 See https://reproducible-builds.org/specs/source-date-epoch/ for more information about this environment variable.
 
-== EXIT STATUS
+== Exit Status
 
 *0*::
   Success.
@@ -171,27 +173,31 @@ See https://reproducible-builds.org/specs/source-date-epoch/ for more informatio
 *1*::
   Failure (syntax or usage error; configuration error; document processing failure; unexpected error).
 
-== BUGS
+== Bugs
 
 Refer to the *Asciidoctor* issue tracker at https://github.com/asciidoctor/asciidoctor/issues?q=is%3Aopen.
 
-== AUTHORS
+== Authors
 
-*Asciidoctor* was written by Dan Allen, Ryan Waldron, Jason Porter, Nick Hengeveld, and other contributors.
+*Asciidoctor* is led and maintained by Dan Allen and Sarah White and has received contributions from many individuals in the Asciidoctor community.
+The project was started in 2012 by Ryan Waldron based on a prototype written by Nick Hengeveld for the Git website.
+Jason Porter wrote the first implementation of the CLI interface provided by this command.
 
-*AsciiDoc* was written by Stuart Rackham and has received contributions from many other individuals.
+*AsciiDoc.py* was created by Stuart Rackham and has received contributions from many individuals in the AsciiDoc.py community.
 
-== RESOURCES
+== Resources
 
-*Project web site:* https://asciidoctor.org
+*Project website:* https://asciidoctor.org
 
-*Git source repository on GitHub:* https://github.com/asciidoctor/asciidoctor
+*Project documentation:* https://docs.asciidoctor.org
 
-*GitHub organization:* https://github.com/asciidoctor
+*Community chat:* https://chat.asciidoctor.org
 
-*Discussion list / forum:* http://discuss.asciidoctor.org
+*Source repository:* https://github.com/asciidoctor/asciidoctor
 
-== COPYING
+*Mailing list archive:* https://discuss.asciidoctor.org
 
-Copyright \(C) 2012-present Dan Allen, Ryan Waldron, and the Asciidoctor Project.
-Free use of this software is granted under the terms of the MIT License.
+== Copying
+
+Copyright \(C) 2012-present Dan Allen, Sarah White, Ryan Waldron, and the individual contributors to Asciidoctor.
+Use of this software is granted under the terms of the MIT License.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: asciidoctor
 version: !ruby/object:Gem::Version
-  version: 2.0.16
+  version: 2.0.18
 platform: ruby
 authors:
 - Dan Allen
@@ -13,7 +13,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-08-03 00:00:00.000000000 Z
+date: 2018-03-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -253,8 +253,8 @@ licenses:
 - MIT
 metadata:
   bug_tracker_uri: https://github.com/asciidoctor/asciidoctor/issues
-  changelog_uri: https://github.com/asciidoctor/asciidoctor/blob/master/CHANGELOG.adoc
-  mailing_list_uri: http://discuss.asciidoctor.org
+  changelog_uri: https://github.com/asciidoctor/asciidoctor/blob/HEAD/CHANGELOG.adoc
+  mailing_list_uri: https://chat.asciidoctor.org
   source_code_uri: https://github.com/asciidoctor/asciidoctor
 post_install_message: 
 rdoc_options: []
@@ -271,7 +271,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.22
+rubygems_version: 3.3.7
 signing_key: 
 specification_version: 4
 summary: An implementation of the AsciiDoc text processor and publishing toolchain