Fix indentation in docs
authorHeikki Linnakangas <[email protected]>
Fri, 16 Jan 2015 11:49:10 +0000 (13:49 +0200)
committerHeikki Linnakangas <[email protected]>
Fri, 16 Jan 2015 11:49:10 +0000 (13:49 +0200)
doc/src/sgml/ref/pg_rewind.sgml

index 9e1bca95591d1e1cc1c5da6921f58d6a0a0cef05..1e5a1349c9fff74e24137f143bc0606dacee727c 100644 (file)
@@ -41,45 +41,45 @@ PostgreSQL documentation
   <title>Description</title>
 
   <para>
-    <application>pg_rewind</> is a tool for synchronizing a PostgreSQL cluster
-    with another copy of the same cluster, after the clusters' timelines have
-    diverged. A typical scenario is to bring an old master server back online
-    after failover, as a standby that follows the new master.
+   <application>pg_rewind</> is a tool for synchronizing a PostgreSQL cluster
+   with another copy of the same cluster, after the clusters' timelines have
+   diverged. A typical scenario is to bring an old master server back online
+   after failover, as a standby that follows the new master.
   </para>
 
   <para>
-    The result is equivalent to replacing the target data directory with the
-    source one. All files are copied, including configuration files. The
-    advantage of <application>pg_rewind</> over taking a new base backup, or
-    tools like <application>rsync</>, is that <application>pg_rewind</> does
-    not require reading through all unchanged files in the cluster. That makes
-    it a lot faster when the database is large and only a small portion of it
-    differs between the clusters.
+   The result is equivalent to replacing the target data directory with the
+   source one. All files are copied, including configuration files. The
+   advantage of <application>pg_rewind</> over taking a new base backup, or
+   tools like <application>rsync</>, is that <application>pg_rewind</> does
+   not require reading through all unchanged files in the cluster. That makes
+   it a lot faster when the database is large and only a small portion of it
+   differs between the clusters.
   </para>
 
   <para>
-    <application>pg_rewind</> examines the timeline histories of the source
-    and target clusters to determine the point where they diverged, and
-    expects to find WAL in the target cluster's <filename>pg_xlog</> directory
-    reaching all the way back to the point of divergence. In the typical
-    failover scenario where the target cluster was shut down soon after the
-    divergence, that is not a problem, but if the target cluster had run for a
-    long time after the divergence, the old WAL files might not be present
-    anymore. In that case, they can be manually copied from the WAL archive to
-    the <filename>pg_xlog</> directory. Fetching missing files from a WAL
-    archive automatically is currently not supported.
+   <application>pg_rewind</> examines the timeline histories of the source
+   and target clusters to determine the point where they diverged, and
+   expects to find WAL in the target cluster's <filename>pg_xlog</> directory
+   reaching all the way back to the point of divergence. In the typical
+   failover scenario where the target cluster was shut down soon after the
+   divergence, that is not a problem, but if the target cluster had run for a
+   long time after the divergence, the old WAL files might not be present
+   anymore. In that case, they can be manually copied from the WAL archive to
+   the <filename>pg_xlog</> directory. Fetching missing files from a WAL
+   archive automatically is currently not supported.
   </para>
 
   <para>
-    When the target server is started up for the first time after running
-    <application>pg_rewind</>, it will go into recovery mode and replay all
-    WAL generated in the source server after the point of divergence.
-    If some of the WAL was no longer available in the source server when
-    <application>pg_rewind</> was run, and thereforce could not be copied by
-    <application>pg_rewind</> session, it needs to be made available when the
-    target server is started up. That can be done by creating a
-    <filename>recovery.conf</> file in the target data directory with a
-    suitable <varname>restore_command</>.
+   When the target server is started up for the first time after running
+   <application>pg_rewind</>, it will go into recovery mode and replay all
+   WAL generated in the source server after the point of divergence.
+   If some of the WAL was no longer available in the source server when
+   <application>pg_rewind</> was run, and thereforce could not be copied by
+   <application>pg_rewind</> session, it needs to be made available when the
+   target server is started up. That can be done by creating a
+   <filename>recovery.conf</> file in the target data directory with a
+   suitable <varname>restore_command</>.
   </para>
  </refsect1>
 
@@ -95,33 +95,33 @@ PostgreSQL documentation
       <term><option>-D</option></term>
       <term><option>--target-pgdata</option></term>
       <listitem>
-        <para>
-          This option specifies the target data directory that is synchronized
-          with the source. The target server must shut down cleanly before
-          running <application>pg_rewind</application>
-        </para>
+       <para>
+        This option specifies the target data directory that is synchronized
+        with the source. The target server must shut down cleanly before
+        running <application>pg_rewind</application>
+       </para>
       </listitem>
      </varlistentry>
 
      <varlistentry>
       <term><option>--source-pgdata</option></term>
       <listitem>
-        <para>
-          Specifies a source data directory to synchronize the target with.
-          When <option>--source-pgdata</> is used, the source server must be
-          cleanly shut down.
-        </para>
+       <para>
+        Specifies a source data directory to synchronize the target with.
+        When <option>--source-pgdata</> is used, the source server must be
+        cleanly shut down.
+       </para>
       </listitem>
      </varlistentry>
 
      <varlistentry>
       <term><option>--source-server</option></term>
       <listitem>
-        <para>
-          Specifies a libpq connection string to connect to the source
-          <productname>PostgreSQL</> server to synchronize the target with.
-          The server must be up and running, and must not be in recovery mode.
-        </para>
+       <para>
+        Specifies a libpq connection string to connect to the source
+        <productname>PostgreSQL</> server to synchronize the target with.
+        The server must be up and running, and must not be in recovery mode.
+       </para>
       </listitem>
      </varlistentry>
 
@@ -129,9 +129,9 @@ PostgreSQL documentation
       <term><option>-n</option></term>
       <term><option>--dry-run</option></term>
       <listitem>
-        <para>
-          Do everything except actually modifying the target directory.
-        </para>
+       <para>
+        Do everything except actually modifying the target directory.
+       </para>
       </listitem>
      </varlistentry>
 
@@ -187,9 +187,9 @@ PostgreSQL documentation
   <title>Environment</title>
 
   <para>
-    When <option>--source-server</> option is used,
-    <application>pg_rewind</application> also uses the environment variables
-    supported by <application>libpq</> (see <xref linkend="libpq-envars">).
+   When <option>--source-server</> option is used,
+   <application>pg_rewind</application> also uses the environment variables
+   supported by <application>libpq</> (see <xref linkend="libpq-envars">).
   </para>
  </refsect1>
 
@@ -197,41 +197,41 @@ PostgreSQL documentation
   <title>Theory of operation</title>
 
   <para>
-    The basic idea is to copy everything from the new cluster to the old
-    cluster, except for the blocks that we know to be the same.
+   The basic idea is to copy everything from the new cluster to the old
+   cluster, except for the blocks that we know to be the same.
   </para>
 
   <procedure>
-    <step>
-      <para>
-        Scan the WAL log of the old cluster, starting from the last checkpoint
-        before the point where the new cluster's timeline history forked off
-        from the old cluster. For each WAL record, make a note of the data
-        blocks that were touched. This yields a list of all the data blocks
-        that were changed in the old cluster, after the new cluster forked off.
-      </para>
-     </step>
-     <step>
-      <para>
-        Copy all those changed blocks from the new cluster to the old cluster.
-      </para>
-     </step>
-     <step>
-      <para>
-        Copy all other files like clog, conf files etc. from the new cluster
-        to old cluster. Everything except the relation files.
-      </para>
-     </step>
-     <step>
-      <para>
-        Apply the WAL from the new cluster, starting from the checkpoint
-        created at failover. (Strictly speaking, <application>pg_rewind</>
-        doesn't apply the WAL, it just creates a backup label file indicating
-        that when <productname>PostgreSQL</> is started, it will start replay
-        from that checkpoint and apply all the required WAL.)
-      </para>
-     </step>
-    </procedure>
+   <step>
+    <para>
+     Scan the WAL log of the old cluster, starting from the last checkpoint
+     before the point where the new cluster's timeline history forked off
+     from the old cluster. For each WAL record, make a note of the data
+     blocks that were touched. This yields a list of all the data blocks
+     that were changed in the old cluster, after the new cluster forked off.
+    </para>
+   </step>
+   <step>
+    <para>
+     Copy all those changed blocks from the new cluster to the old cluster.
+    </para>
+   </step>
+   <step>
+    <para>
+     Copy all other files like clog, conf files etc. from the new cluster
+     to old cluster. Everything except the relation files.
+    </para>
+   </step>
+   <step>
+    <para>
+     Apply the WAL from the new cluster, starting from the checkpoint
+     created at failover. (Strictly speaking, <application>pg_rewind</>
+     doesn't apply the WAL, it just creates a backup label file indicating
+     that when <productname>PostgreSQL</> is started, it will start replay
+     from that checkpoint and apply all the required WAL.)
+    </para>
+   </step>
+  </procedure>
  </refsect1>
 
  <refsect1>