From 6b3a81ad5119851d099ab364d1738f610ae65035 Mon Sep 17 00:00:00 2001 From: Jared Grubb Date: Sat, 18 Apr 2015 19:25:08 -0700 Subject: [PATCH] Trigger doc: add note about properties in dynamic triggers --- master/docs/manual/cfg-buildsteps.rst | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/master/docs/manual/cfg-buildsteps.rst b/master/docs/manual/cfg-buildsteps.rst index c0e80fe9754..e37e9c89dee 100644 --- a/master/docs/manual/cfg-buildsteps.rst +++ b/master/docs/manual/cfg-buildsteps.rst @@ -2777,7 +2777,11 @@ For this purpose, Trigger step support a method that you can customize in order :returns: list of tuples (schedulerName, propertiesDict) optionally via deferred This methods returns a list of tuples describing what scheduler to trigger, with which properties. - With this method, you can trigger several time the same scheduler with different set of properties. + The properties should already be rendered (ie, concrete value, not objects wrapped by ``Interpolate`` or + ``Property``). Since this function happens at build-time, the property values are available from the + step and can be used to decide what schedulers or properties to use. + + With this method, you can also trigger the same scheduler multiple times with different set of properties. The sourcestamp configuration is however the same for each triggered build request.