Subject: Re: Please stop change logs in CVS commit messages
To: Todd Vierling <tv@wasabisystems.com>
From: Nathan Ahlstrom <nrahlstr@winternet.com>
List: tech-pkg
Date: 07/10/2001 14:04:45
Sorry for the excessive change log. I will trim them more in the future.
Todd Vierling <tv@wasabisystems.com> wrote:
> This practice of committing with changelogs has got to stop. People have
> asked why I think it's a stupid idea and have "suggested" that I do so in my
> commits, and I'm continuing to refuse to do so. Attached you'll find a
> perfect counterexample that shows how unreasonable this policy is.
>
> All this does is add a lot more clutter to CVS files, and has very little
> advantage otherwise. Remember that if you commit with a big commit message,
> *every* file touched with that commit grows by that amount in the CVS
> repository.
>
> Leave documentation files to provide documentation. That's not what CVS
> commit logs are meant to hold. If you want more descriptive change log
> entries, how about a short manually written note that describes why a
> package is added or upgraded? (And yes, "many bug fixes" should be
> sufficient.)
>
> : Module Name: doc
> : Committed By: nra
> : Date: Tue Jul 10 17:53:18 UTC 2001
> :
> : Modified Files:
> : doc: pkg-CHANGES
> :
> : Log Message:
> : Note update of xpmroot to version 2.4.0. PR #13374 by Martti Kuparinen.
> :
> [*40K* of change log entries]
>
> --
> -- Todd Vierling <tv@wasabisystems.com> * Wasabi NetBSD: Run with it.
> -- NetBSD 1.5 now available on CD-ROM -- http://www.wasabisystems.com/
--
Nathan Ahlstrom / nra@NetBSD.org / nra@FreeBSD.org / GPG: 0x67BC9D19