Received: from maia.hub.org (maia-3.hub.org [200.46.204.243])
	by mail.postgresql.org (Postfix) with ESMTP id 1A9821337B79
	for <pgsql-docs-postgresql.org@mail.postgresql.org>;
	Mon,  7 Feb 2011 22:52:00 -0400 (AST)
Received: from mail.postgresql.org ([200.46.204.86])
	by maia.hub.org (mx1.hub.org [200.46.204.243]) (amavisd-maia,
	port 10024) with ESMTP id 00920-02 for
	<pgsql-docs-postgresql.org@mail.postgresql.org>;
	Tue,  8 Feb 2011 02:51:52 +0000 (UTC)
X-Greylist: from auto-whitelisted by SQLgrey-1.7.6
Received: from momjian.us (momjian.us [70.90.9.53])
	by mail.postgresql.org (Postfix) with ESMTP id 5CB581337B54
	for <pgsql-docs@postgresql.org>; Mon,  7 Feb 2011 22:51:52 -0400 (AST)
Received: (from bruce@localhost) by momjian.us (8.11.6/8.11.6) id
 p182psn15223;
	Mon, 7 Feb 2011 21:51:54 -0500 (EST)
From: Bruce Momjian <bruce@momjian.us>
Message-Id: <201102080251.p182psn15223@momjian.us>
Subject: Re: Why Produce PDF files?
In-Reply-To: <875278.93756.qm@web110709.mail.gq1.yahoo.com>
To: Leslie S Satenstein <lsatenstein@yahoo.com>
Date: Mon, 7 Feb 2011 21:51:54 -0500 (EST)
CC: PostgreSQL-documentation <pgsql-docs@postgresql.org>
X-Mailer: ELM [version 2.4ME+ PL124 (25)]
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset="US-ASCII"
X-Virus-Scanned: Maia Mailguard 1.0.1
X-Spam-Status: No, hits=-1.91 tagged_above=-5 required=5 tests=BAYES_00=-1.9,
	T_RP_MATCHES_RCVD=-0.01
X-Spam-Level: 
X-Archive-Number: 201102/41
X-Sequence-Number: 6389


I already told you that your changes will only appear in 9.1 --- we don't
usually backpatch wording changes.  You can see the development docs here:

        http://developer.postgresql.org/pgdocs/postgres/index.html

---------------------------------------------------------------------------

Leslie S Satenstein wrote:
> 
> it appears that PDF files need no reformatting, and that it is ok to
> allow long command lines to be truncated by the right margins, or even
> better, that pronouns that refer back to a noun, are not specific
> enough.? One has to stop and think, --- to which noun is "this" (a
> pronoun) referring to.
> 
> I am not challenging the technical content, which I have found to be
> precise, but only that someone should proof read text to ensure good
> grammar.
> 
> No real improvement between pdf version 9.02 and 9.03, after I reported
> some issues with the former.
> 
> ------------------
> 
> Regards ?Leslie
>  Mr. Leslie Satenstein 40 years in IT and going strong.  Yesterday was
> a good day, today is a better day, and tomorrow will be even better.
> ?  mailto:lsatenstein@yahoo.com alternative: leslie.satenstein@itbms.biz
> www.itbms.biz / www.eclipseguard.com
> 
> 
> --- On Mon, 2/7/11, Bruce Momjian <bruce@momjian.us> wrote:
> 
> From: Bruce Momjian <bruce@momjian.us> Subject: Re: [DOCS] [COMMITTERS]
> pgsql: remove tags.  To: "Robert Haas" <robertmhaas@gmail.com> Cc: "Tom
> Lane" <tgl@sss.pgh.pa.us>, "PostgreSQL-documentation"
> <pgsql-docs@postgresql.org> Date: Monday, February 7, 2011, 10:54 AM
> 
> Robert Haas wrote:
> > On Mon, Feb 7, 2011 at 9:54 AM, Bruce Momjian <bruce@momjian.us> wrote:
> > > Robert Haas wrote:
> > >> On Sun, Feb 6, 2011 at 11:12 PM, Tom Lane <tgl@sss.pgh.pa.us> wrote:
> > >> > Bruce Momjian <bruce@momjian.us> writes:
> > >> >> Bruce Momjian wrote:
> > >> >>> remove tags.
> > >> >
> > >> >> Sorry, vague commit message (I forgot squash).
> > >> >
> > >> >> Can I will use git ammend to improve this message?
> > >>
> > >> Absolutely not.
> > >>
> > >> > How about git revert, instead? ?It's not apparent to me that these
> > >> > changes were improvements.
> > >>
> > >> I'll buy that one.
> > >
> > > [ ?CC to docs, committers removed. ]
> > >
> > > Well, if we want to revert, then we have to add <literal> to all the
> > > numbers used in our docs --- there was no logic in what we previously
> > > had. ?Do we want that?
> > >
> > > Here is an example line I did not change:
> > >
> > > ? an otherwise idle connection. ?A value of 0 uses the system default.
> > >
> > > Do we want that 0 to appear in a fixed-width font via <literal>?
> > > It is easy to do but we should decide.
> >
> > [ removing -hackers from CC also, no need to cross-post ]
> >
> > Hmm.? I'm starting to lean toward leaving this as you have it.
> >
> > Which way did we more commonly do it before you applied this patch?
> 
> It was mostly like the line I have above, meaning it was not in
> fixed-width font, 95% I would say.? I modified 19 to be like the rest.
> I left <literal> where the context made sense.
> 
> -- ? Bruce Momjian? <bruce@momjian.us>? ? ? ? http://momjian.us ?
> EnterpriseDB? ? ? ? ? ? ? ? ? ? ? ? ? ???http://enterprisedb.com
> 
> ? + It's impossible for everything to be true. +
> 
> -- Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make
> changes to your subscription:
> http://www.postgresql.org/mailpref/pgsql-docs

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

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