Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > comp.lang.python > #59868

Doc generation from annotated source code

Date 2013-11-18 14:46 +0100
From Laszlo Nagy <gandalf@shopzeus.com>
Subject Doc generation from annotated source code
Newsgroups comp.lang.python
Message-ID <mailman.2846.1384782415.18130.python-list@python.org> (permalink)

Show all headers | View raw


I just started rewritting my project from python 2 to python 3. I 
noticed that there are these new parameter and return value annotations. 
I have docstrings everywhere in my project, but I plan to convert many 
of them into annotations. The question is: what kind of auto documenting 
system should I use for this? Previously I have used Sphinx. Is it okay 
to use that for python 3 source code? Is there a better alternative?

Thanks

-- 
This message has been scanned for viruses and
dangerous content by MailScanner, and is
believed to be clean.

Back to comp.lang.python | Previous | NextNext in thread | Find similar | Unroll thread


Thread

Doc generation from annotated source code Laszlo Nagy <gandalf@shopzeus.com> - 2013-11-18 14:46 +0100
  Re: Doc generation from annotated source code Ned Batchelder <ned@nedbatchelder.com> - 2013-11-18 14:56 -0800

csiph-web