On 10/28/2016 04:55 PM, Samuel Williams wrote:
>> as these commands have been around for like 20 years, its kinda late to change them
>
> I understand your position.
>
> For new documentation, it should be better to say `pg_ctl init` rather
> than `initdb`. I think that would guide users in the right direction
> from the start. Even if maintaining the old commands, they could print
> out to stderr "This command is deprecated and now wraps `pg_ctl init`.
> Please use that command in the future".
It does:
https://www.postgresql.org/docs/9.5/static/creating-cluster.html
>
>> initdb is now accessible from pg_ctl:
>
> Thanks Adrian, that's really helpful and exactly what I was looking for.
>
> Should we update the Arch Linux documentation to prefer these
> commands? What is the recommendation here?
Given that pg_ctl initdb is in all current community supported versions
I would say that is alright. Probably better to just point folks at the
Postgres docs, a great deal of effort is done to keep them current. Also
you have the version selection at the top of each page that allows you
to walk back and forth through time.
>
> On 29 October 2016 at 12:39, John R Pierce <pierce@hogranch.com> wrote:
>> On 10/28/2016 4:31 PM, Samuel Williams wrote:
>>>
>>> Just wondering as the naming of these commands seems overly generic
>>> and for a new user it's hard to know what commands are available since
>>> there is no common prefix (e.g. pg_<tab>) for these commands.
>>
>>
>> as these commands have been around for like 20 years, its kinda late to
>> change them
>>
>>
>> --
>> john r pierce, recycling bits in santa cruz
>>
>>
>>
>> --
>> Sent via pgsql-general mailing list (pgsql-general@postgresql.org)
>> To make changes to your subscription:
>> http://www.postgresql.org/mailpref/pgsql-general
>
>
--
Adrian Klaver
adrian.klaver@aklaver.com