public inbox for [email protected]  

help / color / mirror / Atom feed

From: Susanne Ebrecht <[email protected]>
To: Robert Haas <[email protected]>
Cc: [email protected]
Cc: [email protected]
Subject: Re: found a very confusing and maybe outdated sentence
Date: Sat, 02 Apr 2011 09:31:06 +0200
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>
	<[email protected]>

On 31.03.2011 18:13, Robert Haas wrote:
> On Tue, Mar 29, 2011 at 3:07 PM, Susanne Ebrecht
> <[email protected]>  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



Attachments:

  [text/x-patch] doc_tutorial_remove_sentence_about_man_page.patch (759B, 2-doc_tutorial_remove_sentence_about_man_page.patch)
  download | inline diff:
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>

view thread (6+ messages)  latest in thread

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected], [email protected], [email protected]
  Subject: Re: found a very confusing and maybe outdated sentence
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox