Bug 267014 - textproc/asciidoc: manual page for a2x(1)
Summary: textproc/asciidoc: manual page for a2x(1)
Status: Closed FIXED
Alias: None
Product: Ports & Packages
Classification: Unclassified
Component: Individual Port(s) (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: Po-Chuan Hsieh
URL: https://asciidoc-py.github.io/chunked...
Keywords:
Depends on:
Blocks:
 
Reported: 2022-10-13 12:46 UTC by Graham Perrin
Modified: 2022-11-19 08:53 UTC (History)
0 users

See Also:
bugzilla: maintainer-feedback? (sunpoet)


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Graham Perrin freebsd_committer freebsd_triage 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
%
Comment 1 commit-hook freebsd_committer freebsd_triage 2022-11-19 08:19:31 UTC
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/ports/commit/?id=639f229d5905ce6ab26aa4a94f103348f9ca6333

commit 639f229d5905ce6ab26aa4a94f103348f9ca6333
Author:     Po-Chuan Hsieh <sunpoet@FreeBSD.org>
AuthorDate: 2022-11-19 08:11:36 +0000
Commit:     Po-Chuan Hsieh <sunpoet@FreeBSD.org>
CommitDate: 2022-11-19 08:11:36 +0000

    textproc/asciidoc: Build and install manpage

    - Bump PORTREVISION for package change

    PR:             267014
    Reported by:    grahamperrin

 textproc/asciidoc/Makefile | 18 +++++++++++++++++-
 textproc/asciidoc/distinfo |  4 +++-
 2 files changed, 20 insertions(+), 2 deletions(-)
Comment 2 Po-Chuan Hsieh freebsd_committer freebsd_triage 2022-11-19 08:53:24 UTC
Committed. Thanks!