[master] include relnotes in doc

3982.	[doc]		Include release notes in product documentation.
			[RT #37272]

diff --git a/CHANGES b/CHANGES
index 710ab531d9418bf82f4b6650c2d2ebf33bb108e9..0bce3631da44e32bfad556bd4f0cf87cd0c9449a 100644 (file)
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,6 @@
+3982.  [doc]           Include release notes in product documentation.
+                       [RT #37272]
+
 3981.  [bug]           Cache DS/NXDOMAIN independently of other query types.
                        [RT #37467]
 

diff --git a/configure b/configure
index ca244b250b7e0b53dbed0e91b358fee33078a20c..d55acf425fb59794feba0987e7641ad2aaf1d801 100755 (executable)
--- a/configure
+++ b/configure
@@ -21721,7 +21721,7 @@ ac_config_commands="$ac_config_commands chmod"
 # elsewhere if there's a good reason for doing so.
 #
 
-ac_config_files="$ac_config_files make/Makefile make/mkdep Makefile bin/Makefile bin/check/Makefile bin/confgen/Makefile bin/confgen/unix/Makefile bin/delv/Makefile bin/dig/Makefile bin/dnssec/Makefile bin/named/Makefile bin/named/unix/Makefile bin/nsupdate/Makefile bin/pkcs11/Makefile bin/python/Makefile bin/python/dnssec-checkds.py bin/python/dnssec-coverage.py bin/rndc/Makefile bin/tests/Makefile bin/tests/atomic/Makefile bin/tests/db/Makefile bin/tests/dst/Makefile bin/tests/dst/Kdh.+002+18602.key bin/tests/dst/Kdh.+002+18602.private bin/tests/dst/Kdh.+002+48957.key bin/tests/dst/Kdh.+002+48957.private bin/tests/dst/Ktest.+001+00002.key bin/tests/dst/Ktest.+001+54622.key bin/tests/dst/Ktest.+001+54622.private bin/tests/dst/Ktest.+003+23616.key bin/tests/dst/Ktest.+003+23616.private bin/tests/dst/Ktest.+003+49667.key bin/tests/dst/dst_2_data bin/tests/dst/t2_data_1 bin/tests/dst/t2_data_2 bin/tests/dst/t2_dsasig bin/tests/dst/t2_rsasig bin/tests/hashes/Makefile bin/tests/headerdep_test.sh bin/tests/master/Makefile bin/tests/mem/Makefile bin/tests/names/Makefile bin/tests/net/Makefile bin/tests/pkcs11/Makefile bin/tests/pkcs11/benchmarks/Makefile bin/tests/rbt/Makefile bin/tests/resolver/Makefile bin/tests/sockaddr/Makefile bin/tests/system/Makefile bin/tests/system/builtin/Makefile bin/tests/system/conf.sh bin/tests/system/dlz/prereq.sh bin/tests/system/dlzexternal/Makefile bin/tests/system/dlzexternal/ns1/named.conf bin/tests/system/filter-aaaa/Makefile bin/tests/system/geoip/Makefile bin/tests/system/inline/checkdsa.sh bin/tests/system/lwresd/Makefile bin/tests/system/resolver/Makefile bin/tests/system/rpz/Makefile bin/tests/system/rsabigexponent/Makefile bin/tests/system/sit/prereq.sh bin/tests/system/tkey/Makefile bin/tests/system/tsiggss/Makefile bin/tests/tasks/Makefile bin/tests/timers/Makefile bin/tests/virtual-time/Makefile bin/tests/virtual-time/conf.sh bin/tools/Makefile contrib/scripts/check-secure-delegation.pl contrib/scripts/zone-edit.sh doc/Makefile doc/arm/Makefile doc/doxygen/Doxyfile doc/doxygen/Makefile doc/doxygen/doxygen-input-filter doc/misc/Makefile doc/xsl/Makefile doc/xsl/isc-docbook-chunk.xsl doc/xsl/isc-docbook-html.xsl doc/xsl/isc-docbook-latex.xsl doc/xsl/isc-manpage.xsl isc-config.sh lib/Makefile lib/bind9/Makefile lib/bind9/include/Makefile lib/bind9/include/bind9/Makefile lib/dns/Makefile lib/dns/include/Makefile lib/dns/include/dns/Makefile lib/dns/include/dst/Makefile lib/dns/tests/Makefile lib/irs/Makefile lib/irs/include/Makefile lib/irs/include/irs/Makefile lib/irs/include/irs/netdb.h lib/irs/include/irs/platform.h lib/isc/$arch/Makefile lib/isc/$arch/include/Makefile lib/isc/$arch/include/isc/Makefile lib/isc/$thread_dir/Makefile lib/isc/$thread_dir/include/Makefile lib/isc/$thread_dir/include/isc/Makefile lib/isc/Makefile lib/isc/include/Makefile lib/isc/include/isc/Makefile lib/isc/include/isc/platform.h lib/isc/include/pk11/Makefile lib/isc/include/pkcs11/Makefile lib/isc/tests/Makefile lib/isc/nls/Makefile lib/isc/unix/Makefile lib/isc/unix/include/Makefile lib/isc/unix/include/isc/Makefile lib/isc/unix/include/pkcs11/Makefile lib/isccc/Makefile lib/isccc/include/Makefile lib/isccc/include/isccc/Makefile lib/isccfg/Makefile lib/isccfg/include/Makefile lib/isccfg/include/isccfg/Makefile lib/lwres/Makefile lib/lwres/include/Makefile lib/lwres/include/lwres/Makefile lib/lwres/include/lwres/netdb.h lib/lwres/include/lwres/platform.h lib/lwres/man/Makefile lib/lwres/tests/Makefile lib/lwres/unix/Makefile lib/lwres/unix/include/Makefile lib/lwres/unix/include/lwres/Makefile lib/tests/Makefile lib/tests/include/Makefile lib/tests/include/tests/Makefile lib/samples/Makefile lib/samples/Makefile-postinstall unit/Makefile unit/unittest.sh"
+ac_config_files="$ac_config_files make/Makefile make/mkdep Makefile bin/Makefile bin/check/Makefile bin/confgen/Makefile bin/confgen/unix/Makefile bin/delv/Makefile bin/dig/Makefile bin/dnssec/Makefile bin/named/Makefile bin/named/unix/Makefile bin/nsupdate/Makefile bin/pkcs11/Makefile bin/python/Makefile bin/python/dnssec-checkds.py bin/python/dnssec-coverage.py bin/rndc/Makefile bin/tests/Makefile bin/tests/atomic/Makefile bin/tests/db/Makefile bin/tests/dst/Makefile bin/tests/dst/Kdh.+002+18602.key bin/tests/dst/Kdh.+002+18602.private bin/tests/dst/Kdh.+002+48957.key bin/tests/dst/Kdh.+002+48957.private bin/tests/dst/Ktest.+001+00002.key bin/tests/dst/Ktest.+001+54622.key bin/tests/dst/Ktest.+001+54622.private bin/tests/dst/Ktest.+003+23616.key bin/tests/dst/Ktest.+003+23616.private bin/tests/dst/Ktest.+003+49667.key bin/tests/dst/dst_2_data bin/tests/dst/t2_data_1 bin/tests/dst/t2_data_2 bin/tests/dst/t2_dsasig bin/tests/dst/t2_rsasig bin/tests/hashes/Makefile bin/tests/headerdep_test.sh bin/tests/master/Makefile bin/tests/mem/Makefile bin/tests/names/Makefile bin/tests/net/Makefile bin/tests/pkcs11/Makefile bin/tests/pkcs11/benchmarks/Makefile bin/tests/rbt/Makefile bin/tests/resolver/Makefile bin/tests/sockaddr/Makefile bin/tests/system/Makefile bin/tests/system/builtin/Makefile bin/tests/system/conf.sh bin/tests/system/dlz/prereq.sh bin/tests/system/dlzexternal/Makefile bin/tests/system/dlzexternal/ns1/named.conf bin/tests/system/filter-aaaa/Makefile bin/tests/system/geoip/Makefile bin/tests/system/inline/checkdsa.sh bin/tests/system/lwresd/Makefile bin/tests/system/resolver/Makefile bin/tests/system/rpz/Makefile bin/tests/system/rsabigexponent/Makefile bin/tests/system/sit/prereq.sh bin/tests/system/tkey/Makefile bin/tests/system/tsiggss/Makefile bin/tests/tasks/Makefile bin/tests/timers/Makefile bin/tests/virtual-time/Makefile bin/tests/virtual-time/conf.sh bin/tools/Makefile contrib/scripts/check-secure-delegation.pl contrib/scripts/zone-edit.sh doc/Makefile doc/arm/Makefile doc/doxygen/Doxyfile doc/doxygen/Makefile doc/doxygen/doxygen-input-filter doc/misc/Makefile doc/xsl/Makefile doc/xsl/isc-docbook-chunk.xsl doc/xsl/isc-docbook-html.xsl doc/xsl/isc-docbook-latex.xsl doc/xsl/isc-manpage.xsl doc/xsl/isc-notes-latex.xsl isc-config.sh lib/Makefile lib/bind9/Makefile lib/bind9/include/Makefile lib/bind9/include/bind9/Makefile lib/dns/Makefile lib/dns/include/Makefile lib/dns/include/dns/Makefile lib/dns/include/dst/Makefile lib/dns/tests/Makefile lib/irs/Makefile lib/irs/include/Makefile lib/irs/include/irs/Makefile lib/irs/include/irs/netdb.h lib/irs/include/irs/platform.h lib/isc/$arch/Makefile lib/isc/$arch/include/Makefile lib/isc/$arch/include/isc/Makefile lib/isc/$thread_dir/Makefile lib/isc/$thread_dir/include/Makefile lib/isc/$thread_dir/include/isc/Makefile lib/isc/Makefile lib/isc/include/Makefile lib/isc/include/isc/Makefile lib/isc/include/isc/platform.h lib/isc/include/pk11/Makefile lib/isc/include/pkcs11/Makefile lib/isc/tests/Makefile lib/isc/nls/Makefile lib/isc/unix/Makefile lib/isc/unix/include/Makefile lib/isc/unix/include/isc/Makefile lib/isc/unix/include/pkcs11/Makefile lib/isccc/Makefile lib/isccc/include/Makefile lib/isccc/include/isccc/Makefile lib/isccfg/Makefile lib/isccfg/include/Makefile lib/isccfg/include/isccfg/Makefile lib/lwres/Makefile lib/lwres/include/Makefile lib/lwres/include/lwres/Makefile lib/lwres/include/lwres/netdb.h lib/lwres/include/lwres/platform.h lib/lwres/man/Makefile lib/lwres/tests/Makefile lib/lwres/unix/Makefile lib/lwres/unix/include/Makefile lib/lwres/unix/include/lwres/Makefile lib/tests/Makefile lib/tests/include/Makefile lib/tests/include/tests/Makefile lib/samples/Makefile lib/samples/Makefile-postinstall unit/Makefile unit/unittest.sh"
 
 
 #
@@ -22797,6 +22797,7 @@ do
     "doc/xsl/isc-docbook-html.xsl") CONFIG_FILES="$CONFIG_FILES doc/xsl/isc-docbook-html.xsl" ;;
     "doc/xsl/isc-docbook-latex.xsl") CONFIG_FILES="$CONFIG_FILES doc/xsl/isc-docbook-latex.xsl" ;;
     "doc/xsl/isc-manpage.xsl") CONFIG_FILES="$CONFIG_FILES doc/xsl/isc-manpage.xsl" ;;
+    "doc/xsl/isc-notes-latex.xsl") CONFIG_FILES="$CONFIG_FILES doc/xsl/isc-notes-latex.xsl" ;;
     "isc-config.sh") CONFIG_FILES="$CONFIG_FILES isc-config.sh" ;;
     "lib/Makefile") CONFIG_FILES="$CONFIG_FILES lib/Makefile" ;;
     "lib/bind9/Makefile") CONFIG_FILES="$CONFIG_FILES lib/bind9/Makefile" ;;

diff --git a/configure.in b/configure.in
index 8067f003fb943ec0769fd4ba20bc05e3f27947d5..6001e0aa18af184b94b8da727d0e9fbb8d5ed91b 100644 (file)
--- a/configure.in
+++ b/configure.in
@@ -4556,6 +4556,7 @@ AC_CONFIG_FILES([
        doc/xsl/isc-docbook-html.xsl
        doc/xsl/isc-docbook-latex.xsl
        doc/xsl/isc-manpage.xsl
+       doc/xsl/isc-notes-latex.xsl
        isc-config.sh
        lib/Makefile
        lib/bind9/Makefile

diff --git a/doc/arm/Bv9ARM-book.xml b/doc/arm/Bv9ARM-book.xml
index e8ff4a4627971af728d41976a133b4a4882909b0..7331b1d65d590620389a4890ac8e9c9c61a7fdc5 100644 (file)
--- a/doc/arm/Bv9ARM-book.xml
+++ b/doc/arm/Bv9ARM-book.xml
@@ -16513,6 +16513,7 @@ allow-query { !{ !10/8; any; }; key example; };
     </chapter>
     <appendix id="Bv9ARM.ch09">
       <title>Appendices</title>
+      <xi:include href="notes.xml"/>
       <sect1>
        <title>Acknowledgments</title>
        <sect2 id="historical_dns_information">

diff --git a/doc/arm/Makefile.in b/doc/arm/Makefile.in
index 5bae2b2e47a170f0a55fb0a35fddb292e29d6ff0..6bc57e647e5350b95b35aaaae344727004f7013f 100644 (file)
--- a/doc/arm/Makefile.in
+++ b/doc/arm/Makefile.in
@@ -25,15 +25,17 @@ top_srcdir =        @top_srcdir@
 
 PKGVERSION = @PACKAGE_VERSION@
 
-MANOBJS = Bv9ARM.html
+MANOBJS = Bv9ARM.html notes.html
 
-PDFOBJS = Bv9ARM.pdf
+PDFOBJS = Bv9ARM.pdf notes.pdf
 
 doc man:: ${MANOBJS} ${PDFOBJS}
 
 clean::
        rm -f Bv9ARM.aux Bv9ARM.brf Bv9ARM.glo Bv9ARM.idx Bv9ARM.toc
        rm -f Bv9ARM.log Bv9ARM.out Bv9ARM.tex Bv9ARM.tex.tmp
+       rm -f notes.aux notes.brf notes.glo notes.idx notes.toc
+       rm -f notes.log notes.out notes.tex notes.tex.tmp
 
 docclean manclean maintainer-clean:: clean
        rm -f *.html ${PDFOBJS}
@@ -41,30 +43,46 @@ docclean manclean maintainer-clean:: clean
 docclean manclean maintainer-clean distclean::
        rm -f releaseinfo.xml
        rm -f pkgversion.xml
+       rm -f noteversion.xml
 
-Bv9ARM.html: Bv9ARM-book.xml releaseinfo.xml pkgversion.xml
+notes.html: notes-wrapper.xml notes.xml releaseinfo.xml pkgversion.xml noteversion.xml
+       expand notes-wrapper.xml | \
+       ${XSLTPROC} -o notes.html ../xsl/isc-docbook-html.xsl -
+
+notes.tex: notes-wrapper.xml notes.xml releaseinfo.xml pkgversion.xml noteversion.xml
+       expand notes-wrapper.xml | \
+       ${XSLTPROC} ${top_srcdir}/doc/xsl/pre-latex.xsl - | \
+       ${XSLTPROC} ${top_srcdir}/doc/xsl/isc-notes-latex.xsl - | \
+       @PERL@ latex-fixup.pl >$@.tmp 
+       if test -s $@.tmp; then mv $@.tmp $@; else rm -f $@.tmp; exit 1; fi
+
+notes.pdf: notes.tex releaseinfo.xml pkgversion.xml noteversion.xml
+       rm -f notes-wrapper.aux notes.pdf notes.log
+       ${PDFLATEX} '\batchmode\input notes.tex' || (rm -f $@ ; exit 1)
+
+Bv9ARM.html: Bv9ARM-book.xml releaseinfo.xml pkgversion.xml noteversion.xml
        expand Bv9ARM-book.xml | \
        ${XSLTPROC} --stringparam root.filename Bv9ARM \
                ${top_srcdir}/doc/xsl/isc-docbook-chunk.xsl -
 
-Bv9ARM-all.html: Bv9ARM-book.xml releaseinfo.xml pkgversion.xml
+Bv9ARM-all.html: Bv9ARM-book.xml releaseinfo.xml pkgversion.xml noteversion.xml
        expand Bv9ARM-book.xml | \
        ${XSLTPROC} -o Bv9ARM-all.html ../xsl/isc-docbook-html.xsl -
 
-Bv9ARM.tex: Bv9ARM-book.xml releaseinfo.xml pkgversion.xml
+Bv9ARM.tex: Bv9ARM-book.xml releaseinfo.xml pkgversion.xml noteversion.xml
        expand Bv9ARM-book.xml | \
        ${XSLTPROC} ${top_srcdir}/doc/xsl/pre-latex.xsl - | \
        ${XSLTPROC} ${top_srcdir}/doc/xsl/isc-docbook-latex.xsl - | \
        @PERL@ latex-fixup.pl >$@.tmp 
        if test -s $@.tmp; then mv $@.tmp $@; else rm -f $@.tmp; exit 1; fi
 
-Bv9ARM.dvi: Bv9ARM.tex releaseinfo.xml pkgversion.xml
+Bv9ARM.dvi: Bv9ARM.tex releaseinfo.xml pkgversion.xml noteversion.xml
        rm -f Bv9ARM-book.aux Bv9ARM-book.dvi Bv9ARM-book.log
        ${LATEX} '\batchmode\input Bv9ARM.tex' || (rm -f $@ ; exit 1)
        ${LATEX} '\batchmode\input Bv9ARM.tex' || (rm -f $@ ; exit 1)
        ${LATEX} '\batchmode\input Bv9ARM.tex' || (rm -f $@ ; exit 1)
 
-Bv9ARM.pdf: Bv9ARM.tex releaseinfo.xml pkgversion.xml
+Bv9ARM.pdf: Bv9ARM.tex releaseinfo.xml pkgversion.xml noteversion.xml
        rm -f Bv9ARM-book.aux Bv9ARM-book.pdf Bv9ARM-book.log
        ${PDFLATEX} '\batchmode\input Bv9ARM.tex' || (rm -f $@ ; exit 1)
        ${PDFLATEX} '\batchmode\input Bv9ARM.tex' || (rm -f $@ ; exit 1)
@@ -75,5 +93,8 @@ FORCE:
 releaseinfo.xml: FORCE
        echo >$@ '<releaseinfo>BIND Version ${VERSION}</releaseinfo>'
 
+noteversion.xml: FORCE
+       echo >$@ '<title>Release Notes for BIND Version ${VERSION}</title>'
+
 pkgversion.xml: FORCE
        echo >$@ '      <para>This version of the manual corresponds to BIND version ${PKGVERSION}.</para>'

diff --git a/doc/arm/notes-wrapper.xml b/doc/arm/notes-wrapper.xml
new file mode 100644 (file)
index 0000000..131a353
--- /dev/null
+++ b/doc/arm/notes-wrapper.xml
@@ -0,0 +1,31 @@
+<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+             "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"
+              [<!ENTITY mdash "&#8212;">]>
+<!--
+ - Copyright (C) 2014  Internet Systems Consortium, Inc. ("ISC")
+ -
+ - Permission to use, copy, modify, and/or distribute this software for any
+ - purpose with or without fee is hereby granted, provided that the above
+ - copyright notice and this permission notice appear in all copies.
+ -
+ - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
+ - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+ - AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
+ - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+ - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
+ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+ - PERFORMANCE OF THIS SOFTWARE.
+-->
+
+<book xmlns:xi="http://www.w3.org/2001/XInclude">
+<preface>
+  <title>&#x00a0;</title>
+  <xi:include href="notes.xml"/>
+</preface>
+</book>
+
+<!--
+  - Local variables:
+  - mode: sgml
+  - End:
+ -->

diff --git a/doc/arm/notes.xml b/doc/arm/notes.xml
new file mode 100644 (file)
index 0000000..0bd6a79
--- /dev/null
+++ b/doc/arm/notes.xml
@@ -0,0 +1,80 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+ - Copyright (C) 2014  Internet Systems Consortium, Inc. ("ISC")
+ -
+ - Permission to use, copy, modify, and/or distribute this software for any
+ - purpose with or without fee is hereby granted, provided that the above
+ - copyright notice and this permission notice appear in all copies.
+ -
+ - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
+ - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+ - AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
+ - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+ - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
+ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+ - PERFORMANCE OF THIS SOFTWARE.
+-->
+
+<sect1 xmlns:xi="http://www.w3.org/2001/XInclude">
+  <xi:include href="noteversion.xml"/>
+  <sect2 id="relnotes_intro">
+    <title>Introduction</title>
+    <para>
+      This document summarizes changes since the last production release
+      of BIND on the corresponding major release branch.
+    </para>
+  </sect2>
+  <sect2 id="relnotes_download">
+    <title>Download</title>
+    <para>
+      The latest versions of BIND 9 software can always be found at
+      <ulink url="http://www.isc.org/downloads/"
+       >http://www.isc.org/downloads/</ulink>.
+      There you will find additional information about each release,
+      source code, and pre-compiled versions for Microsoft Windows
+      operating systems.
+    </para>
+  </sect2>
+  <sect2 id="relnotes_security">
+    <title>Security Fixes</title>
+    <itemizedlist>
+      <listitem>
+       <para>None</para>
+      </listitem>
+    </itemizedlist>
+  </sect2>
+  <sect2 id="relnotes_features">
+    <title>New Features</title>
+    <itemizedlist>
+      <listitem>
+       <para>None</para>
+      </listitem>
+    </itemizedlist>
+  </sect2>
+  <sect2 id="relnotes_changes">
+    <title>Feature Changes</title>
+    <itemizedlist>
+      <listitem>
+       <para>None</para>
+      </listitem>
+    </itemizedlist>
+  </sect2>
+  <sect2 id="relnotes_features">
+    <title>Bug Fixes</title>
+    <itemizedlist>
+      <listitem>
+       <para>None</para>
+      </listitem>
+    </itemizedlist>
+  </sect2>
+  <sect2 id="relnotes_thanks">
+    <title>Thank You</title>
+    <para>
+      Thank you to everyone who assisted us in making this release possible.
+      If you would like to contribute to ISC to assist us in continuing to
+      make quality open source software, please visit our donations page at
+      <ulink url="http://www.isc.org/donate/"
+       >http://www.isc.org/donate/</ulink>.
+    </para>
+  </sect2>
+</sect1>

diff --git a/doc/xsl/Makefile.in b/doc/xsl/Makefile.in
index cba3068e741903c0eeee9d547bf57218bcd0aed2..bd828ce3331b22016cf463060013cf322197aa81 100644 (file)
--- a/doc/xsl/Makefile.in
+++ b/doc/xsl/Makefile.in
@@ -12,8 +12,6 @@
 # OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
 # PERFORMANCE OF THIS SOFTWARE.
 
-# $Id: Makefile.in,v 1.4 2007/06/19 23:47:13 tbox Exp $
-
 srcdir =       @srcdir@
 VPATH =                @srcdir@
 top_srcdir =   @top_srcdir@
@@ -25,4 +23,4 @@ TARGETS =
 
 distclean::
        rm -f isc-docbook-chunk.xsl isc-docbook-html.xsl \
-             isc-docbook-latex.xsl isc-manpage.xsl
+             isc-docbook-latex.xsl isc-manpage.xsl isc-notes-latex.xsl

diff --git a/doc/xsl/isc-notes-latex.xsl.in b/doc/xsl/isc-notes-latex.xsl.in
new file mode 100644 (file)
index 0000000..aa87bb4
--- /dev/null
+++ b/doc/xsl/isc-notes-latex.xsl.in
@@ -0,0 +1,101 @@
+<!--
+ - Copyright (C) 2014  Internet Systems Consortium, Inc. ("ISC")
+ -
+ - Permission to use, copy, modify, and/or distribute this software for any
+ - purpose with or without fee is hereby granted, provided that the above
+ - copyright notice and this permission notice appear in all copies.
+ -
+ - THE SOFTWARE IS PROVIDED "AS IS" AND ISC DISCLAIMS ALL WARRANTIES WITH
+ - REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+ - AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE FOR ANY SPECIAL, DIRECT,
+ - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+ - LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
+ - OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+ - PERFORMANCE OF THIS SOFTWARE.
+-->
+
+<!-- ISC customizations for db2latex generator -->
+
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+
+  <!-- Import the db2latex stuff -->
+  <xsl:import href="@XSLT_DB2LATEX_STYLE@"/>
+
+  <!-- Blank lines between paragraphs, please -->
+  <xsl:param name="latex.use.parskip" select="1"/>
+
+  <!-- Least bad current option for constructing tables -->
+  <xsl:param name="latex.use.ltxtable" select="1"/>
+  <xsl:param name="latex.use.longtable" select="1"/>
+
+  <!-- LaTeX2e documentclass options. -->
+  <xsl:param name="latex.documentclass.common"/>
+  <xsl:param name="latex.documentclass.book">10pt,twoside,openright</xsl:param>
+
+  <!-- This documentation is in English (or maybe Bad English) -->
+  <xsl:param name="latex.babel.language" select="'english'"/>
+  <xsl:param name="l10n.gentext.default.language" select="'en'"/>
+
+  <!-- Where to find "admonition" graphics -->
+  <xsl:param name="admon.graphics.path" select="'@XSLT_DB2LATEX_ADMONITIONS@'"/>
+
+  <!-- ANSI C function prototypes, please -->
+  <xsl:param name="funcsynopsis.style">ansi</xsl:param>
+
+  <!-- Local modifications to db2latex's mapping rules -->
+  <xsl:param name="latex.mapping.xml" select="document('isc-docbook-latex-mappings.xml')"/>
+
+  <!-- Patch around db2latex (0.8pre1) bug -->
+  <xsl:template match="copyright/year">
+    <xsl:apply-templates />
+    <xsl:if test="position() != last()">
+      <xsl:text>, </xsl:text>
+    </xsl:if>
+  </xsl:template>
+
+  <!-- Number by section, not chapter -->
+  <xsl:param name="chapter.autolabel" select="1"/>
+  <xsl:param name="section.autolabel" select="1"/>
+  <xsl:param name="section.label.includes.component.label" select="0"/>
+
+  <!-- Suppress title page, header -->
+  <xsl:param name="latex.maketitle"/>
+  <xsl:param name="latex.use.fancyhdr"/>
+
+  <!--
+    - Add support for multiple <para/> elements in a table entry.
+    - db2latex is already typesetting the table entry as a parbox,
+    - so we just have to insert the paragraph breaks.
+   -->
+  <xsl:template match="tbody/row/entry/para[position() != last()]">
+    <xsl:apply-imports/>
+    <xsl:text> \par </xsl:text>
+  </xsl:template>
+
+  <!-- 
+    - Add support for <optional/> in <programlisting/>.
+   -->
+  <xsl:template match="optional" mode="latex.verbatim">
+    <xsl:text>[</xsl:text>
+    <xsl:apply-templates mode="latex.verbatim"/>
+    <xsl:text>]</xsl:text>
+  </xsl:template>
+
+  <!--
+    - Try to avoid some weird looking line breaks.
+    -
+    - This doesn't really work right, so disable for now.
+   -->
+  <xsl:template match="literal" mode="disabled">
+    <xsl:text>\mbox{</xsl:text>
+    <xsl:apply-imports/>
+    <xsl:text>}</xsl:text>
+  </xsl:template>
+
+</xsl:stylesheet>
+
+<!-- 
+  - Local variables:
+  - mode: sgml
+  - End:
+ -->