1 |
|
<html> |
2 |
|
<head> |
3 |
|
</head> |
4 |
|
<body> |
5 |
GCMPACK CVS policies |
GCMPACK CVS policies |
6 |
==================== |
==================== |
7 |
|
|
17 |
tracked. If CVS is used without any other policy the result can be a |
tracked. If CVS is used without any other policy the result can be a |
18 |
collection of files each of which has complex, multiply branched set of |
collection of files each of which has complex, multiply branched set of |
19 |
interelated versions. This sort of CVS repository can be come like a |
interelated versions. This sort of CVS repository can be come like a |
20 |
library where books are simply stored in a huge heap. Although nothing is actually lost, the task of finding a coherent collection of material soon |
library where books are simply stored in a huge heap. Although nothing is |
21 |
|
actually lost, the task of finding a coherent collection of material soon |
22 |
becomes impossible. |
becomes impossible. |
23 |
|
|
24 |
The policies we employ address two areas |
The policies we employ address two areas |
84 |
|
|
85 |
3. Testing |
3. Testing |
86 |
|
|
87 |
|
Things in a checkpoint tree require a test case that |
88 |
|
can be used to validate the component. |
89 |
|
|
90 |
4. Checkpoint tagging |
4. Checkpoint tagging |
91 |
|
|
92 |
|
No code should be left in limbo. Checking in code and then |
93 |
|
leaving it in the repository untagged is bad. When you check |
94 |
|
in code you are creating a new checkpoint. That means you don't |
95 |
|
check in some code which you "know" works 100% and then go away |
96 |
|
for two weeks. When you start checking in code you make sure |
97 |
|
you have time to do the process end-to-end as described in section |
98 |
|
2. |
99 |
|
|
100 |
5. Release tagging |
5. Release tagging |
101 |
|
|
102 |
|
Releases are only based on checkpoint tree code. Maintenance fixes |
103 |
|
to releases are also maintained within the checkpoint tree. Files |
104 |
|
within a release must have accompanying documentation. The form of this |
105 |
|
documentation depends on the file type. |
106 |
|
|
107 |
6. Branches |
6. Branches |
108 |
|
|
109 |
Branches are to be used for bug-fixes and code patches to releases |
Branches are to be used for bug-fixes and code patches to releases |
127 |
Watch this space! |
Watch this space! |
128 |
|
|
129 |
Questions, comments e-mail: gcmpack.code.czars@mitgcm.org |
Questions, comments e-mail: gcmpack.code.czars@mitgcm.org |
130 |
|
</body> |
131 |
|
</html> |