Asciidoc

Latest version: v10.2.1

Safety actively analyzes 714875 Python packages for vulnerabilities to keep your Python projects secure.

Scan your dependencies

Page 14 of 16

4.2

------------------------
- The default HTML output is now XHTML 1.0 markup. To output the
former HTML 4 markup specify the `html-4` backend.
- The default DocBook output is now DocBook XML. To output the former
DocBook SGML specify the `docbook-sgml` backend. The associated
`docbook-sgml.conf` file illustrates how to support minor DTD
variations. Examples of using the `xmlto(1)` command for DocBook
conversion have been added to the User Guide.
- Glossary entries set using the command-line -g option can now be
referenced in configuration files.
- Configuration dumps (`-c` command-line option) no longer output
redundant undefined glossary entries.
- DelimitedBlock arguments can now be specified in a separate arguments
line immediately following the leading delimiter line, This is in
preference to the existing delimiter embedded arguments. Reasons:
* The syntax is in keeping with the Tables arguments syntax.
* It's easier to enter and implements line continuation.
- A new QuoteBlock DelimitedBlock definition has been added to the
distribution configuration files.
- The table arguments lines can be continued using the backslash line
continuation character.
- Added new calculated glossary reference type `{<name>%<value>}`.
- Double-quote characters can now appear in unquoted positional
arguments.

4.1

------------------------
- Added DSV (Delimiter Separated Values) tables format.
- `{eval:<expr>}` glossary references drop the containing line if
`<expr>` evaluates to `None`.
- Block, Table and Macro arguments can now be positional (quoted or
unquoted).
- Vocabulary change: DelimitedBlock, Table and Macro 'attributes' are
now referred to as 'arguments'. This makes more sense in light of the
extended syntax and avoids confusion with backend markup tag
attributes.
- 'tablewidth' table ruler parameter can now be expressed in percent
units (0..100). If between 0 and 1 then the original fractional unit
measure is applied.
- The use of quoting for generating footnotes and index entries has
been dropped in favor of 'footnote' and 'indexterm' inline macros.
- 'backmatter' inline macro included in distribution.
- Fixed: CSS styled HTML tables are now fully XHTML 1.0 conformant.
- Fixed: 'tablewidth' was processed incorrectly when passed as table
argument.
- Fixed: Glossary references like `{x=\{y}}` were one character off
if \{x] was defined and `{y}` was not.

4.0

------------------------
***************************************************
This release has had some fairly major code and
documentation changes. Please report any problems
you encounter.

'Stuart Rackham'
***************************************************

- Added tables to AsciiDoc.
- Added two special 'subs' options: 'default' specifies the default
substitution options and 'none' specifies no substitution. These
options can only appear singly.
- Line continuation using a trailing backslash character is available
in Paragraphs, ListItems, Tables.
- The left and right quotes for quoted text can now be specified
separately.
- Shipped configuration files implement footnotes (only useful for
DocBook output) using \[[]] quoting.
- Shipped configuration files implement index terms (only useful for
DocBook and LinuxDoc output) using \(()) quoting.
- The shipped 'html' backend configuration now emits valid 'HTML 4.01
Transitional'.
- Added new calculated glossary reference types `{<name>!<value>}`
and `{<name><value>}`.
- The DelimitedBlock 'params' option has been dropped in favor of the
new 'block attributes' mechanism. If you have customized block
params options you may need to adjust source files to use the
'block attributes' syntax. The example code filter has been updated
to reflect these changes.
- The code filter now has a `-t tabsize` option.
- Replaced `-w` option with `-v` (verbose) option. The warnings option
was just to confusing.
- Named attributes can now be specified in macro calls.
- The 'tabsize' attribute is recognized in the built-in `include`
macros. A tabsize of zero suppresses tab expansion.
- The configuration file `[options]` section has been split into
`[miscellaneous]` and `[titles]`. If you have customized any of
these settings you will need to adjust the affected configuration
files.
- Configuration file `[miscellaneous]` entries can now also be set
using the command-line `-g` option.
- Fixed: error that occurred when attempting to use zero length
configuration and source files.
- Fixed: blocking filter halt problem.
- Fixed: inline macro escape prefix problem.
- Fixed: missing macros from configuration dump problem.
- Fixed: named macros were dumped incorrectly.
- Many documentation changes/additions/corrections.

3.2.2

--------------------------
- Added `-n` option (synonym for `-g section-numbers`).
- Dropped the processing commentary (hey, this is Unix).
- Added new calculated glossary reference type `{<name>?<value>}`.
`<name>` is the glossary entry name and `<value>` is the text
substituted if the glossary entry is defined. `<value>` can only
contain literal text (no glossary references allowed).
- Added `asciidoc2text` to distribution `examples/asciidoc2text`
directory (converts AsciiDoc source to text file with section
numbering).
- Fixed incorrect nesting of Simple lists inside Variable lists.
- List definitions have been modified so that list items can be
indented. This allows a more intuitive indentation of nested lists
in AsciiDoc source.
- Lists must be separated from preceding paragraphs by a blank line.
This is to avoid paragraph lines being mistaken for list items.
- Corrected asciidoc man page documentation error: the`-f` option does
*not* search relative to source document directory for the
configuration file.
- Minor updates to various distribution `.conf` files.
- Included `badges.conf` in `examples` directory.
- `css-embedded-stylesheet.conf` now supports footer badges.
- The default in-line element processing order has been changed:
Glossary References are now processed before Inline Macros. This
allows glossary expansions to occur inside macro references.
- Glossary entries are now allowed in Author and Revision lines.
- Default List `subs` options and Paragraph `presubs` options are
assigned the following default value if not specified:

specialcharacters,quotes,specialwords,replacements,glossary,macros

- Documentation changes/additions/corrections.

3.2

------------------------
- Added a `-s` command-line option to suppress the output of
`[header]` and `[footer]` sections.
- Article document headers are no longer mandatory: this allows
AsciiDoc to process arbitrary chunks of text. When used in
conjunction with the new `-s` command-line option corresponding
chunks of backend markup can be generated.
- AsciiDoc now emits a warning message and continues when an out of
sequence section title is detected (previously it failed and
halted). This allows document sections to be processed separately.
- Optional 'presubs' and 'postsubs' entries have been added to
'DelimitedBlock' and 'Paragraph' definitions. As a consequence
substitution options are no longer legal in 'options' entries.
- 'presubs' and 'postsubs' substitutions are processed in the order
the options are specified (rather than the fixed 'options' order of
previous versions).
- ./filters subdirectories are automatically searched for filter
commands.
- A 'title-subs' configuration option specifies the substitutions
performed on document Header and Section titles.
- A 'subs' entry in now included in List configuration file
definitions that specified substitutions performed on list entry
text.
- Configuration files are auto-loaded from ./filters subdirectories.
- Added example code filter (see ./examples/filters).
- Bug fix: if section was empty you may have got erroneous 'missing
tag "paragraph"' error.
- Internal code tidy up.

3.1

------------------------
- In version 3.0 a `[macros]` section entry of the form 'name' was
equivalent to 'name='. An entry of the form 'name' now undefines the
entry (to bring it in line with the behavior of other special
sections).
- Paragraphs have now been generalized (in the same way as Lists and
DelimitedBlocks).
- The 'indentsize' option has been dropped as as consequence of
paragraph generalization.
- Pipe | characters can be included in substituted tag and
substitution section text using the \{brvbar} (broken vertical bar)
glossary reference.
- Removed the restriction requiring substitution section text
placeholders | to be on a separate line.
- Added an `-e` asciidoc(1) command option that excludes implicit
configuration files (used in conjunction with `-c` generated
configuration files).
- Version 3.0 documentation has undergone a considerable cleanup.
- The dumping of quoted section entries (see `-c` option) now works
correctly.
- The format of special section entries has been made consistent:
`name` undefines the entry; `name=` sets the entry value to a blank
string; `name=value` sets the entry value to `value`.
- As a consequence of the previous change the caret prefix is no
longer used in glossary configuration file entries (although it is
still used when undefining an entry using the `-g` command-line
option).

Page 14 of 16

© 2025 Safety CLI Cybersecurity Inc. All Rights Reserved.