pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedSuggested changes to Tutorial
6+ messages / 3 participants
[nested] [flat]
* Suggested changes to Tutorial
@ 2006-07-31 22:29 Josh Berkus <josh@agliodbs.com>
2006-08-01 00:09 ` Re: Suggested changes to Tutorial Joshua D. Drake <jd@commandprompt.com>
0 siblings, 1 reply; 6+ messages in thread
From: Josh Berkus @ 2006-07-31 22:29 UTC (permalink / raw)
To: pgsql-docs
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
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Suggested changes to Tutorial
2006-07-31 22:29 Suggested changes to Tutorial Josh Berkus <josh@agliodbs.com>
@ 2006-08-01 00:09 ` Joshua D. Drake <jd@commandprompt.com>
2006-08-01 00:11 ` Re: Suggested changes to Tutorial Josh Berkus <josh@agliodbs.com>
0 siblings, 1 reply; 6+ messages in thread
From: Joshua D. Drake @ 2006-08-01 00:09 UTC (permalink / raw)
To: josh@agliodbs.com; +Cc: pgsql-docs
>
> 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/
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Suggested changes to Tutorial
2006-07-31 22:29 Suggested changes to Tutorial Josh Berkus <josh@agliodbs.com>
2006-08-01 00:09 ` Re: Suggested changes to Tutorial Joshua D. Drake <jd@commandprompt.com>
@ 2006-08-01 00:11 ` Josh Berkus <josh@agliodbs.com>
2006-08-01 00:41 ` Re: Suggested changes to Tutorial Joshua D. Drake <jd@commandprompt.com>
2006-08-01 06:54 ` Re: Suggested changes to Tutorial Peter Eisentraut <peter_e@gmx.net>
0 siblings, 2 replies; 6+ messages in thread
From: Josh Berkus @ 2006-08-01 00:11 UTC (permalink / raw)
To: Joshua D. Drake <jd@commandprompt.com>; +Cc: pgsql-docs
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
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Suggested changes to Tutorial
2006-07-31 22:29 Suggested changes to Tutorial Josh Berkus <josh@agliodbs.com>
2006-08-01 00:09 ` Re: Suggested changes to Tutorial Joshua D. Drake <jd@commandprompt.com>
2006-08-01 00:11 ` Re: Suggested changes to Tutorial Josh Berkus <josh@agliodbs.com>
@ 2006-08-01 00:41 ` Joshua D. Drake <jd@commandprompt.com>
2006-08-01 08:08 ` Re: Suggested changes to Tutorial Peter Eisentraut <peter_e@gmx.net>
1 sibling, 1 reply; 6+ messages in thread
From: Joshua D. Drake @ 2006-08-01 00:41 UTC (permalink / raw)
To: josh@agliodbs.com; +Cc: pgsql-docs
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/
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Suggested changes to Tutorial
2006-07-31 22:29 Suggested changes to Tutorial Josh Berkus <josh@agliodbs.com>
2006-08-01 00:09 ` Re: Suggested changes to Tutorial Joshua D. Drake <jd@commandprompt.com>
2006-08-01 00:11 ` Re: Suggested changes to Tutorial Josh Berkus <josh@agliodbs.com>
2006-08-01 00:41 ` Re: Suggested changes to Tutorial Joshua D. Drake <jd@commandprompt.com>
@ 2006-08-01 08:08 ` Peter Eisentraut <peter_e@gmx.net>
0 siblings, 0 replies; 6+ messages in thread
From: Peter Eisentraut @ 2006-08-01 08:08 UTC (permalink / raw)
To: pgsql-docs; +Cc: Joshua D. Drake <jd@commandprompt.com>; josh@agliodbs.com
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/
^ permalink raw reply [nested|flat] 6+ messages in thread
* Re: Suggested changes to Tutorial
2006-07-31 22:29 Suggested changes to Tutorial Josh Berkus <josh@agliodbs.com>
2006-08-01 00:09 ` Re: Suggested changes to Tutorial Joshua D. Drake <jd@commandprompt.com>
2006-08-01 00:11 ` Re: Suggested changes to Tutorial Josh Berkus <josh@agliodbs.com>
@ 2006-08-01 06:54 ` Peter Eisentraut <peter_e@gmx.net>
1 sibling, 0 replies; 6+ messages in thread
From: Peter Eisentraut @ 2006-08-01 06:54 UTC (permalink / raw)
To: pgsql-docs; josh@agliodbs.com; +Cc: Joshua D. Drake <jd@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/
^ permalink raw reply [nested|flat] 6+ messages in thread
end of thread, other threads:[~2006-08-01 08:08 UTC | newest]
Thread overview: 6+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2006-07-31 22:29 Suggested changes to Tutorial Josh Berkus <josh@agliodbs.com>
2006-08-01 00:09 ` Joshua D. Drake <jd@commandprompt.com>
2006-08-01 00:11 ` Josh Berkus <josh@agliodbs.com>
2006-08-01 00:41 ` Joshua D. Drake <jd@commandprompt.com>
2006-08-01 08:08 ` Peter Eisentraut <peter_e@gmx.net>
2006-08-01 06:54 ` Peter Eisentraut <peter_e@gmx.net>
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox