[PATCH 0/8] Generate utilities manpages

Jon TURNEY jon.turney@dronecode.org.uk
Mon Jun 15 12:36:00 GMT 2015

Sorry about the patch-bomb.

Currently, the manpages in the cygwin-doc package are generated by a conversion 
from the DocBook XML by perl scripts with minimal understanding of the markup, 
which gives sub-optimal results.  I've been looking at doing that in a better 

This patch set changes the DocBook source XML for the Cygwin utilities to use 
refentry entities, and also generates man pages from that.

Note that after this, the chunked html now has a page for each utility, rather 
than one containing all utilities.  This probably could be changed back with 
further stylesheet customization, but I'm not sure that's required.

Jon TURNEY (8):
  winsup/doc: Remove tarball target from .PHONY
  winsup/doc: Fix xidepend to handle relative pathnames
  winsup/doc: Some preparatory XML fixes
  winsup/doc: Use fo.xsl to customize PDF generation from DocBook XML
  winsup/doc: Convert utils.xml to using refentry
  winsup/doc: Make it easier to extend xidepend to more targets
  winsup/doc: Make and install manpages for utils
  winsup/doc: Fix an issue with parallel make

 winsup/doc/ChangeLog         |  46 +++
 winsup/doc/Makefile.in       |  40 +-
 winsup/doc/cygwin-ug-net.xml |   1 -
 winsup/doc/cygwin.xsl        |  13 +
 winsup/doc/fo.xsl            |  36 ++
 winsup/doc/utils.xml         | 852 ++++++++++++++++++++++++++++++-------------
 winsup/doc/xidepend          |   3 +-
 7 files changed, 730 insertions(+), 261 deletions(-)


More information about the Cygwin-patches mailing list