changeset 758:439817d28d4f

add warning about unstable attachment xmlrpc API
author Thomas Waldmann <tw AT waldmann-edv DOT de>
date Thu, 08 Jun 2006 18:16:24 +0200
parents 38914e43f0dd
children 6389a1d32527
files MoinMoin/xmlrpc/__init__.py
diffstat 1 files changed, 8 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/MoinMoin/xmlrpc/__init__.py	Thu Jun 08 17:30:01 2006 +0200
+++ b/MoinMoin/xmlrpc/__init__.py	Thu Jun 08 18:16:24 2006 +0200
@@ -398,6 +398,12 @@
                  self._outstr(results.formatContext(hit, 180, 1)))
                 for hit in results.hits]
 
+    # XXX BEGIN WARNING XXX
+    # All xmlrpc_*Attachment* functions have to be considered as UNSTABLE API -
+    # they are neither standard nor are they what we need when we have switched
+    # attachments (1.5 style) to mimetype items (hopefully in 1.6).
+    # They are likely to get removed again when we remove AttachFile module.
+    # So use them on your own risk.
     def xmlrpc_listAttachments(self, pagename):
         """ Get all attachments associated with pagename
         
@@ -462,6 +468,8 @@
         os.chmod(filename, 0666 & config.umask)
         AttachFile._addLogEntry(self.request, 'ATTNEW', pagename, filename)
         return xmlrpclib.Boolean(1)
+    
+    # XXX END WARNING XXX
 
     def process(self):
         """ xmlrpc v1 and v2 dispatcher """