Re: Why Produce PDF files?

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Leslie S Satenstein <lsatenstein(at)yahoo(dot)com>
Cc: PostgreSQL-documentation <pgsql-docs(at)postgresql(dot)org>
Subject: Re: Why Produce PDF files?
Date: 2011-02-08 02:51:54
Message-ID: 201102080251.p182psn15223@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-committers pgsql-docs pgsql-hackers


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(at)yahoo(dot)com alternative: leslie(dot)satenstein(at)itbms(dot)biz
> www.itbms.biz / www.eclipseguard.com
>
>
> --- On Mon, 2/7/11, Bruce Momjian <bruce(at)momjian(dot)us> wrote:
>
> From: Bruce Momjian <bruce(at)momjian(dot)us> Subject: Re: [DOCS] [COMMITTERS]
> pgsql: remove tags. To: "Robert Haas" <robertmhaas(at)gmail(dot)com> Cc: "Tom
> Lane" <tgl(at)sss(dot)pgh(dot)pa(dot)us>, "PostgreSQL-documentation"
> <pgsql-docs(at)postgresql(dot)org> Date: Monday, February 7, 2011, 10:54 AM
>
> Robert Haas wrote:
> > On Mon, Feb 7, 2011 at 9:54 AM, Bruce Momjian <bruce(at)momjian(dot)us> wrote:
> > > Robert Haas wrote:
> > >> On Sun, Feb 6, 2011 at 11:12 PM, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:
> > >> > Bruce Momjian <bruce(at)momjian(dot)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(at)momjian(dot)us>? ? ? ? http://momjian.us ?
> EnterpriseDB? ? ? ? ? ? ? ? ? ? ? ? ? ???http://enterprisedb.com
>
> ? + It's impossible for everything to be true. +
>
> -- Sent via pgsql-docs mailing list (pgsql-docs(at)postgresql(dot)org) To make
> changes to your subscription:
> http://www.postgresql.org/mailpref/pgsql-docs

--
Bruce Momjian <bruce(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com

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

In response to

Browse pgsql-committers by date

  From Date Subject
Next Message Robert Haas 2011-02-08 03:03:35 Re: [COMMITTERS] pgsql: Implement genuine serializable isolation level.
Previous Message Bruce Momjian 2011-02-08 01:58:08 'literal' for numbers

Browse pgsql-docs by date

  From Date Subject
Next Message Daniel Grace 2011-02-08 21:30:13 Missing documentation for uses of extract(field from interval)
Previous Message Bruce Momjian 2011-02-08 02:00:16 Re: Change to documentation headers

Browse pgsql-hackers by date

  From Date Subject
Next Message Robert Haas 2011-02-08 03:03:35 Re: [COMMITTERS] pgsql: Implement genuine serializable isolation level.
Previous Message Robert Haas 2011-02-08 02:28:05 Re: Varlena and binary