[DOCS] fixed doc bug in sepgsql.sgml
Hello, by accident we recognised that the author of sepgsql.sgml used < and > instead of < and > I just fixed it and here is the patch. Susanne -- Susanne Ebrecht - 2ndQuadrant PostgreSQL Development, 24x7 Support, Training and Services www.2ndQuadrant.com diff --git a/doc/src/sgml/sepgsql.sgml b/doc/src/sgml/sepgsql.sgml index 21b46de..589fe79 100644 --- a/doc/src/sgml/sepgsql.sgml +++ b/doc/src/sgml/sepgsql.sgml @@ -105,7 +105,7 @@ $ initdb $ vi $PGDATA/postgresql.conf $ for DBNAME in template0 template1 postgres; do postgres --single -F -O -c exit_on_error=true $DBNAME \ - < /usr/local/pgsql/share/contrib/sepgsql.sql > /dev/null + < /usr/local/pgsql/share/contrib/sepgsql.sql > /dev/null done -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] found a very confusing and maybe outdated sentence
On 31.03.2011 18:13, Robert Haas wrote: On Tue, Mar 29, 2011 at 3:07 PM, Susanne Ebrecht 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 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 \? at the psql prompt.) The full capabilities of psql are documented in -. 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. +. -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] refer to books in footnote
On 31.03.2011 18:11, Robert Haas wrote: I actually find both phrasings a bit ... What we're really trying to do here is provide the links, but that is sometimes better done in a footnote or bibliography than in the middle of a body of text. Honestly, I like the idea for the future. I think the effort doing it in existing docs is too high - but for future docs it is great. I have another argument for it: During translating the tutorial I found another sentence - referring books for SQL beginners. After very long thinking and after chatting about it with Peter - I skipped the sentence German translation. I translate the documentation into German mostly for ppl who are not able to speak English. It is not a good style to tell people here that when they want to learn SQL they should read English books - besides there is a translated version of the books - which wasn't the case. I would not have such a big problem here with translation when links to books would be just in a footnote - it don't look such painful to refer to English books in footnotes, when the books aren't available in German. Just my 2Cent, Susanne -- Susanne Ebrecht - 2ndQuadrant PostgreSQL Development, 24x7 Support, Training and Services www.2ndQuadrant.com -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] fixed doc bug in sepgsql.sgml
On 02.04.2011 10:24, Susanne Ebrecht wrote: Hello, by accident we recognised that the author of sepgsql.sgml used < and > instead of < and > I just fixed it and here is the patch. Committed, and I also fixed one case of that in pg_basebackup docs. -- Heikki Linnakangas EnterpriseDB http://www.enterprisedb.com -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs
Re: [DOCS] psql's \h MOVE
Alvaro Herrera writes:
> I just noticed that \h MOVE is particularly unhelpful:
> alvherre=# \h move
> Command: MOVE
> Description: position a cursor
> Syntax:
> MOVE [ direction { FROM | IN } ] cursorname
> The problem is that it doesn't specify what "direction" is. The doc
> text tells you to look into FETCH for details, but in \h you have to
> guess.
> We could fix this by including a note about fetch in the ,
> so that it'd look like this:
> alvherre=# \h move
> Command: MOVE
> Description: position a cursor
> Syntax:
> MOVE [ direction [ FROM | IN ] ] cursor_name
> See FETCH for details on direction
-1 ... if this annoys you, just duplicate the definition of direction
from FETCH.
regards, tom lane
--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
