Re: Add docs stub for recovery.conf

Поиск
Список
Период
Сортировка
От Daniel Gustafsson
Тема Re: Add docs stub for recovery.conf
Дата
Msg-id F7619CAB-C549-46FD-98FE-707AA99036BF@yesql.se
обсуждение исходный текст
Ответ на Re: Add docs stub for recovery.conf  (Bruce Momjian <bruce@momjian.us>)
Список pgsql-hackers
> On 11 Nov 2020, at 21:01, Bruce Momjian <bruce@momjian.us> wrote:
>
> On Wed, Nov 11, 2020 at 08:59:40PM +0100, Daniel Gustafsson wrote:
>>> On 11 Nov 2020, at 20:44, Bruce Momjian <bruce@momjian.us> wrote:
>>> On Tue, Nov 10, 2020 at 01:38:14PM +0800, Craig Ringer wrote:
>>
>>>> I noticed that when recovery.conf was removed in 2dedf4d9a8 (yay!) the docs for
>>>> it were removed completely as well. That's largely sensible, but is confusing
>>>> when users have upgraded and are trying to find out what happened, or how to
>>>> configure equivalent functionality.
>>>
>>> I don't see the logic in carrying doc stuff that we don't have anymore.
>>
>> Well, we do have that already in <tip>'s sprinkled across the docs where it
>> makes sense to help transitioning users, like this one in func.sgml:
>>
>>    "Prior to PostgreSQL 12, it was possible to skip arbitrary text in the
>>    input string using non-letter or non-digit characters..."
>>
>> It doesn't seem like a terrible idea to do a similar one for recovery.conf.
>
> I am fine with a tip.  The patch looked like it was creating a new
> chapter for it.

I admittedly hadn't looked at the patch, but now that I have I agree with not
adding a separate "obsolete" topic for it.  I'd prefer to use tips within the
docs, they will also help guide users who search for recovery.conf and lands in
the tip which is next to the relevant updated documentation on the topic.

cheers ./daniel


В списке pgsql-hackers по дате отправления:

Предыдущее
От: Bruce Momjian
Дата:
Сообщение: Re: Add docs stub for recovery.conf
Следующее
От: Andrew Dunstan
Дата:
Сообщение: Allow matching whole DN from a client certificate