[Buildbot-commits] buildbot/docs buildbot.texinfo,1.108,1.109

[Brian Warner]

Update of /cvsroot/buildbot/buildbot/docs
In directory sc8-pr-cvs3.sourceforge.net:/tmp/cvs-serv18563/docs

Modified Files:
	buildbot.texinfo 
Log Message:
[project @ mail.py: add changesource for SVN's commit-email.pl script, contributed by Justin Mason. Closes SF#1072845.]

Original author: warner at lothar.com
Date: 2007-07-28 16:47:40+00:00

Index: buildbot.texinfo
===================================================================
RCS file: /cvsroot/buildbot/buildbot/docs/buildbot.texinfo,v
retrieving revision 1.108
retrieving revision 1.109
diff -u -d -r1.108 -r1.109
--- buildbot.texinfo	28 Jul 2007 02:37:14 -0000	1.108
+++ buildbot.texinfo	28 Jul 2007 16:48:34 -0000	1.109
@@ -163,6 +163,7 @@
 * FCMaildirSource::             
 * SyncmailMaildirSource::       
 * BonsaiMaildirSource::         
+* SVNCommitEmailMaildirSource::  
 
 Build Process
 
@@ -2563,6 +2564,7 @@
 @item pb.PBChangeSource (listening for connections from a long-running
 @code{contrib/svn_watcher.py} or @code{contrib/svnpoller.py} polling
 process
+ at item mail.SVNCommitEmailMaildirSource (watching for email sent by commit-email.pl)
 @item svnpoller.SVNPoller (polling the SVN repository)
 @end itemize
 
@@ -2823,7 +2825,7 @@
 @item svnmailer
 http://opensource.perlig.de/en/svnmailer/
 @item commit-email.pl
-(distributed with Subversion)
+ at ref{SVNCommitEmailMaildirSource}
 @end table
 
 @item Mercurial
@@ -2834,6 +2836,10 @@
 
 @end table
 
+
+The following sections describe the parsers available for each of
+these tools.
+
 Most of these parsers accept a @code{prefix=} argument, which is used
 to limit the set of files that the buildmaster pays attention to. This
 is most useful for systems like CVS and SVN which put multiple
@@ -2844,14 +2850,11 @@
 prefix is stripped from the filename before any further processing is
 done. Thus the prefix usually ends with a slash.
 
-
-The following sections describe the parsers available for each of
-these tools.
-
 @menu
 * FCMaildirSource::             
 * SyncmailMaildirSource::       
 * BonsaiMaildirSource::         
+* SVNCommitEmailMaildirSource::  
 @end menu
 
 @node FCMaildirSource, SyncmailMaildirSource, Parsing Email Change Messages, Parsing Email Change Messages
@@ -2894,16 +2897,38 @@
 c['sources'] = SyncmailMaildirSource("~/maildir-buildbot")
 @end example
 
- at node BonsaiMaildirSource,  , SyncmailMaildirSource, Parsing Email Change Messages
+ at node BonsaiMaildirSource, SVNCommitEmailMaildirSource, SyncmailMaildirSource, Parsing Email Change Messages
 @subsubsection BonsaiMaildirSource
 
 @csindex buildbot.changes.mail.BonsaiMaildirSource
 
 http://www.mozilla.org/bonsai.html
 
- at code{bonsai_parser} parses messages sent out by Bonsai, the CVS
+ at code{BonsaiMaildirSource} parses messages sent out by Bonsai, the CVS
 tree-management system built by Mozilla.
 
+ at example
+from buildbot.changes.mail import BonsaiMaildirSource
+c['sources'] = BonsaiMaildirSource("~/maildir-buildbot")
+ at end example
+
+ at node SVNCommitEmailMaildirSource,  , BonsaiMaildirSource, Parsing Email Change Messages
+ at subsubsection SVNCommitEmailMaildirSource
+
+ at csindex buildbot.changes.mail.SVNCommitEmailMaildirSource
+
+ at code{SVNCommitEmailMaildirSource} parses message sent out by the
+ at code{commit-email.pl} script, which is included in the Subversion
+distribution.
+
+It does not currently handle branches: all of the Change objects that
+it creates will be associated with the default (i.e. trunk) branch.
+
+ at example
+from buildbot.changes.mail import SVNCommitEmailMaildirSource
+c['sources'] = SVNCommitEmailMaildirSource("~/maildir-buildbot")
+ at end example
+
 
 @node PBChangeSource, P4Source, Mail-parsing ChangeSources, Getting Source Code Changes
 @section PBChangeSource