Mu2e Home
Release Notes

There are two places to document changes that you make to the code. One is in the cvs commit comments and the other is in the release notes. I want comments within the code to describe only current behaviour of the code, not its history; we have cvs to maintain history. The role of the release notes is:

If you are making truly trivial changes to the code, for example just changes to comments, there is no reason to document this in the release notes files. It is enough to document it in the cvs commit comments.

When commiting files it will sometimes be useful to refer to the release notes in the commit comments.

When you check out Offline, you will see a subdirectory named ReleaseNotes, which contains subdirectories v0 and v1; later on it will get v2, v3 and so on. You can also view the ReleaseNotes via the code browser.

The directory ReleaseNotes/v1 contains files with names like, v1_0_0.txt, v1_0_1.txt and so on. Each file holds the release notes for a tagged version of our Offline code. The file v1_0_0.txt holds the release notes for version v1_0_0 and so on.

Here is the tricky part. Once we tag the cvs HEAD with a version number, all new commits will become part of the tag with the next version number. Suppose, for example, that the last tag was v1_0_8 and that the next tag will be v1_0_9; in this example new commits should be documented in the file v1_0_9.txt

Normally it will be safe to find the file with the highest version number and to add your information to that file. On rare occasions, I have done a tag and forgotten to make the next release notes file. If you notice this, fix it yourself and then let me know. When you add information to a release notes file, use the previous entries as a model.

After you have editted the release notes, remember to commit your changes!

Fermilab at Work ]  [ Mu2e Home ]  [ Mu2e @ Work ]  [ Mu2e DocDB ]  [ Mu2e Search ]

For web related questions:
For content related questions:
This file last modified Monday, 05-Mar-2012 17:23:10 CST
Security, Privacy, Legal Fermi National Accelerator Laboratory