[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

Re: [PATCH] issue#2317 - Problem with Peg Revisions for filescontaining '@' - V2

From: <kfogel_at_collab.net>
Date: 2005-07-06 04:25:46 CEST

Julian Foad <julianfoad@btopenworld.com> writes:
> kfogel@collab.net wrote:
> > Alexander, perhaps this meta-explanation will help with log messages:
> > The intended audience is a Subversion developer who is not familiar
> > with the change. Usually when someone goes back and reads a change
> > (which happens surprisingly frequently), they no longer have in their
> > head all the context around that change. They've forgotten the mails
> > about it, the issue, the code discussions, etc. It could be six
> > months later and they're porting it to a release branch and need to
> > review it, or something like that.
> > Your log message is the introduction to the change. Write it for an
> > experienced Subversion developer who is starting with no particular
> > knowledge of what this change is about, but who knows Subversion in
> > general.
>
> Karl, you are good at saying these kinds of things. It would be nice
> to be able to point people at some existing explanation each time,
> rather than trying to re-explain it each time. Therefore could you
> perhaps add the above to the "Writing log messages" secion of HACKING?

Okay, I've tried to do this in r15270. Further tweaks welcome!

-Karl

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Wed Jul 6 05:13:22 2005

This is an archived mail posted to the Subversion Dev mailing list.