diff --git a/doc/src/sgml/backup.sgml b/doc/src/sgml/backup.sgml index be05a33205..8cb24d6ae5 100644 --- a/doc/src/sgml/backup.sgml +++ b/doc/src/sgml/backup.sgml @@ -1309,7 +1309,16 @@ restore_command = 'cp /mnt/server/archivedir/%f %p' a new timeline is created to identify the series of WAL records generated after that recovery. The timeline ID number is part of WAL segment file names so a new timeline does - not overwrite the WAL data generated by previous timelines. It is + not overwrite the WAL data generated by previous timelines. + For example, in the WAL file name + 0000000100001234000055CD, the leading + 00000001 is the timeline ID in hexadecimal. (Note that + in other contexts, such as server log messages, timeline IDs are + usually printed in decimal.) + + + + It is in fact possible to archive many different timelines. While that might seem like a useless feature, it's often a lifesaver. Consider the situation where you aren't quite sure what point-in-time to recover to, diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml index e5c41cc6c6..481f93cea1 100644 --- a/doc/src/sgml/config.sgml +++ b/doc/src/sgml/config.sgml @@ -4113,6 +4113,14 @@ restore_command = 'copy "C:\\server\\archivedir\\%f" "%p"' # Windows a standby server. latest is the default. + + To specify a timeline ID in hexadecimal (for example, if extracted + from a WAL file name or history file), prefix it with a + 0x. For instance, if the WAL file name is + 00000011000000A10000004F, then the timeline ID is + 0x11 (or 17 decimal). + + You usually only need to set this parameter in complex re-recovery situations, where you need to return to