Index: palm/trunk/DOC/tec/technical_documentation.html
===================================================================
--- palm/trunk/DOC/tec/technical_documentation.html	(revision 486)
+++ palm/trunk/DOC/tec/technical_documentation.html	(revision 493)
@@ -1,4 +1,6 @@
 <!DOCTYPE html PUBLIC "-//w3c//dtd html 4.0 transitional//en">
 <html><head>
+
+
 
 
@@ -27,6 +29,7 @@
 </p><ul> <a href="#Kapitel1.0">1.0</a>&nbsp;
 History of changes <p><a href="#Kapitel2.0">2.0</a>&nbsp;
-How to change the model source
-code </p> <p><a href="#Kapitel3.0">3.0</a>&nbsp;
+How to change the source
+code and how to document modifications<br>
+ </p> <p><a href="#Kapitel3.0">3.0</a>&nbsp;
 Description of selected model numerics<br>
 &nbsp;</p>
@@ -917,9 +920,92 @@
 <br>&nbsp;
 <h2><a name="Kapitel2.0"></a>2.0&nbsp; How
-to change the model source
-code</h2>Currently
+to change the source
+code and how to document modifications<br>
+</h2>Currently
 (Sep 23rd, 2009), only selected users are allowed to commit changes to
-the repository. Some rules about how to check in modified code will be
-added later.<br>
+the repository. Rules given below are preliminary, until we have switched to the "trac"-System.<br>
+<br>
+<ol>
+  <li>Change source code in your current working copy. Document changes in the respective file headers unter "<span style="font-family: Courier New,Courier,monospace;">Current revisions:</span>".
+Additionally, document all changes in a local file (e.g.
+~/palm/current_version/CURRENT_MODIFICATIONS), including the files that
+have been changed. Classify changes in three cases, new (N), changed
+(C), and bugfix (B). <span style="font-weight: bold;">Try to be as short and as precise as possible in describing the changes!</span><br>
+    <br>
+  </li>
+  <li>Test the changed version, unless it works sufficiently.<br>
+    <br>
+  </li>
+  
+  <li>Commit the changes to the repository<br>
+    <br>
+    <span style="font-family: Courier New,Courier,monospace;">&nbsp;&nbsp; svn commit -m "message string" trunk<br>
+    </span><br>
+where "<span style="font-family: Courier New,Courier,monospace;">message string</span>" is a short, <span style="font-weight: bold;">meaningful</span> summary of the changes.<br>
+    <br>
+Alternatively, in case that you have made quite a lot of changes, you
+can also give the contents of your file CURRENT_MODIFICATIONS as the
+log message:<br>
+    <br>
+    <span style="font-family: Courier New,Courier,monospace;">&nbsp;&nbsp; svn commit -F CURRENT_MODIFICATIONS trunk</span><br>
+    <br>
+  </li>
+
+  <li>Enter the changes into the technical documentation (under <span style="font-family: Courier New,Courier,monospace;">.../trunk/DOC/tec/technical_documentation.html</span>).<br>
+    <br>
+  </li>
+  <li>Move the change comments in the file headers from "Current
+revisions:" to "Former revisions:". Set the current svn id in front of
+that.<br>
+    <br>
+    <span style="font-weight: bold;">Example:</span><br>
+    <br>
+    <span style="font-weight: bold;">before move:</span><br>
+    <br>
+    <span style="font-family: Courier New,Courier,monospace;">! Current revisions:</span><br style="font-family: Courier New,Courier,monospace;">
+    <span style="font-family: Courier New,Courier,monospace;">! -----------------</span><br style="font-family: Courier New,Courier,monospace;">
+    <span style="font-family: Courier New,Courier,monospace;">! <span style="font-weight: bold;">new dummy argument abcd</span></span><span style="font-family: Courier New,Courier,monospace;"></span><br style="font-family: Courier New,Courier,monospace;">
+    <span style="font-family: Courier New,Courier,monospace;">!</span><br style="font-family: Courier New,Courier,monospace;">
+    <span style="font-family: Courier New,Courier,monospace;">! Former revisions:</span><br style="font-family: Courier New,Courier,monospace;">
+    <span style="font-family: Courier New,Courier,monospace;">! -----------------</span><br style="font-family: Courier New,Courier,monospace;">
+    <span style="font-family: Courier New,Courier,monospace;">! $Id$</span><br style="font-family: Courier New,Courier,monospace;">
+    <span style="font-family: Courier New,Courier,monospace;">!</span><br style="font-family: Courier New,Courier,monospace;">
+    <span style="font-family: Courier New,Courier,monospace;"></span><span style="font-family: Courier New,Courier,monospace;"></span><span style="font-family: Courier New,Courier,monospace;"></span><span style="font-family: Courier New,Courier,monospace;">! 407 2009-12-01 15:01:15Z maronga</span><br style="font-family: Courier New,Courier,monospace;">
+    <span style="font-family: Courier New,Courier,monospace;">! var_ts is replaced by dots_max </span><br>
+    <br>
+    <span style="font-weight: bold;">after move:</span><br>
+    <br>
+    <span style="font-family: Courier New,Courier,monospace;">! Current revisions:</span><br style="font-family: Courier New,Courier,monospace;">
+
+    <span style="font-family: Courier New,Courier,monospace;">! -----------------</span><br style="font-family: Courier New,Courier,monospace;">
+
+    <span style="font-family: Courier New,Courier,monospace;">! </span><br style="font-family: Courier New,Courier,monospace;">
+
+    <span style="font-family: Courier New,Courier,monospace;">!</span><br style="font-family: Courier New,Courier,monospace;">
+
+    <span style="font-family: Courier New,Courier,monospace;">! Former revisions:</span><br style="font-family: Courier New,Courier,monospace;">
+
+    <span style="font-family: Courier New,Courier,monospace;">! -----------------</span><br style="font-family: Courier New,Courier,monospace;">
+
+    <span style="font-family: Courier New,Courier,monospace;">! $Id$<br>
+!</span><br style="font-family: Courier New,Courier,monospace;">
+    <span style="font-family: Courier New,Courier,monospace;">! </span><span style="font-family: Courier New,Courier,monospace;"><span style="font-weight: bold; color: rgb(51, 51, 255);">377 2008-08-30 11:03:41Z raasch</span><br>
+! </span><span style="font-family: Courier New,Courier,monospace; font-weight: bold;">new dummy argument abcd</span><br style="font-family: Courier New,Courier,monospace;">
+
+    <span style="font-family: Courier New,Courier,monospace;">!</span><br style="font-family: Courier New,Courier,monospace;">
+
+    <span style="font-family: Courier New,Courier,monospace;">! 359 2008-06-01 15:01:15Z maronga</span><br style="font-family: Courier New,Courier,monospace;">
+
+    <span style="font-family: Courier New,Courier,monospace;">! var_ts is replaced by dots_max<br>
+ </span><br>
+  </li>
+  <li>Commit the changes in the technical documentation and the file headers:<br>
+    <br>
+    <span style="font-family: Courier New,Courier,monospace;">&nbsp;&nbsp; svn commit -m "last commit documented" trunk</span><br>
+    <br>
+ <br>
+  </li>
+</ol>
+
 <h2>
 <a name="Kapitel3.0"></a>3.0&nbsp; Description
