diff --git a/branches/ucs-3.2/ucs-3.2-1/doc/developer-reference/developer-reference-3.2.xml b/branches/ucs-3.2/ucs-3.2-1/doc/developer-reference/developer-reference-3.2.xml index 6d1fc74..66991d3 100644 --- a/branches/ucs-3.2/ucs-3.2-1/doc/developer-reference/developer-reference-3.2.xml +++ b/branches/ucs-3.2/ucs-3.2-1/doc/developer-reference/developer-reference-3.2.xml @@ -33,8 +33,8 @@ - 3.2-0 - 19th of November 2013 + 3.2-1 + 17th of March 2014 diff --git a/branches/ucs-3.2/ucs-3.2-1/doc/developer-reference/ucr/ucr.xml b/branches/ucs-3.2/ucs-3.2-1/doc/developer-reference/ucr/ucr.xml index ed2ac93..8718766 100644 --- a/branches/ucs-3.2/ucs-3.2-1/doc/developer-reference/ucr/ucr.xml +++ b/branches/ucs-3.2/ucs-3.2-1/doc/developer-reference/ucr/ucr.xml @@ -203,21 +203,26 @@ if ucr.is_false('repository/online/unmaintained', True): Modifying variables requires a different approach. - Two functions handler_set() and handler_unset() can be used to set and unset variables. + The function ucr_update() should be used to set and unset variables. Changing &ucsUCRV;s in Python - As handler_set() and handler_unset() don't automatically update any instance of ConfigRegistry, the load() method has to be called manually afterwards to reflect the updated values. + The function ucr_update() requires an instance of ConfigRegistry as its first argument. + The method is guaranteed to be atomic and uses file locking internally to prevent race conditions. + + + The second argument must be a Python dictionary mapping UCR variable names to their new value. + The value must be either a string or None, which is used to unset the variable.