]> git.llucax.com Git - software/mutt-debian.git/blobdiff - doc/devel-notes.txt
removing an article form the Description of mutt-patched to make lintian happy
[software/mutt-debian.git] / doc / devel-notes.txt
index ec845ca92c1d5ab763454e874768bcdc542ea887..31db35edebd5cc28ee9ee185cd0d9f6ed383c943 100644 (file)
@@ -141,6 +141,28 @@ is in the root directory.  The script does all the automake/autoconf
 magic that needs to be done with a fresh checkout.
 
 
 magic that needs to be done with a fresh checkout.
 
 
+Contributing patches
+--------------------
+
+As Mercurial is a distributed version control system, it's easy to
+commit changes locally without impacting anybody else's work, starting
+over again, or turn several commit and backouts into a new single patch
+ready for submission.
+
+These so-called "changesets" (a diff with a reasonable message
+describing the change) can be exported using Mercurial through the
+"patchbomb" extension shipped with Mercurial (please see the hg
+documentation for details) which also is the preferred format for
+submission to the mutt-dev mailing list for discussion and review.
+
+In order to ease later bisecting in case of bugs and code history,
+changes should be grouped logically, feature by feature or bugfix by
+bugfix. Especially a single patch fixing several problems at once
+should be avoided.
+
+Before submitting patches, please make sure the check_sec.sh script
+in the top-level source directory reports no errors/warnings.
+
 A word about warnings
 ---------------------
 
 A word about warnings
 ---------------------
 
@@ -216,10 +238,12 @@ expected to be plain text, with some formatting instructions roughly
 similar to [ntg]roff:
 
  - \fI switches to italics
 similar to [ntg]roff:
 
  - \fI switches to italics
+
  - \fB switches to boldface
 
  - \fB switches to boldface
 
- - \fP switches to normal display
+ - \fT switches to monospace
+
+ - \fP switches to normal display after \fI, \fB or \fT
 
  - \(as can be used to represent an asterisk (*).  This is intended
    to help avoiding character sequences such as /* or */ inside
 
  - \(as can be used to represent an asterisk (*).  This is intended
    to help avoiding character sequences such as /* or */ inside