pg.ddx.io pgsql-docs@postgresql.org mailing list archive
help / color / mirror / Atom feedWhy Produce PDF files?
2+ messages / 2 participants
[nested] [flat]
* Why Produce PDF files?
@ 2011-02-08 00:39 Leslie S Satenstein <lsatenstein@yahoo.com>
2011-02-08 02:51 ` Re: Why Produce PDF files? Bruce Momjian <bruce@momjian.us>
0 siblings, 1 reply; 2+ messages in thread
From: Leslie S Satenstein @ 2011-02-08 00:39 UTC (permalink / raw)
To: pgsql-docs
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
^ permalink raw reply [nested|flat] 2+ messages in thread
* Re: Why Produce PDF files?
2011-02-08 00:39 Why Produce PDF files? Leslie S Satenstein <lsatenstein@yahoo.com>
@ 2011-02-08 02:51 ` Bruce Momjian <bruce@momjian.us>
0 siblings, 0 replies; 2+ messages in thread
From: Bruce Momjian @ 2011-02-08 02:51 UTC (permalink / raw)
To: Leslie S Satenstein <lsatenstein@yahoo.com>; +Cc: pgsql-docs
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. +
^ permalink raw reply [nested|flat] 2+ messages in thread
end of thread, other threads:[~2011-02-08 02:51 UTC | newest]
Thread overview: 2+ messages (download: mbox mbox.gz follow: Atom feed)
-- links below jump to the message on this page --
2011-02-08 00:39 Why Produce PDF files? Leslie S Satenstein <lsatenstein@yahoo.com>
2011-02-08 02:51 ` Bruce Momjian <bruce@momjian.us>
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