Bug 267014

Description Graham Perrin 2022-10-13 12:46:20 UTC

From <https://asciidoc-py.github.io/chunked/ch05.html#X43>: 

> … See the a2x(1) man page for details. …

The page does exist in e.g. Arch <https://man.archlinux.org/man/a2x.1.en> but not in FreeBSD (below). 

Please, are we missing something? 

----

% man a2x
No manual entry for a2x
% a2x --help
Usage: a2x [OPTIONS] SOURCE_FILE

A toolchain manager for AsciiDoc (converts Asciidoc text files to other file
formats)

Options:
  --version             show program's version number and exit
  -h, --help            show this help message and exit
  -a ATTRIBUTE, --attribute=ATTRIBUTE
                        set asciidoc attribute value
  --asciidoc-opts=ASCIIDOC_OPTS
                        asciidoc options
  --copy                DEPRECATED: does nothing
  --conf-file=CONF_FILE
                        configuration file
  -D PATH, --destination-dir=PATH
                        output directory (defaults to SOURCE_FILE directory)
  -d DOCTYPE, --doctype=DOCTYPE
                        article, manpage, book
  -b BACKEND, --backend=BACKEND
                        name of backend plugin
  --epubcheck           check EPUB output with epubcheck
  -f FORMAT, --format=FORMAT
                        chunked, epub, htmlhelp, manpage, pdf, text, xhtml,
                        dvi, ps, tex, docbook
  --icons               use admonition, callout and navigation icons
  --icons-dir=PATH      admonition and navigation icon directory
  -k, --keep-artifacts  do not delete temporary build files
  --lynx                use lynx to generate text files
  -L, --no-xmllint      do not check asciidoc output with xmllint
  -n, --dry-run         just print the commands that would have been executed
  -r PATH, --resource=PATH
                        resource file or directory containing resource files
  -m FILE, --resource-manifest=FILE
                        read resources from FILE
  --resource-dir=PATH   DEPRECATED: use --resource
  -s, --skip-asciidoc   DEPRECATED: redundant
  --stylesheet=STYLESHEET
                        HTML CSS stylesheet file name
  --safe                DEPRECATED: does nothing
  --dblatex-opts=DBLATEX_OPTS
                        dblatex options
  --backend-opts=BACKEND_OPTS
                        backend plugin options
  --fop                 use FOP to generate PDF files
  --fop-opts=FOP_OPTS   options for FOP pdf generation
  --xsltproc-opts=XSLTPROC_OPTS
                        xsltproc options for XSL stylesheets
  --xsl-file=XSL_FILE   custom XSL stylesheet
  -v, --verbose         increase verbosity
%