Re: [COMMITTERS] pgsql-server/doc/src/sgml Makefile

From: Bruce Momjian <pgman(at)candle(dot)pha(dot)pa(dot)us>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: Peter Eisentraut <peter_e(at)gmx(dot)net>, PostgreSQL-documentation <pgsql-docs(at)postgresql(dot)org>, "Marc G(dot) Fournier" <scrappy(at)hub(dot)org>
Subject: Re: [COMMITTERS] pgsql-server/doc/src/sgml Makefile
Date: 2004-03-09 18:13:01
Message-ID: 200403091813.i29ID1427492@candle.pha.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-committers pgsql-docs

Tom Lane wrote:
> Bruce Momjian <pgman(at)candle(dot)pha(dot)pa(dot)us> writes:
> >> Peter Eisentraut <peter_e(at)gmx(dot)net> writes:
> >>> A better approach for that would be to remove HISTORY from CVS and build
> >>> it only when the release tarball is made.
>
> > I think the only reason HISTORY and INSTALL are in CVS is because we
> > want people running CVS during beta to have changes docs and install
> > instructions that don't require them to pull down a new tarball each
> > time or read the docs via a web site.
>
> That argument seems a bit silly for HISTORY, seeing that it's generally
> not up-to-date during beta testing. As for INSTALL, those instructions
> don't change fast enough to surprise beta testers, so I'm not convinced
> about it either.

Actually, recent releases had a current HISTORY before beta started.
However, if they are downloading the beta tarballs, the HISTORY/INSTALL
files are already generated. It would only be useful for CVS pulls
during beta though.

One idea would be to replace file content with a single URL that points
to the development docs, then when the tarball is built, it can
overwrite those files.

Marc?

--
Bruce Momjian | http://candle.pha.pa.us
pgman(at)candle(dot)pha(dot)pa(dot)us | (610) 359-1001
+ If your life is a hard drive, | 13 Roberts Road
+ Christ can be your backup. | Newtown Square, Pennsylvania 19073

In response to

Responses

Browse pgsql-committers by date

  From Date Subject
Next Message Tom Lane 2004-03-09 18:16:58 Re: [COMMITTERS] pgsql-server/doc/src/sgml Makefile
Previous Message Tom Lane 2004-03-09 18:00:52 Re: pgsql-server/doc/src/sgml Makefile

Browse pgsql-docs by date

  From Date Subject
Next Message Tom Lane 2004-03-09 18:16:58 Re: [COMMITTERS] pgsql-server/doc/src/sgml Makefile
Previous Message Tom Lane 2004-03-09 18:00:52 Re: pgsql-server/doc/src/sgml Makefile