Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                
doc: Fix description about default behavior of recovery_target_timeline.
authorFujii Masao <fujii@postgresql.org>
Wed, 6 Jan 2021 02:58:23 +0000 (11:58 +0900)
committerFujii Masao <fujii@postgresql.org>
Wed, 6 Jan 2021 02:59:20 +0000 (11:59 +0900)
The default value of recovery_target_timeline was changed in v12,
but the description about the default behavior of that was not updated.

Back-patch to v12 where the default behavior of recovery_target_timeline
was changed.

Author: Benoit LobrĂ©au
Reviewed-by: Fujii Masao
Discussion: https://postgr.es/m/CAPE8EZ7c3aruEmM24GYkj8y8WmHKD1m9TtPtgCF0nQ3zw4LCkQ@mail.gmail.com

doc/src/sgml/backup.sgml

index bdc9026c62955f3944d8589b9de4789744075afb..120d58652fb73f018047abaada73f6cfeeaadc16 100644 (file)
@@ -1437,12 +1437,13 @@ restore_command = 'cp /mnt/server/archivedir/%f %p'
    </para>
 
    <para>
-    The default behavior of recovery is to recover along the same timeline
-    that was current when the base backup was taken.  If you wish to recover
-    into some child timeline (that is, you want to return to some state that
-    was itself generated after a recovery attempt), you need to specify the
-    target timeline ID in <xref linkend="guc-recovery-target-timeline"/>. You cannot recover into
-    timelines that branched off earlier than the base backup.
+    The default behavior of recovery is to recover to the latest timeline found
+    in the archive. If you wish to recover to the timeline that was current
+    when the base backup was taken or into a specific child timeline (that
+    is, you want to return to some state that was itself generated after a
+    recovery attempt), you need to specify <literal>current</literal> or the
+    target timeline ID in <xref linkend="guc-recovery-target-timeline"/>. You
+    cannot recover into timelines that branched off earlier than the base backup.
    </para>
   </sect2>