diff --git a/doc/src/sgml/protocol.sgml b/doc/src/sgml/protocol.sgml
index 34da8592c08..1a596cd0edf 100644
--- a/doc/src/sgml/protocol.sgml
+++ b/doc/src/sgml/protocol.sgml
@@ -1320,16 +1320,16 @@ the connection to be used for logical replication from that database.
psql "dbname=postgres replication=database" -c "IDENTIFY_SYSTEM;"
- However it is often more useful to use
- pg_receivexlog (for physical replication) or
- pg_recvlogical (for logical replication).
+ However, it is often more useful to use
+ (for physical replication) or
+ (for logical replication).
The commands accepted in walsender mode are:
- IDENTIFY_SYSTEM
+ IDENTIFY_SYSTEM
IDENTIFY_SYSTEM
@@ -1342,7 +1342,7 @@ The commands accepted in walsender mode are:
- systemid
+ systemid (text)
@@ -1355,11 +1355,11 @@ The commands accepted in walsender mode are:
- timeline
+ timeline (int4)
- Current TimelineID. Also useful to check that the standby is
+ Current timeline ID. Also useful to check that the standby is
consistent with the master.
@@ -1367,7 +1367,7 @@ The commands accepted in walsender mode are:
- xlogpos
+ xlogpos (text)
@@ -1379,11 +1379,11 @@ The commands accepted in walsender mode are:
- dbname
+ dbname (text)
- Database connected to or NULL.
+ Database connected to or null.
@@ -1394,7 +1394,7 @@ The commands accepted in walsender mode are:
- TIMELINE_HISTORY tli
+ TIMELINE_HISTORY tli
TIMELINE_HISTORY
@@ -1408,18 +1408,18 @@ The commands accepted in walsender mode are:
- filename
+ filename (text)
- Filename of the timeline history file, e.g 00000002.history>.
+ File name of the timeline history file, e.g., 00000002.history>.
- content
+ content (bytea)
@@ -1434,7 +1434,7 @@ The commands accepted in walsender mode are:
- CREATE_REPLICATION_SLOT slot_name> { PHYSICAL> [ RESERVE_WAL ] | LOGICAL> output_plugin> }
+ CREATE_REPLICATION_SLOT slot_name> { PHYSICAL> [ RESERVE_WAL> ] | LOGICAL> output_plugin> }
CREATE_REPLICATION_SLOT
@@ -1469,7 +1469,7 @@ The commands accepted in walsender mode are:
Specify that this physical replication reserves WAL>
- immediately; otherwise WAL> is only reserved upon
+ immediately. Otherwise, WAL> is only reserved upon
connection from a streaming replication client.
@@ -1479,7 +1479,7 @@ The commands accepted in walsender mode are:
- START_REPLICATION [SLOT slot_name>] [PHYSICAL] XXX/XXX> [TIMELINE tli>]
+ START_REPLICATION [ SLOT slot_name> ] [ PHYSICAL ] XXX/XXX> [ TIMELINE tli> ]
START_REPLICATION
@@ -1489,7 +1489,7 @@ The commands accepted in walsender mode are:
If TIMELINE option is specified,
streaming starts on timeline tli>;
otherwise, the server's current timeline is selected. The server can
- reply with an error, e.g. if the requested section of WAL has already
+ reply with an error, for example if the requested section of WAL has already
been recycled. On success, server responds with a CopyBothResponse
message, and then starts to stream WAL to the frontend.
@@ -1503,9 +1503,9 @@ The commands accepted in walsender mode are:
- If the client requests a timeline that's not the latest, but is part of
+ If the client requests a timeline that's not the latest but is part of
the history of the server, the server will stream all the WAL on that
- timeline starting from the requested startpoint, up to the point where
+ timeline starting from the requested start point up to the point where
the server switched to another timeline. If the client requests
streaming at exactly the end of an old timeline, the server responds
immediately with CommandComplete without entering COPY mode.
@@ -1516,8 +1516,8 @@ The commands accepted in walsender mode are:
the server will end streaming by exiting the COPY mode. When the client
acknowledges this by also exiting COPY mode, the server sends a result
set with one row and two columns, indicating the next timeline in this
- server's history. The first column is the next timeline's ID, and the
- second column is the XLOG position where the switch happened. Usually,
+ server's history. The first column is the next timeline's ID (type int8), and the
+ second column is the WAL position where the switch happened (type text). Usually,
the switch position is the end of the WAL that was streamed, but there
are corner cases where the server can send some WAL from the old
timeline that it has not itself replayed before promoting. Finally, the
@@ -1809,12 +1809,12 @@ The commands accepted in walsender mode are:
- START_REPLICATION SLOT slot_name> LOGICAL XXX/XXX> [ ( option_name [option_value] [, ... ] ) ]
+ START_REPLICATION SLOT slot_name> LOGICAL XXX/XXX> [ ( option_name [ option_value ] [, ...] ) ]
Instructs server to start streaming WAL for logical replication, starting
at WAL position XXX/XXX>. The server can
- reply with an error, e.g. if the requested section of WAL has already
+ reply with an error, for example if the requested section of WAL has already
been recycled. On success, server responds with a CopyBothResponse
message, and then starts to stream WAL to the frontend.
@@ -1871,7 +1871,7 @@ The commands accepted in walsender mode are:
- DROP_REPLICATION_SLOT slot_name>
+ DROP_REPLICATION_SLOT slot_name>
DROP_REPLICATION_SLOT
@@ -1893,7 +1893,7 @@ The commands accepted in walsender mode are:
- BASE_BACKUP [LABEL 'label'] [PROGRESS] [FAST] [WAL] [NOWAIT] [MAX_RATE rate] [TABLESPACE_MAP]
+ BASE_BACKUP [ LABEL 'label' ] [ PROGRESS ] [ FAST ] [ WAL ] [ NOWAIT ] [ MAX_RATE rate ] [ TABLESPACE_MAP ]
BASE_BACKUP
@@ -1923,10 +1923,10 @@ The commands accepted in walsender mode are:
send back an approximate size in the header of each tablespace, which
can be used to calculate how far along the stream is done. This is
calculated by enumerating all the file sizes once before the transfer
- is even started, and may as such have a negative impact on the
- performance - in particular it may take longer before the first data
+ is even started, and might as such have a negative impact on the
+ performance. In particular, it might take longer before the first data
is streamed. Since the database files can change during the backup,
- the size is only approximate and may both grow and shrink between
+ the size is only approximate and might both grow and shrink between
the time of approximation and the sending of the actual files.
@@ -1957,7 +1957,7 @@ The commands accepted in walsender mode are:
NOWAIT
- By default, the backup will wait until the last required xlog
+ By default, the backup will wait until the last required WAL
segment has been archived, or emit a warning if log archiving is
not enabled. Specifying NOWAIT disables both
the waiting and the warning, leaving the client responsible for
@@ -2010,29 +2010,29 @@ The commands accepted in walsender mode are:
The fields in this row are:
- spcoid
+ spcoid (oid)
- The oid of the tablespace, or NULL> if it's the base
+ The OID of the tablespace, or null if it's the base
directory.
- spclocation
+ spclocation (text)
- The full path of the tablespace directory, or NULL>
+ The full path of the tablespace directory, or null
if it's the base directory.
- size
+ size (int8)
The approximate size of the tablespace, if progress report has
- been requested; otherwise it's NULL>.
+ been requested; otherwise it's null.
@@ -2040,7 +2040,7 @@ The commands accepted in walsender mode are:
After the second regular result set, one or more CopyResponse results
- will be sent, one for PGDATA and one for each additional tablespace other
+ will be sent, one for the main data directory and one for each additional tablespace other
than pg_default> and pg_global>. The data in
the CopyResponse results will be a tar format (following the
ustar interchange format> specified in the POSIX 1003.1-2008
@@ -2093,14 +2093,9 @@ The commands accepted in walsender mode are:
- Owner, group and file mode are set if the underlying file system on
+ Owner, group, and file mode are set if the underlying file system on
the server supports it.
-
- Once all tablespaces have been sent, a final regular result set will
- be sent. This result set contains the end position of the
- backup, given in XLogRecPtr format as a single column in a single row.
-