Message-ID: <4D96D0BA.6040101@2ndQuadrant.com>
Date: Sat, 02 Apr 2011 09:31:06 +0200
From: Susanne Ebrecht <susanne@2ndQuadrant.com>
User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US;
	rv:1.9.2.14) Gecko/20110223 Thunderbird/3.1.8
MIME-Version: 1.0
To: Robert Haas <robertmhaas@gmail.com>
CC: pgsql-docs@postgresql.org, pgsql-hackers@postgresql.org
Subject: Re: found a very confusing and maybe outdated sentence
References: <4D922DDC.2070900@2ndQuadrant.com>
	<AANLkTi=wPAzABPi2DBW=dAjCn_jRjeKvcDEbujUFaUPb@mail.gmail.com>
In-Reply-To: <AANLkTi=wPAzABPi2DBW=dAjCn_jRjeKvcDEbujUFaUPb@mail.gmail.com>
Content-Type: multipart/mixed; boundary="------------050800030001090601000202"

This is a multi-part message in MIME format.
--------------050800030001090601000202
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit

On 31.03.2011 18:13, Robert Haas wrote:
> On Tue, Mar 29, 2011 at 3:07 PM, Susanne Ebrecht
> <susanne@2ndquadrant.com>  wrote:
>> Hello,
>>
>> It is in start.sgml. You can see it here:
>>
>> http://www.postgresql.org/docs/9.0/static/tutorial-accessdb.html
>>
>> The last two sentences on the page:
>>
>> " If PostgreSQL is installed correctly you can also
>> type man psql at the operating system shell prompt
>> to see the documentation. In this tutorial we will not
>> use these features explicitly, but you can use them
>> yourself when it is helpful."
>>
>> Isn't that totally outdated?
>>
>> Is "man" really working on Windows?
>>
>> Also the sentence says that the whole product isn't correct
>> installed just because docs aren't installed. Which also isn't
>> really true.
>>
>> Honesty, I just would like to drop the whole sentences.
>>
>> What do you think?
> +1 for deleting the entire sentence.
>

Here is the patch for removing the whole sentence.

Susanne

-- 
Susanne Ebrecht - 2ndQuadrant
PostgreSQL Development, 24x7 Support, Training and Services
www.2ndQuadrant.com


--------------050800030001090601000202
Content-Type: text/x-patch;
	name="doc_tutorial_remove_sentence_about_man_page.patch"
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment;
	filename="doc_tutorial_remove_sentence_about_man_page.patch"

diff --git a/doc/src/sgml/start.sgml b/doc/src/sgml/start.sgml
index 4275bf8..0bfc25e 100644
--- a/doc/src/sgml/start.sgml
+++ b/doc/src/sgml/start.sgml
@@ -403,11 +403,7 @@ mydb=#
     command shell. (For more internal commands, type
     <literal>\?</literal> at the <command>psql</command> prompt.)  The
     full capabilities of <command>psql</command> are documented in
-    <xref linkend="app-psql">.  If <productname>PostgreSQL</> is
-    installed correctly you can also type <literal>man psql</literal>
-    at the operating system shell prompt to see the documentation.  In
-    this tutorial we will not use these features explicitly, but you
-    can use them yourself when it is helpful.
+    <xref linkend="app-psql">.
    </para>
 
   </sect1>

--------------050800030001090601000202--