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

@@ -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

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"

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

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"

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"

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

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"

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"

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

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

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
+
+