Обсуждение: Suggested changes to Tutorial

Поиск
Список
Период
Сортировка

Suggested changes to Tutorial

От
Josh Berkus
Дата:
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

Re: Suggested changes to Tutorial

От
"Joshua D. Drake"
Дата:
>
> 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/



Re: Suggested changes to Tutorial

От
Josh Berkus
Дата:
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

Re: Suggested changes to Tutorial

От
"Joshua D. Drake"
Дата:
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/



Re: Suggested changes to Tutorial

От
Peter Eisentraut
Дата:
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/

Re: Suggested changes to Tutorial

От
Peter Eisentraut
Дата:
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/