Re: Release note bloat is getting out of hand

From: Andrew Dunstan <andrew(at)dunslane(dot)net>
To: 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>
Cc: "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 14:08:45
Message-ID: 54D0D66D.1030700@dunslane.net
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers


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.

cheers

andrew

In response to

Responses

Browse pgsql-hackers by date

  From Date Subject
Next Message Fabrízio de Royes Mello 2015-02-03 14:44:09 Re: Proposal : REINDEX xxx VERBOSE
Previous Message Kevin Grittner 2015-02-03 13:55:11 Re: Release note bloat is getting out of hand