[Buildbot-devel] Documentation feedback for Triggerable schedulers

[Charles Bacon]

At http://buildbot.net/repos/release/docs/buildbot.html there's a  
small disconnect between the documentation at the anchor #Triggerable- 
Scheduler and #Triggering-Schedulers

Triggerable-Scheduler shows you constructing rules with:
from buildbot.steps import trigger
f.addStep(trigger.Trigger('mktarball', schedulers=['mktarball'],
                                             waitForFinish=True)

Triggering-Schedulers shows triggering rules like:
from buildbot.steps.trigger import Trigger
f.addStep(Trigger(schedulerNames=['build-prep'],
                   waitForFinish=True,
                   updateSourceStamp=True))

For what it's worth, I didn't have any luck with the trigger.Trigger  
version from Triggerable-Scheduler.  As in, I got errors during  
buildbot reconfig when my master.cfg had rules of that form.  Using  
the form from Triggering-Schedulers gave me no problems.

It's possible that I had the wrong import statements setup the first  
time, but it would be nice if the documentation settled on a single  
way of writing the Trigger steps, lest other people run into trouble  
like I did.


Charles