asciidoc / BUGS.txt

Bugs and Known Problems
=======================

AsciiDoc
--------
- A benign warning 'with will become a reserved keyword
  in Python 2.6' sometimes occurs when using Python 2.5 -- it's
  harmless and will disappear with Python 3.
- The `toc` attribute will be ignored if it's set in a custom user or
  document configuration file. This is because the default
  configuration file containing the document `[header]` is sourced
  before custom configuration files and the `toc` attribute is
  processed using conditional inclusion macros.
- Reported line numbers in diagnostic messages are sometimes wrong.
- Embedding open brace characters `{` in argument values can cause
  incorrect argument substitution.
- Attribute references in macro attribute lists can't be unescaped
  (with the exception of attribute list entry `{0}`).
- Section numbering is incorrect when outputting HTML from a
  multi-part book type document. This is not a biggy since multi-part
  books are generally processed to DocBook.
- A row of apostrophes in an inline context throws AsciiDoc into an
  endless loop.
- Multiple comma separated command names in the manpage NAME section
  translate to a single DocBook `refname` instead of multiple
  `refname` elements.
- Escaping quoted text and macros is sometimes tricky owing to some
  macro and quoting ambiguities.

dblatex
-------
See `./dblatex/dblatex-readme.txt`.
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.