[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: [SPAM] Re: [updated PATCH] %language declaration

From: Paul Eggert
Subject: Re: [SPAM] Re: [updated PATCH] %language declaration
Date: Wed, 13 Dec 2006 09:55:52 -0800
User-agent: Gnus/5.1008 (Gnus v5.10.8) Emacs/21.4 (gnu/linux)

"Joel E. Denny" <address@hidden> writes:

> Do you use `make alpha', `make distcheck', or something else to roll the 
> tarball?

I don't use 'make alpha'; it doesn't work.  I can't remember now whether
I use make distcheck or make maintainer-check; probably both.

('make alpha' is high-maintenance, and nobody has the time to maintain
it right now.)

>> Can we reword this documentation to not need
>> the version number?
> That implies that we should never refer to the next release in the manual.

As a general rule, the manual should explain only the current Bison
release.  The manual is not a good place to discuss what we might do
in the future, or what things looked like in the past, as typically
such discussions overly complicate the explanation of the present
situation.  Plus, these discussions make the manual harder to maintain
-- and it's important to keep the manual easy to maintain.

For future stuff, TODO is the usual place.

For past stuff, NEWS and/or ChangeLog is the usual place.

(There are exceptions to this general rule of course.)

reply via email to

[Prev in Thread] Current Thread [Next in Thread]