proc(5) and xml version

Jon Turney jon.turney@dronecode.org.uk
Mon Nov 16 13:41:11 GMT 2020


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.


More information about the Cygwin-patches mailing list