Re: Beta1 announcement: alpha1 draft

On Fri, Apr 29, 2016 at 01:36:35PM +0200, Magnus Hagander wrote:
>     > > http://www.postgresql.org/docs/devel/static/functions-admin.html
>     > >
>     > > Note that it's technically backwards compatible, however, the existing
>     > > exclusive backup approach is bad and may mean that the database doesn't
>     > > automatically recover from a crash which happens while the backup is
>     > > running.  All backup tools should be updated to the new APIs to avoid
>     > > that risk.
>     >
>     > Is this risk new?  Is it documented?
>
>     No, it's not new.  I'm not sure off-hand if it's documented.
>
>
> It is not new.  
>
> And no it is at least not well documented. But there are other parts which
> aren't as well - such as the requirement to actually run pg_stop_backup() even
> in the case you want to abort a backup, or your next one will fail. Basically
> the old method is quite fragile and no, we haven't documented that properly
> previously.

Well, if the API was in wide use and will be supported for several more
years, we had better document it, no?

--
  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 +