Changeset 002d2dc for server/major/bind.xml

Timestamp:

08/18/2022 07:48:23 PM (21 months ago)

Author:

Thomas Trepl (Moody) <thomas@…>

Branches:

11.2, 11.3, 12.0, 12.1, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, lazarus, lxqt, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, trunk, xry111/llvm18, xry111/soup3, xry111/xf86-video-removal

Children:

f0505850

Parents:

cae94da

Message:

Update bind- and bind-utils-9.18.6

File:

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

server/major/bind.xml

@@ -9 +9 @@
   <!ENTITY bind-md5sum        "d30ac638f74a9aa5da2f54c4f16ccd81">
   <!ENTITY bind-size          "4.9 MB">
-  <!ENTITY bind-buildsize     "137 MB (26 MB installed)">
-  <!ENTITY bind-time          "0.4 SBU (with parallelism=4; add 30+ minutes, somewhat processor independent, to run the complete test suite)">
+  <!ENTITY bind-buildsize     "81 MB (13 MB installed)"><!-- differs much from prev maybe because of docs? -->
+  <!ENTITY bind-time          "0.4 SBU (with parallelism=4; about 7 SBU somewhat processor independent, to run the complete test suite)">
 ]>
 
@@ -104 +104 @@
       <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>
@@ -122 +122 @@
     </para>
 
+<!-- docs are now all sphinx based
     <bridgehead renderas="sect4">Optional (to rebuild the documentation)</bridgehead>
     <para role="optional">
@@ -128 +129 @@
       <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>)
     </para>
+-->
 
     <para condition="html" role="usernotes">User Notes:
@@ -179 +181 @@
       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>
@@ -201 +203 @@
 <!-- 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 644 /usr/share/doc/bind-&bind-version;/{arm,dnssec-guide} &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>
 
@@ -474 +482 @@
         <command>dig</command> utility. A current copy of root.hints can be
         obtained from <ulink url="https://www.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,
-        epub and PDF formats, also available at <ulink
-        url="https://downloads.isc.org/isc/bind9/&bind-version;/doc/arm/html/">
-        BIND 9 Administrator Reference Manual</ulink>.
+        For details, consult the "BIND 9 Administrator Reference Manual".
       </para>
 
@@ -560 +564 @@
         You can see almost instantaneous results with the named caching
         lookups. Consult the <application>BIND</application> Administrator
-        Reference Manual located at
-        <ulink url="https://downloads.isc.org/isc/bind9/&bind-version;/doc/arm/html/"/>
-        for further configuration options.
+        Reference Manual (see below) for further configuration options.
       </para>
 
@@ -569 +571 @@
   </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="http://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>
+  
   <sect2 role="content">
     <title>Contents</title>