- LP #142535: Fix faulty docstring for manage_changeProperties which

  incorrectly suggested that passing a simple dictionary as REQUEST
  argument was supported.

doc/CHANGES.rst

@@ -181,6 +181,10 @@ Features Added
 Bugs Fixed
 ++++++++++
 
+- LP #142535: Fix faulty docstring for manage_changeProperties which
+  incorrectly suggested that passing a simple dictionary as REQUEST
+  argument was supported.
+
 - LP #374818: Use module-provided functions as opposed to the old
   "folder methods" when creating folders and user folders in
   ZopeTestCase.

src/OFS/PropertyManager.py

@@ -316,8 +316,8 @@ class PropertyManager(Base, ElementWithAttributes):
     def manage_changeProperties(self, REQUEST=None, **kw):
         """Change existing object properties.
 
-        Change object properties by passing either a mapping object
-        of name:value pairs {'foo':6} or passing name=value parameters
+        Change object properties by passing either a REQUEST object or
+        name=value parameters
         """
         if REQUEST is None:
             props={}

src/OFS/PropertySheets.py

@@ -441,9 +441,11 @@ class PropertySheet(Traversable, Persistent, Implicit):
 
     security.declareProtected(manage_properties, 'manage_changeProperties')
     def manage_changeProperties(self, REQUEST=None, **kw):
-        """Change existing object properties by passing either a mapping
-           object of name:value pairs {'foo':6} or passing name=value
-           parameters."""
+        """Change existing object properties.
+
+        Change object properties by passing either a REQUEST object or
+        name=value parameters
+        """
         if REQUEST is None:
             props={}
         else: props=REQUEST

src/OFS/interfaces.py

@@ -797,8 +797,8 @@ class IPropertyManager(Interface):
     def manage_changeProperties(REQUEST=None, **kw):
         """Change existing object properties.
 
-        Change object properties by passing either a mapping object
-        of name:value pairs {'foo':6} or passing name=value parameters
+        Change object properties by passing either a REQUEST object or
+        name=value parameters
         """
 
     def manage_changePropertyTypes(old_ids, props, REQUEST=None):

src/Products/OFSP/help/PropertySheet.py

@@ -165,9 +165,8 @@ class PropertySheet:
     def manage_changeProperties(REQUEST=None, **kw):
         """
 
-        Change existing object properties by passing either a mapping
-        object as 'REQUEST' containing name:value pairs or by passing
-        name=value keyword arguments.
+        Change object properties by passing either a REQUEST object or
+        name=value parameters
 
         Some objects have "special" properties defined by product
         authors that cannot be changed. If you try to change one of
@@ -178,7 +177,7 @@ class PropertySheet:
         ensure that the updated values are of the correct type.
         *This should probably change*.
 
-        If a value is provided for 'REQUEST' (as it will be when
+        If a REQUEST object is passed (as it will be when
         called via the web), the method will return an HTML message
         dialog. If no REQUEST is passed, the method returns 'None' on
         success.