[Buildbot-commits] buildbot CREDITS, NONE, 1.1 ChangeLog, 1.716, 1.717 MANIFEST.in, 1.22, 1.23 NEWS, 1.56, 1.57 README, 1.32, 1.33

Brian Warner warner at users.sourceforge.net
Wed Aug 23 07:04:38 UTC 2006 

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

Modified Files:
	ChangeLog MANIFEST.in NEWS README 
Added Files:
	CREDITS 
Log Message:
[project @ update README and NEWS, add CREDITS]

Original author: warner at lothar.com
Date: 2006-08-23 05:11:12

--- NEW FILE: CREDITS ---
This is a list of everybody who has contributed to Buildbot in some way, in
no particular order. Thanks everybody!

Scott Lamb
Olivier Bonnet
Mark Hammond
Gary Granger
Marius Gedminas
Paul Winkler
John O'Duinn
JP Calderone
Zandr Milewski
Niklaus Giger
Tobi Vollebregt
John Pye
Neal Norwitz
Anthony Baxter
AllMyData.com
Clement Stenac
Kevin Turner
Steven Walter
Dobes Vandermeer
Brad Hards
Nathaniel Smith
Mark Dillavou
Thomas Vander Stichele
Bear
Brandon Philips
Nick Trout
Paul Warren
Rene Rivera
Baptiste Lepilleur
Gerald Combs
Yoz Grahame
Alexander Staubo
Elliot Murphy
Stephen Davis
Kirill Lapshin
Dave Peticolas
Andrew Bennetts
Olly Betts
Philipp Frauenfelder

Index: ChangeLog
===================================================================
RCS file: /cvsroot/buildbot/buildbot/ChangeLog,v
retrieving revision 1.716
retrieving revision 1.717
diff -u -d -r1.716 -r1.717
--- ChangeLog	23 Aug 2006 04:02:30 -0000	1.716
+++ ChangeLog	23 Aug 2006 07:04:36 -0000	1.717
@@ -1,5 +1,10 @@
 2006-08-22  Brian Warner  <warner at lothar.com>
 
+	* README: update
+
+	* CREDITS: new file, list of people who have helped. Thanks!
+	* MANIFEST.in: ship it
+
 	* MANIFEST.in: stop shipping the old PyCon-2003 paper.. with the
 	new diagrams, the user's manual is more informative than it was.
 	Start shipping the .html user's manual (and generated .png

Index: MANIFEST.in
===================================================================
RCS file: /cvsroot/buildbot/buildbot/MANIFEST.in,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -d -r1.22 -r1.23
--- MANIFEST.in	23 Aug 2006 04:02:30 -0000	1.22
+++ MANIFEST.in	23 Aug 2006 07:04:36 -0000	1.23
@@ -1,5 +1,5 @@
 
-include ChangeLog MANIFEST.in README README.w32 NEWS
+include ChangeLog MANIFEST.in README README.w32 NEWS CREDITS
 include docs/examples/*.cfg
 include docs/buildbot.texinfo
 include docs/buildbot.info

Index: NEWS
===================================================================
RCS file: /cvsroot/buildbot/buildbot/NEWS,v
retrieving revision 1.56
retrieving revision 1.57
diff -u -d -r1.56 -r1.57
--- NEWS	6 Aug 2006 21:14:44 -0000	1.56
+++ NEWS	23 Aug 2006 07:04:36 -0000	1.57
@@ -2,6 +2,20 @@
 
 * Release ?.?.? (?)
 
+** Things You Need To Know
+
+The PBChangeSource's prefix= argument has changed, you probably need to add a
+slash now. This is mostly used by sites which use Subversion and
+svn_buildbot.py.
+
+The subcommands that are used to create a buildmaster or a buildslave have
+changed. They used to be called 'buildbot master' and 'buildbot slave'. Now
+they are called 'buildbot create-master' and 'buildbot create-slave'. Zipf's
+Law suggests that these are more appropriate names for these
+infrequently-used commands.
+
+The syntax for the c['manhole'] feature has changed.
+
 ** new features
 
 *** full Perforce support
@@ -23,6 +37,32 @@
 files that use them must be updated. The "Debug options" section in the
 user's manual provides a complete description.
 
+*** Multiple Logfiles
+
+BuildSteps can watch multiple log files in realtime, not just stdout/stderr.
+This works in a similar fashion to 'tail -f': the file is polled once per
+second, and any new data is sent to the buildmaster.
+
+This requires a buildslave running 0.7.4 or later, and a warning message is
+produced if used against an old buildslave (which will otherwise produce no
+data). Use "logfiles={'name': 'filename'}" to take advantage of this feature
+from master.cfg, and see the "ShellCommand" section of the user's manual for
+full documentation.
+
+The 'Trial' buildstep has been updated to use this, to display
+_trial_temp/test.log in realtime. It also knows to fall back to the previous
+"cat" command if the buildslave is too old.
+
+*** BuildStep URLs
+
+BuildSteps can now add arbitrary URLs which will be displayed on the
+Waterfall page in the same place that Logs are presented. This is intended to
+provide a link to generated HTML pages, such as the output of a code coverage
+tool. The step is responsible for somehow uploading the HTML to a web server:
+this feature merely provides an easy way to present the HREF link to the
+user. See the "BuildStep URLs" section of the user's manual for details and
+examples.
+
 *** LogObservers
 
 BuildSteps can now attach LogObservers to various logfiles, allowing them to
@@ -35,30 +75,29 @@
 The 'Trial' buildstep has been updated to use this for progress tracking, by
 counting how many test cases have run.
 
-*** Multiple Logfiles
-
-BuildSteps can watch multiple log files in realtime, not just stdout/stderr.
-This works in a similar fashion to 'tail -f': the file is polled once per
-second, and any new data is sent to the buildmaster.
-
-This requires a buildslave running 0.7.4 or later, and a warning message is
-produced if used against an old buildslave. Use "logfiles={'name':
-'filename'}" to take advantage of this feature from master.cfg, and see the
-"ShellCommand" section of the user's manual for full documentation.
-
-The 'Trial' buildstep has been updated to use this, to display
-_trial_temp/test.log in realtime.
-
 ** new documentation
 
 What classes are useful in your master.cfg file? A table of them has been
 added to the user's manual, in a section called "Index of Useful Classes".
 
+Want a list of all the keys in master.cfg? Look in the "Index of master.cfg
+keys" section.
+
 A number of pretty diagrams have been added to the "System Architecture"
 portion of the manual, explaining how all the buildbot pieces fit together.
 
+An HTML form of the user's manual is now shipped in the source tarball. This
+makes it a bit bigger: sorry about that. The old PyCon-2003 paper has been
+removed from the distribution, as it is mostly supplanted by the user's
+manual by this point.
+
 ** bugfixes
 
+SF#1217699 + SF#1381867: The prefix= argument to PBChangeSource has been
+changed: now it does just a simple string-prefix match and strip. The
+previous behavior was buggy and unhelpful. NOTE: if you were using prefix=
+before, you probably need to add a slash to the end of it.
+
 SF#1398174: ignore SVN property changes better, fixed by Olivier Bonnet
 
 SF#1452801: don't double-escape the build URL, fixed by Olivier Bonnet
@@ -68,8 +107,8 @@
 reloading unchanged config files with WithProperties shouldn't change anything.
 
 All svn commands now include --non-interactive so they won't ask for
-passwords. Instead the command fails if it cannot be performed without user
-input.
+passwords. Instead, the command will fail if it cannot be performed without
+user input.
 
 Deprecation warnings with newer versions of Twisted have been hushed.
 
@@ -93,6 +132,13 @@
 will pop up an HTML tooltip to show the reason for the build. Thanks to Zandr
 Milewski for the suggestion.
 
+contrib/CSS/*.css now contains several contributed stylesheets to make the
+Waterfall display a bit less ugly. Thanks to John O'Duinn for gathering them.
+
+ShellCommand and its derivatives can now accept either a string or a list of
+strings in the description= and descriptionDone= arguments. Thanks to Paul
+Winkler for the catch.
+
 
 * Release 0.7.3 (23 May 2006)
 

Index: README
===================================================================
RCS file: /cvsroot/buildbot/buildbot/README,v
retrieving revision 1.32
retrieving revision 1.33
diff -u -d -r1.32 -r1.33
--- README	11 Aug 2006 07:31:03 -0000	1.32
+++ README	23 Aug 2006 07:04:36 -0000	1.33
@@ -52,21 +52,26 @@
  Python: http://www.python.org
 
    Buildbot requires python-2.2 or later, and is primarily developed against
-   python-2.3. The buildmaster uses generators, a feature which is not
-   available in python-2.1, and both master and slave require a version of
-   Twisted which only works with python-2.2 or later. Certain features (like
-   the inclusion of build logs in status emails) require python-2.2.2 or
-   later, while the IRC 'force' command requires python-2.3 .
+   python-2.3. Specifically, it requires generators, and a version of Twisted
+   which only works with python-2.2 or later. Certain features (like the
+   inclusion of build logs in status emails) require python-2.2.2 or later,
+   while the IRC 'force' command requires python-2.3 . It has been tested
+   against python-2.4 .
 
  Twisted: http://twistedmatrix.com
 
    Both the buildmaster and the buildslaves require Twisted-2.0.x or later.
-   As always, the most recent version is recommended.
+   As always, the most recent version is recommended. It has been tested
+   against Twisted-2.4.0 and Twisted SVN as of the date of release.
 
    When using the split subpackages of Twisted-2.x.x, 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).
+   page, and delivering build status via IRC, respectively). You might also
+   want TwistedConch (for the encrypted Manhole debug port). Note that recent
+   Twisteds require ZopeInterface to be installed as well.
+
+ACCESSORIES:
 
  CVSToys: http://purl.net/net/CVSToys
 
@@ -78,9 +83,8 @@
 
 INSTALLATION:
 
-Please read the User's Manual in docs/buildbot.info (or in HTML form on the
-buildbot web site) for complete instructions. This file only contains a brief
-summary.
+Please read the User's Manual in docs/buildbot.info or docs/buildbot.html for
+complete instructions. This file only contains a brief summary.
 
  RUNNING THE UNIT TESTS
 
@@ -88,11 +92,12 @@
 
  PYTHONPATH=. trial buildbot.test
 
-This should run up to 175 tests, depending upon what VC tools you have
-installed. On my desktop machine it takes about four 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
-process, as it will probably be easier to track down the bug early.
+This should run up to 221 tests, depending upon what VC tools you have
+installed. On my desktop machine it takes about six minutes to complete.
+Nothing should fail (at least under unix), a few might be skipped. If any of
+the tests fail, you should stop and investigate the cause before continuing
+the installation process, as it will probably be easier to track down the bug
+early.
 
 Neither CVS nor SVN support file based repositories on network filesystem
 (or network drives in Windows parlance). Therefore it is recommended to run
@@ -108,11 +113,9 @@
 
 To test this, shift to a different directory (like /tmp), and run:
 
- pydoc buildbot
+ buildbot --version
 
-If it shows you a brief description of the package and its contents, the
-install went ok. If it says "no Python documentation found for 'buildbot'",
-then something went wrong.
+If it announces the versions of Buildbot and Twisted, the install went ok.
 
 
  SETTING UP A BUILD SLAVE:

More information about the Commits mailing list