agora inbox for pgsql-docs@postgresql.org
help / color / mirror / Atom feeddocs are incomplete or wrong...
3+ messages / 3 participants
[nested] [flat]
* docs are incomplete or wrong...
@ 2024-12-12 14:33 PG Doc comments form <noreply@postgresql.org>
2024-12-18 11:58 ` Re: docs are incomplete or wrong... Ian Lawrence Barwick <barwick@gmail.com>
2024-12-18 13:33 ` Re: docs are incomplete or wrong... David G. Johnston <david.g.johnston@gmail.com>
0 siblings, 2 replies; 3+ messages in thread
From: PG Doc comments form @ 2024-12-12 14:33 UTC (permalink / raw)
To: pgsql-docs@lists.postgresql.org; +Cc: josersleal.it@gmail.com
The following documentation comment has been logged on the website:
Page: https://www.postgresql.org/docs/17/tutorial-createdb.html
Description:
Folowing the online docs @
https://www.postgresql.org/docs/17/tutorial-createdb.html
it says: "To create a new database, in this example named mydb, you use the
following command:
$ createdb mydb"
When performing it error comes:
"createdb: error: connection to server on socket
"/var/run/postgresql/.s.PGSQL.5432" failed: FATAL: role "root" does not
exist"
No matter what explanation there is for it, this is supposed to be official
documentation. It MUST be right.
^ permalink raw reply [nested|flat] 3+ messages in thread
* Re: docs are incomplete or wrong...
2024-12-12 14:33 docs are incomplete or wrong... PG Doc comments form <noreply@postgresql.org>
@ 2024-12-18 11:58 ` Ian Lawrence Barwick <barwick@gmail.com>
1 sibling, 0 replies; 3+ messages in thread
From: Ian Lawrence Barwick @ 2024-12-18 11:58 UTC (permalink / raw)
To: josersleal.it@gmail.com; pgsql-docs@lists.postgresql.org
2024年12月18日(水) 18:58 PG Doc comments form <noreply@postgresql.org>:
>
> The following documentation comment has been logged on the website:
>
> Page: https://www.postgresql.org/docs/17/tutorial-createdb.html
> Description:
>
> Folowing the online docs @
> https://www.postgresql.org/docs/17/tutorial-createdb.html
> it says: "To create a new database, in this example named mydb, you use the
> following command:
>
> $ createdb mydb"
> When performing it error comes:
> "createdb: error: connection to server on socket
> "/var/run/postgresql/.s.PGSQL.5432" failed: FATAL: role "root" does not
> exist"
> No matter what explanation there is for it, this is supposed to be official
> documentation. It MUST be right.
If you read a bit further down that page, it tells you how to deal
with that kind of error:
> Another response could be this:
> createdb: error: connection to server on socket "/tmp/.s.PGSQL.5432" failed: FATAL: role "joe" does not exist
Specifically it says:
> You will need to become the operating system user under which PostgreSQL
> was installed (usually postgres) to create the first user account.
Regards
Ian Barwick
^ permalink raw reply [nested|flat] 3+ messages in thread
* Re: docs are incomplete or wrong...
2024-12-12 14:33 docs are incomplete or wrong... PG Doc comments form <noreply@postgresql.org>
@ 2024-12-18 13:33 ` David G. Johnston <david.g.johnston@gmail.com>
1 sibling, 0 replies; 3+ messages in thread
From: David G. Johnston @ 2024-12-18 13:33 UTC (permalink / raw)
To: josersleal.it@gmail.com <josersleal.it@gmail.com>; pgsql-docs@lists.postgresql.org <pgsql-docs@lists.postgresql.org>
On Thursday, December 12, 2024, PG Doc comments form <noreply@postgresql.org>
wrote:
> The following documentation comment has been logged on the website:
>
> Page: https://www.postgresql.org/docs/17/tutorial-createdb.html
> Description:
>
> Folowing the online docs @
> https://www.postgresql.org/docs/17/tutorial-createdb.html
> it says: "To create a new database, in this example named mydb, you use the
> following command:
>
> $ createdb mydb"
> When performing it error comes:
> "createdb: error: connection to server on socket
> "/var/run/postgresql/.s.PGSQL.5432" failed: FATAL: role "root" does not
> exist"
> No matter what explanation there is for it, this is supposed to be official
> documentation. It MUST be right.
>
The documentation is required to make some assumptions/requirements
regarding the operating context of the examples. Namely, you are running
commands as the OS user postgres, and that user can peer authenticate (or
trust…) into the default location for where you initdb’d and the cluster
(discussed earlier in the documentation). You are running the command as
root and thus violating those requirements.
IOW, it is correct but has pre-requisites that you haven’t followed. There
is no good way to make such an example entirely self-contained and
pre-requisite free. But if you’d like to suggest an improvement we are
open to making tweaks.
David J.
^ permalink raw reply [nested|flat] 3+ messages in thread
end of thread, other threads:[~2024-12-18 13:33 UTC | newest]
Thread overview: 3+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2024-12-12 14:33 docs are incomplete or wrong... PG Doc comments form <noreply@postgresql.org>
2024-12-18 11:58 ` Ian Lawrence Barwick <barwick@gmail.com>
2024-12-18 13:33 ` David G. Johnston <david.g.johnston@gmail.com>
This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox