Jim Klimov writes:

  NUT "dist" tarballs, including release snapshots, do include a copy of generated man pages (probably in a *roff format) for the benefit of end-users

Yes, I do the same. I store Docbook XML in git, and when a packaged tarball gets prepared it includes the generated nroff man pages, for direct installation.

I'm not familiar with asciidoc, but that workflow seems analogous. When you wrote that you were contemplating large scale man page updates I thought you meant manual editing of nroff. Scary, scary thought…

  Also note that since NUT v2.8.3 we added support for `configure` options to assign man section codes (numbers or not) for systems that do not follow suit of Linux and BSD numbering (e.g. in Solaris/illumos, the system commands are historically not "8" but "1m"). Previously this required strange patch files on packager side, a burden to be revised/updated for each NUT release; now it requires just a few configure options that can be left in the recipe once and forever.

Yowza. Solaris is still around?

Attachment: pgp18VkL7ZDxv.pgp
Description: PGP signature

_______________________________________________
Nut-upsuser mailing list
[email protected]
https://alioth-lists.debian.net/cgi-bin/mailman/listinfo/nut-upsuser

Reply via email to