On Apr 8, 3:21 pm, Hans Georg Schaathun <h...@schaathun.net> wrote: > Interesting tool, but it solves only part of the problem. > I could use it as a replacement for pylit, but I would then still > have the problem of commenting code within a block, which is a > reST/sphinx problem.
I'm sorry; I don't understand "commenting code within a block" but I wondered if it meant you were not fully familiar with the idea of the web-type programs. Instead of looking to typeset the comments, you uses chunks. Thus a <<main>> chunk may be something like (pyweb has somewhat different syntax) <<main>> def main(argv=None,log=None): <<read command line argument>> <<handle options>> <<run driver routine>> <<report results>> Before each chunk comes the description of what that chunk does. Something like This routine factors $n$ finding any factors that are powers of a prime number. <<run driver routine>> def driver(n,opt1,opt2): <<find square root>> <<factor>> is a rough idea (here $n$ is a LaTeX; you can do HTML or RST). So you are commenting the chunks, which can be blocks of the code. > Alternatively, I could use pyweb directly with LaTeX. However, then > I would need to find or create macro packages which provide the > features of reST directly in LaTeX. Do you know of a good candidate? What features? Jim -- http://mail.python.org/mailman/listinfo/python-list