Thread: 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/