On 16/11/2020 12:07, Corinna Vinschen wrote:
Hi Brain,
On Nov 13 07:25, Brian Inglis wrote:
Hacked a Cygwin proc.5 man page FMOI over time, by combing through
fhandler_proc..., converted to proc-5.xml using doclifter, back with xmlto
as in the build, man width 80 output from both, and diff (all attached).
Nice idea!
Yes, nice work.
Unsure how this might best be fitted into the distro (cygwin, cygwin-doc,
...?) and/or whether there may be xml remediation possible to generate
verbatim output left justified with zero margin, and character value
displays, the major output issues in the diff? Content feedback is also
welcome.
This could replace the pathnames-proc and pathnames-proc-registry
sections in specialnames.xml.
I think by using the refentry markup the man page would be generated
automagically, but Jon (CCed) is the definitiv source of wisdom here.
Yes, all refentries in the UG should have manpages generated from them
(only cygwin utilities currently).
The install rule in the Makefile would probably need extending to
install *.5 to man5dir.
These would then be included in the cygwin-doc package.
