Changes in server/major/bind.xml [cd9f166a:8414284]

File:

• server/major/bind.xml (modified) (16 diffs)

server/major/bind.xml

@@ -7 +7 @@
   <!ENTITY bind-download-http "https://ftp.isc.org/isc/bind9/&bind-version;/bind-&bind-version;.tar.xz">
   <!ENTITY bind-download-ftp  "ftp://ftp.isc.org/isc/bind9/&bind-version;/bind-&bind-version;.tar.xz">
-  <!ENTITY bind-md5sum        "0bf3c0f656844194579647abd7a2961a">
-  <!ENTITY bind-size          "4.8 MB">
-  <!ENTITY bind-buildsize     "117 MB (20 MB installed)">
-  <!ENTITY bind-time          "0.8 SBU (with parallelism=4; add 30+ minutes, somewhat processor independent, to run the complete test suite)">
+  <!ENTITY bind-md5sum        "6586d9c376e7ee9674767e1d79d63382">
+  <!ENTITY bind-size          "5.0 MB">
+  <!ENTITY bind-buildsize     "139 MB (26 MB installed)"><!-- differs much from prev maybe because of docs? -->
+  <!ENTITY bind-time          "0.4 SBU (with parallelism=4; about 20 SBU somewhat processor independent, to run the complete test suite)">
 ]>
 
@@ -16 +16 @@
   <?dbhtml filename="bind.html"?>
 
-  <sect1info>
-    <date>$Date$</date>
-  </sect1info>
 
   <title>BIND-&bind-version;</title>
@@ -35 +32 @@
     </para>
 
-    &lfs110a_checked;
+    &lfs112_checked;
 
     <bridgehead renderas="sect3">Package Information</bridgehead>
@@ -104 +101 @@
       <ulink url="https://github.com/cjheath/geoip">geoip</ulink>,
       <ulink url="https://docs.pytest.org/en/stable/">pytest</ulink>,
-      <ulink url="https://pypi.python.org/pypi/Sphinx">Sphinx</ulink>, and
+      <ulink url="https://pypi.python.org/pypi/Sphinx">Sphinx</ulink> (required to build documentation), and
       <ulink url="&w3m-url;">w3m</ulink>
     </para>
@@ -111 +108 @@
     <para role="optional">
       <xref linkend="db"/>,
-      <xref linkend="mariadb"/> or <ulink url="http://www.mysql.com/">MySQL</ulink>,
+      <xref linkend="mariadb"/> or <ulink url="https://www.mysql.com/">MySQL</ulink>,
       <xref linkend="openldap"/>,
       <xref linkend="postgresql"/>, and
@@ -122 +119 @@
     </para>
 
+<!-- docs are now all sphinx based
     <bridgehead renderas="sect4">Optional (to rebuild the documentation)</bridgehead>
     <para role="optional">
@@ -128 +126 @@
       <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>)
     </para>
+-->
 
     <para condition="html" role="usernotes">User Notes:
@@ -137 +136 @@
     <title>Installation of BIND</title>
 
+<!--
     <para>
       To ensure <application>BIND</application> will build dnssec-keymgr,
@@ -144 +144 @@
 
 <screen role="root"><userinput>pip3 install ply</userinput></screen>
+-->
 
     <para>
@@ -154 +155 @@
             --localstatedir=/var    \
             --mandir=/usr/share/man \
-            --with-libtool          \
             --disable-static        &amp;&amp;
 make</userinput></screen>
@@ -178 +178 @@
       The test suite may indicate some skipped tests depending on
       what configuration options are used. Some tests are marked
-      <quote>UNTESTED</quote> if <xref linkend="perl-net-dns"/> is not
-      installed. <!--One test, <quote>CPU</quote>, is known to fail.-->
+      <quote>UNTESTED</quote> or does even fail if <xref linkend="perl-net-dns"/>
+      is not installed. <!--One test, <quote>CPU</quote>, is known to fail.-->
       To run the tests, as an unprivileged user, execute:
     </para>
@@ -198 +198 @@
     </para>
 
+<!-- Documentation is an issue - The docs are now all in .rst format and appear
+to be sphinx based. install source .rst files for now...
+
+leave docs untouched as they does only use disk space when not
+used to recreate the docs via Sphinx. I've added a note regarding
+the documentation. (thomas)
+
+<screen role="root"><userinput>make install &amp;&amp;
+
+install -vdm 755 /usr/share/doc/bind-&bind-version;/{arm,dnssec-guide} &amp;&amp;
+install doc/arm/* /usr/share/doc/bind-&bind-version;/arm               &amp;&amp;
+install doc/dnssec-guide/* /usr/share/doc/bind-&bind-version;/dnssec-guide</userinput></screen>
+-->
 <screen role="root"><userinput>make install</userinput></screen>
+
   </sect2>
-
-<!-- Documentation is an issue - The docs are now all in .rst format and appear
-to be sphinx based.
--->
 
   <sect2 role="commands">
@@ -215 +225 @@
     </para>
 
-    <para>
-      <parameter>--with-libtool</parameter>: This parameter forces the
+    <!-- Seems to be removed in 9.18.0
+    <para>
+      <parameter>- -with-libtool</parameter>: This parameter forces the
       building of dynamic libraries and links the installed binaries to these
       libraries.
     </para>
+    -->
 
     <para>
@@ -436 +448 @@
 A.ROOT-SERVERS.NET.     6D  IN      A       198.41.0.4
 A.ROOT-SERVERS.NET.     6D  IN      AAAA    2001:503:ba3e::2:30
-B.ROOT-SERVERS.NET.     6D  IN      A       192.228.79.201
+B.ROOT-SERVERS.NET.     6D  IN      A       199.9.14.201
 B.ROOT-SERVERS.NET.     6D  IN      AAAA    2001:500:200::b
 C.ROOT-SERVERS.NET.     6D  IN      A       192.33.4.12
@@ -466 +478 @@
         servers. This file must be updated periodically with the
         <command>dig</command> utility. A current copy of root.hints can be
-        obtained from <ulink url="ftp://rs.internic.net/domain/named.root" />.
-        For details, consult the "BIND 9 Administrator Reference Manual",
-        included in every source archive of BIND 9 distributed by ISC, in HTML
-        and PDF formats, also available at <ulink
-        url="ftp://ftp.isc.org/isc/bind9/cur/&bind-minor-version;/doc/arm/Bv9ARM.html">
-        BIND 9 Administrator Reference Manual</ulink>.
+        obtained from <ulink url="https://www.internic.net/domain/named.root"/>.
+        For details, consult the "BIND 9 Administrator Reference Manual".
       </para>
 
@@ -553 +561 @@
         You can see almost instantaneous results with the named caching
         lookups. Consult the <application>BIND</application> Administrator
-        Reference Manual located at
-        <ulink url="https://bind9.readthedocs.io/en/v9_16/"/>
-        for further configuration options.
+        Reference Manual (see below) for further configuration options.
       </para>
 
     </sect3>
 
+  </sect2>
+
+  <sect2>
+    <title>Administrator Reference Manual (ARM)</title>
+
+    <para>
+      The ARM documentation (do not confuse with the processor architecture)
+      is included in the source package. The documentation is in .rst
+      format which means, it can be converted in human readable formats
+      if <ulink url="https://www.sphinx-doc.org/">Sphinx</ulink> is
+      installed. As time of writing, sphinx is not included in
+      the BLFS book and therefore, the instructions above do not
+      install the docs.
+    </para>
+
+    <para>
+      When <application>BIND</application> is set up, especially when
+      to operate in a real live scenario, it is <emphasis>highly</emphasis>
+      recommended to consult the ARM documentation. ISC provides an
+      updated set of excellent documentation along with every release
+      so it can be easily be viewed and/or downloaded - so there is
+      no excuse to not read the docs. The formats ISC provides are PDF,
+      epub and html at <ulink url="https://downloads.isc.org/isc/bind9/&bind-version;/doc/arm/"/>.
+    </para>
   </sect2>