Mercurial > hg > octave-lyh
diff doc/interpreter/contrib.txi @ 12559:a12d7f53c2ab
Document recommended format for commit messages which reference the bug tracker.
author | Rik <octave@nomad.inbox5.com> |
---|---|
date | Thu, 31 Mar 2011 10:41:32 -0700 (2011-03-31) |
parents | 8ac9687dbe9f |
children | d624b6f216ac |
line wrap: on
line diff
--- a/doc/interpreter/contrib.txi +++ b/doc/interpreter/contrib.txi @@ -71,9 +71,9 @@ @end example You may want to get familiar with Mercurial queues to manage your -changesets. Here is a slightly less simple example using Mercurial -queues, where you work on two unrelated changesets in parallel and -update one of the changesets after discussion in the maintainers mailing +changesets. Here is a slightly more complex example using Mercurial +queues, where work on two unrelated changesets is done in parallel and +one of the changesets is updated after discussion on the maintainers mailing list: @example @@ -115,7 +115,7 @@ comment header (use appropriate year, name and comment marks): @example -## Copyright (C) 1996, 1997, 2007 John W. Eaton <jwe@@octave.org> +## Copyright (C) 1996-2011 John W. Eaton <jwe@@octave.org> ## ## This file is part of Octave. ## @@ -160,6 +160,19 @@ code, particularly if there is something that might not be obvious to someone reading it later. +When submitting code which addresses a known bug on the Octave bug tracker +(@url{http://bugs.octave.org}), please add '(bug #XXXXX)' to the ChangeLog +and Mercurial commit messages. Example: + +@example +@group +2011-03-29 Michael Creel <michael.creel@@uab.es> + + * statistics/base/ols.m: Fix erroneous degrees of freedom when + computing the covariance estimator (bug #32892). +@end group +@end example + The preferred comment mark for places that may need further attention is FIXME.