On 2020-11-16 06:41, Jon Turney wrote:
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).
I saw those but not specialnames, so should be able to incorporate the comments
to update the content, generate the xml and adapt to the existing context as an
update, then look at manpage generation.
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.
Great, that sounds workable.
--
Take care. Thanks, Brian Inglis, Calgary, Alberta, Canada
This email may be disturbing to some readers as it contains
too much technical detail. Reader discretion is advised.
[Data in binary units and prefixes, physical quantities in SI.]
