Changes between Version 9 and Version 10 of Documentation/UserGuide/CommitOnTrunk
- Timestamp:
- 2015-09-25T16:42:33+02:00 (9 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
Documentation/UserGuide/CommitOnTrunk
v9 v10 1 = Commit on the trunk = 1 [[PageOutline]] 2 = Commit on the trunk or a branch = 2 3 Here are some general guidelines for committing into the trunk ORCHIDEE. These recommendations can also be applied to branches and other versions under SVN control. 3 4 … … 10 11 11 12 Some cases must be discussed in advance: 12 * if the behavio r of the model change. For example: change in parameter name in getin function, change in default value for some parameters, etc..13 * if the behaviour of the model change. For example: change in parameter name in getin function, change in default value for some parameters, etc.. 13 14 * if the interface towards the atmosphere is changed 14 15 * big modifications 15 16 16 17 During commit: 17 * one commit per ticket18 * a commit should only resolve one problem at a time, related to one ticket. Do not make to be commit. 18 19 * write a useful log message in English 19 20 * use '''#X''' to refer to the ticket number X (the # will make a link directly to the ticket when visualizing the log message on the web) 20 21 21 22 After commit: 22 * for important changes, make a note here: [wiki: trunk]23 * for important changes, make a note here: [wiki:SourceCode] 23 24 * tell the project group if the results changed even for tiny changes. A new reference must then be done in the [http://webservices.ipsl.fr/trusting/ trusting]. 24 25 * if related to a ticket, add a link to the commit in the ticket using '''[Y]''', where Y is the revision number on the commit. Close the ticket if all questions are treated. 25 26 26 27 == Basic use of SVN == 27 See the section '''svn''' on the [wiki:Documentation/UserGuide How to] page... 28 See also the section '''svn''' on the [wiki:Documentation/UserGuide]. 29 === Create a new file === 30 Add a new file to the svn repository either by coping an existent, renaming or adding a new file. 31 32 {{{ 33 > svn cp file1 file2 34 or 35 > svn mv file1 file2 36 or create first the file2 and then add it 37 > svn add file2 38 }}} 39 40 All these commands will only add locally the file. To finally add them to the repository you must commit: 41 42 {{{ 43 > svn -u stat 44 > svn ci 45 }}} 46 47 48 === Activate revision information === 49 If you added a new file, make sure also to activate the commit information in the header, after activation this should be done automatically at each commit. Add in the beginning of the file the following keywords : 50 {{{ 51 !! $HeadURL$ 52 !! $Date$ 53 !! $Revision$ 54 }}} 55 56 Activate substitution by using propset and commit the file: 57 {{{ 58 > svn propset svn:keywords "Date Revision HeadURL" file2.f90 59 > svn ci file2.f90 60 }}} 61 62 63 After the commit it should look something like: 64 {{{ 65 !! $HeadURL: svn://forge.ipsl.jussieu.fr/orchidee/trunk/ORCHIDEE/src_sechiba/file2.f90 $ 66 !! $Date: 2015-09-21 13:37:38 +0200 (lun. 21 sept. 2015) $ 67 !! $Revision: 2928 $ 68 }}} 69 70