[Buildbot-commits] buildbot/docs buildbot.texinfo,1.16,1.17

[Brian Warner]

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

Modified Files:
	buildbot.texinfo 
Log Message:
Revision: arch at buildbot.sf.net--2004/buildbot--dev--0--patch-277
Creator:  Brian Warner <warner at monolith.lothar.com>

make 'try' actually work, mostly

	* docs/buildbot.texinfo (try): add --port argument to PB style

	* buildbot/scripts/tryclient.py (SourceStampExtractor): return an
	actual SourceStamp. Still need to extract a branch name, somehow.
	(Try): finish implementing the try client side, still need a UI
	for specifying which builders to use
	(Try.getopt): factor our options/config-file reading
	* buildbot/test/test_scheduler.py (Scheduling.testTryUserpass):
	test it
	* buildbot/test/test_vc.py: match SourceStampExtractor change

	* buildbot/scripts/runner.py (Options.opt_verbose): --verbose
	causes the twisted log to be sent to stderr

	* buildbot/scheduler.py (Try_Userpass): implement the PB style

--This line, and those below, will be ignored--
Files to commit:
   <can't compute list>

This list might be incomplete or outdated if editing the log
message was not invoked from an up-to-date changes buffer!


Index: buildbot.texinfo
===================================================================
RCS file: /cvsroot/buildbot/buildbot/docs/buildbot.texinfo,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -d -r1.16 -r1.17
--- buildbot.texinfo	10 Aug 2005 08:15:44 -0000	1.16
+++ buildbot.texinfo	11 Aug 2005 08:22:17 -0000	1.17
@@ -3729,12 +3729,15 @@
 
 To use the username/password form of authentication, create a
 @code{Try_Userpass} instance instead. It takes the same
- at code{builderNames} argument as the @code{Try_Jobdir} form:
+ at code{builderNames} argument as the @code{Try_Jobdir} form, but
+accepts an addtional @code{port} argument (to specify the TCP port to
+listen on) and a @code{userpass} list of username/password pairs to
+accept:
 
 @example
 from buildbot.scheduler import Try_Userpass
 s = Try_Userpass("try2", ["full-linux", "full-netbsd", "full-OSX"],
-                 userpass=[("alice","pw1"), ("bob", "pw2")] )
+                 port=8031, userpass=[("alice","pw1"), ("bob", "pw2")] )
 c['schedulers'] = [s]
 @end example
 
@@ -3748,10 +3751,13 @@
 (or @code{try_connect = 'ssh'} or @code{try_connect = 'pb'} in
 @file{.buildbot/options}).
 
-For the PB approach, the command must be given a @option{--username}
-and @option{--passwd} pair of arguments that match one of the entries
-in the buildmaster's @code{tryusers} list. These arguments can also be
-provided as @code{try_username} and @code{try_password} entries in the
+For the PB approach, the command must be given a @option{--master}
+argument (in the form HOST:PORT) that points to TCP port that you
+picked in the @code{Try_Userpass} scheduler. It also takes a
+ at option{--username} and @option{--passwd} pair of arguments that match
+one of the entries in the buildmaster's @code{userpass} list. These
+arguments can also be provided as @code{try_master},
+ at code{try_username}, and @code{try_password} entries in the
 @file{.buildbot/options} file.
 
 For the SSH approach, the command must be given @option{--tryhost},