Re: [PHP-DOC] When to update www.php.net/manual? From: Chris Adams (chris <email protected>)
Date: 08/07/00

> > On Mon, Aug 07, 2000 at 11:47:58PM +0200, eschmid+sic <email protected> wrote:
> >
> > > I vote for a cronjob.
> >
> > Perhaps every week or two weeks? Or is the goal to update the live
> > manual on an almost continuous basis?
>
> Another concern with a live-updating manual is that there might be stuff
> in there that is not in any released version of PHP. That can get
> confusing. Although, being able to immediately fix problems in the
> documentation and get them online probably outweighs this problem.
>
> -Rasmus

Would releasing documentation for unreleased features really be that big of
a problem if the version information is kept up to date? I think having
changes released quickly is much more important than a few people not
realizing that "(PHP4 >= 4.0.1)" means they can't use array_unique() with
3.0.12.

On a mostly unrelated note, would the internal structure of the version info
make it easy to produce a new/changed function listing between arbitrary
releases? As a developer I'd really love to have a page where I could see a
change history for the entire manual. I think it'd be better to key that off
of something like the version info field instead of CVS to avoid seeing a
ton of "Fixed typo" changes bury everything else.