Received: from maia.hub.org (maia-5.hub.org [200.46.204.29]) by mail.postgresql.org (Postfix) with ESMTP id 559A01337BA8 for ; Wed, 22 Dec 2010 18:08:28 -0400 (AST) Received: from mail.postgresql.org ([200.46.204.86]) by maia.hub.org (mx1.hub.org [200.46.204.29]) (amavisd-maia, port 10024) with ESMTP id 99030-04 for ; Wed, 22 Dec 2010 22:08:21 +0000 (UTC) X-Greylist: domain auto-whitelisted by SQLgrey-1.7.6 Received: from nm21-vm0.bullet.mail.sp2.yahoo.com (nm21-vm0.bullet.mail.sp2.yahoo.com [98.139.91.220]) by mail.postgresql.org (Postfix) with SMTP id D754B133616B for ; Wed, 22 Dec 2010 18:08:19 -0400 (AST) Received: from [98.139.91.64] by nm21.bullet.mail.sp2.yahoo.com with NNFMP; 22 Dec 2010 22:08:18 -0000 Received: from [98.139.91.60] by tm4.bullet.mail.sp2.yahoo.com with NNFMP; 22 Dec 2010 22:08:18 -0000 Received: from [127.0.0.1] by omp1060.mail.sp2.yahoo.com with NNFMP; 22 Dec 2010 22:08:18 -0000 X-Yahoo-Newman-Property: ymail-3 X-Yahoo-Newman-Id: 458296.58022.bm@omp1060.mail.sp2.yahoo.com Received: (qmail 39671 invoked by uid 60001); 22 Dec 2010 22:08:18 -0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s1024; t=1293055697; bh=KoIovCzv1c1uOBjRaPerKBLy3Dp4NER0MfX4IZzZAbk=; h=Message-ID:X-YMail-OSG:Received:X-Mailer:Date:From:Subject:To:Cc:In-Reply-To:MIME-Version:Content-Type; b=nAFVV4n2DhqLocYEQRr7NRRisIvm8TDNXQwU53zGsqfGncr0bKnta8aVJIeQ7jIBAQXgyW1TUycNemhKKEiWsPOrT8U6D9Xp8LDAVfboANG/kXS2wH/Aiv3mjDyv0sNCQmA46fnEkdyKHUMJwdNrPtixYmolHx0IX0gYveaqOu0= 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:Cc:In-Reply-To:MIME-Version:Content-Type; b=jsCkmgcoayrhkU3ptnW557Jp2x42ySIO8D8TnvEjuQUxY1FN/OVHK9RSVrwD/+duzh6jYjn2NM8D+kLhcKxVruaBspUUG8QhtPB+FoSQVibamV3ymZ0+yG3fgkaEoyPFpvE66RiZUT/XxBMHawacaKjrO73hoZ9tTFhx+6J4QnE=; Message-ID: <928638.38398.qm@web110710.mail.gq1.yahoo.com> X-YMail-OSG: p7QsUNUVM1nMXZVZV_FeVPTkIhl9OT0xw5cIwKbVmn3GIB0 EV6dGgASX8NIh3Ebtr0cT52vCJgJzie2pm_ihXYDXiUGoQQ3MKbK1kSYj_9p 8Cm0g9ogrfFPVvx8txylRwETQbgcgGuETygA5pnqq5k8fCT2wHBHVvQmAjIm 25r0Y0yB3n6RFTaenvXuSEnx_t3gx2Q1P9RMhqbn_.vXevbipjkl4NWIAErh rfulanaULvhcfIbmNDLpr_9piwvDjxo_8Z.HtdMFUDILoCwmD40sZabbWn7u a6EXYSlKJ1ecZCCaW0MYibZlkgG5sW6sjz.HZ7OaUaZ0HNEzKoEwXwMQgn.e gytznDcT3kaXxjDQRV.8PuX7Yw7j17rMtEdzMImTQ2BuBKIlBKIaEL6bzrWh qFU5qVhwdEnU- Received: from [65.94.247.127] by web110710.mail.gq1.yahoo.com via HTTP; Wed, 22 Dec 2010 14:08:17 PST X-Mailer: YahooMailClassic/11.4.20 YahooMailWebService/0.8.107.285259 Date: Wed, 22 Dec 2010 14:08:17 -0800 (PST) From: Leslie S Satenstein Subject: Re: Grammar and formatting errors for 9.02 pdf version To: Robert Haas Cc: pgsql-docs In-Reply-To: MIME-Version: 1.0 Content-Type: multipart/alternative; boundary="0-1396342215-1293055697=:38398" 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: 201012/34 X-Sequence-Number: 6270 --0-1396342215-1293055697=:38398 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable --- On Tue, 12/21/10, Robert Haas wrote: From: Robert Haas Subject: Re: [DOCS] Grammar and formatting errors for 9.02 pdf version To: "Leslie S Satenstein" Cc: "pgsql-docs" Date: Tuesday, December 21, 2010, 10:56 PM On Tue, Dec 21, 2010 at 10:43 PM, Leslie S Satenstein wrote: > > Hi Robert, I am not familiar with your patch process.=A0 However, I can c= opy and paste the offending lines in the PDF file, to a word or openoffice = document, and use green for insert and red text for delete and yellow for e= laboration or comments.=A0 And of course, as well, to identify the page fro= m the pdf guide. > > Some text, if rephrased, makes the meaning more clear. Some text has miss= ing nouns and where several nouns precede a pronoun,=A0 it causes a delay a= s one stops to analyze the sentence in order to extract the author's meanin= g. > > If there is a better way, please advise me. Please keep replies on-list, and write your replies beneath the quoted text rather than above it. To submit a patch, you need to check out the source code, edit the SGML documentation, and then use git diff.=A0 See: http://wiki.postgresql.org/wiki/Submitting_a_Patch In short: git clone git://git.postgresql.org/git/postgresql.git git diff > grammar.patch If you have only a handful of changes, feel free to just point out the parts that you think could be phrased better and how you think they should be written, rather than generating a patch.=A0 Actually, it'd probably be better to point out the first few changes that way anyhow, to see if we agree with your opinions on what should be done.=A0 If you're submitting a large number of edits, you're going to have to learn how to generate a patch file as per the above, because otherwise it's going to be extremely laborious for anyone to think about applying your changes. -- Robert Haas EnterpriseDB: http://www.enterprisedb.com The Enterprise PostgreSQL Company Hi Robert. Since Yahoo.com does not allow me to respond as an append, please excuse th= e formatting that takes place in the left margin. =A0 For this time, please use html for reading this email. Here is an example of how I was thinking to proceed but=0A using a word doc= ument so that formatting would be respected.=A0 I would =0Apresent the page= in word, and then identify the changes with red/green.=A0=0A To keep this = email short, I am showing only a very few changes. Green is for an insertio= n, Red is for a deletion.=A0 Yellow is for clarification PDF 9.02 Page 591, bottom tty Ignored (formerly, this parameter specified where to send server debug outp= ut). Word parameter is inserted. Page 594 Text below is truncated as it goes beyond the right margin Make a connection to the database server in a nonblocking manner. PGconn *PQconnectStartParams(const char **keywords, const char **values, in= t expand_dbname); =A0 Page 595 To begin a nonblocking connection callexecute conn =3D Further down IfAfter PQconnectStart succeeds ... Leaving the opening If ..... in my mind says, what to do if it does not suc= ceed then what?=A0 By writing after PQConnectStart succeeds... takes away l= iability. There=0A is some rewording that I would do on later pages.=A0 Why do I brin= g these=0A changes up for review, because of Latin readers (French/ Spanish= =0Areaders are translating the English and therefore good=0A precision is = needed). Living in Quebec Canada, and doing business in =0ALatin America, I= have become trilingual and write software and =0Adocumentation in these ad= ditional languages. Oh yes, in this chapter 31, protocol is mentioned several times.=A0 But the= very first time protocol is defined or explained is in chapter 46.=A0 I be= lieve that a forward reference is required before the first mention of this= property (page 602). Regards Bien =E0 vous Leslie --0-1396342215-1293055697=:38398 Content-Type: text/html; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable

--- On Tue, 12/21/10, Robert Haas &= lt;robertmhaas@gmail.com> wrote:
From: Robert Haas <robertmhaas@gmail.com>
Subject: Re: [DOCS] Gra= mmar and formatting errors for 9.02 pdf version
To: "Leslie S Satenstein= " <lsatenstein@yahoo.com>
Cc: "pgsql-docs" <pgsql-docs@postgres= ql.org>
Date: Tuesday, December 21, 2010, 10:56 PM

On Tue, Dec 21, 2010 at 10:43 PM, Leslie S Satenstein
<= ;lsatenstein@yahoo.com> wrote:
>
> Hi R= obert, I am not familiar with your patch process.  However, I can copy= and paste the offending lines in the PDF file, to a word or openoffice doc= ument, and use green for insert and red text for delete and yellow for elaboration or com= ments.  And of course, as well, to identify the page from the pdf guid= e.
>
> Some text, if rephrased, makes the meaning more clear. S= ome text has missing nouns and where several nouns precede a pronoun, = it causes a delay as one stops to analyze the sentence in order to extract= the author's meaning.
>
> If there is a better way, please adv= ise me.

Please keep replies on-list, and write your replies beneath = the quoted
text rather than above it.

To submit a patch, you need= to check out the source code, edit the
SGML documentation, and then use= git diff.  See:

http://wiki.postgresql.org/wiki/Submitti= ng_a_Patch

In short:

git clone git://git.postgresql.org/g= it/postgresql.git
<make your changes in doc/src/sgml>
git diff > grammar.patch
<email the patch file to pgsql-docs>
<= br>If you have only a handful of changes, feel free to just point out theparts that you think could be phrased better and how you think they
sh= ould be written, rather than generating a patch.  Actually, it'd
pr= obably be better to point out the first few changes that way anyhow,
to = see if we agree with your opinions on what should be done.  If
you'= re submitting a large number of edits, you're going to have to
learn how= to generate a patch file as per the above, because otherwise
it's going= to be extremely laborious for anyone to think about
applying your chang= es.

--
Robert Haas
EnterpriseDB: http://www.enterprisedb.com
The Enterpr= ise PostgreSQL Company


Hi Robert.
Since Yahoo.com does not al= low me to respond as an append, please excuse the formatting that takes place in the left margin.

 
For this time, please use html = for reading this email.

Here is an example of how I was thinking to = proceed but=0A using a word document so that formatting would be respected.=   I would =0Apresent the page in word, and then identify the changes w= ith red/green. =0A To keep this email short, I am showing only a very = few changes. Gre= en is for an insertion, Red is for a deletion.  Yellow is for clar= ification

PDF 9.02 Page 591, bottom
tty

Ignored (formerly,= this parameter specified wh= ere to send server debug output).

Word parameter is inserted.
Page 594
Text below= is truncated as it goes beyond the right margin

Make a connection to the database server in a nonbl= ocking manner.
callexecute= conn =3D

Further down

<= span style=3D"color: rgb(255, 0, 0);">If= After PQconnectStart suc= ceeds ...

Leaving the opening If ..... in my mi= nd says, what to do if it does not succeed then what?  By writing afte= r PQConnectStart succeeds... takes away liability.

There=0A is some = rewording that I would do on later pages.  Why do I bring these=0A cha= nges up for review, because of Latin readers (French/ Spanish =0Areaders ar= e translating the English and therefore good=0A precision is needed). Livin= g in Quebec Canada, and doing business in =0ALatin America, I have become t= rilingual and write software and =0Adocumentation in these additional langu= ages.

Oh yes, in this chapter 31, protocol is mentioned several time= s.  But the very first time protocol is defined or explained is in cha= pter 46.  I believe that a forward reference is required before the fi= rst mention of this property (page 602).

Regards
Bien =E0 vous
Leslie
--0-1396342215-1293055697=:38398--