exarkun@magnon:~$ cd epytext-test/ exarkun@magnon:~/epytext-test$ mkdir foo exarkun@magnon:~/epytext-test$ touch foo/__init__.py exarkun@magnon:~/epytext-test$ cat > foo/bar.py def f(): """ B{foo bar} """ exarkun@magnon:~/epytext-test$ pydoctor --make-html --verbose --verbose --add-package foo/ adding directory /home/exarkun/epytext-test/foo processing ['foo.__init__'] processing ['foo.bar'] WARNING: guessing foo for project name /home/exarkun/Projects/Twisted/trunk/twisted/web/http.py:40: RuntimeWarning: Python C API version mismatch for module _c_urlarg: This Python has API version 1012, module _c_urlarg has version 1013. from twisted.protocols._c_urlarg import unquote writing html to apidocs using pydoctor.nevowhtml.writer.NevowWriter starting ModuleIndexPage ... took 0.505011s starting ClassIndexPage ... took 0.006259s starting IndexPage ... took 0.107010s starting NameIndexPage ... took 0.020194s starting UndocumentedSummaryPage ... took 0.087143s Package 'foo' Module 'foo.bar' epytext error in Function 'foo.bar.f' 1 2 B{foo 3 bar} 4 Line 1: Unbalanced '{'. B{foo ^ Module 'foo.__init__' exarkun@magnon:~/epytext-test$ epydoc --verbose --verbose foo/ Building documentation [ 0%] foo (/home/exarkun/epytext-test/foo/__init__) [100%] foo.bar (/home/exarkun/epytext-test/foo/bar.py) Merging parsed & introspected information [ 0%] foo [ 33%] foo [ 66%] foo.bar Linking imported variables [ 0%] foo [ 33%] foo.bar Indexing documentation [ 0%] foo [ 50%] foo.bar Parsing docstrings [ 0%] foo [ 33%] foo.bar Inheriting documentation Sorting & Grouping [ 0%] foo [ 33%] foo.bar Writing HTML docs to 'html' [ 4%] epydoc.css [ 8%] epydoc.js [ 12%] identifier-index.html [ 41%] module-tree.html [ 50%] help.html [ 54%] frames.html [ 58%] toc.html [ 62%] toc-everything.html [ 66%] toc-foo-module.html [ 70%] toc-foo.bar-module.html [ 75%] foo-module.html [ 79%] foo.bar-module.html [ 83%] foo.bar-pysrc.html [ 87%] foo-pysrc.html [ 91%] redirect.html [ 95%] api-objects.txt [100%] index.html Timing summary: Building documentation............. 0.5s |========================================================================================================== Merging parsed & introspected i.... 0.0s | Linking imported variables......... 0.2s |================================= Indexing documentation............. 0.0s | Parsing docstrings................. 0.0s | Inheriting documentation........... 0.0s | Sorting & Grouping................. 0.0s | Writing HTML docs to 'html'........ 0.1s |===================== exarkun@magnon:~/epytext-test$