You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Mario Blättermann 186e2c32ba
colors.adoc: format command name bold
5 months ago
..
Makemodule.am Add missing *.adoc files to Makemodule.am 5 months ago
README.md fix whitespace issue in ducumentation 1 year ago
bugreports.adoc docs: update github URL 8 months ago
colors.adoc colors.adoc: format command name bold 5 months ago
footer-config.adoc Add asciidoc man pages and some include files 1 year ago
footer-lib.adoc Add asciidoc man pages and some include files 1 year ago
footer.adoc Add asciidoc man pages and some include files 1 year ago
help-version.adoc man pages: unify output of --help and --version 5 months ago
in-bytes.adoc docs: add man-common/in-bytes.adoc 5 months ago
manpage-stub.adoc man pages: unify output of --help and --version 5 months ago
translation.adoc Add asciidoc man pages and some include files 1 year ago

README.md

Working with the Asciidoc files

To get the groff version from an asciidoc man page (example for a dummy man page filename.1.adoc):

asciidoctor -b manpage \
            -a release-version=2.37 \
            -a adjtime_path=/etc/adjtime \
            -a docdir=/usr/share/doc \
            -a runstatedir=/run \
            -D output_directory \
            filename.1.adoc

To get the translated versions, add an extra option which includes translation.adoc:

            -a translation

The "-a" options are applicable to certain man pages. However, if the mentioned variable is unused, they don't produce an error message.

The footers of the asciidoc files already contain relative paths to the files in man-common.