The branch 'docbook-utils-manpages' was deleted. It previously pointed to: cc32694... Remove 'usage' from synopsis
Diff: !!! WARNING: THE FOLLOWING COMMITS ARE NO LONGER ACCESSIBLE (LOST): ------------------------------------------------------------------- cc32694... Remove 'usage' from synopsis 6478dfe... Fix an issue with parallel make 37aacab... Make and install manpages for utils 6b583cd... Make it easier to extend xidepend to more targets 967379a... Convert utils.xml to using refentry 435df2e... Use fo.xsl to customize PDF generation from DocBook XML b8039f8... Some preparatory XML fixes b58319b... Fix xidepend to handle relative pathnames 5078fdd... Remove tarball target from .PHONY commit cc3269454fa65a8b1cf36c1782969195902c7a6b Author: Jon TURNEY <[email protected]> Date: Fri Jun 12 10:56:47 2015 +0100 Remove 'usage' from synopsis commit 6478dfe7bb953e5a77a8d2018d356f6b794481ed Author: Jon TURNEY <[email protected]> Date: Fri Jun 12 14:18:07 2015 +0100 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 <[email protected]> * Makefile.in (cygwin-ug-net/cygwin-ug-net-nochunks.html.gz): Ensure cygwin-ug-net directory exists. Signed-off-by: Jon TURNEY <[email protected]> commit 37aacab143e856a2ad3a6733343edb8f88a369d0 Author: Jon TURNEY <[email protected]> Date: Fri Jun 12 13:33:13 2015 +0100 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-06-12 Jon Turney <[email protected]> * Makefile.in (install-man, utils2man.stamp): Add rules to build and install manpages for utils. Signed-off-by: Jon TURNEY <[email protected]> commit 6b583cdcb381439e1e14aed6fab2302a58cadabf Author: Jon TURNEY <[email protected]> Date: Fri Jun 12 13:30:50 2015 +0100 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 <[email protected]> * xidepend: Write a Makefile fragment defining variables containing all the XIncluded sources, rather than a dependency on those sources. * Makefile.in: Use that variable to express the dependency. Signed-off-by: Jon TURNEY <[email protected]> commit 967379a9328542021b42d9e54b88bf4bb744756e Author: Jon TURNEY <[email protected]> Date: Fri Jun 12 14:51:00 2015 +0100 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 page for each utility, rather than one containing all utilities. A small customization to TOC generation for HTML and PDF is needed to ensure that it appears as before, containing an entry for each utility command. Future work: synopsis and options sections could use more detailed markup than just wrapping the whole thing in <screen> 2015-06-12 Jon Turney <[email protected]> * Makefile.in (XMLTO): Switch from dblatex to fop. * utils.xml : Convert from using a sect2 to using a refentry for each utility program. * cygwin.xsl: Customize autotoc to include refentries. * fo.xsl: Ditto. Signed-off-by: Jon TURNEY <[email protected]> commit 435df2eff8e94ebafc8707288dfd4902d2f7423e Author: Jon TURNEY <[email protected]> Date: Fri Jun 12 16:07:21 2015 +0100 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 <[email protected]> * 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 <[email protected]> commit b8039f89da16b38add5684ad0171a74aea165c16 Author: Jon TURNEY <[email protected]> Date: Fri Jun 12 12:07:59 2015 +0100 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 <screen> are not consistently formatted, replace with spaces. Remove pointlesss and incorrect date 2015-06-12 Jon Turney <[email protected]> * cygwin-ug-net.xml: Remove incorrect unused date. * utils.xml : Remove .exe suffix inconsistently added in a few places. Consistently refer to cross-references outside this file as in the Cygwin User's Guide. Tidy up some trailing whitespace. Signed-off-by: Jon TURNEY <[email protected]> commit b58319b3c12b30301ceaa112e1de055aa17b502f Author: Jon TURNEY <[email protected]> Date: Fri Jun 12 10:56:55 2015 +0100 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/winsup/doc/Makefile.dep" grep: ../../../../src/winsup/doc/cygwin-ug-net.xml: No such file or directory grep: ../../../../src/winsup/doc/cygwin-api.xml: No such file or directory Although it might be better to fix this by making xidepend use pathnames, rather than ignoring them and assuming everything is in the current directory... 2015-06-12 Jon Turney <[email protected]> * xidepend: Fix to handle relative pathnames. Signed-off-by: Jon TURNEY <[email protected]> commit 5078fdd9a2a4c3a08368d4461259f02fc567f422 Author: Jon TURNEY <[email protected]> Date: Fri Jun 12 11:44:21 2015 +0100 Remove tarball target from .PHONY Left over after 4885352e. 2015-06-12 Jon Turney <[email protected]> * Makefile.in (.PHONY): Remove tarball target.
