Change indentation in doc/arm/dnssec.xml

This commit does not change anything significant, it just makes
the file more readable in preparation for upcoming changes related
to the `dnssec-policy` configuration option.

doc/arm/dnssec.xml

@@ -15,10 +15,13 @@
   <section><info><title>Converting from insecure to secure</title></info>
 
   </section>
-  <para>Changing a zone from insecure to secure can be done in two
+  <para>
+    Changing a zone from insecure to secure can be done in two
     ways: using a dynamic DNS update, or the
-  <command>auto-dnssec</command> zone option.</para>
+    <command>auto-dnssec</command> zone option.
-  <para>For either method, you need to configure
+  </para>
+  <para>
+    For either method, you need to configure
     <command>named</command> so that it can see the
     <filename>K*</filename> files which contain the public and private
     parts of the keys that will be used to sign the zone. These files
@@ -33,12 +36,15 @@
 		file "dynamic/example.net/example.net";
 		key-directory "dynamic/example.net";
 	};
-</programlisting>
+  </programlisting>
-  <para>If one KSK and one ZSK DNSKEY key have been generated, this
+  <para>
+    If one KSK and one ZSK DNSKEY key have been generated, this
     configuration will cause all records in the zone to be signed
     with the ZSK, and the DNSKEY RRset to be signed with the KSK as
     well. An NSEC chain will be generated as part of the initial
-  signing process.</para>
+    signing process.
+  </para>
+
   <section><info><title>Dynamic DNS update method</title></info>
 
   </section>
@@ -50,16 +56,20 @@
 	&gt; update add example.net DNSKEY 257 3 7 AwEAAd/7odU/64o2LGsifbLtQmtO8dFDtTAZXSX2+X3e/UNlq9IHq3Y0 XtC0Iuawl/qkaKVxXe2lo8Ct+dM6UehyCqk=
 	&gt; send
 </screen>
-  <para>While the update request will complete almost immediately,
+  <para>
+    While the update request will complete almost immediately,
     the zone will not be completely signed until
     <command>named</command> has had time to walk the zone and
     generate the NSEC and RRSIG records. The NSEC record at the apex
     will be added last, to signal that there is a complete NSEC
-  chain.</para>
+    chain.
-  <para>If you wish to sign using NSEC3 instead of NSEC, you should
+  </para>
+  <para>
+    If you wish to sign using NSEC3 instead of NSEC, you should
     add an NSEC3PARAM record to the initial update request. If you
     wish the NSEC3 chain to have the OPTOUT bit set, set it in the
-  flags field of the NSEC3PARAM record.</para>
+    flags field of the NSEC3PARAM record.
+  </para>
   <screen>
 	% nsupdate
 	&gt; ttl 3600
@@ -68,29 +78,37 @@
 	&gt; update add example.net NSEC3PARAM 1 1 100 1234567890
 	&gt; send
 </screen>
-  <para>Again, this update request will complete almost
+  <para>
+    Again, this update request will complete almost
     immediately; however, the record won't show up until
     <command>named</command> has had a chance to build/remove the
     relevant chain. A private type record will be created to record
     the state of the operation (see below for more details), and will
-  be removed once the operation completes.</para>
+    be removed once the operation completes.
-  <para>While the initial signing and NSEC/NSEC3 chain generation
+  </para>
-  is happening, other updates are possible as well.</para>
+  <para>
+    While the initial signing and NSEC/NSEC3 chain generation
+    is happening, other updates are possible as well.
+  </para>
+
   <section><info><title>Fully automatic zone signing</title></info>
 
   </section>
-  <para>To enable automatic signing, add the
+  <para>
+    To enable automatic signing, add the
     <command>auto-dnssec</command> option to the zone statement in
     <filename>named.conf</filename>.
     <command>auto-dnssec</command> has two possible arguments:
     <constant>allow</constant> or
-  <constant>maintain</constant>.</para>
+    <constant>maintain</constant>.
-  <para>With
+  </para>
-  <command>auto-dnssec allow</command>,
+  <para>
+    With <command>auto-dnssec allow</command>,
     <command>named</command> can search the key directory for keys
     matching the zone, insert them into the zone, and use them to
     sign the zone. It will do so only when it receives an
-  <command>rndc sign &lt;zonename&gt;</command>.</para>
+    <command>rndc sign &lt;zonename&gt;</command>.
+  </para>
   <para>
     <!-- TODO: this is repeated in the ARM -->
     <command>auto-dnssec maintain</command> includes the above
@@ -133,25 +151,32 @@
     the zone is signed and the NSEC3 chain is completed, the NSEC3PARAM
     record will appear in the zone.
   </para>
-  <para>Using the
+  <para>
+    Using the
     <command>auto-dnssec</command> option requires the zone to be
     configured to allow dynamic updates, by adding an
     <command>allow-update</command> or
     <command>update-policy</command> statement to the zone
     configuration. If this has not been done, the configuration will
-  fail.</para>
+    fail.
+  </para>
+
   <section><info><title>Private-type records</title></info>
 
   </section>
-  <para>The state of the signing process is signaled by
+  <para>
+    The state of the signing process is signaled by
     private-type records (with a default type value of 65534). When
     signing is complete, these records will have a nonzero value for
     the final octet (for those records which have a nonzero initial
-  octet).</para>
+    octet).
-  <para>The private type record format: If the first octet is
+  </para>
+  <para>
+    The private type record format: If the first octet is
     non-zero then the record indicates that the zone needs to be
     signed with the key matching the record, or that all signatures
-  that match the record should be removed.</para>
+    that match the record should be removed.
+  </para>
   <para>
     <literallayout>
 <!-- TODO: how to format this? -->
@@ -161,14 +186,18 @@
   complete flag (octet 5)
 </literallayout>
   </para>
-  <para>Only records flagged as "complete" can be removed via
+  <para>
+    Only records flagged as "complete" can be removed via
     dynamic update. Attempts to remove other private type records
-  will be silently ignored.</para>
+    will be silently ignored.
-  <para>If the first octet is zero (this is a reserved algorithm
+  </para>
+  <para>
+    If the first octet is zero (this is a reserved algorithm
     number that should never appear in a DNSKEY record) then the
     record indicates changes to the NSEC3 chains are in progress. The
     rest of the record contains an NSEC3PARAM record. The flag field
-  tells what operation to perform based on the flag bits.</para>
+    tells what operation to perform based on the flag bits.
+  </para>
   <para>
     <literallayout>
 <!-- TODO: how to format this? -->
@@ -181,36 +210,49 @@
   <section><info><title>DNSKEY rollovers</title></info>
 
   </section>
-  <para>As with insecure-to-secure conversions, rolling DNSSEC
+  <para>
+    As with insecure-to-secure conversions, rolling DNSSEC
     keys can be done in two ways: using a dynamic DNS update, or the
-  <command>auto-dnssec</command> zone option.</para>
+    <command>auto-dnssec</command> zone option.
+  </para>
+
   <section><info><title>Dynamic DNS update method</title></info>
 
   </section>
-  <para> To perform key rollovers via dynamic update, you need to add
+  <para>
+    To perform key rollovers via dynamic update, you need to add
     the <filename>K*</filename> files for the new keys so that
     <command>named</command> can find them. You can then add the new
     DNSKEY RRs via dynamic update.
     <command>named</command> will then cause the zone to be signed
     with the new keys. When the signing is complete the private type
     records will be updated so that the last octet is non
-  zero.</para>
+    zero.
-  <para>If this is for a KSK you need to inform the parent and any
+  </para>
-  trust anchor repositories of the new KSK.</para>
+  <para>
-  <para>You should then wait for the maximum TTL in the zone before
+    If this is for a KSK you need to inform the parent and any
+    trust anchor repositories of the new KSK.
+  </para>
+  <para>
+    You should then wait for the maximum TTL in the zone before
     removing the old DNSKEY. If it is a KSK that is being updated,
     you also need to wait for the DS RRset in the parent to be
     updated and its TTL to expire. This ensures that all clients will
     be able to verify at least one signature when you remove the old
-  DNSKEY.</para>
+    DNSKEY.
-  <para>The old DNSKEY can be removed via UPDATE. Take care to
+  </para>
+  <para>
+    The old DNSKEY can be removed via UPDATE. Take care to
     specify the correct key.
     <command>named</command> will clean out any signatures generated
-  by the old key after the update completes.</para>
+    by the old key after the update completes.
+  </para>
+
   <section><info><title>Automatic key rollovers</title></info>
 
   </section>
-  <para>When a new key reaches its activation date (as set by
+  <para>
+    When a new key reaches its activation date (as set by
     <command>dnssec-keygen</command> or <command>dnssec-settime</command>),
     if the <command>auto-dnssec</command> zone option is set to
     <constant>maintain</constant>, <command>named</command> will
@@ -222,34 +264,46 @@
     old key being replaced with signatures from the new key as their
     signature validity periods expire.  By default, this rollover
     completes in 30 days, after which it will be safe to remove the
-  old key from the DNSKEY RRset.</para>
+    old key from the DNSKEY RRset.
+  </para>
+
   <section><info><title>NSEC3PARAM rollovers via UPDATE</title></info>
 
   </section>
-  <para>Add the new NSEC3PARAM record via dynamic update. When the
+  <para>
+    Add the new NSEC3PARAM record via dynamic update. When the
     new NSEC3 chain has been generated, the NSEC3PARAM flag field
     will be zero. At this point you can remove the old NSEC3PARAM
     record. The old chain will be removed after the update request
-  completes.</para>
+    completes.
+  </para>
+
   <section><info><title>Converting from NSEC to NSEC3</title></info>
 
   </section>
-  <para>To do this, you just need to add an NSEC3PARAM record. When
+  <para>
+    To do this, you just need to add an NSEC3PARAM record. When
     the conversion is complete, the NSEC chain will have been removed
     and the NSEC3PARAM record will have a zero flag field. The NSEC3
     chain will be generated before the NSEC chain is
-  destroyed.</para>
+    destroyed.
+  </para>
+
   <section><info><title>Converting from NSEC3 to NSEC</title></info>
 
   </section>
-  <para>To do this, use <command>nsupdate</command> to
+  <para>
+    To do this, use <command>nsupdate</command> to
     remove all NSEC3PARAM records with a zero flag
     field. The NSEC chain will be generated before the NSEC3 chain is
-  removed.</para>
+    removed.
+  </para>
+
   <section><info><title>Converting from secure to insecure</title></info>
 
   </section>
-  <para>To convert a signed zone to unsigned using dynamic DNS,
+  <para>
+    To convert a signed zone to unsigned using dynamic DNS,
     delete all the DNSKEY records from the zone apex using
     <command>nsupdate</command>. All signatures, NSEC or NSEC3 chains,
     and associated NSEC3PARAM records will be removed automatically.
@@ -262,14 +316,18 @@
     zone statement is used, it should be removed or changed to
     <command>allow</command> instead (or it will re-sign).
   </para>
+
   <section><info><title>Periodic re-signing</title></info>
 
   </section>
-  <para>In any secure zone which supports dynamic updates, <command>named</command>
+  <para>
+    In any secure zone which supports dynamic updates, <command>named</command>
     will periodically re-sign RRsets which have not been re-signed as
     a result of some update action. The signature lifetimes will be
     adjusted so as to spread the re-sign load over time rather than
-  all at once.</para>
+    all at once.
+  </para>
+
   <section><info><title>NSEC3 and OPTOUT</title></info>
 
   </section>
@@ -282,5 +340,6 @@
     <command>named</command> does not support changing the OPTOUT
     state of an individual NSEC3 record, the entire chain needs to be
     changed if the OPTOUT state of an individual NSEC3 needs to be
-  changed.</para>
+    changed.
+  </para>
 </section>