]> git.saurik.com Git - wxWidgets.git/commitdiff
better __docfilter__ and other epydoc tweaks
authorRobin Dunn <robin@alldunn.com>
Tue, 27 Apr 2004 19:26:48 +0000 (19:26 +0000)
committerRobin Dunn <robin@alldunn.com>
Tue, 27 Apr 2004 19:26:48 +0000 (19:26 +0000)
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@26986 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

21 files changed:
wxPython/contrib/activex/activex.i
wxPython/contrib/gizmos/gizmos.i
wxPython/contrib/glcanvas/glcanvas.i
wxPython/contrib/iewin/iewin.i
wxPython/contrib/ogl/ogl.i
wxPython/contrib/stc/stc.i
wxPython/contrib/xrc/xrc.i
wxPython/src/__init__.py
wxPython/src/_core_ex.py
wxPython/src/calendar.i
wxPython/src/controls.i
wxPython/src/gdi.i
wxPython/src/grid.i
wxPython/src/html.i
wxPython/src/misc.i
wxPython/src/windows.i
wxPython/src/wizard.i
wxPython/wx/build/__init__.py
wxPython/wx/tools/__init__.py
wxPython/wx/tools/img2png.py
wxPython/wx/tools/img2xpm.py

index 6e7c157b45d5e1e3d0fe6fdee0a1da41f4d80023..3b7460921ef2057f7d0a81ef7e0bc27904f3df36 100644 (file)
@@ -25,7 +25,7 @@
 
 %import core.i
 %pythoncode { wx = _core }
-%pythoncode { __docfilter__ = wx.__docfilter__ }
+%pythoncode { __docfilter__ = wx.__DocFilter(globals()) }
 
 MAKE_CONST_WXSTRING_NOSWIG(PanelNameStr);
 
index 8b85c16f3a8f9c36b874fe5bc2a6479d09e8ad0f..b76d189788c809a35e224380c5d45749bb52e195 100644 (file)
@@ -36,7 +36,7 @@
 %import windows.i
 %import controls.i
 %pythoncode { wx = _core }
-%pythoncode { __docfilter__ = wx.__docfilter__ }
+%pythoncode { __docfilter__ = wx.__DocFilter(globals()) }
 
 
 MAKE_CONST_WXSTRING2(DynamicSashNameStr,     wxT("dynamicSashWindow"));
index 5e5c8d77c7e88795f223492b10514cc98372988a..8e1596eecc0cf3b6a5f3ec35f9c30cfaf4a1386e 100644 (file)
@@ -25,7 +25,7 @@
 
 %import core.i
 %pythoncode { wx = _core }
-%pythoncode { __docfilter__ = wx.__docfilter__ }
+%pythoncode { __docfilter__ = wx.__DocFilter(globals()) }
 
 
 MAKE_CONST_WXSTRING2(GLCanvasNameStr, wxT("GLCanvas"));
index 8a1a4169a9f7a8f54d4d08822e31dff083ffe7c3..8ea307ec712db4a779ad7fc716f9312e01c946de 100644 (file)
@@ -25,7 +25,7 @@
 
 %import core.i
 %pythoncode { wx = _core }
-%pythoncode { __docfilter__ = wx.__docfilter__ }
+%pythoncode { __docfilter__ = wx.__DocFilter(globals()) }
 
 MAKE_CONST_WXSTRING_NOSWIG(PanelNameStr);
 
index b7cb72c7722a24ea0c8d040372dc0c6544bd4a03..01bdc1d12f79ac398310a574cfa1accf169c9521 100644 (file)
@@ -24,7 +24,7 @@
 
 %import windows.i
 %pythoncode { wx = _core }
-%pythoncode { __docfilter__ = wx.__docfilter__ }
+%pythoncode { __docfilter__ = wx.__DocFilter(globals()) }
 
 
 MAKE_CONST_WXSTRING_NOSWIG(EmptyString);
index 199798909abfba94f04795d7a27f8fc05633a0cd..51fa9b6860ac9d738bfa71fd63c842027ee414ee 100644 (file)
@@ -25,7 +25,7 @@
 %import core.i
 %import misc.i  // for DnD
 %pythoncode { wx = _core }
-%pythoncode { __docfilter__ = wx.__docfilter__ }
+%pythoncode { __docfilter__ = wx.__DocFilter(globals()) }
 
 MAKE_CONST_WXSTRING(STCNameStr);
 
index 23a04ec32ede231701dac332bd8ac922f13e6413..f7f990aed27c2bb6a71af0516d92c08ea7c9a8d2 100644 (file)
@@ -27,7 +27,7 @@
 
 %import core.i
 %pythoncode { wx = _core }
-%pythoncode { __docfilter__ = wx.__docfilter__ }
+%pythoncode { __docfilter__ = wx.__DocFilter(globals()) }
 
 
 MAKE_CONST_WXSTRING_NOSWIG(EmptyString);
index 65b23070eac67a04db5d87fabcc75dafa7b67a86..d6c0977443576a95ca246dbfb458c06bef6b5f09 100644 (file)
@@ -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('__'))]
index 6c6ff3b1f9ec882b8ea6e0ce2cd77c9f98c87369..ff368615ae39691d30639af1ec842775212e51fd 100644 (file)
@@ -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
 
 #----------------------------------------------------------------------------
 #----------------------------------------------------------------------------
index 8f2f16602b99d3b74241a60001690b1d893d186d..b0466c88e171787a87039c11e818ee6d2008c8b3 100644 (file)
@@ -24,7 +24,7 @@
 
 %import misc.i
 %pythoncode { wx = _core }
-%pythoncode { __docfilter__ = wx.__docfilter__ }
+%pythoncode { __docfilter__ = wx.__DocFilter(globals()) }
 
 %include _calendar_rename.i
 
index eb0cd7ea07445a7e0e4b38758c4ca3e820926e9a..e51a2e628f3dc6175b613a4a9dd2c6ffa7d49c31 100644 (file)
@@ -23,7 +23,6 @@
 
 %import core.i
 %pythoncode { wx = _core }
-%pythoncode { __docfilter__ = wx.__docfilter__ }
 
 %include __controls_rename.i
 
index 4e6acd8f78d7a3613ba1bb3d1ecbedb20869d24e..453b0e9f8e2a78d8e449e44c0582cc427863af1b 100644 (file)
@@ -24,7 +24,6 @@
 
 %import core.i
 %pythoncode { wx = _core }
-%pythoncode { __docfilter__ = wx.__docfilter__ }
 
 %include __gdi_rename.i
 
index c01e8a7bbf275b9210b78aa025393ddd3e09d545..e0e0ae42b1d85e73286783df13906edbf479e422 100644 (file)
@@ -27,7 +27,7 @@
 
 %import windows.i
 %pythoncode { wx = _core }
-%pythoncode { __docfilter__ = wx.__docfilter__ }
+%pythoncode { __docfilter__ = wx.__DocFilter(globals()) }
 
 
 %include _grid_rename.i
index d167819a5f4f42aab6671c6baa25138854504337..164183844e2a74df81dd42877cd1a3196714196a 100644 (file)
@@ -30,7 +30,7 @@
 
 %import windows.i
 %pythoncode { wx = _core }
-%pythoncode { __docfilter__ = wx.__docfilter__ }
+%pythoncode { __docfilter__ = wx.__DocFilter(globals()) }
 
 %include _html_rename.i
 
index a6b6a4990436d25ad4f2a08f6796c92418b0c03f..2919e201e0ec8f5ce50aa41a1279ed2c0833763e 100644 (file)
@@ -25,7 +25,6 @@
 
 %import core.i
 %pythoncode { wx = _core }
-%pythoncode { __docfilter__ = wx.__docfilter__ }
 
 %include __misc_rename.i
 
index 2591e356c3788e57727e2de3c05ff266e8ba333a..5044563f2abb54274d3a174712138bc4d6d5f3bc 100644 (file)
@@ -24,7 +24,6 @@
 
 %import core.i
 %pythoncode { wx = _core }
-%pythoncode { __docfilter__ = wx.__docfilter__ }
 
 %include __windows_rename.i
 
index 309da8bac3a6e46628de591cbb384a929f119bc8..6fd84dff2ecbaa484db3ff3490ee31620a06722c 100644 (file)
@@ -25,6 +25,7 @@
 
 %import windows.i
 %pythoncode { wx = _core }
+%pythoncode { __docfilter__ = wx.__DocFilter(globals()) }
 
 %include _wizard_rename.i
 
index 08c9d6695402e56351aed7589a9aa0523e9d2067..4bf06acf29664edd8c5b3a7a3576fd927395eed8 100644 (file)
@@ -1 +1,20 @@
 # A Python package
+"""
+This package provides the config module, which is used by wxPython's
+setup.py distutils script.  It was moved here so it would be installed
+with the rest of wxPython and could therefore be used by the setup.py
+for other projects that needed this same info and functionality (most
+likely in order to be compatible with wxPython.)
+
+See config.py and wxPython's setup.py for more details.
+
+"""
+
+
+# Exclude config from the epydoc docs because it will currently cause
+# a lot of noise.  Once it has been refactored then add "config" to
+# the list below.
+
+__all__ = []
+
+
index 54e9b268d85896d7c2a293457a98e6eaf36051df..6c958a601432bee1d3cb4fb4054f15ee1eee3f4a 100644 (file)
@@ -1,4 +1,18 @@
-#
+"""
+Some useful tools and utilities for wxPython.
+"""
+
+
+# XRCed is purposfully left out so epydoc won't document it
+__all__ = [
+    'dbg',
+    'genaxmodule',
+    'helpviewer',
+    'img2img',
+    'img2png',
+    'img2py',
+    'img2xpm',
+    ]
 
 
 
index 4416df9ebf216ca0e280ec490dd1961da7409d6a..2f5bc8baab0620161c15b1dcef7762e7ba7f744e 100644 (file)
@@ -14,7 +14,7 @@
 #
 
 """
-img2png.py  -- convert several image formats to PNG format
+img2png.py  -- convert several image formats to PNG format.
 
 Usage:
 
index 97c6d6061dfbea43600c221999c09d02066e07ec..3fa833b0cea347a894cc146160fcfc15f078796b 100644 (file)
@@ -14,7 +14,7 @@
 #
 
 """
-img2xpm.py  -- convert several image formats to XPM
+img2xpm.py  -- convert several image formats to XPM.
 
 Usage: