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 mailing list