From 9b26804b581d11dc845e96073bda32f739581aee Mon Sep 17 00:00:00 2001
From: Eric Luce <source@isc.org>
Date: Mon, 18 Sep 2000 17:06:15 +0000
Subject: [PATCH] Regenerated the HTML version of the ARM again.

Added more text to the "README-SGML" document on how to set up
environment on FreeBSD. Still need to do NetBSD.
---
 doc/arm/Bv9ARM.ch01.html |  8 +++-
 doc/arm/Bv9ARM.ch02.html |  2 +-
 doc/arm/Bv9ARM.ch03.html | 11 +++++-
 doc/arm/Bv9ARM.ch04.html |  2 +-
 doc/arm/Bv9ARM.ch05.html |  2 +-
 doc/arm/Bv9ARM.ch06.html | 83 +++++++++++++++++++++++++++++++++++++++-
 doc/arm/Bv9ARM.ch07.html |  2 +-
 doc/arm/Bv9ARM.ch08.html |  2 +-
 doc/arm/Bv9ARM.ch09.html | 11 +++++-
 doc/arm/Bv9ARM.html      |  2 +-
 doc/arm/README-SGML      | 65 +++++++++++++++++++++++++++++--
 11 files changed, 177 insertions(+), 13 deletions(-)

diff --git a/doc/arm/Bv9ARM.ch01.html b/doc/arm/Bv9ARM.ch01.html
index 3da4189f1f..3f47b4869b 100644
--- a/doc/arm/Bv9ARM.ch01.html
+++ b/doc/arm/Bv9ARM.ch01.html
@@ -4,7 +4,7 @@
 >Introduction </TITLE
 ><META
 NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.54"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.57"><LINK
 REL="HOME"
 HREF="Bv9ARM.html"><LINK
 REL="PREVIOUS"
@@ -230,6 +230,9 @@ NAME="AEN32"
     conventions:</P
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN35"
+></A
 ><P
 ></P
 ><TABLE
@@ -352,6 +355,9 @@ CLASS="acronym"
 >BIND</SPAN
 > configuration file:<DIV
 CLASS="informaltable"
+><A
+NAME="AEN73"
+></A
 ><P
 ></P
 ><TABLE
diff --git a/doc/arm/Bv9ARM.ch02.html b/doc/arm/Bv9ARM.ch02.html
index 602ba358fc..1eb05ba65d 100644
--- a/doc/arm/Bv9ARM.ch02.html
+++ b/doc/arm/Bv9ARM.ch02.html
@@ -4,7 +4,7 @@
 >BIND Resource Requirements</TITLE
 ><META
 NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.54"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.57"><LINK
 REL="HOME"
 HREF="Bv9ARM.html"><LINK
 REL="PREVIOUS"
diff --git a/doc/arm/Bv9ARM.ch03.html b/doc/arm/Bv9ARM.ch03.html
index 5610f87325..f5041296f7 100644
--- a/doc/arm/Bv9ARM.ch03.html
+++ b/doc/arm/Bv9ARM.ch03.html
@@ -4,7 +4,7 @@
 >Nameserver Configuration</TITLE
 ><META
 NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.54"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.57"><LINK
 REL="HOME"
 HREF="Bv9ARM.html"><LINK
 REL="PREVIOUS"
@@ -215,6 +215,9 @@ following means that clients will connect to each machine one third
 of the time:</P
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN291"
+></A
 ><P
 ></P
 ><TABLE
@@ -785,6 +788,9 @@ CLASS="command"
 >:</P
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN483"
+></A
 ><P
 ></P
 ><TABLE
@@ -1236,6 +1242,9 @@ CLASS="command"
 > command.</P
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN604"
+></A
 ><P
 ></P
 ><TABLE
diff --git a/doc/arm/Bv9ARM.ch04.html b/doc/arm/Bv9ARM.ch04.html
index 81b015d6f8..031aa8d8d7 100644
--- a/doc/arm/Bv9ARM.ch04.html
+++ b/doc/arm/Bv9ARM.ch04.html
@@ -4,7 +4,7 @@
 >Advanced Concepts</TITLE
 ><META
 NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.54"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.57"><LINK
 REL="HOME"
 HREF="Bv9ARM.html"><LINK
 REL="PREVIOUS"
diff --git a/doc/arm/Bv9ARM.ch05.html b/doc/arm/Bv9ARM.ch05.html
index 7d34f2d325..18b653c3ef 100644
--- a/doc/arm/Bv9ARM.ch05.html
+++ b/doc/arm/Bv9ARM.ch05.html
@@ -4,7 +4,7 @@
 >The BIND 9 Lightweight Resolver</TITLE
 ><META
 NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.54"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.57"><LINK
 REL="HOME"
 HREF="Bv9ARM.html"><LINK
 REL="PREVIOUS"
diff --git a/doc/arm/Bv9ARM.ch06.html b/doc/arm/Bv9ARM.ch06.html
index fbfd48dbc8..fbec671808 100644
--- a/doc/arm/Bv9ARM.ch06.html
+++ b/doc/arm/Bv9ARM.ch06.html
@@ -4,7 +4,7 @@
 >BIND 9 Configuration Reference</TITLE
 ><META
 NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.54"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.57"><LINK
 REL="HOME"
 HREF="Bv9ARM.html"><LINK
 REL="PREVIOUS"
@@ -142,6 +142,9 @@ CLASS="acronym"
 file documentation:</P
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN1023"
+></A
 ><P
 ></P
 ><TABLE
@@ -976,6 +979,9 @@ CLASS="acronym"
 >The following statements are supported:</P
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN1250"
+></A
 ><P
 ></P
 ><TABLE
@@ -1247,6 +1253,9 @@ CLASS="command"
 >The following ACLs are built-in:</P
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN1332"
+></A
 ><P
 ></P
 ><TABLE
@@ -2266,6 +2275,9 @@ CLASS="acronym"
 > releases.</P
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN1584"
+></A
 ><P
 ></P
 ><TABLE
@@ -3299,6 +3311,9 @@ CLASS="command"
 > statement, an options
 block with each option set to its default will be used.<DIV
 CLASS="informaltable"
+><A
+NAME="AEN1840"
+></A
 ><P
 ></P
 ><TABLE
@@ -3644,6 +3659,9 @@ NAME="boolean_options"
 ></H3
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN1935"
+></A
 ><P
 ></P
 ><TABLE
@@ -4353,6 +4371,9 @@ its cache.</P
 ><P
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN2121"
+></A
 ><P
 ></P
 ><TABLE
@@ -4445,6 +4466,9 @@ be checked for compliance with the RFCs defining valid hostnames.</P
 ><P
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN2148"
+></A
 ><P
 ></P
 ><TABLE
@@ -4584,6 +4608,9 @@ details on how to specify IP address lists.</P
 ><P
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN2188"
+></A
 ><P
 ></P
 ><TABLE
@@ -4893,6 +4920,9 @@ and set limits on the amount of load that transfers place on the
 system. The following options apply to zone transfers.</P
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN2271"
+></A
 ><P
 ></P
 ><TABLE
@@ -5354,6 +5384,9 @@ HREF="Bv9ARM.ch06.html#configuration_file_elements"
 >.</P
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN2394"
+></A
 ><P
 ></P
 ><TABLE
@@ -5655,6 +5688,9 @@ NAME="AEN2473"
 ></H3
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN2475"
+></A
 ><P
 ></P
 ><TABLE
@@ -6102,6 +6138,9 @@ CLASS="command"
 > are:</P
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN2579"
+></A
 ><P
 ></P
 ><TABLE
@@ -6234,6 +6273,9 @@ NAME="tuning"
 ></H3
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN2617"
+></A
 ><P
 ></P
 ><TABLE
@@ -7377,6 +7419,9 @@ NAME="AEN2893"
 ></H3
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN2895"
+></A
 ><P
 ></P
 ><TABLE
@@ -7650,6 +7695,9 @@ NAME="AEN2962"
 ></H3
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN2964"
+></A
 ><P
 ></P
 ><TABLE
@@ -8379,6 +8427,9 @@ CLASS="varname"
 </P
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN3171"
+></A
 ><P
 ></P
 ><TABLE
@@ -8526,6 +8577,9 @@ HREF="Bv9ARM.ch06.html#rrset_ordering"
 >The components of a Resource Record are:</P
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN3212"
+></A
 ><P
 ></P
 ><TABLE
@@ -8633,6 +8687,9 @@ CLASS="emphasis"
 or historical (h) and no longer in general use):</P
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN3244"
+></A
 ><P
 ></P
 ><TABLE
@@ -9006,6 +9063,9 @@ CLASS="emphasis"
 are currently valid in the DNS:</P
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN3356"
+></A
 ><P
 ></P
 ><TABLE
@@ -9054,6 +9114,9 @@ CLASS="emphasis"
 data that describes the resource:</P
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN3372"
+></A
 ><P
 ></P
 ><TABLE
@@ -9257,6 +9320,9 @@ knowledge of the typical representation for the data.</P
 >For example, we might show the RRs carried in a message as:</P
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN3427"
+></A
 ><P
 ></P
 ><TABLE
@@ -9462,6 +9528,9 @@ domain names.</P
 >Similarly we might see:</P
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN3493"
+></A
 ><P
 ></P
 ><TABLE
@@ -9582,6 +9651,9 @@ the mail will be delivered to the server specified in the MX record
 pointed to by the CNAME.</P
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN3527"
+></A
 ><P
 ></P
 ><TABLE
@@ -9873,6 +9945,9 @@ should be discarded. The following three types of TTL are currently
 used in a zone file.</P
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN3619"
+></A
 ><P
 ></P
 ><TABLE
@@ -9976,6 +10051,9 @@ CLASS="optional"
 >] domain:</P
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN3647"
+></A
 ><P
 ></P
 ><TABLE
@@ -10342,6 +10420,9 @@ CLASS="literal"
 ></PRE
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN3746"
+></A
 ><P
 ></P
 ><TABLE
diff --git a/doc/arm/Bv9ARM.ch07.html b/doc/arm/Bv9ARM.ch07.html
index c1ebdb6cec..8be2e72ec1 100644
--- a/doc/arm/Bv9ARM.ch07.html
+++ b/doc/arm/Bv9ARM.ch07.html
@@ -4,7 +4,7 @@
 >BIND 9 Security Considerations</TITLE
 ><META
 NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.54"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.57"><LINK
 REL="HOME"
 HREF="Bv9ARM.html"><LINK
 REL="PREVIOUS"
diff --git a/doc/arm/Bv9ARM.ch08.html b/doc/arm/Bv9ARM.ch08.html
index eb6c9040e4..ea1b0a6a81 100644
--- a/doc/arm/Bv9ARM.ch08.html
+++ b/doc/arm/Bv9ARM.ch08.html
@@ -4,7 +4,7 @@
 >Troubleshooting</TITLE
 ><META
 NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.54"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.57"><LINK
 REL="HOME"
 HREF="Bv9ARM.html"><LINK
 REL="PREVIOUS"
diff --git a/doc/arm/Bv9ARM.ch09.html b/doc/arm/Bv9ARM.ch09.html
index 039b975806..d24765313b 100644
--- a/doc/arm/Bv9ARM.ch09.html
+++ b/doc/arm/Bv9ARM.ch09.html
@@ -4,7 +4,7 @@
 >Appendices</TITLE
 ><META
 NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.54"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.57"><LINK
 REL="HOME"
 HREF="Bv9ARM.html"><LINK
 REL="PREVIOUS"
@@ -321,6 +321,9 @@ Unicast address scheme. For more information, see RFC 2374.</P
 >The aggregatable global Unicast address format is as follows:</P
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN3940"
+></A
 ><P
 ></P
 ><TABLE
@@ -536,6 +539,9 @@ VALIGN="MIDDLE"
 >Where
 <DIV
 CLASS="informaltable"
+><A
+NAME="AEN4009"
+></A
 ><P
 ></P
 ><TABLE
@@ -715,6 +721,9 @@ in much the same way as Classless InterDomain Routing (CIDR).</P
 unicast address consists of:</P
 ><DIV
 CLASS="informaltable"
+><A
+NAME="AEN4064"
+></A
 ><P
 ></P
 ><TABLE
diff --git a/doc/arm/Bv9ARM.html b/doc/arm/Bv9ARM.html
index fc29567fd5..2132c85cc6 100644
--- a/doc/arm/Bv9ARM.html
+++ b/doc/arm/Bv9ARM.html
@@ -4,7 +4,7 @@
 ></TITLE
 ><META
 NAME="GENERATOR"
-CONTENT="Modular DocBook HTML Stylesheet Version 1.54"><LINK
+CONTENT="Modular DocBook HTML Stylesheet Version 1.57"><LINK
 REL="NEXT"
 TITLE="Introduction "
 HREF="Bv9ARM.ch01.html"></HEAD
diff --git a/doc/arm/README-SGML b/doc/arm/README-SGML
index e57be251bf..847d48d9b3 100644
--- a/doc/arm/README-SGML
+++ b/doc/arm/README-SGML
@@ -1,6 +1,6 @@
 The BIND v9 ARM master document is now kept in DocBook XML format.
 
-Version: $Id: README-SGML,v 1.4 2000/09/11 17:54:44 scanner Exp $
+Version: $Id: README-SGML,v 1.5 2000/09/18 17:06:15 scanner Exp $
 
 The entire ARM is in the single file:
 
@@ -145,9 +145,12 @@ To convert the resulting TeX file in to a DVI file you need to do:
 
     tex "&jadetex" Bv9ARM-book.tex
 
+You can also directly generate the pdf file via:
+
+    pdftex "&pdfjadetex" Bv9ARM-book.tex
+
 You will need to up both the "pool_size" and "hash_extra" variables in
-your texmf.cnf file and regenerate them. Stay tuned for instructions
-here.
+your texmf.cnf file and regenerate them. See below.
 
 You can see that I am using a DSSSL style sheet for DocBook. Actually
 two different ones - one for rendering html, and one for 'print'
@@ -181,3 +184,59 @@ entity. You can ignore those for now.
 Also with the style sheets we have and jade as it is you will get
 messages about "xref to title" being unsupported. You can ignore these
 for now as well.
+
+=== Getting the various tools installed on FreeBSD
+(NetBSD coming soon..)
+
+o On freebsd you need to install the following packages:
+  o print/teTeX
+  o textproc/openjade
+  o textproc/docbook
+  o textproc/docbook-xml
+  o textproc/dsssl-docbook-modular
+  o textproc/dtd-catalogs
+
+o on freebsd you need to make some entities visible to the docbook xml
+  dtd by making a symlink (can probably be done with a catalog too)
+  ln -s /usr/local/share/xml/entity /usr/local/share/xml/dtd/docbook/ent
+
+o you may need to edit /usr/local/share/sgml/catalog and add the line:
+
+  CATALOG "/usr/local/share/sgml/openjade/catalog"
+
+o add "hugelatex," Enlarge pool sizes, install the jadetex TeX driver
+  file.
+
+  cd /usr/local/share/texmf/web2c/
+  sudo cp texmf.cnf texmf.cnf.bak
+
+  o edit the lines in texmf.cnf with these keys to these values:
+
+                  main_memory = 1100000
+                  hash_extra = 15000
+                  pool_size = 500000
+                  string_vacancies = 45000
+                  max_strings = 55000
+                  pool_free = 47500
+                  nest_size = 500
+                  param_size = 1500
+                  save_size = 5000
+                  stack_size = 1500
+
+  sudo tex -ini -progname=hugelatex -fmt=hugelatex latex.ltx
+  sudo texconfig init
+
+  o For the jadetex macros you will need I recommend you get a more
+    current version than what is packaged with openjade or jade.
+
+    Checkout http://www.tug.org/applications/jadetex/
+    
+    Unzip the file you get from there (should be jadetex-2.20 or
+    newer.) 
+
+    In the directory you unzip: 
+
+      sudo make install
+      sudo texhash
+
+