Re: Release note bloat is getting out of hand - Mailing list pgsql-hackers

From David Fetter
Subject Re: Release note bloat is getting out of hand
Date
Msg-id 20150203150014.GA32623@fetter.org
Whole thread Raw
In response to Re: Release note bloat is getting out of hand  (Andrew Dunstan <andrew@dunslane.net>)
Responses binworld and install-binworld targets - was Re: Release note bloat is getting out of hand  (Andrew Dunstan <andrew@dunslane.net>)
List 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@sss.pgh.pa.us> wrote:
> >>Josh Berkus <josh@agliodbs.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@fetter.org> http://fetter.org/
Phone: +1 415 235 3778  AIM: dfetter666  Yahoo!: dfetter
Skype: davidfetter      XMPP: david.fetter@gmail.com

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



pgsql-hackers by date:

Previous
From: Magnus Hagander
Date:
Subject: Re: Release note bloat is getting out of hand
Next
From: Kevin Grittner
Date:
Subject: Re: Redesigning checkpoint_segments