This is the mail archive of the
cygwin-patches
mailing list for the Cygwin project.
[PATCH 0/8] Generate utilities manpages
- From: Jon TURNEY <jon dot turney at dronecode dot org dot uk>
- To: cygwin-patches at cygwin dot com
- Cc: Jon TURNEY <jon dot turney at dronecode dot org dot uk>
- Date: Mon, 15 Jun 2015 13:36:25 +0100
- Subject: [PATCH 0/8] Generate utilities manpages
- Authentication-results: sourceware.org; auth=none
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
way.
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(-)
--
2.1.4