Reviewed documentation of Amount interface and split the different parts of...

Reviewed documentation of Amount interface and split the different parts of the interface for better readabilit (although such parts are private).

git-svn-id: https://svn.erp5.org/repos/public/erp5/trunk@30623 20353a03-c40f-0410-a6d1-a30d3c3de9de

product/ERP5Type/Core/Folder.py

@@ -1161,6 +1161,10 @@ class Folder(CopyContainer, CMFBTreeFolder, CMFHBTreeFolder, Base, FolderMixIn,
         # It will be less efficient in this case. We also do not
         # use this heuristic whenever activate_kw is defined
         self._reindexObject(**kw)
+        # XXX-JPS: Here, we could invoke Folder_reindexAll instead, like this:
+        #   self.Folder_reindexAll()
+        #   return
+        # this shows that both methods should be merged.
         for c in self.objectValues():
           if getattr(aq_base(c),
                     'recursiveReindexObject', None) is not None: