More random python observations from a perl programmer
John Max Skaller
skaller at maxtal.com.au
Sat Aug 21 01:53:12 CEST 1999
On Fri, 20 Aug 1999 02:54:36 +0200, Per Kistler <kistler at fnmail.com> wrote:
>Tom Christiansen wrote:
>> The fact that they did icky windows help and not man pages says
>> something significant.
>Why not create something like perldoc for python?
>There must be others missing it...
Such tools exist, but Pythons docstrings
are not as well principled as Perl's perldod.
OTOH, the most powerful literate programming
tool available, interscript, can be used to document python (or perl)
and it makes perlpod (and javadoc) look a bit micky mouse: it is written
in python, can be extended 'indocument' in python,
and it supports perlpod as well :-)
So in some sense Python offers two options,
'unstructured doc strings' -- which are available at run time --
and fully blown book/web site generation. Perlpod and
javadoc sit in between (neither is 'online', and neither
is powerful enough to generate 'real' documentation)
John Max Skaller ph:61-2-96600850
mailto:skaller at maxtal.com.au 10/1 Toxteth Rd
http://www.maxtal.com.au/~skaller Glebe 2037 NSW AUSTRALIA
More information about the Python-list