Changes between Version 28 and Version 29 of Developers/SVN_QuickReference

Timestamp:

2017-12-08T17:58:22+01:00 (7 years ago)

Author:

nicolasmartin

Comment:

--

Developers/SVN_QuickReference

@@ -80 +80 @@
 # for csh  "    "      "      ""  ,      "      ""    "    "" "" ~/.login                     )
 setenv SVN_EDITOR='your_favourite_editor'
-# Commit and write the log message (ticket link #.... and so on) in your editor
-svn ci files_list # `svn ci` without files list will commit all modified files recursively from the current directory
-# or directly from the command line of the shell session
-svn ci  -m 'log message' files_list
 }}}
 
-==== Commit message syntax
+{{{#!div class="notice system-message"
 
-New syntax to add in commit message to enable extended functionalities `[command #ticket_number]`
-* Add commit message as comment in the ticket: ex `[see #ticket_number]`, you can use a word in `addresses re references refs see`
-* Close a ticket with the commit: ex `[fix #ticket_number]`,  you can use a word in `close closed closes fix fixed fixes`
+__Recommended syntax to be added in the commit message__
+
+* If the commit is related to one or several tickets, we highly suggest to add the commit message as ticket comment.     \\
+  To do so, you can use one of the word in the list `addresses re references refs see` followed by usual ticket link(s). \\
+  ''Ex: `see #1948` somewhere in the commit message to link with #1948''
+
+* If the commit is a fix for one or several tickets, you can close them with the commit.                                    \\
+  To do so, you can use one of the word in the list `close closed closes fix fixed fixes` followed by usual ticket link(s). \\
+  ''Ex: `fix #1948` somewhere in the commit message to close #1948 without a browser.''
+
+__Be careful if you mix the 2.__
+
+}}}
+
+{{{#!sh
+# Commit and write the log message (ticket link #.... and so on) in your editor
+svn ci files_list
+# `svn ci` without files list will commit all modified files recursively from the current directory
+# or directly from the command line of the shell session
+svn ci -m 'log_message' files_list
+}}}
+
 
 === Tag