Suggested changes to Tutorial
Folks:
in tutorial-createdb, it says:
"... where your own login name is mentioned. This will happen if the
administrator has not created a PostgreSQL user account for you.
(PostgreSQL user accounts are distinct from operating system user
accounts.) If you are the administrator, see Chapter 18 for help creating
accounts. You will need to become the operating system user under which
PostgreSQL was installed (usually postgres) to create the first user
account. It could also be that you were assigned a PostgreSQL user name
that is different from your operating system user name; in that case you
need to use the -U switch or set the PGUSER environment variable to
specify your PostgreSQL user name."
This isn't nearly clear enough for a tutorial. It should say:
"... where your own login name is mentioned. This will happen if the
administrator has not created a PostgreSQL user account for you.
(PostgreSQL user accounts are distinct from operating system user
accounts.) It could also be that you were assigned a PostgreSQL user name
that is different from your operating system user name; in that case you
need to use the -U switch or set the PGUSER environment variable to
specify your PostgreSQL user name.
If this is a new installation and you are the administrator, then you
probably need to connect as the system user who owns the PostgreSQL
installation, usually "postgres", but sometimes "pgsql". On POSIX systems
you can do this via the command "su - postgres"; otherwise simply log into
the system as that system user. Once you are logged in as the
installation owner, you can use createuser<link> to add other accounts."
--
--Josh
Josh Berkus
PostgreSQL @ Sun
San Francisco
If this is a new installation and you are the administrator, then you
probably need to connect as the system user who owns the PostgreSQL
installation, usually "postgres", but sometimes "pgsql". On POSIX systems
you can do this via the command "su - postgres"; otherwise simply log into
the system as that system user. Once you are logged in as the
installation owner, you can use createuser<link> to add other accounts."
Josh... then why didn't you just submit a patch?
Joshua D. Drake
--
=== The PostgreSQL Company: Command Prompt, Inc. ===
Sales/Support: +1.503.667.4564 || 24x7/Emergency: +1.800.492.2240
Providing the most comprehensive PostgreSQL solutions since 1997
http://www.commandprompt.com/
JD,
Josh... then why didn't you just submit a patch?
See earlier conversation about the lack of good tools for Docbook/SGML.
--
--Josh
Josh Berkus
PostgreSQL @ Sun
San Francisco
Josh Berkus wrote:
JD,
Josh... then why didn't you just submit a patch?
See earlier conversation about the lack of good tools for Docbook/SGML.
I guess this comes back to.. why (really) haven't we switched to what is
widely considered the documentation standard, which is Docbook XML.
Joshua D. Drake
--
=== The PostgreSQL Company: Command Prompt, Inc. ===
Sales/Support: +1.503.667.4564 || 24x7/Emergency: +1.800.492.2240
Providing the most comprehensive PostgreSQL solutions since 1997
http://www.commandprompt.com/
Josh Berkus wrote:
Josh... then why didn't you just submit a patch?
See earlier conversation about the lack of good tools for
Docbook/SGML.
Surely diff doesn't care.
--
Peter Eisentraut
http://developer.postgresql.org/~petere/
Joshua D. Drake wrote:
I guess this comes back to.. why (really) haven't we switched to what
is widely considered the documentation standard, which is Docbook
XML.
Every time this is brought up for discussion, people come up with
irrelevant and incorrect arguments about this -- see last discussion a
few weeks ago. We need to see factual arguments about benefits.
--
Peter Eisentraut
http://developer.postgresql.org/~petere/