DOC: documented pg-setup limitations

Author: Liudmila Mantrova

doc/src/sgml/ref/pg-setup.sgml

@@ -104,24 +104,28 @@
      <varlistentry>
       <term><option>initdb [<replaceable>initdb_options</replaceable>]</option></term>
       <listitem><para>Initialize the database cluster on behalf of the
-      <literal>postgres</literal> user. Optionally, you can provide
-      any <xref linkend="app-initdb"> options to customize the installation.
+      <literal>postgres</literal> user.
       </para>
-      <para>If no <application>initdb</application>
-      options are provided, the database cluster is initialized in the
+      <para>By default, the database cluster is initialized in the
       <filename>/var/lib/pgpro/&edition;-&majorversion;/data</filename> directory,
-      using localization settings specified in the <envar>LANG</envar>
+      with checksums enabled, <literal>auth-local</literal> parameter
+      set to <literal>peer</literal>, and <literal>auth-host</literal>
+      parameter set to <literal>md5</literal>.
+      Localization settings are inherited from the <envar>LANG</envar>
       environment variable for the current session.
       All the <literal>LC_*</literal> environment variables are ignored.
+      Optionally, you can provide <xref linkend="app-initdb"> options
+      to customize the installation.
       </para>
-      <note>
+      <important>
       <para>
-      <application>pg-setup</application> initializes the database cluster
-      with checksums enabled. If this is not what you expect, do not
+      With <application>pg-setup</application>, you cannot
+      initialize the database cluster with checksums disabled or
+      choose the data directory. If this is not what you expect, do not
       use <application>pg-setup</application> for cluster initialization
       and run <xref linkend="app-initdb"> directly instead.
       </para>
-      </note>
+      </important>
       </listitem>
      </varlistentry>