* Michael G Schwern ([EMAIL PROTECTED]) [19 Aug 2003 00:15]: > On Mon, Aug 18, 2003 at 10:11:23PM +1000, Iain Truskett wrote: > > Strictly speaking, the F<ChangeLog> is a log of changes, > > usually extracted straight from version control software > > (e.g. C<< svn log > ChangeLog >>). > > > > The F<Changes> file is more a user-oriented description of > > the net effect of the individual changes.
> Says who? Actually, s/Strictly speaking/Ideally/ It's the closest thing to a convention I've observed in the various change files I've been reading on CPAN. In my view, it's a decent convention to have. And I'm sure I read it somewhere in the docs at some point, but damned if I know where. Most raw change logs extracted from repositories aren't useful enough to the average raw user since they don't just summarise what's new, what's deprecated, what's gone. At the very least, I think it's something that should be encouraged. A lot of the ancillary files don't get much of a look in in the perldocs. cheers, -- Iain.
