[Epydoc-devel] LaTeX markup

[Jonathan G. <gu...@ni...>]

Hello Ed Loper, et al.,

long time listener, first time caller...


We've been using epydoc on our FiPy project for a couple of years and  
are very happy with it. The one area where we thought there was room  
for improvement was in separating the content from the LaTeX markup  
(I recall similar desire re: HTML/CSS expressed at PyCon'04). We got  
this working well enough for our own needs about two years ago, but  
never cleaned it up enough to pass back. My reward for that lethargy,  
is that I got to merge the changes from 2.1 to 3.0 instead of letting  
Ed do it 8^). I've now managed to pull things together so that  
they're generally usable and brought them up to date with r1588 from  
the epydoc svn repository.

I've posted links to our changed files and some examples of output to  
https://www.matforge.org/fipy/wiki/EpydocLaTeX

There are still some issues I'm working on (there are some  
discrepancies in indexing, for instance), but I'd like to know if  
this is of any interest to the epydoc developers.

If these changes are accepted, then if nobody else is looking at it,  
I'm willing to tackle the inherited methods issue next (our manual is  
just way, way too long with all the inherited methods repeated all  
over the place), and then maybe try to get dot support working.

- Jon