Re: Release note bloat is getting out of hand

From: David Fetter <david(at)fetter(dot)org>
To: Andrew Dunstan <andrew(at)dunslane(dot)net>
Cc: Kevin Grittner <kgrittn(at)ymail(dot)com>, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Josh Berkus <josh(at)agliodbs(dot)com>, "pgsql-hackers(at)postgresql(dot)org" <pgsql-hackers(at)postgresql(dot)org>, Peter Eisentraut <peter_e(at)gmx(dot)net>
Subject: Re: Release note bloat is getting out of hand
Date: 2015-02-03 15:00:14
Message-ID: 20150203150014.GA32623@fetter.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On Tue, Feb 03, 2015 at 09:08:45AM -0500, Andrew Dunstan wrote:
>
> On 02/03/2015 08:55 AM, Kevin Grittner wrote:
> >Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> wrote:
> >>Josh Berkus <josh(at)agliodbs(dot)com> writes:
> >>>On 02/02/2015 05:39 PM, Peter Eisentraut wrote:
> >>>>I share the sentiment that the release notes *seem* too big, but the
> >>>>subsequent discussion shows that it's not clear why that's really a
> >>>>problem. Exactly what problem are we trying to fix?
> >>>At a rough count of lines, the release notes for unsupported versions
> >>>are about 18% of documentation overall (47K out of 265K lines). So
> >>>they're not insubstantial. Compared to the total size of the tarball,
> >>>though ...
> >>It would not make that much of a difference in tarball size, agreed.
> >>It *would* make a difference in the build time and output size of the
> >>SGML docs --- as I mentioned at the outset, the release notes currently
> >>account for 25% of the SGML source linecount.
> >I run `make -s -j4 world` on my i7 fairly often, and it is often
> >the doc build that I wind up waiting for at the end.
>
> I realize this is slightly OT, but I wonder if it might be worth having
> targets that build and install everything but the docs.

That'd be great.

Cheers,
David.
--
David Fetter <david(at)fetter(dot)org> http://fetter.org/
Phone: +1 415 235 3778 AIM: dfetter666 Yahoo!: dfetter
Skype: davidfetter XMPP: david(dot)fetter(at)gmail(dot)com

Remember to vote!
Consider donating to Postgres: http://www.postgresql.org/about/donate

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Kevin Grittner 2015-02-03 15:00:20 Re: Redesigning checkpoint_segments
Previous Message Magnus Hagander 2015-02-03 14:53:28 Re: Release note bloat is getting out of hand