proc(5) and xml version

Corinna Vinschen corinna-cygwin@cygwin.com
Mon Nov 23 08:45:21 GMT 2020


On Nov 20 09:42, Brian Inglis wrote:
> On 2020-11-16 16:21, Brian Inglis wrote:
> > 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.
> 
> Attaching UG build doc outputs as results easier to see and review and
> change more obvious, rather than specialnames.xml and Makefile.in patches
> for now, as git does not appear to like non-patch attachments.

The actual patch is preferable, actually.


Thanks,
Corinna



More information about the Cygwin-patches mailing list