better __docfilter__ and other epydoc tweaks

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@26986 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

wxPython/src/__init__.py

@@ -26,7 +26,16 @@ __all__ = [
     'calendar',
     'grid',
     'html',
-    'wizard',    
+    'wizard',
+
+    # contribs (need a better way to find these...)
+    'activex',
+    'gizmos',
+    'glcanvas',
+    'iewin',
+    'ogl',
+    'stc',
+    'xrc',
     ]
 
 # Load the package namespace with the core classes and such
@@ -36,7 +45,7 @@ del wx
 # Load up __all__ with all the names of items that should appear to be
 # defined in this pacakge so epydoc will document them that way.
 import wx._core
-__docfilter__ = wx._core.__docfilter__
+__docfilter__ = wx._core.__DocFilter(globals())
 
 __all__ += [name for name in dir(wx._core)
             if not (name.startswith('__') and name.endswith('__'))]

wxPython/src/_core_ex.py

@@ -222,14 +222,22 @@ class FutureCall:
 # documented (or will be) as part of the classes/functions/methods
 # where they should be used.
 
-def __docfilter__(name):
-    import types
-    obj = globals().get(name, None)
-    if type(obj) not in [type, types.ClassType, types.FunctionType, types.BuiltinFunctionType]:
-        return False
-    if name.startswith('_') or name.endswith('Ptr') or name.startswith('EVT'):
-        return False
-    return True
+class __DocFilter:
+    """
+    A filter for epydoc that only allows non-Ptr classes and
+    fucntions, in order to reduce the clutter in the API docs.
+    """
+    def __init__(self, globals):
+        self._globals = globals
+        
+    def __call__(self, name):
+        import types
+        obj = self._globals.get(name, None)
+        if type(obj) not in [type, types.ClassType, types.FunctionType, types.BuiltinFunctionType]:
+            return False
+        if name.startswith('_') or name.endswith('Ptr') or name.startswith('EVT'):
+            return False
+        return True
 
 #----------------------------------------------------------------------------
 #----------------------------------------------------------------------------

wxPython/src/calendar.i

@@ -24,7 +24,7 @@
 
 %import misc.i
 %pythoncode { wx = _core }
-%pythoncode { __docfilter__ = wx.__docfilter__ }
+%pythoncode { __docfilter__ = wx.__DocFilter(globals()) }
 
 %include _calendar_rename.i
 

wxPython/src/controls.i

@@ -23,7 +23,6 @@
 
 %import core.i
 %pythoncode { wx = _core }
-%pythoncode { __docfilter__ = wx.__docfilter__ }
 
 %include __controls_rename.i
 

wxPython/src/gdi.i

@@ -24,7 +24,6 @@
 
 %import core.i
 %pythoncode { wx = _core }
-%pythoncode { __docfilter__ = wx.__docfilter__ }
 
 %include __gdi_rename.i
 

wxPython/src/grid.i

@@ -27,7 +27,7 @@
 
 %import windows.i
 %pythoncode { wx = _core }
-%pythoncode { __docfilter__ = wx.__docfilter__ }
+%pythoncode { __docfilter__ = wx.__DocFilter(globals()) }
 
 
 %include _grid_rename.i

wxPython/src/html.i

@@ -30,7 +30,7 @@
 
 %import windows.i
 %pythoncode { wx = _core }
-%pythoncode { __docfilter__ = wx.__docfilter__ }
+%pythoncode { __docfilter__ = wx.__DocFilter(globals()) }
 
 %include _html_rename.i
 

wxPython/src/misc.i

@@ -25,7 +25,6 @@
 
 %import core.i
 %pythoncode { wx = _core }
-%pythoncode { __docfilter__ = wx.__docfilter__ }
 
 %include __misc_rename.i
 

wxPython/src/windows.i

@@ -24,7 +24,6 @@
 
 %import core.i
 %pythoncode { wx = _core }
-%pythoncode { __docfilter__ = wx.__docfilter__ }
 
 %include __windows_rename.i
 

wxPython/src/wizard.i

@@ -25,6 +25,7 @@
 
 %import windows.i
 %pythoncode { wx = _core }
+%pythoncode { __docfilter__ = wx.__DocFilter(globals()) }
 
 %include _wizard_rename.i