2021-03-29 13:19:59 -05:00
|
|
|
# Working with the Asciidoc files
|
|
|
|
|
2021-05-10 08:53:50 -05:00
|
|
|
To get the groff version from an asciidoc man page (example for a dummy man page filename.1.adoc):
|
2021-03-11 11:38:46 -06:00
|
|
|
|
2021-03-29 13:19:59 -05:00
|
|
|
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
|
2021-05-10 08:53:50 -05:00
|
|
|
|
2021-03-29 12:13:54 -05:00
|
|
|
To get the translated versions, add an extra option which includes translation.adoc:
|
2021-03-11 11:38:46 -06:00
|
|
|
|
2021-03-29 13:19:59 -05:00
|
|
|
-a translation
|
2021-05-10 08:53:50 -05:00
|
|
|
|
2021-03-29 12:13:54 -05:00
|
|
|
The "-a" options are applicable to certain man pages. However, if the mentioned
|
2021-05-10 08:53:50 -05:00
|
|
|
variable is unused, they don't produce an error message.
|
2021-03-29 12:13:54 -05:00
|
|
|
|
|
|
|
The footers of the asciidoc files already contain relative paths to the files in man-common.
|