[Buildbot-commits] buildbot ChangeLog,1.365,1.366 Makefile,1.5,1.6 NEWS,1.37,1.38

[Brian Warner]

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

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

deprecation warnings

2005-04-21  Brian Warner  <warner at lothar.com>

   * Makefile: minor tweaks

   * NEWS: point out deprecation warnings, new features for
   /usr/bin/buildbot

   * buildbot/master.py (BuildMaster.loadConfig): emit
   DeprecationWarnings for Builders defined with tuples. Rearrange
   code to facility removal of deprecated configuration keys in the
   next release.


Index: ChangeLog
===================================================================
RCS file: /cvsroot/buildbot/buildbot/ChangeLog,v
retrieving revision 1.365
retrieving revision 1.366
diff -u -d -r1.365 -r1.366
--- ChangeLog	22 Apr 2005 02:57:22 -0000	1.365
+++ ChangeLog	22 Apr 2005 03:55:52 -0000	1.366
@@ -1,5 +1,15 @@
 2005-04-21  Brian Warner  <warner at lothar.com>
 
+	* Makefile: minor tweaks
+
+	* NEWS: point out deprecation warnings, new features for
+	/usr/bin/buildbot
+
+	* buildbot/master.py (BuildMaster.loadConfig): emit
+	DeprecationWarnings for Builders defined with tuples. Rearrange
+	code to facility removal of deprecated configuration keys in the
+	next release.
+
 	* buildbot/scripts/runner.py (createMaster,createSlave): rewrite
 	'buildbot' command to put a little Makefile in the target that
 	helps you re-create the buildbot.tap file, start or stop the

Index: Makefile
===================================================================
RCS file: /cvsroot/buildbot/buildbot/Makefile,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -d -r1.5 -r1.6
--- Makefile	18 Apr 2005 00:26:57 -0000	1.5
+++ Makefile	22 Apr 2005 03:55:53 -0000	1.6
@@ -2,7 +2,7 @@
 # this is just a convenience for developers, and to automate the release
 # process a little bit. This Makefile is not included in the source tarball.
 
-BBBASE = ~/stuff/Projects/BuildBot/sourceforge
+BBBASE = $(PWD)
 ifdef SVN
 T=~/stuff/python/twisted/Twisted
 else

Index: NEWS
===================================================================
RCS file: /cvsroot/buildbot/buildbot/NEWS,v
retrieving revision 1.37
retrieving revision 1.38
diff -u -d -r1.37 -r1.38
--- NEWS	20 Apr 2005 23:28:27 -0000	1.37
+++ NEWS	22 Apr 2005 03:55:53 -0000	1.38
@@ -2,12 +2,27 @@
 
 * Release X.X.X (XX)
 
-** API docs
+** 'buildbot' tool gets more uses
 
-Thanks to Thomas Vander Stichele, most of the docstrings have been converted
-to epydoc format. There is a utility in docs/gen-reference to turn these into
-a tree of cross-referenced HTML pages. Eventually these docs will be
-auto-generated and somehow published on the buildbot web page.
+The 'buildbot' executable has acquired two new subcommands. 'buildbot
+debugclient' brings up the small remote-control panel that connects to a
+buildmaster (via the slave port and the c['debugPassword']). This tool,
+formerly in contrib/debugclient.py, lets you reload the config file, force
+builds, and simulate inbound commit messages. It requires gtk2, glade, and
+the python bindings for both to be installed.
+
+'buildbot status_gui' brings up a live status client, formerly available by
+running buildbot/clients/gtkPanes.py as a program. This connects to the PB
+status port that you create with:
+
+  c['status'].append(client.PBListener(portnum))
+
+and shows two boxes per Builder, one for the last build, one for current
+activity. These boxes are updated in realtime. The effect is primitive, but
+is intended as an example of what's possible with the PB status interface.
+
+Note: both names are subject to change. The status_gui is currently
+completely broken, but I might manage to fix it before the next release.
 
 ** web page has a favicon
 
@@ -16,6 +31,38 @@
 requested. Many web browsers display this as an icon next to the URL or
 bookmark. A goofy little default icon is included.
 
+** Deprecated features
+
+*** defining Builders with tuples is deprecated
+
+For a long time, the preferred way to define builders in the config file has
+been with a dictionary. The less-flexible old style of a 4-item tuple (name,
+slavename, builddir, factory) is now officially deprecated (i.e., it will
+emit a warning if you use it), and will be removed in the next release.
+Dictionaries are more flexible: additional keys like periodicBuildTime are
+simply unavailable to tuple-defined builders.
+
+Note: it is a good idea to watch the logfile (usually in twistd.log) when you
+first start the buildmaster, or whenever you reload the config file. Any
+warnings or errors in the config file will be found there.
+
+*** c['webPortnum'], c['webPathname'], c['irc'] are deprecated
+
+All status reporters should be defined in the c['status'] array, using
+buildbot.status.html.Waterfall or buildbot.status.words.IRC . These have been
+deprecated for a while, but this is fair warning that these keys will be
+removed in the next release.
+
+*** c['manholePort'] is deprecated
+
+Again, this has been deprecated for a while, in favor of:
+
+ c['manhole'] = master.Manhole(port, username, password)
+
+The preferred syntax will eventually let us use other, better kinds of debug
+shells, such as the experimental curses-based ones in the Twisted sandbox
+(which would offer command-line editing and history).
+
 ** bug fixes
 
 The waterfall page has been improved a bit. A circular-reference bug in the
@@ -40,6 +87,13 @@
 Thankt to Nick Trout, more compatibility fixes have been incorporated,
 improving the chances that the unit tests will pass on windows systems.
 
+** API docs
+
+Thanks to Thomas Vander Stichele, most of the docstrings have been converted
+to epydoc format. There is a utility in docs/gen-reference to turn these into
+a tree of cross-referenced HTML pages. Eventually these docs will be
+auto-generated and somehow published on the buildbot web page.
+
 
 
 * Release 0.6.2 (13 Dec 2004)