Re: [COMMITTERS] pgsql: remove tags. - Mailing list pgsql-docs

From Bruce Momjian
Subject Re: [COMMITTERS] pgsql: remove tags.
Date
Msg-id 201102071559.p17Fxrb07886@momjian.us
Whole thread Raw
In response to Re: [COMMITTERS] pgsql: remove tags.  (Tom Lane <tgl@sss.pgh.pa.us>)
List pgsql-docs
Tom Lane wrote:
> Robert Haas <robertmhaas@gmail.com> writes:
> > Which way did we more commonly do it before you applied this patch?
>
> We don't have a standard for this, and an undocumented patch applied
> without any discussion doesn't create one.  It's hopeless to imagine
> that you'll ever achieve any uniformity that way.  It won't last long
> if you do, since you're outnumbered by committers who won't be following
> whatever you think the convention is.

Well, the problem is that we then have paragraphs where a number is
fixed width, and in the next paragraph it isn't;  this is particuarly
true in the config.sgml file where we show defaults.  Seems worth trying
to make that consistent.  I am happy to do whatever we agree on --- I
don't have an opinion.

> I'm not even sure why you're trying --- I don't think it even makes
> sense to try to have a standard about this.  I can easily imagine that
> integer constants might read better with <literal> in some contexts
> and better without in others.

Yes, I reviewed all the places and left <literal> where it made sense.

--
  Bruce Momjian  <bruce@momjian.us>        http://momjian.us
  EnterpriseDB                             http://enterprisedb.com

  + It's impossible for everything to be true. +

pgsql-docs by date:

Previous
From: Robert Haas
Date:
Subject: Re: [COMMITTERS] pgsql: remove tags.
Next
From: Bruce Momjian
Date:
Subject: Re: [COMMITTERS] pgsql: remove tags.