public inbox for [email protected]
help / color / mirror / Atom feedFwd: Bug#308535: postgresql-client: [psql] manual page does not document ~/.pgpass file
9+ messages / 5 participants
[nested] [flat]
* Fwd: Bug#308535: postgresql-client: [psql] manual page does not document ~/.pgpass file
@ 2005-05-12 20:43 Martin Pitt <[email protected]>
0 siblings, 1 reply; 9+ messages in thread
From: Martin Pitt @ 2005-05-12 20:43 UTC (permalink / raw)
To: PostgreSQL Bugs <[email protected]>
Hi PostgreSQL developers!
We recently got the bug report below. Do you agree that documenting
~/.pgpass in psql(1) is a good idea?
Thanks for considering and have a nice day!
Martin
----- Forwarded message from Jari Aalto <[email protected]> -----
Subject: Bug#308535: postgresql-client: [psql] manual page does not document ~/.pgpass file
Reply-To: Jari Aalto <[email protected]>, [email protected]
From: Jari Aalto <[email protected]>
To: Debian Bug Tracking System <[email protected]>
Date: Tue, 10 May 2005 23:26:00 +0300
X-Spam-Status: No, score=0.0 required=4.0 tests=AWL,BAYES_50 autolearn=no
version=3.0.2
Package: postgresql-client
Version: 7.4.7-6
Severity: minor
psql(1) manual page does not mention in the FILES section ~/.pgpass file
and how it is used. It should include:
FILES
...
o The file ~/.pgpass in is a file that can contain passwords to be
used if the connection requires a password (and no password has
been specified otherwise). This file should have lines of the
following format:
hostname:port:database:username:password
Each of the first four fields may be a literal value, or *, which
matches anything. The password field from the first line that matches
the current connection parameters will be used. (Therefore, put
more-specific entries first when you are using wildcards.) If an entry
needs to contain : or \, escape this character with \.
The permissions on .pgpass must disallow any access to world or group;
achieve this by the command chmod 0600 ~/.pgpass. If the permissions
are less strict than this, the file will be ignored.
This explanation was exerpted from
http://www.postgresql.org/docs/7.4/static/libpq-pgpass.html
I have no idea why it is there, where nobidy is looking
----- End forwarded message -----
--
Martin Pitt http://www.piware.de
Ubuntu Developer http://www.ubuntulinux.org
Debian Developer http://www.debian.org
Attachments:
[application/pgp-signature] signature.asc (189B, 2-signature.asc)
download
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: Fwd: Bug#308535: postgresql-client: [psql] manual page does not document ~/.pgpass file
@ 2005-05-13 13:49 Tom Lane <[email protected]>
parent: Martin Pitt <[email protected]>
0 siblings, 2 replies; 9+ messages in thread
From: Tom Lane @ 2005-05-13 13:49 UTC (permalink / raw)
To: Martin Pitt <[email protected]>; +Cc: PostgreSQL Bugs <[email protected]>
Martin Pitt <[email protected]> writes:
> We recently got the bug report below. Do you agree that documenting
> ~/.pgpass in psql(1) is a good idea?
On that theory we'd have to replicate large parts of the libpq
documentation on every one of the "client application" pages,
which doesn't seem very maintainable. (.pgpass is just the tip
of the iceberg; the "environment variables" and "SSL support"
pages are also pretty critical for users to know about.)
I agree that there needs to be some more prominent mention,
but this doesn't look like the way to do it. Maybe some
"see also" links?
regards, tom lane
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: Fwd: Bug#308535: postgresql-client: [psql] manual page does not document ~/.pgpass file
@ 2005-05-13 16:07 Martin Pitt <[email protected]>
parent: Tom Lane <[email protected]>
1 sibling, 0 replies; 9+ messages in thread
From: Martin Pitt @ 2005-05-13 16:07 UTC (permalink / raw)
To: PostgreSQL Bugs <[email protected]>
Hi!
Tom Lane [2005-05-13 9:49 -0400]:
> Martin Pitt <[email protected]> writes:
> > We recently got the bug report below. Do you agree that documenting
> > ~/.pgpass in psql(1) is a good idea?
>
> On that theory we'd have to replicate large parts of the libpq
> documentation on every one of the "client application" pages,
> which doesn't seem very maintainable. (.pgpass is just the tip
> of the iceberg; the "environment variables" and "SSL support"
> pages are also pretty critical for users to know about.)
>
> I agree that there needs to be some more prominent mention,
> but this doesn't look like the way to do it. Maybe some
> "see also" links?
A prominent pointer (URL and hint to local documentation) would
certainly be adequate then.
Thanks and have a nice weekend!
Martin
--
Martin Pitt http://www.piware.de
Ubuntu Developer http://www.ubuntulinux.org
Debian Developer http://www.debian.org
Attachments:
[application/pgp-signature] signature.asc (189B, 2-signature.asc)
download
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: Fwd: Bug#308535: postgresql-client: [psql] manual page does
@ 2005-05-14 16:40 Bruce Momjian <[email protected]>
parent: Tom Lane <[email protected]>
1 sibling, 2 replies; 9+ messages in thread
From: Bruce Momjian @ 2005-05-14 16:40 UTC (permalink / raw)
To: Tom Lane <[email protected]>; +Cc: Martin Pitt <[email protected]>; PostgreSQL Bugs <[email protected]>
Tom Lane wrote:
> Martin Pitt <[email protected]> writes:
> > We recently got the bug report below. Do you agree that documenting
> > ~/.pgpass in psql(1) is a good idea?
>
> On that theory we'd have to replicate large parts of the libpq
> documentation on every one of the "client application" pages,
> which doesn't seem very maintainable. (.pgpass is just the tip
> of the iceberg; the "environment variables" and "SSL support"
> pages are also pretty critical for users to know about.)
>
> I agree that there needs to be some more prominent mention,
> but this doesn't look like the way to do it. Maybe some
> "see also" links?
Have you looked at the current docs? 8.0.3 has this in the second
paragraph of the psql Usage section:
http://www.postgresql.org/docs/8.0/static/app-psql.html
It is also convenient to have a ~/.pgpass file to avoid regularly having
to type in passwords. See Section 27.12 for more information.
This was added in February:
revision 1.133
date: 2005/02/11 04:19:05; author: momjian; state: Exp; lines: +22 -15
Mention that some psql environment variables come from libpq and note
more variables can be found in the libpq manual section.
Mention .pgpass in the psql manual page section dealing with connection
parameters and point to the libpq section for more details.
Is that sufficient?
--
Bruce Momjian | http://candle.pha.pa.us
[email protected] | (610) 359-1001
+ If your life is a hard drive, | 13 Roberts Road
+ Christ can be your backup. | Newtown Square, Pennsylvania 19073
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: [BUGS] Fwd: Bug#308535: postgresql-client: [psql] manual page does not document ~/.pgpass file
@ 2005-05-14 18:07 Tom Lane <[email protected]>
parent: Bruce Momjian <[email protected]>
1 sibling, 1 reply; 9+ messages in thread
From: Tom Lane @ 2005-05-14 18:07 UTC (permalink / raw)
To: Bruce Momjian <[email protected]>; +Cc: Martin Pitt <[email protected]>; pgsql-docs
Bruce Momjian <[email protected]> writes:
> It is also convenient to have a ~/.pgpass file to avoid regularly having
> to type in passwords. See Section 27.12 for more information.
> Is that sufficient?
It responds to the immediate complaint, but I was thinking that we ought
to add links to the relevant pages of the libpq docs in the "See Also"
parts of all of the client-application reference pages. If the links
read like "Client Environment Variables", "Client Password File", etc
then it seems to me this would let us remove the rather incomplete
information that is in the individual reference pages today.
regards, tom lane
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: Fwd: Bug#308535: postgresql-client: [psql] manual page
@ 2005-05-14 20:26 Chris Travers <[email protected]>
parent: Bruce Momjian <[email protected]>
1 sibling, 0 replies; 9+ messages in thread
From: Chris Travers @ 2005-05-14 20:26 UTC (permalink / raw)
To: Bruce Momjian <[email protected]>; [email protected]
Maybe it would be a good idea to have a manual page called somelint like
libpq-connect and document it there. The other man pages could then
reference it.
Best Wishes,
Chris Travers
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: [BUGS] Fwd: Bug#308535: postgresql-client: [psql] manual
@ 2005-05-29 03:33 Bruce Momjian <[email protected]>
parent: Tom Lane <[email protected]>
0 siblings, 1 reply; 9+ messages in thread
From: Bruce Momjian @ 2005-05-29 03:33 UTC (permalink / raw)
To: Tom Lane <[email protected]>; +Cc: Martin Pitt <[email protected]>; pgsql-docs
Tom Lane wrote:
> Bruce Momjian <[email protected]> writes:
>
> > It is also convenient to have a ~/.pgpass file to avoid regularly having
> > to type in passwords. See Section 27.12 for more information.
>
> > Is that sufficient?
>
> It responds to the immediate complaint, but I was thinking that we ought
> to add links to the relevant pages of the libpq docs in the "See Also"
> parts of all of the client-application reference pages. If the links
> read like "Client Environment Variables", "Client Password File", etc
> then it seems to me this would let us remove the rather incomplete
> information that is in the individual reference pages today.
Right, done for environment variables, and attached. PGPASSORD mentions
.pgpass so I think we are done.
--
Bruce Momjian | http://candle.pha.pa.us
[email protected] | (610) 359-1001
+ If your life is a hard drive, | 13 Roberts Road
+ Christ can be your backup. | Newtown Square, Pennsylvania 19073
Index: doc/src/sgml/ref/clusterdb.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/clusterdb.sgml,v
retrieving revision 1.16
diff -c -c -r1.16 clusterdb.sgml
*** doc/src/sgml/ref/clusterdb.sgml 29 Nov 2003 19:51:38 -0000 1.16
--- doc/src/sgml/ref/clusterdb.sgml 29 May 2005 03:27:19 -0000
***************
*** 235,240 ****
--- 235,241 ----
<simplelist type="inline">
<member><xref linkend="sql-cluster" endterm="sql-cluster-title"></member>
+ <member>Environment Variables (<xref linkend="libpq-envars">)</member>
</simplelist>
</refsect1>
Index: doc/src/sgml/ref/createdb.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/createdb.sgml,v
retrieving revision 1.40
diff -c -c -r1.40 createdb.sgml
*** doc/src/sgml/ref/createdb.sgml 18 Jun 2004 21:47:23 -0000 1.40
--- doc/src/sgml/ref/createdb.sgml 29 May 2005 03:27:19 -0000
***************
*** 294,299 ****
--- 294,300 ----
<simplelist type="inline">
<member><xref linkend="app-dropdb"></member>
<member><xref linkend="sql-createdatabase" endterm="sql-createdatabase-title"></member>
+ <member>Environment Variables (<xref linkend="libpq-envars">)</member>
</simplelist>
</refsect1>
Index: doc/src/sgml/ref/createlang.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/createlang.sgml,v
retrieving revision 1.33
diff -c -c -r1.33 createlang.sgml
*** doc/src/sgml/ref/createlang.sgml 29 Nov 2003 19:51:38 -0000 1.33
--- doc/src/sgml/ref/createlang.sgml 29 May 2005 03:27:20 -0000
***************
*** 232,237 ****
--- 232,238 ----
<simplelist type="inline">
<member><xref linkend="app-droplang"></member>
<member><xref linkend="sql-createlanguage" endterm="sql-createlanguage-title"></member>
+ <member>Environment Variables (<xref linkend="libpq-envars">)</member>
</simplelist>
</refsect1>
Index: doc/src/sgml/ref/createuser.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/createuser.sgml,v
retrieving revision 1.40
diff -c -c -r1.40 createuser.sgml
*** doc/src/sgml/ref/createuser.sgml 13 May 2005 16:31:43 -0000 1.40
--- doc/src/sgml/ref/createuser.sgml 29 May 2005 03:27:20 -0000
***************
*** 334,339 ****
--- 334,340 ----
<simplelist type="inline">
<member><xref linkend="app-dropuser"></member>
<member><xref linkend="sql-createuser" endterm="sql-createuser-title"></member>
+ <member>Environment Variables (<xref linkend="libpq-envars">)</member>
</simplelist>
</refsect1>
Index: doc/src/sgml/ref/dropdb.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/dropdb.sgml,v
retrieving revision 1.26
diff -c -c -r1.26 dropdb.sgml
*** doc/src/sgml/ref/dropdb.sgml 29 Nov 2003 19:51:38 -0000 1.26
--- doc/src/sgml/ref/dropdb.sgml 29 May 2005 03:27:20 -0000
***************
*** 220,225 ****
--- 220,226 ----
<simplelist type="inline">
<member><xref linkend="app-createdb"></member>
<member><xref linkend="sql-dropdatabase" endterm="sql-dropdatabase-title"></member>
+ <member>Environment Variables (<xref linkend="libpq-envars">)</member>
</simplelist>
</refsect1>
Index: doc/src/sgml/ref/droplang.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/droplang.sgml,v
retrieving revision 1.25
diff -c -c -r1.25 droplang.sgml
*** doc/src/sgml/ref/droplang.sgml 29 Nov 2003 19:51:38 -0000 1.25
--- doc/src/sgml/ref/droplang.sgml 29 May 2005 03:27:20 -0000
***************
*** 220,225 ****
--- 220,226 ----
<simplelist type="inline">
<member><xref linkend="app-createlang"></member>
<member><xref linkend="sql-droplanguage" endterm="sql-droplanguage-title"></member>
+ <member>Environment Variables (<xref linkend="libpq-envars">)</member>
</simplelist>
</refsect1>
Index: doc/src/sgml/ref/dropuser.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/dropuser.sgml,v
retrieving revision 1.31
diff -c -c -r1.31 dropuser.sgml
*** doc/src/sgml/ref/dropuser.sgml 29 Nov 2003 19:51:38 -0000 1.31
--- doc/src/sgml/ref/dropuser.sgml 29 May 2005 03:27:20 -0000
***************
*** 224,229 ****
--- 224,230 ----
<simplelist type="inline">
<member><xref linkend="app-createuser"></member>
<member><xref linkend="sql-dropuser" endterm="sql-dropuser-title"></member>
+ <member>Environment Variables (<xref linkend="libpq-envars">)</member>
</simplelist>
</refsect1>
Index: doc/src/sgml/ref/pg_dump.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/pg_dump.sgml,v
retrieving revision 1.76
diff -c -c -r1.76 pg_dump.sgml
*** doc/src/sgml/ref/pg_dump.sgml 17 Jan 2005 04:30:37 -0000 1.76
--- doc/src/sgml/ref/pg_dump.sgml 29 May 2005 03:27:21 -0000
***************
*** 697,702 ****
--- 697,703 ----
<member><xref linkend="app-pg-dumpall"></member>
<member><xref linkend="app-pgrestore"></member>
<member><xref linkend="app-psql"></member>
+ <member>Environment Variables (<xref linkend="libpq-envars">)</member>
</simplelist>
</refsect1>
Index: doc/src/sgml/ref/pg_dumpall.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/pg_dumpall.sgml,v
retrieving revision 1.48
diff -c -c -r1.48 pg_dumpall.sgml
*** doc/src/sgml/ref/pg_dumpall.sgml 6 Jan 2005 18:29:08 -0000 1.48
--- doc/src/sgml/ref/pg_dumpall.sgml 29 May 2005 03:27:21 -0000
***************
*** 415,421 ****
<para>
<xref linkend="app-pgdump">. Check there for details on possible
! error conditions.
</para>
</refsect1>
--- 415,422 ----
<para>
<xref linkend="app-pgdump">. Check there for details on possible
! error conditions. Also see suppored environment variables
! (<xref linkend="libpq-envars">).
</para>
</refsect1>
Index: doc/src/sgml/ref/pg_restore.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/pg_restore.sgml,v
retrieving revision 1.50
diff -c -c -r1.50 pg_restore.sgml
*** doc/src/sgml/ref/pg_restore.sgml 23 Jan 2005 00:30:31 -0000 1.50
--- doc/src/sgml/ref/pg_restore.sgml 29 May 2005 03:27:21 -0000
***************
*** 616,621 ****
--- 616,622 ----
<member><xref linkend="app-pgdump"></member>
<member><xref linkend="app-pg-dumpall"></member>
<member><xref linkend="app-psql"></member>
+ <member>Environment Variables (<xref linkend="libpq-envars">)</member>
</simplelist>
</refsect1>
</refentry>
Index: doc/src/sgml/ref/psql-ref.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/psql-ref.sgml,v
retrieving revision 1.135
diff -c -c -r1.135 psql-ref.sgml
*** doc/src/sgml/ref/psql-ref.sgml 28 Apr 2005 13:09:59 -0000 1.135
--- doc/src/sgml/ref/psql-ref.sgml 29 May 2005 03:27:23 -0000
***************
*** 2759,2764 ****
--- 2759,2772 ----
</refsect1>
+ <refsect1>
+ <title>See Also</title>
+
+ <simplelist type="inline">
+ <member>Environment Variables (<xref linkend="libpq-envars">)</member>
+ </simplelist>
+ </refsect1>
+
</refentry>
<!-- Keep this comment at the end of the file
Index: doc/src/sgml/ref/vacuumdb.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/vacuumdb.sgml,v
retrieving revision 1.35
diff -c -c -r1.35 vacuumdb.sgml
*** doc/src/sgml/ref/vacuumdb.sgml 6 Jan 2005 18:29:08 -0000 1.35
--- doc/src/sgml/ref/vacuumdb.sgml 29 May 2005 03:27:24 -0000
***************
*** 301,306 ****
--- 301,307 ----
<simplelist type="inline">
<member><xref linkend="sql-vacuum" endterm="sql-vacuum-title"></member>
+ <member>Environment Variables (<xref linkend="libpq-envars">)</member>
</simplelist>
</refsect1>
Attachments:
[text/plain] /bjm/diff (8.0K, 2-%2Fbjm%2Fdiff)
download | inline:
Index: doc/src/sgml/ref/clusterdb.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/clusterdb.sgml,v
retrieving revision 1.16
diff -c -c -r1.16 clusterdb.sgml
*** doc/src/sgml/ref/clusterdb.sgml 29 Nov 2003 19:51:38 -0000 1.16
--- doc/src/sgml/ref/clusterdb.sgml 29 May 2005 03:27:19 -0000
***************
*** 235,240 ****
--- 235,241 ----
<simplelist type="inline">
<member><xref linkend="sql-cluster" endterm="sql-cluster-title"></member>
+ <member>Environment Variables (<xref linkend="libpq-envars">)</member>
</simplelist>
</refsect1>
Index: doc/src/sgml/ref/createdb.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/createdb.sgml,v
retrieving revision 1.40
diff -c -c -r1.40 createdb.sgml
*** doc/src/sgml/ref/createdb.sgml 18 Jun 2004 21:47:23 -0000 1.40
--- doc/src/sgml/ref/createdb.sgml 29 May 2005 03:27:19 -0000
***************
*** 294,299 ****
--- 294,300 ----
<simplelist type="inline">
<member><xref linkend="app-dropdb"></member>
<member><xref linkend="sql-createdatabase" endterm="sql-createdatabase-title"></member>
+ <member>Environment Variables (<xref linkend="libpq-envars">)</member>
</simplelist>
</refsect1>
Index: doc/src/sgml/ref/createlang.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/createlang.sgml,v
retrieving revision 1.33
diff -c -c -r1.33 createlang.sgml
*** doc/src/sgml/ref/createlang.sgml 29 Nov 2003 19:51:38 -0000 1.33
--- doc/src/sgml/ref/createlang.sgml 29 May 2005 03:27:20 -0000
***************
*** 232,237 ****
--- 232,238 ----
<simplelist type="inline">
<member><xref linkend="app-droplang"></member>
<member><xref linkend="sql-createlanguage" endterm="sql-createlanguage-title"></member>
+ <member>Environment Variables (<xref linkend="libpq-envars">)</member>
</simplelist>
</refsect1>
Index: doc/src/sgml/ref/createuser.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/createuser.sgml,v
retrieving revision 1.40
diff -c -c -r1.40 createuser.sgml
*** doc/src/sgml/ref/createuser.sgml 13 May 2005 16:31:43 -0000 1.40
--- doc/src/sgml/ref/createuser.sgml 29 May 2005 03:27:20 -0000
***************
*** 334,339 ****
--- 334,340 ----
<simplelist type="inline">
<member><xref linkend="app-dropuser"></member>
<member><xref linkend="sql-createuser" endterm="sql-createuser-title"></member>
+ <member>Environment Variables (<xref linkend="libpq-envars">)</member>
</simplelist>
</refsect1>
Index: doc/src/sgml/ref/dropdb.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/dropdb.sgml,v
retrieving revision 1.26
diff -c -c -r1.26 dropdb.sgml
*** doc/src/sgml/ref/dropdb.sgml 29 Nov 2003 19:51:38 -0000 1.26
--- doc/src/sgml/ref/dropdb.sgml 29 May 2005 03:27:20 -0000
***************
*** 220,225 ****
--- 220,226 ----
<simplelist type="inline">
<member><xref linkend="app-createdb"></member>
<member><xref linkend="sql-dropdatabase" endterm="sql-dropdatabase-title"></member>
+ <member>Environment Variables (<xref linkend="libpq-envars">)</member>
</simplelist>
</refsect1>
Index: doc/src/sgml/ref/droplang.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/droplang.sgml,v
retrieving revision 1.25
diff -c -c -r1.25 droplang.sgml
*** doc/src/sgml/ref/droplang.sgml 29 Nov 2003 19:51:38 -0000 1.25
--- doc/src/sgml/ref/droplang.sgml 29 May 2005 03:27:20 -0000
***************
*** 220,225 ****
--- 220,226 ----
<simplelist type="inline">
<member><xref linkend="app-createlang"></member>
<member><xref linkend="sql-droplanguage" endterm="sql-droplanguage-title"></member>
+ <member>Environment Variables (<xref linkend="libpq-envars">)</member>
</simplelist>
</refsect1>
Index: doc/src/sgml/ref/dropuser.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/dropuser.sgml,v
retrieving revision 1.31
diff -c -c -r1.31 dropuser.sgml
*** doc/src/sgml/ref/dropuser.sgml 29 Nov 2003 19:51:38 -0000 1.31
--- doc/src/sgml/ref/dropuser.sgml 29 May 2005 03:27:20 -0000
***************
*** 224,229 ****
--- 224,230 ----
<simplelist type="inline">
<member><xref linkend="app-createuser"></member>
<member><xref linkend="sql-dropuser" endterm="sql-dropuser-title"></member>
+ <member>Environment Variables (<xref linkend="libpq-envars">)</member>
</simplelist>
</refsect1>
Index: doc/src/sgml/ref/pg_dump.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/pg_dump.sgml,v
retrieving revision 1.76
diff -c -c -r1.76 pg_dump.sgml
*** doc/src/sgml/ref/pg_dump.sgml 17 Jan 2005 04:30:37 -0000 1.76
--- doc/src/sgml/ref/pg_dump.sgml 29 May 2005 03:27:21 -0000
***************
*** 697,702 ****
--- 697,703 ----
<member><xref linkend="app-pg-dumpall"></member>
<member><xref linkend="app-pgrestore"></member>
<member><xref linkend="app-psql"></member>
+ <member>Environment Variables (<xref linkend="libpq-envars">)</member>
</simplelist>
</refsect1>
Index: doc/src/sgml/ref/pg_dumpall.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/pg_dumpall.sgml,v
retrieving revision 1.48
diff -c -c -r1.48 pg_dumpall.sgml
*** doc/src/sgml/ref/pg_dumpall.sgml 6 Jan 2005 18:29:08 -0000 1.48
--- doc/src/sgml/ref/pg_dumpall.sgml 29 May 2005 03:27:21 -0000
***************
*** 415,421 ****
<para>
<xref linkend="app-pgdump">. Check there for details on possible
! error conditions.
</para>
</refsect1>
--- 415,422 ----
<para>
<xref linkend="app-pgdump">. Check there for details on possible
! error conditions. Also see suppored environment variables
! (<xref linkend="libpq-envars">).
</para>
</refsect1>
Index: doc/src/sgml/ref/pg_restore.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/pg_restore.sgml,v
retrieving revision 1.50
diff -c -c -r1.50 pg_restore.sgml
*** doc/src/sgml/ref/pg_restore.sgml 23 Jan 2005 00:30:31 -0000 1.50
--- doc/src/sgml/ref/pg_restore.sgml 29 May 2005 03:27:21 -0000
***************
*** 616,621 ****
--- 616,622 ----
<member><xref linkend="app-pgdump"></member>
<member><xref linkend="app-pg-dumpall"></member>
<member><xref linkend="app-psql"></member>
+ <member>Environment Variables (<xref linkend="libpq-envars">)</member>
</simplelist>
</refsect1>
</refentry>
Index: doc/src/sgml/ref/psql-ref.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/psql-ref.sgml,v
retrieving revision 1.135
diff -c -c -r1.135 psql-ref.sgml
*** doc/src/sgml/ref/psql-ref.sgml 28 Apr 2005 13:09:59 -0000 1.135
--- doc/src/sgml/ref/psql-ref.sgml 29 May 2005 03:27:23 -0000
***************
*** 2759,2764 ****
--- 2759,2772 ----
</refsect1>
+ <refsect1>
+ <title>See Also</title>
+
+ <simplelist type="inline">
+ <member>Environment Variables (<xref linkend="libpq-envars">)</member>
+ </simplelist>
+ </refsect1>
+
</refentry>
<!-- Keep this comment at the end of the file
Index: doc/src/sgml/ref/vacuumdb.sgml
===================================================================
RCS file: /cvsroot/pgsql/doc/src/sgml/ref/vacuumdb.sgml,v
retrieving revision 1.35
diff -c -c -r1.35 vacuumdb.sgml
*** doc/src/sgml/ref/vacuumdb.sgml 6 Jan 2005 18:29:08 -0000 1.35
--- doc/src/sgml/ref/vacuumdb.sgml 29 May 2005 03:27:24 -0000
***************
*** 301,306 ****
--- 301,307 ----
<simplelist type="inline">
<member><xref linkend="sql-vacuum" endterm="sql-vacuum-title"></member>
+ <member>Environment Variables (<xref linkend="libpq-envars">)</member>
</simplelist>
</refsect1>
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: [BUGS] Fwd: Bug#308535: postgresql-client: [psql] manual
@ 2005-05-29 09:26 Peter Eisentraut <[email protected]>
parent: Bruce Momjian <[email protected]>
0 siblings, 1 reply; 9+ messages in thread
From: Peter Eisentraut @ 2005-05-29 09:26 UTC (permalink / raw)
To: Bruce Momjian <[email protected]>; +Cc: Tom Lane <[email protected]>; Martin Pitt <[email protected]>; pgsql-docs
Bruce Momjian wrote:
> Right, done for environment variables, and attached. PGPASSORD
> mentions .pgpass so I think we are done.
Have you looked at the output this creates? The xref already creates
link text containing the section title. You don't need to write
"Environment variables" again.
--
Peter Eisentraut
http://developer.postgresql.org/~petere/
^ permalink raw reply [nested|flat] 9+ messages in thread
* Re: [BUGS] Fwd: Bug#308535: postgresql-client: [psql] manual
@ 2005-05-29 13:24 Bruce Momjian <[email protected]>
parent: Peter Eisentraut <[email protected]>
0 siblings, 0 replies; 9+ messages in thread
From: Bruce Momjian @ 2005-05-29 13:24 UTC (permalink / raw)
To: Peter Eisentraut <[email protected]>; +Cc: Tom Lane <[email protected]>; Martin Pitt <[email protected]>; pgsql-docs
Peter Eisentraut wrote:
> Bruce Momjian wrote:
> > Right, done for environment variables, and attached. PGPASSORD
> > mentions .pgpass so I think we are done.
>
> Have you looked at the output this creates? The xref already creates
> link text containing the section title. You don't need to write
> "Environment variables" again.
I did look and I see:
http://developer.postgresql.org/docs/postgres/app-psql.html
Environment Variables (Section 27.11)
Is that how it should look? Should I be using different tags? I would
rather not show the numbers but I thought that was required when linking
from the ref pages to the main docs.
--
Bruce Momjian | http://candle.pha.pa.us
[email protected] | (610) 359-1001
+ If your life is a hard drive, | 13 Roberts Road
+ Christ can be your backup. | Newtown Square, Pennsylvania 19073
^ permalink raw reply [nested|flat] 9+ messages in thread
end of thread, other threads:[~2005-05-29 13:24 UTC | newest]
Thread overview: 9+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2005-05-12 20:43 Fwd: Bug#308535: postgresql-client: [psql] manual page does not document ~/.pgpass file Martin Pitt <[email protected]>
2005-05-13 13:49 ` Tom Lane <[email protected]>
2005-05-13 16:07 ` Martin Pitt <[email protected]>
2005-05-14 16:40 ` Re: Fwd: Bug#308535: postgresql-client: [psql] manual page does Bruce Momjian <[email protected]>
2005-05-14 18:07 ` Tom Lane <[email protected]>
2005-05-29 03:33 ` Re: [BUGS] Fwd: Bug#308535: postgresql-client: [psql] manual Bruce Momjian <[email protected]>
2005-05-29 09:26 ` Re: [BUGS] Fwd: Bug#308535: postgresql-client: [psql] manual Peter Eisentraut <[email protected]>
2005-05-29 13:24 ` Re: [BUGS] Fwd: Bug#308535: postgresql-client: [psql] manual Bruce Momjian <[email protected]>
2005-05-14 20:26 ` Re: Fwd: Bug#308535: postgresql-client: [psql] manual page Chris Travers <[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