[Buildbot-commits] site ChangeLog,1.20,1.21 NEWS,1.6,1.7 README,1.13,1.14 index.html,1.39,1.40

Brian Warner warner at users.sourceforge.net
Wed May 18 08:30:50 UTC 2005


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

Modified Files:
	ChangeLog NEWS README index.html 
Log Message:
update for 0.6.5

Index: ChangeLog
===================================================================
RCS file: /cvsroot/buildbot/site/ChangeLog,v
retrieving revision 1.20
retrieving revision 1.21
diff -u -d -r1.20 -r1.21
--- ChangeLog	28 Apr 2005 08:21:10 -0000	1.20
+++ ChangeLog	18 May 2005 08:30:47 -0000	1.21
@@ -1,3 +1,408 @@
+2005-05-18  Brian Warner  <warner at lothar.com>
+
+	* buildbot/__init__.py (version): Releasing buildbot-0.6.5
+
+2005-05-18  Brian Warner  <warner at lothar.com>
+
+	* README: update for 0.6.5
+	* debian/changelog: same
+
+	* buildbot/changes/changes.py: rename tag= to branch=, since
+	that's how we're using it, and my design for the upcoming "build a
+	specific branch" feature wants it. also, tag= was too CVS-centric
+	* buildbot/changes/mail.py (parseSyncmail): same
+	* buildbot/process/base.py (Build.isBranchImportant): same
+	* buildbot/test/test_mailparse.py (Test3.testMsgS4): same
+	* docs/buildbot.texinfo (Attributes of Changes): same
+
+	* NEWS: update tag=, update for upcoming release
+
+2005-05-17  Brian Warner  <warner at lothar.com>
+
+	* buildbot/scripts/runner.py (stop): actually poll once per
+	second, instead of re-killing the poor daemon once per second.
+	Sleep briefly (0.1s) before the first poll, since there's a good
+	chance we can avoid waiting the full second if the daemon shuts
+	down quickly. Also remove the sys.exit() at the end.
+	(start): remove the unneighborly sys.exit()
+
+	* Makefile: improve permission-setting to not kick Arch so badly
+
+	* buildbot/scripts/runner.py (SlaveOptions.optParameters): set a
+	default --keepalive=600, since it doesn't hurt very much, and it's
+	a hassle to discover that you need it.
+	* buildbot/test/test_runner.py (Create.testSlave): test it
+
+	* buildbot/status/words.py (IrcStatusBot.buildFinished): Teach the
+	IRC bot about EXCEPTION
+
+	* buildbot/status/client.py (PBListener): upcall more correctly
+
+	* buildbot/process/base.py (Build.allStepsDone): if a step caused
+	an exception mark the overall build with EXCEPTION, not SUCCESS
+
+	* buildbot/scripts/runner.py (makefile_sample): remove the leading
+	newline
+	* buildbot/status/mail.py (MailNotifier): oops, forgot to upcall
+	* Makefile: update some release-related stuff
+
+	* buildbot/slave/commands.py (ShellCommand.kill): if somehow this
+	gets called when there isn't actually an active process, just end
+	the Command instead of blowing up. I don't know how it gets into
+	this state, but the twisted win32 buildslave will sometimes hang,
+	and when it shakes its head and comes back, it thinks it's still
+	running a Command. The next build causes this command to be
+	interrupted, but the lack of self.process.pid breaks the interrupt
+	attempt.
+
+	* NEWS: document changes since the last release
+
+	* buildbot/scripts/runner.py (start): change 'buildbot start' to
+	look for Makefile.buildbot instead of a bare Makefile . The
+	'buildbot start' does not install this file, so you have to
+	manually copy it if you want to customize startup behavior.
+	(createMaster): change 'buildbot master' command to create
+	Makefile.sample instead of Makefile, to create master.cfg.sample
+	instead of master.cfg (requiring you to copy it before the
+	buildmaster can be started). Both sample files are kept up to
+	date, i.e. they are overwritten if they have been changed. The
+	'buildbot.tac' file is *not* overwritten, but if the new contents
+	don't match the old, a 'buildbot.tac.new' file is created and the
+	user is warned. This seems to be a much more sane way to handle
+	startup files. Also, don't sys.exit(0) when done, so we can run
+	unit tests against it.
+	(createSlave): same. Don't overwrite the sample info/ files.
+	* buildbot/scripts/sample.mk: remove. the contents were pulled
+	into runner.py, since they need to match the behavior of start()
+	* setup.py: same
+	* MANIFEST.in: same
+
+	* docs/buildbot.texinfo (Launching the daemons): document it
+	* buildbot/test/test_runner.py (Create): test it
+
+	* buildbot/test/test_vc.py (SetupMixin.failUnlessIn): Add a
+	version that can handle string-in-string tests, because otherwise
+	python-2.2 fails the tests. It'd be tremendous if Trial's test
+	took two strings under 2.2 too.
+
+	* everything: fixed all deprecation warnings when running against
+	Twisted-2.0 . (at least all the ones in buildbot code, there are a
+	few that come from Twisted itself). This involved putting most of
+	the Twisted-version specific code in the new buildbot.twcompat
+	module, and creating some abstract base classes in
+	buildbot.changes.base and buildbot.status.base (which might be
+	useful anyway). __implements__ is a nuisance and requires an ugly
+	'if' clause everywhere.
+
+	* buildbot/test/test_status.py (Mail.testMail): add a 0.1 second
+	delay before finishing the test: it seems that smtp.sendmail
+	doesn't hang up on the server, so we must wait a moment so it can
+	hang up on us. This removes the trial warning about an unclean
+	reactor.
+
+2005-05-16  Brian Warner  <warner at lothar.com>
+
+	* buildbot/process/step.py (Source): add 'retry' argument. It is a
+	tuple of (delay, repeats).
+	* buildbot/test/test_vc.py (Retry): test it
+	* docs/buildbot.texinfo (Source Checkout): document it
+	* buildbot/slave/commands.py (SourceBase): add 'retry' parameter.
+	(SourceBase.maybeDoVCRetry): If 'retry' is set, failures in
+	doVCFull() are handled by re-trying the checkout (after a delay)
+	some number of times.
+	(ShellCommand._startCommand): make header lines easier to read
+
+	* buildbot/test/test_web.py (WebTest.tearDown): factor out master
+	shutdown
+	(WebTest.test_logfile): make sure master gets shut down, silences
+	some "unclean reactor" test errors
+
+	* buildbot/test/test_changes.py (Sender.tearDown): spin the
+	reactor once after shutdown, something in certain versions of
+	Twisted trigger a test failure. 1.3.0 is ok, 2.0.0 fails, 2.0.1pre
+	fails, svn-trunk is ok.
+
+	* buildbot/test/test_slavecommand.py (Shell.testShellZ): add a
+	second win32 error message
+
+	* buildbot/test/test_run.py (Status.testSlave): be smarter about
+	validating the ETA, so the tests don't fail on slow systems
+
+2005-05-15  Brian Warner  <warner at lothar.com>
+
+	* buildbot/status/builder.py (HTMLLogFile): make this behave like
+	the new LogFile class, so upgrading works properly
+	(LogFileProducer.resumeProducing): survive resumeProducing after
+	we've exhausted the chunkGenerator
+
+	* buildbot/test/test_web.py (WebTest.test_logfile): validate HTML
+	logs too
+	* buildbot/test/test_status.py (Log.testAdd): validate hasContents
+	(Log.testUpgrade): same
+
+	* docs/buildbot.texinfo (Maintenance): describe how to delete old
+	Builds and logs with a cron job.
+
+	* buildbot/status/builder.py (LogFile): revamp LogFiles. Got rid
+	of the old non-offline LogFile, added code to upgrade these to
+	new-style contents-live-on-disk instances at load time (in a way
+	that doesn't invalidate the old Build pickles, so upgrading to
+	0.6.5 is not a one-way operation). Got rid of everything related
+	to 'stub' builds.
+	(LogFile.__init__): create LogFiles with the parent step status,
+	the log's name, and a builder-relative filename where it can keep
+	the contents on disk.
+	(LogFile.hasContents): new method, clients are advised to call it
+	before getText or getChunks and friends. If it returns False, the
+	log's contents have been deleted and getText() will raise an
+	error.
+	(LogFile.getChunks): made it a generator
+	(LogFile.subscribeConsumer): new method, takes a Twisted-style
+	Consumer (except one that takes chunks instead of strings). This
+	enables streaming of very large logfiles without storing the whole
+	thing in memory.
+	(BuildStatus.generateLogfileName): create names like
+	12-log-compile-output, with a _0 suffix if required to be unique
+	(BuildStatus.upgradeLogfiles): transform any old-style (from 0.6.4
+	or earlier) logfiles into new-style ones
+	(BuilderStatus): remove everything related to 'stub' builds. There
+	is now only one build cache, and we don't strip logs from old
+	builds anymore.
+	(BuilderStatus.getBuildByNumber): check self.currentBuild too,
+	since we no longer fight to keep it in the cache
+
+	* buildbot/status/html.py (TextLog.render_GET): use a
+	ChunkConsumer to stream the log entries efficiently.
+	(ChunkConsumer): wrapper which consumes chunks and writes
+	formatted HTML.
+
+	* buildbot/test/test_twisted.py (Parse.testParse): use a
+	LogFile-like object instead of a real one
+
+	* buildbot/test/test_status.py (MyLog): handle new LogFile code
+	(Log.testMerge3): validate more merge behavior
+	(Log.testChunks): validate LogFile.getChunks
+	(Log.testUpgrade): validate old-style LogFile upgrading
+	(Log.testSubscribe): validate LogFile.subscribe
+	(Log.testConsumer): validate LogFile.subscribeConsumer
+
+	* buildbot/interfaces.py (IStatusLogStub): remove
+	(IStatusLog.subscribeConsumer): new method
+	(IStatusLog.hasContents): new method
+	(IStatusLogConsumer): describes things passed to subscribeConsumer
+
+	* buildbot/status/html.py (StepBox.getBox): Don't offer an href to
+	the log contents if it does not have any contents.
+	(StatusResourceBuildStep.body): same
+	(StatusResourceBuildStep.getChild): give a 404 for empty logs
+
+2005-05-14  Brian Warner  <warner at lothar.com>
+
+	* buildbot/test/test_web.py (WebTest.test_logfile): add 5-second
+	timeouts to try and make the windows metabuildslave not hang
+
+2005-05-13  Mike Taylor  <bear at code-bear.com>
+
+	* buildbot/slave/commands.py (rmdirRecursive): added a check
+	to ensure the path passed into rmdirRecursive actually exists.
+	On win32 a non-existant path would generate an exception.
+
+2005-05-13  Brian Warner  <warner at lothar.com>
+
+	* buildbot/slave/commands.py (rmdirRecursive): replacement for
+	shutil.rmtree which behaves correctly on windows in the face of
+	files that you have to chmod before deleting. Thanks to Bear at
+	the OSAF for the routine.
+	(SourceBase.doClobber): use rmdirRecursive
+
+2005-05-12  Brian Warner  <warner at lothar.com>
+
+	* buildbot/status/builder.py (OfflineLogFile.getChunks): have this
+	method generate chunks instead of returning a big list. This
+	allows the same method to be used for both old LogFile and new
+	OfflineLogFile.
+	(OfflineLogFile.getText): use the generator
+	(OfflineLogFile.subscribe): same
+	* buildbot/status/html.py (TextLog.resumeProducing): same
+	* buildbot/interfaces.py (IStatusLog.getChunks): document it
+
+	* buildbot/test/test_web.py (WebTest.test_logfile): Add a test to
+	point out that OfflineLogFile does not currently work with
+	html.Waterfall . Fixing this is high-priority.
+
+	* buildbot/scripts/runner.py (start): add --logfile=twistd.log, since
+	apparently windows defaults to using stdout
+
+	* buildbot/test/test_slavecommand.py (Shell.testShellZ): log a
+	better message on failure so I can figure out the win32 problem
+
+	* buildbot/slave/commands.py (ShellCommand._startCommand): update
+	log messages to include more useful copies of the command being
+	run, the argv array, and the child command's environment.
+	(Git.doVCFull): update cg-close usage, patch from Brandon Philips.
+
+2005-05-11  Brian Warner  <warner at lothar.com>
+
+	* setup.py: oops, install debug.glade so 'buildbot debugclient'
+	will actually work
+	* Makefile: update the deb-snapshot version
+
+	* docs/buildbot.texinfo: move all .xhtml docs into a new
+	.texinfo-format document, adding a lot of material in the process.
+	This is starting to look like a real user's manual. Removed all
+	the Lore-related files: *.xhtml, *.css, template.tpl .
+	* docs/Makefile: simple makefile to run 'makeinfo'
+	* buildbot/scripts/sample.cfg: rearrange slightly
+	* MANIFEST.in: include .info and .textinfo, don't include *.xhtml
+
+2005-05-10  Brian Warner  <warner at lothar.com>
+
+	* buildbot/scripts/runner.py (start): Twisted-1.3.0 used a
+	different name for the internal twistw module, handle it.
+
+	* MANIFEST.in: we deleted plugins.tml, so stop shipping it
+	* setup.py: .. and stop trying to install it
+
+	* buildbot/process/step.py (Git): added support for 'cogito' (aka
+	'git'), the new linux kernel VC system (http://kernel.org/git/).
+	Thanks to Brandon Philips for the patch.
+	* buildbot/slave/commands.py (Git): same
+
+2005-05-06  Brian Warner  <warner at lothar.com>
+
+	* buildbot/status/builder.py (OfflineLogFile): replace the default
+	LogFile with a form that appends its new contents to a disk file
+	as they arrive. The complete log data is never kept in RAM. This
+	is the first step towards handling very large (100MB+) logfiles
+	without choking quite so badly. (The other half is
+	producer/consumer on the HTML pages).
+	(BuildStepStatus.addLog): use OfflineLogFile by default
+	(BuildStatus.getLogfileName): helper code to give the
+	OfflineLogFile a filename to work with
+
+	* buildbot/test/test_status.py (Results.testAddResults): update
+	tests to handle new asserts
+	* buildbot/test/test_vc.py (Patch.doPatch): same
+	* buildbot/test/test_steps.py (BuildStep.setUp): same
+
+2005-05-05  Brian Warner  <warner at lothar.com>
+
+	* buildbot/scripts/runner.py (start): if there is no Makefile,
+	launch the app by importing twistd's internals and calling run(),
+	rather than spawning a new twistd process. This stands a much
+	better chance of working under windows.
+	(stop): kill the process with os.kill instead of spawning
+	/bin/kill, again to reduce the number of external programs which
+	windows might not have in the PATH. Also wait up to 5 seconds for
+	the process to go away, allowing things like 'buildbot stop;
+	buildbot start' to be reliable in the face of slow shutdowns.
+
+	* buildbot/master.py (Dispatcher.__getstate__): remove old
+	.tap-related methods
+	(BuildMaster.__getstate__): same
+	(makeService): same
+	* buildbot/slave/bot.py (makeService): same
+	(Options.longdesc): same
+	* buildbot/scripts/runner.py: copy over some old mktap option text
+
+	* buildbot/scripts/runner.py (masterTAC): stop using mktap.
+	'buildbot master' now creates a buildbot.tac file, so there is no
+	longer a create-instance/save/reload sequence. mktap is dead, long
+	live twistd -y.
+	* buildbot/scripts/sample.mk: use twistd -y, not -f
+	* buildbot/test/test_config.py: remove mktap-based test
+	* buildbot/bb_tap.py, buildbot/plugins.tml: delete old files
+	* README: don't reference mktap
+
+	* docs/source.xhtml: document some of the attributes that Changes
+	might have
+
+	* docs/steps.xhtml (Bazaar): document the Bazaar checkout step
+
+	* general: merge in Change(tag=) patch from Thomas Vander Stichele.
+	[org.apestaart at thomas--buildbot/buildbot--cvstag--0-dev--patch-2]
+	* buildbot/changes/changes.py (Change)
+	* buildbot/changes/mail.py (parseSyncmail)
+	* buildbot/test/test_mailparse.py (Test3.getNoPrefix)
+	(Test3.testMsgS5)
+	* buildbot/process/base.py (Build.isTagImportant)
+	(Build.addChange)
+
+
+2005-05-04  Brian Warner  <warner at lothar.com>
+
+	* buildbot/clients/sendchange.py (Sender.send): tear down the PB
+	connection after sending the change, so that unit tests don't
+	complain about sockets being left around
+
+	* buildbot/status/html.py (WaterfallStatusResource.body): fix
+	exception in phase=0 rendering
+	* buildbot/test/test_web.py (WebTest.test_waterfall): test it
+
+	* buildbot/changes/dnotify.py (DNotify.__init__): remove debug msg
+
+	* buildbot/master.py (BuildMaster.loadConfig): finally remove
+	deprecated config keys: webPortnum, webPathname, irc, manholePort,
+	and configuring builders with tuples.
+	* buildbot/test/test_config.py: stop testing compatibility with
+	deprecated config keys
+	* buildbot/test/test_run.py: same
+
+2005-05-03  Brian Warner  <warner at lothar.com>
+
+	* contrib/arch_buildbot.py: survive if there are no logfiles
+	(username): just use a string, os.getlogin isn't reliable
+
+	* buildbot/scripts/runner.py (sendchange): oops, fix the command
+	so 'buildbot sendchange' actually works. The earlier test only
+	covered the internal (non-reactor-running) form.
+
+	* contrib/arch_buildbot.py: utility that can run as an Arch hook
+	script to notify the buildmaster about changes
+
+	* buildbot/scripts/runner.py (sendchange): new command to send a
+	change to a buildbot.changes.pb.PBChangeSource receiver.
+	* buildbot/test/test_changes.py (Sender): test it
+
+	* buildbot/master.py (BuildMaster.startService): mark .readConfig
+	after any reading of the config file, not just when we do it in
+	startService. This makes some tests a bit cleaner.
+
+	* buildbot/changes/pb.py: add some log messages
+
+	* buildbot/process/base.py (Build.startBuild): fix a bug that
+	caused an exception when the build terminated in the very first
+	step.
+	(Build.stepDone): let steps return a status of EXCEPTION. This
+	terminates the build right away, and sets the build's overall
+	status to EXCEPTION too.
+	* buildbot/process/step.py (BuildStep.failed): return a status of
+	EXCEPTION when that is what has happened.
+
+	* buildbot/process/step.py (Arch.computeSourceRevision): finally
+	implement this, allowing Arch-based projects to get precise
+	checkouts instead of always using the latest code
+	(Bazaar): create variant of Arch to let folks use baz instead of
+	tla. Requires a new buildslave too.
+	* buildbot/slave/commands.py (Arch): add 'revision' argument
+	(Bazaar): create variant of Arch that uses baz instead of tla.
+	Remove the code that extracts the archive name from the
+	register-archive output, since baz doesn't provide it, and require
+	the user provide both the archive name and its location.
+	* buildbot/test/test_vc.py (VC.testBazaar): added tests
+
+2005-05-02  Brian Warner  <warner at lothar.com>
+
+	* buildbot/scripts/sample.cfg: improve docs for c['buildbotURL'],
+	thanks to Nick Trout.
+
+	* buildbot/scripts/runner.py (Maker.makefile): chmod before edit,
+	deals better with source Makefile coming from a read-only CVS
+	checkout. Thanks to Nick Trout for the catch.
+
+	* buildbot/__init__.py (version): bump to 0.6.4+ while between
+	releases
+
 2005-04-28  Brian Warner  <warner at lothar.com>
 
 	* buildbot/__init__.py (version): Releasing buildbot-0.6.4

Index: NEWS
===================================================================
RCS file: /cvsroot/buildbot/site/NEWS,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -d -r1.6 -r1.7
--- NEWS	28 Apr 2005 08:21:13 -0000	1.6
+++ NEWS	18 May 2005 08:30:48 -0000	1.7
@@ -1,5 +1,99 @@
 User visible changes in Buildbot.
 
+* Release 0.6.5 (18 May 2005)
+
+** deprecated config keys removed
+
+The 'webPortnum', 'webPathname', 'irc', and 'manholePort' config-file keys,
+which were deprecated in the previous release, have now been removed. In
+addition, Builders must now always be configured with dictionaries: the
+support for configuring them with tuples has been removed.
+
+** master/slave creation and startup changed
+
+The buildbot no longer uses .tap files to store serialized representations of
+the buildmaster/buildslave applications. Instead, this release now uses .tac
+files, which are human-readable scripts that create new instances (rather
+than .tap files, which were pickles of pre-created instances). 'mktap
+buildbot' is gone.
+
+You will need to update your buildbot directories to handle this. The
+procedure is the same as creating a new buildmaster or buildslave: use
+'buildbot master BASEDIR' or 'buildbot slave BASEDIR ARGS..'. This will
+create a 'buildbot.tac' file in the target directory. The 'buildbot start
+BASEDIR' will use twistd to start the application.
+
+The 'buildbot start' command now looks for a Makefile.buildbot, and if it
+finds one (and /usr/bin/make exists), it will use it to start the application
+instead of calling twistd directly. This allows you to customize startup,
+perhaps by adding environment variables. The setup commands create a sample
+file in Makefile.sample, but you must copy this to Makefile.buildbot to
+actually use it. The previous release looked for a bare 'Makefile', and also
+installed a 'Makefile', so you were always using the customized approach,
+even if you didn't ask for it. That old Makefile launched the .tap file, so
+changing names was also necessary to make sure that the new 'buildbot start'
+doesn't try to run the old .tap file.
+
+'buildbot stop' now uses os.kill instead of spawning an external process,
+making it more likely to work under windows. It waits up to 5 seconds for the
+daemon to go away, so you can now do 'buildbot stop BASEDIR; buildbot start
+BASEDIR' with less risk of launching the new daemon before the old one has
+fully shut down. Likewise, 'buildbot start' imports twistd's internals
+directly instead of spawning an external copy, so it should work better under
+windows.
+
+** new documentation
+
+All of the old Lore-based documents were converted into a new Texinfo-format
+manual, and considerable new text was added to describe the installation
+process. The docs are not yet complete, but they're slowly shaping up to form
+a proper user's manual.
+
+** new features
+
+Arch checkouts can now use precise revision stamps instead of always using
+the latest revision. A separate Source step for using Bazaar (an alternative
+Arch client) instead of 'tla' was added. A Source step for Cogito (the new
+linux kernel VC system) was contributed by Brandon Philips. All Source steps
+now accept a retry= argument to indicate that failing VC checkouts should be
+retried a few times (SF#1200395), note that this requires an updated
+buildslave.
+
+The 'buildbot sendchange' command was added, to be used in VC hook scripts to
+send changes at a pb.PBChangeSource . contrib/arch_buildbot.py was added to
+use this tool; it should be installed using the 'Arch meta hook' scheme.
+
+Changes can now accept a branch= parameter, and Builders have an
+isBranchImportant() test that acts like isFileImportant(). Thanks to Thomas
+Vander Stichele. Note: I renamed his tag= to branch=, in anticipation of an
+upcoming feature to build specific branches. "tag" seemed too CVS-centric.
+
+LogFiles have been rewritten to stream the incoming data directly to disk
+rather than keeping a copy in memory all the time (SF#1200392). This
+drastically reduces the buildmaster's memory requirements and makes 100MB+
+log files feasible. The log files are stored next to the serialized Builds,
+in files like BASEDIR/builder-dir/12-log-compile-output, so you'll want a
+cron job to delete old ones just like you do with old Builds. Old-style
+Builds from 0.6.4 and earlier are converted when they are first read, so the
+first load of the Waterfall display after updating to this release may take
+quite some time.
+
+** build process updates
+
+BuildSteps can now return a status of EXCEPTION, which terminates the build
+right away. This allows exceptions to be caught right away, but still make
+sure the build stops quickly.
+
+** bug fixes
+
+Some more windows incompatibilities were fixed. The test suite now has two
+failing tests remaining, both of which appear to be Twisted issues that
+should not affect normal operation.
+
+The test suite no longer raises any deprecation warnings when run against
+twisted-2.0 (except for the ones which come from Twisted itself).
+
+
 * Release 0.6.4 (28 Apr 2005)
 
 ** major bugs fixed

Index: README
===================================================================
RCS file: /cvsroot/buildbot/site/README,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- README	26 Apr 2005 03:44:41 -0000	1.13
+++ README	18 May 2005 08:30:48 -0000	1.14
@@ -43,6 +43,10 @@
 The PyCon paper has a good description of the overall architecture. It is
 available in HTML form in docs/PyCon-2003/buildbot.html, or on the web page.
 
+docs/buildbot.info contains the beginnings of the User's Manual, and the
+Installation chapter is the best guide to use for setup instructions. The
+.texinfo source can also be turned into printed documentation.
+
 REQUIREMENTS:
 
  Python: http://www.python.org
@@ -61,12 +65,10 @@
    with Twisted-1.1.0, but 1.3.0 is the version that has received the most
    testing.
 
-   They run against Twisted-2.0.0 as well, albeit with a number of warnings
-   about the use of deprecated features. If you use Twisted-2.0, you'll need
-   at least "Twisted" (the core package), and you'll also want TwistedMail,
-   TwistedWeb, TwistedWords, and TwistedLore (for sending email, serving a
-   web status page, delivering build status via IRC, and generating the HTML
-   documentation, respectively).
+   Both work with Twisted-2.0.0 as well. You'll need at least "Twisted" (the
+   core package), and you'll also want TwistedMail, TwistedWeb, and
+   TwistedWords (for sending email, serving a web status page, and delivering
+   build status via IRC, respectively).
 
  CVSToys: http://purl.net/net/CVSToys
 
@@ -76,16 +78,18 @@
    a mail-parsing change source, or the SVN notification script), you will
    not need CVSToys.
 
-
 INSTALLATION:
 
+Please read the User's Manual in docs/buildbot.info for complete
+instructions.
+
  RUNNING THE UNIT TESTS
 
 If you would like to run the unit test suite, use a command like this:
 
  PYTHONPATH=. trial -v buildbot.test
 
-This should run up to 109 tests, depending upon what VC tools you have
+This should run up to 124 tests, depending upon what VC tools you have
 installed. On my desktop machine it takes about two minutes to complete.
 Nothing should fail, a few might be skipped. If any of the tests fail, you
 should stop and investigate the cause before continuing the installation
@@ -168,10 +172,10 @@
 keepalive defaults to running once every 10 minutes.
 
 To manually turn on application-level keepalives, or to set them to use some
-other interval, add "--keepalive NNN" to the mktap command line. NNN is the
-number of seconds between keepalives. Use as large a value as your NAT box
-allows to reduce the amount of unnecessary traffic on the wire. 600 seconds
-(10 minutes) is a reasonable value.
+other interval, add "--keepalive NNN" to the 'buildbot slave' command line.
+NNN is the number of seconds between keepalives. Use as large a value as your
+NAT box allows to reduce the amount of unnecessary traffic on the wire. 600
+seconds (10 minutes) is a reasonable value.
 
 
  SETTING UP A BUILD MASTER:

Index: index.html
===================================================================
RCS file: /cvsroot/buildbot/site/index.html,v
retrieving revision 1.39
retrieving revision 1.40
diff -u -d -r1.39 -r1.40
--- index.html	28 Apr 2005 08:21:13 -0000	1.39
+++ index.html	18 May 2005 08:30:48 -0000	1.40
@@ -11,7 +11,7 @@
 Current contents:
 
 <ul>
-  <li>The current release is buildbot-0.6.4 . You can download the source
+  <li>The current release is buildbot-0.6.5 . You can download the source
   from the sf.net download page <a
   href="http://sourceforge.net/project/showfiles.php?group_id=73177">here</a>.
   The release is signed with my GPG public key, available <a
@@ -129,5 +129,5 @@
      align="right" />
 </a>
 
-<!-- hhmts start -->Last modified: Thu Apr 28 01:19:22 PDT 2005 <!-- hhmts end -->
+<!-- hhmts start -->Last modified: Wed May 18 01:29:48 PDT 2005 <!-- hhmts end -->
 </body> </html>





More information about the Commits mailing list