pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedhigh-availability.sgml: misplaced sentence
2+ messages / 2 participants
[nested] [flat]
* high-availability.sgml: misplaced sentence
@ 2010-06-26 16:52 Erik Rijkers <er@xs4all.nl>
2010-06-27 00:43 ` Re: high-availability.sgml: misplaced sentence Robert Haas <robertmhaas@gmail.com>
0 siblings, 1 reply; 2+ messages in thread
From: Erik Rijkers @ 2010-06-26 16:52 UTC (permalink / raw)
To: pgsql-docs
The middle sentence in the 'Note:' doesn't make much sense there (maybe it does when you know
pg_standby). In any case it seems better placed outside it.
Erik Rijkers
Attachments:
high-availability.sgml.diff (application/octet-stream, 1.0K) download
--- doc/src/sgml/high-availability.sgml.orig 2010-06-26 18:21:33.000000000 +0200
+++ doc/src/sgml/high-availability.sgml 2010-06-26 18:22:36.000000000 +0200
@@ -658,15 +658,15 @@
command file <filename>recovery.conf</> in the standby's cluster data
directory, and turn on <varname>standby_mode</>. Set
<varname>restore_command</> to a simple command to copy files from
- the WAL archive.
+ the WAL archive. <varname>restore_command</> should return immediately
+ if the file does not exist; the server will retry the command again if
+ necessary.
</para>
<note>
<para>
Do not use pg_standby or similar tools with the built-in standby mode
- described here. <varname>restore_command</> should return immediately
- if the file does not exist; the server will retry the command again if
- necessary. See <xref linkend="log-shipping-alternative">
+ described here. See <xref linkend="log-shipping-alternative">
for using tools like pg_standby.
</para>
</note>
* Re: high-availability.sgml: misplaced sentence
2010-06-26 16:52 high-availability.sgml: misplaced sentence Erik Rijkers <er@xs4all.nl>
@ 2010-06-27 00:43 ` Robert Haas <robertmhaas@gmail.com>
0 siblings, 0 replies; 2+ messages in thread
From: Robert Haas @ 2010-06-27 00:43 UTC (permalink / raw)
To: Erik Rijkers <er@xs4all.nl>; +Cc: pgsql-docs
On Sat, Jun 26, 2010 at 12:52 PM, Erik Rijkers <er@xs4all.nl> wrote:
> The middle sentence in the 'Note:' doesn't make much sense there (maybe it does when you know
> pg_standby). In any case it seems better placed outside it.
I think the reason why that sentence is there is to explain WHY you
shouldn't try to use pg_standby with the built-in standby mode. I
agree that maybe the paragraph before the note could stand to be
fleshed out a bit - the phrase "a simple command" certainly might not
be totally clear to someone. But it's important for the note to
mention why pg_standby would not be suitable.
--
Robert Haas
EnterpriseDB: http://www.enterprisedb.com
The Enterprise Postgres Company
^ permalink raw reply [nested|flat] 2+ messages in thread
end of thread, other threads:[~2010-06-27 00:43 UTC | newest]
Thread overview: 2+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2010-06-26 16:52 high-availability.sgml: misplaced sentence Erik Rijkers <er@xs4all.nl>
2010-06-27 00:43 ` Robert Haas <robertmhaas@gmail.com>
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox