Re: [DOCS] Example error in createdb doc - Mailing list pgsql-docs

From Bruce Momjian
Subject Re: [DOCS] Example error in createdb doc
Date
Msg-id 20170321012414.GA2045@momjian.us
Whole thread Raw
In response to Re: Example error in createdb doc  (Tom Lane <tgl@sss.pgh.pa.us>)
List pgsql-docs
On Tue, Nov 22, 2016 at 06:17:35PM -0500, Tom Lane wrote:
> Bruce Momjian <bruce@momjian.us> writes:
> > On Thu, Oct 27, 2016 at 09:01:59PM -0400, Jason O'Donnell wrote:
> >> The example given for createdb fails because template0 is not provided:
>
> > I have looked over this report and patch, and it just doesn't feel
> > right.  The example is intending to show how to use common psql-like
> > options to control createdb.  Adding the encoding is nice, but then
> > having to switch to template0 so the encoding setting works just seems
> > beyond the scope of what we want do there.
>
> > I think the attached patch is more focused.
>
> I dunno.  The use of -e seems pretty pointless for a call that is going to
> yield a trivial CREATE DATABASE command.  Besides, we already showed a
> minimal example.  If you think Jason's example is too complex, what about
> just subbing in "-T template0" for "-E LATIN1"?  That should work
> regardless of other configuration.

[Just getting back to this November email]

Agreed on using -T.

> Also, your change to the text loses the point that -e provokes printing
> the underlying command.  Admittedly, that was somewhat indirect in the way
> it was phrased before, but now the concept is just gone entirely; that
> doesn't feel like an improvement either.
>
> Personally I thought Jason's patch was fine as-is.

I tried Jason's example on my server and got an error, so I don't want
to trade one error example for another:

    $ createdb -p 5432 -h localhost -E LATIN1 -T template0 -e demo
    CREATE DATABASE demo ENCODING 'LATIN1' TEMPLATE template0;
    createdb: database creation failed: ERROR:  encoding "LATIN1" does not match locale "en_US.UTF-8"
    DETAIL:  The chosen LC_CTYPE setting requires encoding "UTF8".

I went with the template0 example, attached, and applied it to head.

--
  Bruce Momjian  <bruce@momjian.us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

+ As you are, so once was I.  As I am, so you will be. +
+                      Ancient Roman grave inscription +

Attachment

pgsql-docs by date:

Previous
From: Tatsuo Ishii
Date:
Subject: Re: [DOCS] [HACKERS] Questionable tag usage
Next
From: Bruce Momjian
Date:
Subject: Re: [DOCS] Better example