From: Bruce Momjian <bruce@momjian.us>
Date: Thu, 23 Jun 2011 23:57:42 +0000 (-0400)
Subject: In pg_upgrade docs, clarify that link mode uses "hard" links.
X-Git-Tag: REL9_2_BETA1~1502
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=194e6ee74b0282d0a7b8d0c815ea7204fc23cec9;p=postgresql

In pg_upgrade docs, clarify that link mode uses "hard" links.

Backpatch to 9.1 and 9.0.
---

diff --git a/doc/src/sgml/pgupgrade.sgml b/doc/src/sgml/pgupgrade.sgml
index a505707cc0..b24c1e7b98 100644
--- a/doc/src/sgml/pgupgrade.sgml
+++ b/doc/src/sgml/pgupgrade.sgml
@@ -105,7 +105,7 @@
      <varlistentry>
       <term><option>-k</option></term>
       <term><option>--link</option></term>
-      <listitem><para>link instead of copying files to new cluster</para></listitem>
+      <listitem><para>use hard links instead of copying files to the new cluster</para></listitem>
      </varlistentry>
 
      <varlistentry>
@@ -293,14 +293,18 @@ NET STOP pgsql-8.3  (<productname>PostgreSQL</> 8.3 and older used a different s
     <para>
      Always run the <application>pg_upgrade</> binary of the new server, not the old one.
      <application>pg_upgrade</> requires the specification of the old and new cluster's
-     data and executable (<filename>bin</>) directories. You can also specify separate
+     data and executable (<filename>bin</>) directories. You can also specify
      user and port values, and whether you want the data linked instead of
-     copied (the default). If you use linking, the upgrade will be much
-     faster (hard link data files rather than copying them), but you
-     will no longer be able to access your old cluster once you start
-     the new cluster after the upgrade.  Link mode also requires that the
-     old and new cluster data directories be in the same file system.
-     See <literal>pg_upgrade --help</> for a full list of options.
+     copied (the default). 
+    </para>
+
+    <para>
+     If you use link mode, the upgrade will be much faster (no file
+     copying), but you will not be able to access your old cluster
+     once you start the new cluster after the upgrade.  Link mode also
+     requires that the old and new cluster data directories be in the
+     same file system.  See <literal>pg_upgrade --help</> for a full
+     list of options.
     </para>
 
     <para>