NAME real/makefile_tman — package autogenerated man and cat
Take a portable software package you maintain or care about that already has mdoc(7)
manuals or where you consider converting the manuals to mdoc(7)
. Design and implement make(1)
targets in the distribution tarball build system to generate and package man(7)
and cat (preformatted) versions of the existing mdoc(7)
CAVEATS The difficulty of this exercise, and the amount of work required, can vary greatly depending on the size and complexity of the software package and the build system used. For a large or complex package, familiarity with the build system is probably required.
You must have a checked out copy of the source repository. This exercise cannot be solved starting from a mere release tarball.
If the mdoc(7)
versions of the pages have not yet been written, don't waste your time on that, just write two or three ten-line stubs to get started.
Pay attention to not edit autogenerated files, like Makefile
if there is also Makefile.in
Try to use make(1)
inference (suffix) transformation rules. Avoid writing one rule for each manual page if possible.
To test your changes, build and inspect a release tarball.