Ramblings of Narc

SVN is cute. But you should include the projects touched by each commit when you make it.

In fact, the template should look like this:

(CommaSeparated,ListOf,Projects) Summary: This is a short summary of
what this revision changes (for the better, one would hope).

- This is one item of the detailed changes.
- This is another item. The change detailed here includes an API
change, so we mark it. [CA]
- This is just another sample item. If it included an API change, we'd
use CA to mark it, too.

Deps: rev 77 SomeProject, rev 63 SomeOtherProject

Note that Deps can be omitted altogether, in which case it’s assumed the revision doesn’t depend on any specific revision of another project.

I might remove the whole Deps thing altogether, it seems a bit useless, IMO.

Update: The text “Summary:” can also be omitted, as it is expected the first line will be a comma-separated list of projects in parens, and a summary line.