pg.ddx.io  pgsql-admin@postgresql.org mailing list archive  
help / color / mirror / Atom feed
From: Simon Riggs <simon@2ndquadrant.com>
To: Tom Lane <tgl@sss.pgh.pa.us>
To: Peter Eisentraut <peter_e@gmx.net>
Cc: pgsql-admin@postgresql.org
Subject: Re: PITR Error Message assistance
Date: Wed, 30 Jun 2004 19:42:13 +0100
Message-ID: <1088620933.3266.9657.camel@stromboli> (raw)
In-Reply-To: <8886.1088607524@sss.pgh.pa.us>
References: <auto-000005536314@davinci.ethosmedia.com>
	<200406291036.48477.josh@agliodbs.com>
	<1088541547.3266.7534.camel@stromboli>
	<200406300849.18058.peter_e@gmx.net>
	<8886.1088607524@sss.pgh.pa.us>

On Wed, 2004-06-30 at 15:58, Tom Lane wrote:
> Peter Eisentraut <peter_e@gmx.net> writes:

Thanks very much for your comments.

> > Simon Riggs wrote:
> >> + elog(WARNING, "could not set notify for archiver to read log file
> >> %u, segment %u",
> 
> > Reason? (disk full, network down, leap year?)

? "could not increment year number (additional day found)" :)

> 
> > I think elog() calls don't get translated.  You should always use 
> > ereport.  Tom would know more about the distinction.
> 
> elog is deprecated except for debugging or "can't-happen" messages.
> Anything user-facing ought to be reported with ereport.  In this case
> elog might be okay --- it's not clear to me from this snippet whether
> the condition is one a user would be likely to see.

Thanks for clarifying that, I wasn't clear on that. I'll go through and
make any required changes.

> There's plenty of detail about all this in chapter 45 of the docs:
> http://www.postgresql.org/docs/7.4/static/source.html
> and I think most of Peter's comments trace directly to items in the
> message style guide there.

Yes, I've read that and this post was all about discussing this and
applying it as part of polishing work.

I was really looking for some suggestions rather than a critique - the
messages were not exactly the bit I was focusing on in dev. Peter has
highlighted the extent of improvement, so I'll get on it now.

(For later, I've found it confusing that the Developer's FAQ makes no
mention of those notes, nor the other way around - I'll submit some
suggested changes to make everything clearer for those on their first
patch....and yes, I've tried hard to RTFM)

Can I just clarify whether the end of June freeze does or does not apply
to documentation? Clearly, I have a significant amount of documentation
to write also, which presumably will need review also.

What are the plans for review? I've not really heard much as yet...

Best Regards, Simon Riggs




view thread (5+ messages)  latest in thread

Message-ID: <1088620933.3266.9657.camel@stromboli>
Permalink:  ../1088620933.3266.9657.camel@stromboli/
Also on:    postgresql.org/message-id/1088620933.3266.9657.camel@stromboli

 · 

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients from your mail client; the link fills in
  the headers below: reply via email
  Some clients, webmail especially, drop In-Reply-To and References from
  a link, and the reply then starts a new thread: use the mbox below.

  To: pgsql-admin@postgresql.org
  Cc: simon@2ndquadrant.com, tgl@sss.pgh.pa.us, peter_e@gmx.net
  Subject: Re: PITR Error Message assistance
  In-Reply-To: <1088620933.3266.9657.camel@stromboli>
  References: <auto-000005536314@davinci.ethosmedia.com> <200406291036.48477.josh@agliodbs.com> <1088541547.3266.7534.camel@stromboli> <200406300849.18058.peter_e@gmx.net> <8886.1088607524@sss.pgh.pa.us> <1088620933.3266.9657.camel@stromboli>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox