From: tim_one at email.msn.com (Tim Peters)
Date: Sun, 4 Apr 1999 07:15:50 GMT
Subject: Why are they? Re: Module Documentation Strings
In-Reply-To: <Pine.GSO.3.96.990403203720.881S-100000@crusoe.crusoe.net>
References: <Pine.GSO.3.96.990403203720.881S-100000@crusoe.crusoe.net>
Message-ID: <001101be7e6a$f7cea220$ea9e2299@tim>
X-UID: 616                                                  

[Jeff "evil Japh" Pinyan]
> Why are there documentation strings? ... why not just use
> comment lines?

D:\Python>python
Python 1.5.2b2 (#0, Feb 16 1999, 17:09:09) [MSC 32 bit (Intel)] on win32
Copyright 1991-1995 Stichting Mathematisch Centrum, Amsterdam
>>> dir([])
['append', 'count', 'extend', 'index', 'insert', 'pop', 'remove',
 'reverse', 'sort']
>>> print [].pop.__doc__
[].pop([index]) -> item -- remove and return item at index (default last)
>>>

Comments aren't available for introspection or interactive use.

that's-all-ly y'rs  - tim






