If you are a relax developer and you have commit access to the repository the following conventions should be followed for all commit messages.
An example of a commit message for the closure of a bug is:
Fixing the rest of bug #7241 (https://web.archive.org/web/https://gna.org/bugs/?7241).
Bug #7241 was thought to be fixed in in r2591 and r2593, the commit messages describing the solution being located at http://www.nmr-relax.com/mail.gna.org/public/relax-commits/2006-09/msg00064.html (Message-id: <E1GTgBi-0000R6firstname.lastname@example.org>) for r2591 and http://www.nmr-relax.com/mail.gna.org/public/relax-commits/2006-10/msg00001.html (Message-id: <E1GTt6Cemail@example.com>) for r2593.
However this was not the only place that the Scientific Python PDB data structure peptide_chains was being accessed. The chains were being accessed in the file `pipe_control/sequence.py' when the sequence was being read out of the PDB file. This has now been modified with changes similar to r2591 and r2593.
An example of a commit message for changes relating to a task is:
This change implements half of task #3630 (https://web.archive.org/web/https://gna.org/task/?3630).
The docstring in the generic optimisation function has been modified to clear up the ambiguity cased by supplying the option `None' together with Newton optimisation.
One last commit message example is:
Added the API documentation creation (using Epydoc) to the Scons scripts.
The Scons target to create the HTML API documentation is called `api_manual_html'. The documentation can be created by typing: $ scons api_manual_html
The function `compile_api_manual_html()' was added to the `scons/manuals.py' file. This function runs the `epydoc' command. All the Epydoc options are specified in that function.
The relax user manual (PDF), created 2016-10-28.