Received: from maia.hub.org (maia-2.hub.org [200.46.204.251])
	by mail.postgresql.org (Postfix) with ESMTP id 7921FB5DBCC
	for <pgsql-docs-postgresql.org@mail.postgresql.org>;
	Tue, 19 Jul 2011 07:30:07 -0300 (ADT)
Received: from mail.postgresql.org ([200.46.204.86])
	by maia.hub.org (mx1.hub.org [200.46.204.251]) (amavisd-maia,
	port 10024) with ESMTP id 30767-06 for
	<pgsql-docs-postgresql.org@mail.postgresql.org>;
	Tue, 19 Jul 2011 10:30:01 +0000 (UTC)
X-Greylist: from auto-whitelisted by SQLgrey-1.7.6
Received: from smtp-vbr15.xs4all.nl (smtp-vbr15.xs4all.nl [194.109.24.35])
	by mail.postgresql.org (Postfix) with ESMTP id 9EDEAB5DBC8
	for <pgsql-docs@postgresql.org>; Tue, 19 Jul 2011 07:30:00 -0300 (ADT)
Received: from webmail.xs4all.nl (dovemail8.xs4all.nl [194.109.26.10])
	by smtp-vbr15.xs4all.nl (8.13.8/8.13.8) with ESMTP id p6JATxKV010539
	for <pgsql-docs@postgresql.org>; Tue, 19 Jul 2011 12:29:59 +0200 (CEST)
	(envelope-from er@xs4all.nl)
Received: from 156.83.1.40 (SquirrelMail authenticated user er)
	by webmail.xs4all.nl with HTTP; Tue, 19 Jul 2011 12:29:59 +0200
Message-ID: <2ca7db058d1f4a8af065b0b47ed1f3d7.squirrel@webmail.xs4all.nl>
Date: Tue, 19 Jul 2011 12:29:59 +0200
Subject: pdf-visible links into config.gsml from high-availability.sgml
From: "Erik Rijkers" <er@xs4all.nl>
To: pgsql-docs@postgresql.org
User-Agent: SquirrelMail/1.4.18
MIME-Version: 1.0
Content-Type: multipart/mixed;boundary="----=_20110719122959_60163"
X-Virus-Scanned: by XS4ALL Virus Scanner
X-Virus-Scanned: Maia Mailguard 1.0.1
X-Spam-Status: No, hits=-3.035 tagged_above=-5 required=5 tests=BAYES_00=-1.9,
	RCVD_IN_DNSWL_NONE=-0.0001, RP_MATCHES_RCVD=-1.135
X-Spam-Level: 
X-Archive-Number: 201107/15
X-Sequence-Number: 6882

------=_20110719122959_60163
Content-Type: text/plain; charset="iso-8859-1"
Content-Transfer-Encoding: 8bit


Reading about synchronous replication in a paper copy of .pdf high-availability.sgml pages, I
missed the information in config.sgml. There /is/ a (single) link, but it's not visible in the
pdf; even with the pdf on-screen it is only noticable only with MouseOver.

I think it would be good to make two explicit, visible links, as attached, to connect the two main
places with sync-repl information.  Then there will be a clear "See Section ..." reference.

(against today's REL9_1_STABLE)

thanks,

Erik Rijkers
------=_20110719122959_60163
Content-Type: text/x-patch; name="high-availability.sgml.diff"
Content-Transfer-Encoding: 8bit
Content-Disposition: attachment; filename="high-availability.sgml.diff"

--- doc/src/sgml/high-availability.sgml.orig	2011-07-19 11:23:06.000000000 +0200
+++ doc/src/sgml/high-availability.sgml	2011-07-19 11:25:38.000000000 +0200
@@ -935,7 +935,9 @@
     <xref linkend="guc-synchronous-standby-names"> must be set to
     a non-empty value.  <varname>synchronous_commit</> must also be set to
     <literal>on</>, but since this is the default value, typically no change is
-    required.  This configuration will cause each commit to wait for
+    required. (See <xref linkend="runtime-config-wal-settings"> and 
+    <xref linkend="runtime-config-replication-master">.)
+    This configuration will cause each commit to wait for
     confirmation that the standby has written the commit record to durable
     storage, even if that takes a very long time.
     <varname>synchronous_commit</> can be set by individual
------=_20110719122959_60163--