Contributions > Development

Man Page

<< < (3/3)

gchevallereau:

--- Quote ---In git should exist groff and xml. But, of course end user need only groff file. Just keep it up-to-date after each change made in xml-file.
--- End quote ---
I disagree. There should be only the XML file:

* it's really easy to check for the presence of xmlto in both CMake and autotools.
* if there are both version, you can be sure that one day:
* someone will edit the generated file.
* someone will forgot to update the generated file after making a modification

kkmic:
What I am looking for is to avoid one more required dependency for OpenCom.

How common are the two packages mentioned by winterheart?

My distro, for example, lacks xmlto by default.

Correction, xmlto is present in my distro by default

gchevallereau:
as i have said, it's not hard to make the build of the man page optional, so xmlto wouldn't be a required dependency.
IMHO, we should treat it like doxygen. You can perfectly build openxcom without doxygen installed, because we check for it's presence and only add needed rules to generate documentation if it was found. man page should be handled the same way.

Navigation

[0] Message Index

[*] Previous page