public inbox for cygwin-patches@cygwin.com
 help / color / mirror / Atom feed
From: Jon TURNEY <jon.turney@dronecode.org.uk>
To: cygwin-patches@cygwin.com
Cc: Jon TURNEY <jon.turney@dronecode.org.uk>
Subject: [PATCH 0/8] Generate utilities manpages
Date: Mon, 15 Jun 2015 12:36:00 -0000	[thread overview]
Message-ID: <1434371793-3980-1-git-send-email-jon.turney@dronecode.org.uk> (raw)

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

             reply	other threads:[~2015-06-15 12:36 UTC|newest]

Thread overview: 27+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2015-06-15 12:36 Jon TURNEY [this message]
2015-06-15 12:37 ` [PATCH 7/8] winsup/doc: Make and install manpages for utils Jon TURNEY
2015-06-15 18:12   ` Corinna Vinschen
2015-06-15 12:37 ` [PATCH 6/8] winsup/doc: Make it easier to extend xidepend to more targets Jon TURNEY
2015-06-15 17:15   ` Corinna Vinschen
2015-06-15 12:37 ` [PATCH 5/8] winsup/doc: Convert utils.xml to using refentry Jon TURNEY
2015-06-15 17:11   ` Corinna Vinschen
2015-06-16  9:28     ` Jon TURNEY
2015-06-16  9:45       ` Corinna Vinschen
2015-06-16 11:09         ` Jon TURNEY
2015-06-16 12:49           ` Corinna Vinschen
2015-06-16 17:33             ` Jon TURNEY
2015-06-16 17:49               ` Corinna Vinschen
2015-06-16 18:50                 ` Jon TURNEY
2015-06-16 19:17                   ` Corinna Vinschen
2015-06-15 12:37 ` [PATCH 3/8] winsup/doc: Some preparatory XML fixes Jon TURNEY
2015-06-15 17:04   ` Corinna Vinschen
2015-06-16  9:22     ` Jon TURNEY
2015-06-16  9:35       ` Corinna Vinschen
2015-06-15 12:37 ` [PATCH 2/8] winsup/doc: Fix xidepend to handle relative pathnames Jon TURNEY
2015-06-15 17:02   ` Corinna Vinschen
2015-06-15 12:37 ` [PATCH 1/8] winsup/doc: Remove tarball target from .PHONY Jon TURNEY
2015-06-15 16:52   ` Corinna Vinschen
2015-06-15 12:37 ` [PATCH 4/8] winsup/doc: Use fo.xsl to customize PDF generation from DocBook XML Jon TURNEY
2015-06-15 17:05   ` Corinna Vinschen
2015-06-15 12:37 ` [PATCH 8/8] winsup/doc: Fix an issue with parallel make Jon TURNEY
2015-06-15 17:16   ` Corinna Vinschen

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=1434371793-3980-1-git-send-email-jon.turney@dronecode.org.uk \
    --to=jon.turney@dronecode.org.uk \
    --cc=cygwin-patches@cygwin.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).