Re: [Pythoncard-users] epydoc generated docs for developers

[Kevin A. <al...@se...>]

On May 1, 2004, at 2:35 AM, Andy Todd wrote:

> Kevin Altis wrote:
>> I'm going to periodically build a set of docs based on the framework 
>> code in cvs using epydoc. I haven't figured out how I'm going to 
>> suppress all the wxWidgets classes yet, which makes the docs pretty 
>> large and something I don't want to host on the main site as separate 
>> HTML files yet. Instead, I've zipped up all the files into one 
>> archive, which you can download and view on your local machine. The 
>> zip is 2.7MB.
>> http://pythoncard.sourceforge.net/zips/PythonCard-html-2004-04-30.zip
>> ka
>
> As an alternative to downloading the file is it possible that someone 
> with a checkout of CVS can generate their own? If so any instructions 
> will be welcome.
>
I didn't do anything special, I just did a cd to the Scripts dir and 
supplied the path to my copy of PythonCard. So, it looked like this 
with the Win2K command-prompt.

C:\Python23\Scripts>epydoc.py \python\PythonCard

So anyone can generate their own for an older version of PythonCard as 
well.

I was unable to build the docs until I applied the patch below to my 
release copy of epydoc. If you're using epydoc from cvs, then you 
shouldn't have a problem.

ka
---
"""
It looks like I'm using equality testing where I should be using 
identity testing (since "x in lst" uses equality testing).  I just 
checked the a change into cvs, which should fix the problem.  (I 
included the diff below.)  Let me know if it fixes it.  If you're still 
running into trouble, then just send me the traceback and I'll track 
down the problem.

-Edward
"""

Diff for change (already checked in to cvs):
> Index: uid.py
> ===================================================================
> RCS file: /cvsroot/epydoc/epydoc/src/epydoc/uid.py,v
> retrieving revision 1.51
> diff -u -r1.51 uid.py
> --- uid.py      9 Apr 2004 13:53:24 -0000       1.51
> +++ uid.py      18 Apr 2004 04:14:17 -0000
> @@ -582,11 +582,15 @@
>                  elif (isinstance(obj, _TypeType) and
>                        hasattr(obj, '__module__')):
>                      self._module = 
> ObjectUID(import_module(obj.__module__))
> -                    if (self._module is not None and
> -                        obj not in 
> self._module.value().__dict__.values()):
> -                        # The __module__ attribute lied; try finding 
> it ourselves.
> -                        module = _find_builtin_obj_module(obj)
> -                        if module is not None: self._module = 
> ObjectUID(module)
> +                    if self._module is not None:
> +                        for val in 
> self._module.value().__dict__.values():
> +                            if val is obj: break
> +                        else:
> +                            # The __module__ attribute lied; try
> +                            # finding it ourselves.
> +                            module = _find_builtin_obj_module(obj)
> +                            if module is not None:
> +                                self._module = ObjectUID(module)
>                  elif isinstance(obj, _TypeType):
>                      module = _find_builtin_obj_module(obj)
>                      if module is None: self._module = None