Re: [PATCH 7/8] winsup/doc: Make and install manpages for utils

On Jun 15 13:36, Jon TURNEY wrote: > Use 'xmlto man' to make manpages for utils > (docbook2x-man could also be used, but since we already use xmlto...) > > This will generate multiple .1 files as an output, but we don't know what they > will be called, so use a timestamp file for build avoidance w

Re: [PATCH 8/8] winsup/doc: Fix an issue with parallel make

On Jun 15 13:36, Jon TURNEY wrote: > The cygwin-ug-net-nochunks.html.gz target does not ensure that the > cygwin-ug-net/ directory exists, so it can fail if run on it's own, or if the > cygwin-ug-net/cygwin-ug-net.html target has not yet created it in a parallel > make. > > 2015-06-12 Jon Turney

Re: [PATCH 6/8] winsup/doc: Make it easier to extend xidepend to more targets

On Jun 15 13:36, Jon TURNEY wrote: > Change xidepend to create a variable containing all the XIncluded sources, > which > can be used as a dependency, rather than writing the dependency target itself. > > Future work: Makefile.dep should depend on xidepend, but xidepend should not > be > passed

Re: [PATCH 5/8] winsup/doc: Convert utils.xml to using refentry

On Jun 15 13:36, Jon TURNEY wrote: > Convert utils.xml from using a sect2 to using a refentry for each utility > program. > > Unfortunately, using refentry seems to tickle a bug in dblatex when generating > pdf, which appears to not escape \ properly in the latex for refentry, so use > fop instead

Re: [PATCH 4/8] winsup/doc: Use fo.xsl to customize PDF generation from DocBook XML

On Jun 15 13:36, Jon TURNEY wrote: > fo.xsl doesn't seem to be used since c2f50c40 switched back from xsltproc to > xmlto > > 2015-06-12 Jon Turney <...> > > * Makefile.in (cygwin-ug-net/cygwin-ug-net.pdf) > (cygwin-api/cygwin-api.pdf): Use fo.xsl to customized DocBook > XML->

Re: [PATCH 3/8] winsup/doc: Some preparatory XML fixes

On Jun 15 13:36, Jon TURNEY wrote: > Remove the inconsistent .exe suffix in strace and umount usage lines. > > Consistently refer to cross-references outside utils.xml as being in the > Cygwin > User's Guide. This helps to generate sensible looking references in generated > manpages. ... but it

Re: [PATCH 2/8] winsup/doc: Fix xidepend to handle relative pathnames

On Jun 15 13:36, Jon TURNEY wrote: > It seems that xidepend doesn't work correctly if we are ./configure'd using a > relative pathname to the srcdir: > > $ make > cd ../../../../src/winsup/doc && ./xidepend > ../../../../src/winsup/doc/cygwin-ug-net.xml > ../../../../src/winsup/doc/cygwin-api.xm

Re: [PATCH 1/8] winsup/doc: Remove tarball target from .PHONY

On Jun 15 13:36, Jon TURNEY wrote: > Left over after 4885352e. > > 2015-06-12 Jon Turney <...> > > * Makefile.in (.PHONY): Remove tarball target. Please apply. Thanks, Corinna -- Corinna Vinschen Please, send mails regarding Cygwin to Cygwin Maintainer

[PATCH 8/8] winsup/doc: Fix an issue with parallel make

The cygwin-ug-net-nochunks.html.gz target does not ensure that the cygwin-ug-net/ directory exists, so it can fail if run on it's own, or if the cygwin-ug-net/cygwin-ug-net.html target has not yet created it in a parallel make. 2015-06-12 Jon Turney * Makefile.in (cygwin-ug-net/cygwin-

[PATCH 2/8] winsup/doc: Fix xidepend to handle relative pathnames

It seems that xidepend doesn't work correctly if we are ./configure'd using a relative pathname to the srcdir: $ make cd ../../../../src/winsup/doc && ./xidepend ../../../../src/winsup/doc/cygwin-ug-net.xml ../../../../src/winsup/doc/cygwin-api.xml >"/wip/cygwin/build/x86_64-unknown-cygwin/wins

[PATCH 7/8] winsup/doc: Make and install manpages for utils

Use 'xmlto man' to make manpages for utils (docbook2x-man could also be used, but since we already use xmlto...) This will generate multiple .1 files as an output, but we don't know what they will be called, so use a timestamp file for build avoidance when the dependencies haven't changed. 2015-0

[PATCH 6/8] winsup/doc: Make it easier to extend xidepend to more targets

Change xidepend to create a variable containing all the XIncluded sources, which can be used as a dependency, rather than writing the dependency target itself. Future work: Makefile.dep should depend on xidepend, but xidepend should not be passed to itself. 2015-06-12 Jon Turney * xid

[PATCH 5/8] winsup/doc: Convert utils.xml to using refentry

Convert utils.xml from using a sect2 to using a refentry for each utility program. Unfortunately, using refentry seems to tickle a bug in dblatex when generating pdf, which appears to not escape \ properly in the latex for refentry, so use fop instead. Note that the chunked html now generates a p

[PATCH 3/8] winsup/doc: Some preparatory XML fixes

Remove the inconsistent .exe suffix in strace and umount usage lines. Consistently refer to cross-references outside utils.xml as being in the Cygwin User's Guide. This helps to generate sensible looking references in generated manpages. Tidy up some trailing whitespace. Tabs inside are not co

[PATCH 0/8] Generate utilities manpages

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 t

[PATCH 1/8] winsup/doc: Remove tarball target from .PHONY

Left over after 4885352e. 2015-06-12 Jon Turney * Makefile.in (.PHONY): Remove tarball target. Signed-off-by: Jon TURNEY --- winsup/doc/ChangeLog | 4 winsup/doc/Makefile.in | 2 +- 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/winsup/doc/ChangeLog b/winsup/do

[PATCH 4/8] winsup/doc: Use fo.xsl to customize PDF generation from DocBook XML

fo.xsl doesn't seem to be used since c2f50c40 switched back from xsltproc to xmlto 2015-06-12 Jon Turney * Makefile.in (cygwin-ug-net/cygwin-ug-net.pdf) (cygwin-api/cygwin-api.pdf): Use fo.xsl to customized DocBook XML->PDF conversion. Signed-off-by: Jon TURNEY --- w