proc(5) and xml version

[Brian Inglis]

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.]