]> git.ipfire.org Git - thirdparty/bind9.git/commitdiff
Fix various typos in the documentation
authorOndřej Surý <ondrej@isc.org>
Wed, 16 Dec 2020 09:24:01 +0000 (10:24 +0100)
committerOndřej Surý <ondrej@isc.org>
Tue, 29 Jun 2021 18:39:21 +0000 (20:39 +0200)
Generally, the issues fixed here are missing articles, wrong articles
and double articles.  We especially like "the the".

(cherry picked from commit 4ab9bb63ee100af49705a66306f26994dda3a53b)

doc/arm/advanced.rst
doc/arm/catz.rst
doc/arm/dlz.rst
doc/arm/dnssec.rst
doc/arm/general.rst
doc/arm/introduction.rst
doc/arm/logging-categories.rst
doc/arm/pkcs11.rst
doc/arm/requirements.rst
doc/arm/security.rst

index 9c5f6aff5797a35a5bc95f8452ac2860748a8dda..134025afd7096cf3745f7b684256ced54e62ee06 100644 (file)
@@ -72,7 +72,7 @@ All changes made to a zone using dynamic update are stored in the zone's
 journal file. This file is automatically created by the server when the
 first dynamic update takes place. The name of the journal file is formed
 by appending the extension ``.jnl`` to the name of the corresponding
-zone file, unless specifically overridden. The journal file is in a
+zone file unless specifically overridden. The journal file is in a
 binary format and should not be edited manually.
 
 The server also occasionally writes ("dumps") the complete contents
@@ -612,7 +612,7 @@ recommended that zone keys use a cryptographic algorithm designated as
 RSASHA256 and ECDSAP256SHA256; ECDSAP256SHA256 is recommended for
 current and future deployments.
 
-The following command generates a ECDSAP256SHA256 key for the
+The following command generates an ECDSAP256SHA256 key for the
 ``child.example`` zone:
 
 ``dnssec-keygen -a ECDSAP256SHA256 -n ZONE child.example.``
@@ -834,7 +834,7 @@ Address-to-Name Lookups Using Nibble Format
 
 When looking up an address in nibble format, the address components are
 simply reversed, just as in IPv4, and ``ip6.arpa.`` is appended to the
-resulting name. For example, the following would provide reverse name
+resulting name. For example, the following commands produce a reverse name
 lookup for a host with address ``2001:db8::1``:
 
 ::
index cd3ee30adf6d46da7de96fadcf138341b1f7f2fd..a2f855e18ec7bce734fe3cd1f8be4d872a68567f 100644 (file)
@@ -53,7 +53,7 @@ policy zone is configured as a normal zone and also listed in a
 
 To use the catalog zone feature to serve a new member zone:
 
--  Set up the the member zone to be served on the primary as normal. This
+-  Set up the member zone to be served on the primary as normal. This
    can be done by editing ``named.conf`` or by running
    ``rndc addzone``.
 
@@ -118,19 +118,18 @@ specified in any order.
    member zone name.
 
 ``zone-directory``
-   This option causes local copies of member zones'
-   zone files to be stored in
-   the specified directory, if ``in-memory`` is not set to ``yes``. The default is to store zone files in the
-   server's working directory. A non-absolute pathname in
-   ``zone-directory`` is assumed to be relative to the working directory.
+   This option causes local copies of member zones' zone files to be
+   stored in the specified directory, if ``in-memory`` is not set to
+   ``yes``. The default is to store zone files in the server's working
+   directory. A non-absolute pathname in ``zone-directory`` is assumed
+   to be relative to the working directory.
 
 ``min-update-interval``
-   This option sets the minimum interval between
-   processing of updates to catalog zones, in seconds. If an update to a
-   catalog zone (for example, via IXFR) happens less than
-   ``min-update-interval`` seconds after the most recent update, the
-   changes are not carried out until this interval has elapsed. The
-   default is 5 seconds.
+   This option sets the minimum interval between updates to catalog
+   zones, in seconds. If an update to a catalog zone (for example, via
+   IXFR) happens less than ``min-update-interval`` seconds after the
+   most recent update, the changes are not carried out until this
+   interval has elapsed. The default is 5 seconds.
 
 Catalog zones are defined on a per-view basis. Configuring a non-empty
 ``catalog-zones`` statement in a view automatically turns on
index c1c8da1df8c84de35c9145081a693f2ef11612ce..1992a3565377a1ad588abbca0989797a63bf201d 100644 (file)
@@ -77,13 +77,13 @@ backend storage of redirection rules:
 ::
 
        dlz other {
-       database "dlopen driver.so args";
-       search no;
+              database "dlopen driver.so args";
+              search no;
        };
 
        zone "." {
-       type redirect;
-       dlz other;
+              type redirect;
+              dlz other;
        };
 
 
@@ -99,7 +99,7 @@ module as an argument in the ``dlz`` statement:
 ::
 
        dlz other {
-       database "dlopen driver.so example.nil";
+              database "dlopen driver.so example.nil";
        };
 
 
index 2e1c178afe17acfd9bc6ddda73292fedb8faa31e..b2f2f2e657a09c03ed9f250bc390b7af10c12f41 100644 (file)
@@ -194,7 +194,7 @@ option.
 Dynamic DNS Update Method
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-To perform key rollovers via dynamic update, the ``K*``
+To perform key rollovers via dynamic update, the ``K*``
 files for the new keys must be added so that ``named`` can find them.
 The new DNSKEY RRs can then be added via dynamic update. ``named`` then causes the
 zone to be signed with the new keys; when the signing is complete, the
index a15fb30b62fdeda9374b1988f68b2abfa9ec7a5c..225576be7ae7959ff1538cca21b6d0a3a0722caf 100644 (file)
@@ -175,7 +175,7 @@ Clarification.* January 2006.
 
 :rfc:`4398` - S. Josefsson. *Storing Certificates in the Domain Name System (DNS).* March 2006.
 
-:rfc:`4470` - S. Weiler and J. Ihren. *Minimally Covering NSEC Records and
+:rfc:`4470` - S. Weiler and J. Ihren. *Minimally covering NSEC Records and
 DNSSEC On-line Signing.* April 2006. [5]
 
 :rfc:`4509` - W. Hardaker. *Use of SHA-256 in DNSSEC Delegation Signer
@@ -542,7 +542,7 @@ retrieve unknown keys.
 [4] Compliance is with loading and serving of A6 records only. A6 records were moved
 to the experimental category by :rfc:`3363`.
 
-[5] Minimally covering NSEC records are accepted but not generated.
+[5] Minimally Covering NSEC records are accepted but not generated.
 
 [6] BIND 9 interoperates with correctly designed experiments.
 
index 3020ad15ce66a3eef42bdae6867cf28d8e98020c..ea105d3bb595c9270b2b845134d3dfbe44011d54 100644 (file)
@@ -218,13 +218,13 @@ zone expires and no longer responds to queries.
 Stealth Servers
 ^^^^^^^^^^^^^^^
 
-Usually, all of the zone's authoritative servers are listed in NS records
-in the parent zone. These NS records constitute a *delegation* of the
-zone from the parent. The authoritative servers are also listed in the
-zone file itself, at the *top level* or *apex* of the zone.
-Servers that are not in the parent's
-NS delegation can be listed in the zone's top-level NS records, but servers that are not present at the zone's top level
-cannot be listed in the parent's delegation.
+Usually, all of the zone's authoritative servers are listed in NS
+records in the parent zone. These NS records constitute a *delegation*
+of the zone from the parent. The authoritative servers are also listed
+in the zone file itself, at the *top level* or *apex* of the zone.
+Servers that are not in the parent's NS delegation can be listed in the
+zone's top-level NS records, but servers that are not present at the
+zone's top level cannot be listed in the parent's delegation.
 
 A *stealth server* is a server that is authoritative for a zone but is
 not listed in that zone's NS records. Stealth servers can be used for
index 12aac739f0f951121d3a08b630af323fbd9de416..41f669c17dd6f5ce2c61ad74594b4a5a6683b4ed 100644 (file)
@@ -43,7 +43,7 @@
     Note: eventually ``named`` will have to stop treating such timeouts as due to :rfc:`1034` non-compliance and start treating it as plain packet loss. Falsely classifying packet loss as due to :rfc:`1034` non-compliance impacts DNSSEC validation, which requires EDNS for the DNSSEC records to be returned.
 
 ``general``
-    Catch-all for many things that still are not classified into categories.
+    A catch-all for many things that still are not classified into categories.
 
 ``lame-servers``
     Misconfigurations in remote servers, discovered by BIND 9 when trying to query those servers during resolution.
@@ -58,7 +58,7 @@
     NSID options received from upstream servers.
 
 ``queries``
-    Location where queries should be logged.
+    A location where queries should be logged.
     
     At startup, specifying the category ``queries`` also enables query logging unless the ``querylog`` option has been specified.
     
index f112d3e67d4b1aa808734175f8c46d21bd4fd064..8fcba0ea42d3a40669f7d616fd786bd1a67d6ce7 100644 (file)
@@ -79,7 +79,7 @@ SoftHSMv2, the latest development version of SoftHSM, is available from
 https://github.com/opendnssec/SoftHSMv2. It is a software library
 developed by the OpenDNSSEC project (https://www.opendnssec.org) which
 provides a PKCS#11 interface to a virtual HSM, implemented in the form
-of a SQLite3 database on the local filesystem. It provides less security
+of an SQLite3 database on the local filesystem. It provides less security
 than a true HSM, but it allows users to experiment with native PKCS#11
 when an HSM is not available. SoftHSMv2 can be configured to use either
 OpenSSL or the Botan library to perform cryptographic functions, but
index f2dbf62c35116c2fce58571198b0b0b568b9d253..826c372db8a16448811b9c0acf8d5d53099f6fef 100644 (file)
@@ -60,7 +60,7 @@ Name Server-Intensive Environment Issues
 
 For name server-intensive environments, there are two
 configurations that may be used. The first is one where clients and any
-second-level internal name servers query a main name server, which has
+second-level internal name servers query the main name server, which has
 enough memory to build a large cache; this approach minimizes the
 bandwidth used by external name lookups. The second alternative is to
 set up second-level internal name servers to make queries independently.
index bc0592b0f549a949e13845d8a284d911ce97fb9e..f7c8bd3d5961e433e1e0cf9fc64c13fafec23da8 100644 (file)
@@ -138,7 +138,7 @@ signed with a particular key, use:
    allow-query { !{ !10/8; any; }; key example; };
 
 Within the nested ACL, any address that is *not* in the 10/8 network
-prefix is rejected, which terminates processing of the ACL.
+prefix is rejected, which terminates the processing of the ACL.
 Any address that *is* in the 10/8 network prefix is accepted, but
 this causes a negative match of the nested ACL, so the containing ACL
 continues processing. The query is accepted if it is signed by