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
next 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).