It's taking me longer than expected to finish building the
distribution packages.
There are instructions in doc/internal/dist.txt describing how to put
together the release, I'm having problems with generating the
documentation.
My environment throws a traceback with some interaction between
docutils and epydoc when generating the html api reference. Last
couple of lines of the traceback:
File "/usr/local/lib/python2.6/dist-packages/docutils-0.6-py2.6.egg/
docutils/nodes.py", line 129, in walk
visitor.dispatch_visit(self)
File "/usr/local/lib/python2.6/dist-packages/docutils-0.6-py2.6.egg/
docutils/nodes.py", line 1604, in dispatch_visit
return method(node)
File "/home/ben/pygletdev/pyglet-1.1.4-rc1/tools/epydoc/epydoc/
markup/restructuredtext.py", line 305, in visit_paragraph
m = re.match(r'(\s*[\w\W]*?\.)(\s|$)', child.data)
AttributeError: 'Text' object has no attribute 'data'
This may or may not be causing a second error when generating the html
guide:
Generating HTML guide...
Traceback (most recent call last):
File "tools/gendoc_html.py", line 388, in <module>
api_objects = get_api_objects(options.apidoc_dir)
File "tools/gendoc_html.py", line 360, in get_api_objects
apidoc_file = open(os.path.join(apidoc_dir, 'api-objects.txt'))
IOError: [Errno 2] No such file or directory: 'tools/../doc/html/api/
api-objects.txt'
And yeah, that file doesn't exist, though the directory does. I
suspect it's put there by the preceding stage.
The final error I'm seeing I'm also having a hard time tracking down,
I get an ImportError from the line "from docutils.writers import
docbook" and I so far haven't discovered the package that supplies
this.
I'm afraid I'm fairly unfamiliar with these tools, so it could be as
simple as a misconfiguration.
I've been able to put together the .msi package, source package, and
the various eggs and spending some time here and there on these
problems.
-b