Received: from maia.hub.org (maia-3.hub.org [200.46.204.243]) by mail.postgresql.org (Postfix) with ESMTP id E3E051337B8D for ; Mon, 7 Feb 2011 20:40:07 -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 44312-04 for ; Tue, 8 Feb 2011 00:40:00 +0000 (UTC) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from nm24-vm0.bullet.mail.sp2.yahoo.com (nm24-vm0.bullet.mail.sp2.yahoo.com [98.139.91.226]) by mail.postgresql.org (Postfix) with SMTP id D231813364DE for ; Mon, 7 Feb 2011 20:39:59 -0400 (AST) Received: from [98.139.91.61] by nm24.bullet.mail.sp2.yahoo.com with NNFMP; 08 Feb 2011 00:39:59 -0000 Received: from [98.139.91.30] by tm1.bullet.mail.sp2.yahoo.com with NNFMP; 08 Feb 2011 00:39:59 -0000 Received: from [127.0.0.1] by omp1030.mail.sp2.yahoo.com with NNFMP; 08 Feb 2011 00:39:59 -0000 X-Yahoo-Newman-Property: ymail-3 X-Yahoo-Newman-Id: 459546.86089.bm@omp1030.mail.sp2.yahoo.com Received: (qmail 94006 invoked by uid 60001); 8 Feb 2011 00:39:58 -0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s1024; t=1297125598; bh=NH9+FV+tz4u0E4tUThkuTaQdX+WDZoOf3jGtd3o3Lbg=; h=Message-ID:X-YMail-OSG:Received:X-Mailer:Date:From:Subject:To:In-Reply-To:MIME-Version:Content-Type; b=ch0b4Uaq8CagcTh8DxJnmMOsHOk9FPQ3m6aniCDRhn4YbkWez+bmOD9VnASMlXEx6WgshtW7PecdLI4z6Fr2qiWnUSAoXCdU101H0QmbNzKYU6Ogo79AGb+M4TOwD/xsoLemM8q0RpbN0idh2YrsoMjhLMemazYIFpsQD38QZ50= DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=s1024; d=yahoo.com; h=Message-ID:X-YMail-OSG:Received:X-Mailer:Date:From:Subject:To:In-Reply-To:MIME-Version:Content-Type; b=5PdAYze3KwYTUCcQuRN7aCW1zUlxIR21JbQQuEvXXd13hb6OQI8viDsgtaKlA2lQweSFGPUj/TRnr+rqe8kuS++r1Z4aTR4sETROiKchJ2vQw/Qkdehk4Nw+bkEpAKBtO9P6oetp9yrMR3zS8aOeR1dBpdz0euAS1sbUpwVGl4A=; Message-ID: <875278.93756.qm@web110709.mail.gq1.yahoo.com> X-YMail-OSG: cEPTQJEVM1mc4D_7lRRp.0BdfseUjo4PATtkdyAFCidO45o 1vu.22g2OryLQVgt66vlYempkNQF_rLxON3UfjYG4sq4W3PDcWHBsDKkaW6C IMIw57HbZA32Z1yJmLYuJR5ZeSlHJzw5cFWU0DAfX7vG_nuJ.drSEqVEiaNe kd.nMl730BZZRP7fjlW9m_k04A6mMvf8khx6HgaNGldbRKnfcWp73N8OOUCE 48hPZImUF72RPVwhljANjOO4yABdFyyBndqOUnK8xg0qCETcIP5pWDkP.tbM eHQVfAcPBQj8Zu2kTpN1yQ18MuOs.Dm1PZinW0iNassVgNJvfGwvDfTv94KN b4aC1E.tRIw7eqIVi7HHWmogU23cl9LroO4KubWBnKeEkV4n3q_xDLIXPXqD 7y9hCspUbIU4- Received: from [174.89.242.223] by web110709.mail.gq1.yahoo.com via HTTP; Mon, 07 Feb 2011 16:39:58 PST X-Mailer: YahooMailClassic/11.4.20 YahooMailWebService/0.8.108.291010 Date: Mon, 7 Feb 2011 16:39:58 -0800 (PST) From: Leslie S Satenstein Subject: Why Produce PDF files? To: PostgreSQL-documentation In-Reply-To: <201102071554.p17Fswe20719@momjian.us> MIME-Version: 1.0 Content-Type: multipart/alternative; boundary="0-855762279-1297125598=:93756" X-Virus-Scanned: Maia Mailguard 1.0.1 X-Spam-Status: No, hits=-1.907 tagged_above=-5 required=5 tests=BAYES_00=-1.9, FREEMAIL_FROM=0.001, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, RFC_ABUSE_POST=0.001, T_RP_MATCHES_RCVD=-0.01 X-Spam-Level: X-Archive-Number: 201102/37 X-Sequence-Number: 6385 --0-855762279-1297125598=:93756 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable 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, th= at pronouns that refer back to a noun, are not specific enough.=A0 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 precis= e, 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 som= e issues with the former. ------------------ Regards =20 =A0Leslie 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. =A0 mailto:lsatenstein@yahoo.com alternative: leslie.satenstein@itbms.biz=20 www.itbms.biz / www.eclipseguard.com =20 --- On Mon, 2/7/11, Bruce Momjian wrote: From: Bruce Momjian Subject: Re: [DOCS] [COMMITTERS] pgsql: remove tags. To: "Robert Haas" Cc: "Tom Lane" , "PostgreSQL-documentation" Date: Monday, February 7, 2011, 10:54 AM Robert Haas wrote: > On Mon, Feb 7, 2011 at 9:54 AM, Bruce Momjian wrote: > > Robert Haas wrote: > >> On Sun, Feb 6, 2011 at 11:12 PM, Tom Lane wrote: > >> > Bruce Momjian 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 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 ? > > It is easy to do but we should decide. >=20 > [ removing -hackers from CC also, no need to cross-post ] >=20 > Hmm.=A0 I'm starting to lean toward leaving this as you have it. >=20 > 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.=A0 I modified 19 to be like the rest.=20 I left where the context made sense. --=20 =A0 Bruce Momjian=A0 =A0 =A0 =A0 =A0 http://momjian.us =A0 EnterpriseDB=A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0 =A0=A0= =A0http://enterprisedb.com =A0 + It's impossible for everything to be true. + --=20 Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-docs --0-855762279-1297125598=:93756 Content-Type: text/html; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable

it appears that PDF files need no reforma= tting, 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, ar= e not specific enough.  One has to stop and think, --- to which noun i= s "this" (a pronoun) referring to.

I am not challenging the technica= l content, which I have found to be precise, but only that someone should p= roof read text to ensure good grammar.

No real improvement between p= df version 9.02 and 9.03, after I reported some issues with the former.
=
------------------

Regards


&= nbsp;Leslie
Mr. Leslie Satenstein
40 years in IT and = going strong.
Yesterday was a good day, today is a better day,
and to= morrow will be even better.
 
mailto:lsatenstein@yahoo.com
alt= ernative: leslie.satenstein@itbms.biz
www.itbms.biz / www.eclipseguard.= com


--- On Mon, 2= /7/11, Bruce Momjian <bruce@momjian.us> wrote:

From: Br= uce Momjian <bruce@momjian.us>
Subject: Re: [DOCS] [COMMITTERS] pg= sql: 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, T= om Lane <tgl@sss.pgh.pa.us> wrote:
> >> >= ; Bruce Momjian <bruce@momjian.us> writes:
> >>= ; >> Bruce Momjian wrote:
> >> >>> remove tags.
> &g= t;> >
> >> >> Sorry, vague commit message (I forgot= squash).
> >> >
> >> >> Can I will use gi= t ammend to improve this message?
> >>
> >> Absolut= ely not.
> >>
> >> > How about git revert, inste= ad? ?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 al= l 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 o= therwise 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 cros= s-post ]
>
> Hmm.  I'm starting to lean toward leaving th= is as you have it.
>
> Which way did we more commonly do it be= fore you applied this patch?

It was mostly like the line I have abov= e, meaning it was not in
fixed-width font, 95% I would say.  I modi= fied 19 to be like the rest.
I left <literal> where the context m= ade sense.

--
  Bruce Momjian  <bruce@momjia= n.us>        http://momjian.us
  EnterpriseDB    &nbs= p;                        ht= tp://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 subscri= ption:
http://www.postgresql.org/mailpref/pgsql-docs
--0-855762279-1297125598=:93756--