From owner-cvs-all Mon Jun 17 7:32:10 2002 Delivered-To: cvs-all@freebsd.org Received: from axl.seasidesoftware.co.za (axl.seasidesoftware.co.za [196.31.7.201]) by hub.freebsd.org (Postfix) with ESMTP id 5149537B410; Mon, 17 Jun 2002 07:31:58 -0700 (PDT) Received: from sheldonh (helo=axl.seasidesoftware.co.za) by axl.seasidesoftware.co.za with local-esmtp (Exim 3.36 #1) id 17JxYS-000Bf5-00; Mon, 17 Jun 2002 16:32:28 +0200 From: Sheldon Hearn To: Will Andrews Cc: Kris Kennaway , cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: Verbose commit messages (Re: cvs commit: ports/deskutils/kdepim3 Makefile distinfo pkg-plist ports/deskutils/kdepim3/files patch-icallangbind.c patch-parseholiday.y patch-vcc.y patch-vobject.c patch-y_tab.c ports/audio/arts Makefile distinfo ports/audio/kdemultimedia3 Makefile distinfo ...) In-reply-to: Your message of "Sat, 15 Jun 2002 18:57:06 EST." <20020615235706.GE53809@squall.waterspout.com> Date: Mon, 17 Jun 2002 16:32:28 +0200 Message-ID: <44830.1024324348@axl.seasidesoftware.co.za> Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG On Sat, 15 Jun 2002 18:57:06 EST, Will Andrews wrote: > > Informative commit messages can be great, but please try and remember > > the repo bloat when you write long commit messages for commits which > > touch large numbers of files. > > > > This single commit added close to a megabyte to the ports repo. > > You're right. It takes too long to commit the update with the > individual ports, since there are usually hundreds of files > updated in each upgrade, not to mention that doing them > individually loses atomicity. So perhaps what I'll do next time > is just keep the first line and point to a changelog on a website. > And perhaps follow up to the commit message with the contents of > that changelog. I really like seeing this detail in CVS, but Kris has a point. Maybe you could use a one-liner for "all the files", including "see revision history for x11/kde for more detauls", and then the long message in a follow-up commit to x11/kde (or whatever the big daddy port for this is)? Ciao, Sheldon. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message