doc build.
a test run of "make distrib" (to build the docs and other
additional stuff needed for the distribution).
- $DOCBOOK_SVN/releasetools/catalog-install
+ $DOCBOOK_SVN/releasetools/build-check && \
+ $DOCBOOK_SVN/releasetools/catalog-install && \
make distrib 2>&1 \
XSLTENGINE=xsltproc \
PDF_MAKER=dblatex \
- | tee LOG \
+ | tee LOG && \
$DOCBOOK_SVN/releasetools/catalog-install uninstall
NOTE: If you want to build with saxon instead of xsltproc,
--- /dev/null
+*.html
+reference.pdf.gz
+reference.txt.gz
+reference.fo
+reference.pdf
+reference.txt
--- /dev/null
+The reference documentation for the DocBook XSL stylesheets is
+maintained by Norman Walsh, <ndw@nwalsh.com>, and members of the
+DocBook Project, <docbook-developers@sf.net>
--- /dev/null
+Copyright
+---------
+Copyright (C) 1999-2007 Norman Walsh
+Copyright (C) 2003 Jiří Kosek
+Copyright (C) 2004-2007 Steve Ball
+Copyright (C) 2005-2007 The DocBook Project
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the ``Software''), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or
+sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+Except as contained in this notice, the names of individuals
+credited with contribution to this software shall not be used in
+advertising or otherwise to promote the sale, use or other
+dealings in this Software without prior written authorization
+from the individuals in question.
+
+Any stylesheet derived from this Software that is publically
+distributed will be identified with a different name and the
+version strings in any derived Software will be changed so that
+no possibility of confusion between the derived package and this
+Software will exist.
+
+Warranty
+--------
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL NORMAN WALSH OR ANY OTHER
+CONTRIBUTOR BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+Contacting the Author
+---------------------
+The reference documentation for the DocBook XSL stylesheets is
+maintained by Norman Walsh, <ndw@nwalsh.com>, and members of the
+DocBook Project, <docbook-developers@sf.net>
--- /dev/null
+include ../../releasetools/Variables.mk
+
+XJPARSEFLAGS= -E 0 -w
+FO_BUILDER=saxon
+XSLTOPT=
+PROCOPT=
+
+XEP=xep
+XEPFLAGS=
+
+TXT_MAKER = LANG=C w3mmee
+TXT_MAKER_FLAGS = -dump -config $(W3MMEECONFIG)
+W3MMEECONFIG = ../../releasetools/w3mmee_config
+
+GZIP=gzip
+GZIPFLAGS=
+
+.PHONY : clean
+
+VPATH=../docsrc
+
+DIRS=common refentry lib html fo manpages roundtrip slides-html slides-fo website template utility
+
+%.included: %
+ $(XINCLUDE) $< >$@
+
+# build reference.pdf.gz except for snapshot releases
+ifneq (snapshot,$(findstring snapshot,$(RELVER)))
+all: reference.txt.gz reference.pdf.gz html
+else
+all: reference.txt.gz html
+endif
+
+html: base copyright.html warranty.html reference.html index.html
+
+base:
+ for i in $(DIRS) __bogus__; do \
+ if [ $$i != __bogus__ ] ; then \
+ echo "$(MAKE) -C $$i"; $(MAKE) -C $$i; \
+ fi \
+ done
+
+copyright.html: copyright.xml $(RSTYLE)
+ $(XJPARSE) $(XJPARSEFLAGS) $(VPATH)/$<
+ $(XSLT) $(PROCOPT) $< $(RSTYLE) $@ $(XSLTOPT)
+
+warranty.html: warranty.xml $(RSTYLE)
+ $(XJPARSE) $(XJPARSEFLAGS) $(VPATH)/$<
+ $(XSLT) $(PROCOPT) $< $(RSTYLE) $@ $(XSLTOPT)
+
+reference.html: reference.xml $(RSTYLE)
+ $(XJPARSE) $(XJPARSEFLAGS) $(VPATH)/$<
+ $(XSLT) $(PROCOPT) $< $(RSTYLE) $@ $(XSLTOPT)
+
+index.html: reference.html
+ cp -p $< $@
+
+reference.fo: ../docsrc/reference.dbk.included $(REFERENCEFOXSL)
+ $(DOCBOOK_SVN)/buildtools/xslt -$(FO_BUILDER) $< $(REFERENCEFOXSL) > $@
+
+reference.pdf: reference.fo
+ $(XEP) $(XEPFLAGS) $<
+
+reference.txt.html: ../docsrc/reference.dbk.included $(REFERENCETXTXSL)
+ $(XSLT) $< $(REFERENCETXTXSL) > $@
+
+reference.txt: reference.txt.html
+ $(TXT_MAKER) $(TXT_MAKER_FLAGS) $< > $@
+
+reference.pdf.gz: reference.pdf
+ cat $< | $(GZIP) $(GZIPFLAGS) > $@
+
+reference.txt.gz: reference.txt
+ cat $< | $(GZIP) $(GZIPFLAGS) > $@
+
+clean:
+ for i in $(DIRS) __bogus__; do \
+ if [ $$i != __bogus__ ] ; then \
+ echo "$(MAKE) -C $$i clean"; $(MAKE) -C $$i clean; \
+ fi \
+ done
+ $(RM) copyright.html
+ $(RM) index.html
+ $(RM) reference.html
+ $(RM) warranty.html
+ $(RM) reference.fo
+ $(RM) reference.pdf
+ $(RM) reference.txt
+ $(RM) reference.txt.html
+ $(RM) reference.pdf.gz
+ $(RM) reference.txt.gz
+ $(RM) ../docsrc/reference.dbk.included
--- /dev/null
+# Makefile.incl gets included by makefiles in all subdirs
+
+PARAMFILES = $(shell if [ -f $(VPATH)/docparam.xml ]; then $(XSLT) $(VPATH)/docparam.xml $(DOCPARAM2TXT); fi)
+
+all: $(HTMLFILES)
+
+%.html : %.xml $(JREFHTML)
+ $(XSLT) $< $(JREFHTML) $@ $(XSLTOPT)
+
+index.html: docparam.xml
+ $(XSLT) $< $(CLREFENTRY) $(XSLTOPT)
+
+clean:
+ $(RM) $(HTMLFILES)
+ifneq ($(PARAMFILES),)
+ $(RM) $(PARAMFILES)
+endif
--- /dev/null
+----------------------------------------------------------------------
+ README file for the DocBook XSL Stylesheets reference documentation
+----------------------------------------------------------------------
+$Id$
+
+This is generated reference documentation for the DocBook XSL
+stylesheets, primarily documentation on the parameters you can
+adjust to control the behavior of the stylesheets.
+
+This is purely reference documentation, not how-to documentation.
+For a thorough step-by-step how-to guide to publishing content
+using the DocBook XSL stylesheets, see Bob Stayton's "DocBook XSL:
+The Complete Guide", available online at
+
+ http://www.sagehill.net/docbookxsl/
+
+----------------------------------------------------------------------
+Manifest
+----------------------------------------------------------------------
+AUTHORS - contact information
+COPYING - copyright, license, and warranty information
+README - this file
+copyright.html - copyright and license information (HTML)
+index.html - documentation start page
+reference.html - documentation start page (same as index.html)
+reference.pdf.gz - documentation in PDF form (gzipped)
+reference.txt.gz - documentation in plain-text form (gzipped)
+warranty.html - warranty information (HTML)and
+
+The subdirectories all contain documentation on individual DocBook
+XSL stylesheets parameters, in HTML form. You don't need to access
+the subdirectories directly, because the content in all the
+subdirectories is accessible through the index.html (and
+reference.html) start page.
--- /dev/null
+include ../../../releasetools/Variables.mk
+VPATH=../../docsrc/common
+HTMLFILES = common.html
+include ../Makefile.incl
--- /dev/null
+/* reference.css, a stylesheet for reference documentation */
+
+div.legalnotice { font-size: 80%; }
+
+div.note {
+ border-left: solid #d5dee3 20px;
+ border-right: solid #d5dee3 20px;
+ margin-left: 5%;
+ margin-right: 10%;
+ padding: 5px;
+}
+
+div.informalexample { background-color: #d5dee3;
+ border-top-width: 2px;
+ border-top-style: double;
+ border-top-color: #d3d3d3;
+ border-bottom-width: 2px;
+ border-bottom-style: double;
+ border-bottom-color: #d3d3d3;
+ padding: 4px;
+ margin: 0em;
+ margin-left: 2em;
+ }
+
+pre.programlisting { whitespace: pre;
+ font-family: monospace;
+ background-color: #d5dee3;
+ border-top-width: 1px;
+ border-top-style: single;
+ border-top-color: #d3d3d3;
+ border-bottom-width: 1px;
+ border-bottom-style: single;
+ border-bottom-color: #d3d3d3;
+ padding: 4px;
+ margin: 0em;
+ }
+
+div.informalexample pre { whitespace: pre;
+ font-family: monospace;
+ border-top-width: 0px;
+ border-bottom-width: 0px;
+ padding: 0px;
+ }
--- /dev/null
+include ../../../releasetools/Variables.mk
+VPATH=../../docsrc/fo
+HTMLFILES = index.html table.html
+include ../Makefile.incl
--- /dev/null
+include ../../../releasetools/Variables.mk
+VPATH=../../docsrc/html
+HTMLFILES = index.html
+include ../Makefile.incl
--- /dev/null
+include ../../../releasetools/Variables.mk
+VPATH=../../lib
+HTMLFILES = lib.html
+include ../Makefile.incl
--- /dev/null
+include ../../../releasetools/Variables.mk
+VPATH=../../docsrc/manpages
+HTMLFILES = index.html
+include ../Makefile.incl
--- /dev/null
+include ../../../releasetools/Variables.mk
+VPATH=../../docsrc/pi
+HTMLFILES = common.html
+include ../Makefile.incl
+
+common.html: pi.xml
+ $(XSLT) $< $(PIREFENTRY) $(XSLTOPT)
--- /dev/null
+include ../../../releasetools/Variables.mk
+VPATH=../../docsrc/refentry
+HTMLFILES = refentry.html
+include ../Makefile.incl
--- /dev/null
+include ../../../releasetools/Variables.mk
+VPATH=../../docsrc/roundtrip
+HTMLFILES = index.html
+include ../Makefile.incl
--- /dev/null
+include ../../../releasetools/Variables.mk
+VPATH=../../docsrc/slides-fo
+HTMLFILES = index.html
+include ../Makefile.incl
--- /dev/null
+include ../../../releasetools/Variables.mk
+VPATH=../../docsrc/slides-html
+HTMLFILES = index.html
+include ../Makefile.incl
--- /dev/null
+include ../../../releasetools/Variables.mk
+VPATH=../../docsrc/template
+HTMLFILES = titlepage.html
+include ../Makefile.incl
--- /dev/null
+include ../../../releasetools/Variables.mk
+VPATH=../../docsrc/utility
+HTMLFILES = utility.html
+include ../Makefile.incl
--- /dev/null
+include ../../../releasetools/Variables.mk
+VPATH=../../docsrc/website
+HTMLFILES = index.html
+include ../Makefile.incl