Re: Why Produce PDF files? - Mailing list pgsql-docs

From Bruce Momjian
Subject Re: Why Produce PDF files?
Date
Msg-id 201102080251.p182psn15223@momjian.us
Whole thread Raw
In response to Why Produce PDF files?  (Leslie S Satenstein <lsatenstein@yahoo.com>)
List 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. +

pgsql-docs by date:

Previous
From: Bruce Momjian
Date:
Subject: Re: Change to documentation headers
Next
From: Daniel Grace
Date:
Subject: Missing documentation for uses of extract(field from interval)