Ryan Schmidt wrote: >> Hmm, I thought ChangeLog was in chronological order (which you >> just broke) ? > > Since the ChangeLog is something the casual user might be expected > to read, it should be concise and organized. > > The Subversion log is in chronological order. The ChangeLog should > not merely duplicate the Subversion log. Rather, it should have one > entry per logical change. > > I would also say that the most important changes should be first in > the ChangeLog, so that a user who begins to read it but gives up > before reaching the end learns the most important things anyway. > > Such rearrangement and consolidation of the ChangeLog is probably > something the release manager should do right before a release. I'm > just trying to get a head start.
A matter of conventions, I suppose. I normally have "NEWS" as the user-readable, and ChangeLog for development. The version control log is more like "end of day commit, fix typo, oops move that function, missed a file" etc. --anders _______________________________________________ macports-dev mailing list [email protected] http://lists.macosforge.org/mailman/listinfo.cgi/macports-dev
