public inbox for [email protected]help / color / mirror / Atom feed
found a very confusing and maybe outdated sentence 6+ messages / 2 participants [nested] [flat]
* found a very confusing and maybe outdated sentence @ 2011-03-29 19:07 Susanne Ebrecht <[email protected]> 0 siblings, 1 reply; 6+ messages in thread From: Susanne Ebrecht @ 2011-03-29 19:07 UTC (permalink / raw) To: pgsql-docs 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? Susanne -- Susanne Ebrecht - 2ndQuadrant PostgreSQL Development, 24x7 Support, Training and Services www.2ndQuadrant.com ^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: found a very confusing and maybe outdated sentence @ 2011-03-31 16:13 Robert Haas <[email protected]> parent: Susanne Ebrecht <[email protected]> 0 siblings, 1 reply; 6+ messages in thread From: Robert Haas @ 2011-03-31 16:13 UTC (permalink / raw) To: Susanne Ebrecht <[email protected]>; +Cc: pgsql-docs 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. -- Robert Haas EnterpriseDB: http://www.enterprisedb.com The Enterprise PostgreSQL Company ^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: found a very confusing and maybe outdated sentence @ 2011-04-02 07:31 Susanne Ebrecht <[email protected]> parent: Robert Haas <[email protected]> 0 siblings, 1 reply; 6+ messages in thread From: Susanne Ebrecht @ 2011-04-02 07:31 UTC (permalink / raw) To: Robert Haas <[email protected]>; +Cc: pgsql-docs; [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> ^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: found a very confusing and maybe outdated sentence @ 2011-04-03 23:51 Robert Haas <[email protected]> parent: Susanne Ebrecht <[email protected]> 0 siblings, 1 reply; 6+ messages in thread From: Robert Haas @ 2011-04-03 23:51 UTC (permalink / raw) To: Susanne Ebrecht <[email protected]>; +Cc: pgsql-docs; [email protected] On Sat, Apr 2, 2011 at 3:31 AM, Susanne Ebrecht <[email protected]> wrote: >>> 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. Hmm... this actually removes two sentences. I've committed the removal of the one we talked about; I don't particularly see any reason to remove the following one also. -- Robert Haas EnterpriseDB: http://www.enterprisedb.com The Enterprise PostgreSQL Company ^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: [HACKERS] found a very confusing and maybe outdated sentence @ 2011-04-04 08:06 Susanne Ebrecht <[email protected]> parent: Robert Haas <[email protected]> 0 siblings, 1 reply; 6+ messages in thread From: Susanne Ebrecht @ 2011-04-04 08:06 UTC (permalink / raw) To: Robert Haas <[email protected]>; +Cc: pgsql-docs; [email protected] On 04.04.2011 01:51, Robert Haas wrote: > On Sat, Apr 2, 2011 at 3:31 AM, Susanne Ebrecht<[email protected]> wrote: >>>> 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. > Hmm... this actually removes two sentences. I've committed the > removal of the one we talked about; I don't particularly see any > reason to remove the following one also. > Hello Robert, the second sentence says "these features" - and I would understand: these features == man pages Means, I would understand that the two sentences belong together and both talk about man pages. When we don't mention man pages anymore then we not need the sentence that tells that the tutorial won't take care about man pages. Susanne -- Susanne Ebrecht - 2ndQuadrant PostgreSQL Development, 24x7 Support, Training and Services www.2ndQuadrant.com ^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: [HACKERS] found a very confusing and maybe outdated sentence @ 2011-04-04 14:54 Robert Haas <[email protected]> parent: Susanne Ebrecht <[email protected]> 0 siblings, 0 replies; 6+ messages in thread From: Robert Haas @ 2011-04-04 14:54 UTC (permalink / raw) To: Susanne Ebrecht <[email protected]>; +Cc: pgsql-docs; [email protected] On Mon, Apr 4, 2011 at 4:06 AM, Susanne Ebrecht <[email protected]> wrote: > the second sentence says "these features" - and I would understand: > > these features == man pages > > Means, I would understand that the two sentences belong together and > both talk about man pages. > > When we don't mention man pages anymore then we not need the sentence > that tells that the tutorial won't take care about man pages. Oh, I interpreted that sentence to be talking about the features *of psql*, not the man pages. -- Robert Haas EnterpriseDB: http://www.enterprisedb.com The Enterprise PostgreSQL Company ^ permalink raw reply [nested|flat] 6+ messages in thread
end of thread, other threads:[~2011-04-04 14:54 UTC | newest] Thread overview: 6+ messages (download: mbox mbox.gz follow: Atom feed) -- links below jump to the message on this page -- 2011-03-29 19:07 found a very confusing and maybe outdated sentence Susanne Ebrecht <[email protected]> 2011-03-31 16:13 ` Robert Haas <[email protected]> 2011-04-02 07:31 ` Susanne Ebrecht <[email protected]> 2011-04-03 23:51 ` Robert Haas <[email protected]> 2011-04-04 08:06 ` Susanne Ebrecht <[email protected]> 2011-04-04 14:54 ` Robert Haas <[email protected]>
This inbox is served by agora; see mirroring instructions for how to clone and mirror all data and code used for this inbox