From be71b8d7c957590aecb593e5c9be315aa189729f Mon Sep 17 00:00:00 2001 From: Thierry Parmentelat Date: Wed, 3 Jun 2015 17:12:37 +0200 Subject: [PATCH] add a docstring note about Allocate and the append option --- sfa/methods/Allocate.py | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/sfa/methods/Allocate.py b/sfa/methods/Allocate.py index e386b308..e1367667 100644 --- a/sfa/methods/Allocate.py +++ b/sfa/methods/Allocate.py @@ -23,7 +23,16 @@ class Allocate(Method): @param slice_urn (string) URN of slice to allocate to @param credentials (dict) of credentials @param rspec (string) rspec to allocate - + @param options (dict) + + The PL driver implements here an important option named + 'append' that affects the management of slice tags. + It is recommended to set this option to True, and to not pass + any slice tag in the incoming rspec, in which case + you are guaranteed to leave slice tags alone. + + See also http://svn.planet-lab.org/wiki/SFASliceTags + """ interfaces = ['aggregate', 'slicemgr'] accepts = [ -- 2.43.0