Postgres Pro
Downloads
Home   >   mailing lists

Re: Add exclusive backup deprecation notes to documentation - Mailing list pgsql-hackers

From Magnus Hagander
Subject Re: Add exclusive backup deprecation notes to documentation
Date
Msg-id CABUevEz4rGtf3-q1YBHHcE1v6G8Q1t7CsZ7HwvFS3CPw9bm82w@mail.gmail.com
Whole thread Raw
In response to Re: Add exclusive backup deprecation notes to documentation  (David Steele <david@pgmasters.net>)
Responses Re: Add exclusive backup deprecation notes to documentation
List pgsql-hackers
Tree view
On Fri, Mar 1, 2019 at 2:07 PM David Steele <david@pgmasters.net> wrote:
On 3/1/19 1:13 PM, Peter Eisentraut wrote:
> Please follow the 1-space indentation in the documentation files.

Whoops.  Will fix.

> I think the style of mentioning all the problems in a note before the
> actual description is a bit backwards.

In the case of an important note like this I think it should be right at
the top where people will see it.  Not everyone reads to the end

Maybe have the first note say "This method is deprecated bceause it has serious risks (see bellow)" and then list the actual risks at the end? 

--

pgsql-hackers by date:

Previous
From: David Steele
Date:
Subject: Re: Add exclusive backup deprecation notes to documentation
Next
From: Christoph Berg
Date:
Subject: Re: pgsql: Build src/port files as a library with -fPIC, and usethat in li