On Tuesday 21 October 2003 11:19 am, amk@amk.ca wrote:
> On Tue, Oct 21, 2003 at 09:02:46AM -0400, David Binger wrote:
> > The fact that we don't have convenient template docstrings is annoying
> > though, and seems like another problem worth solving.
>
> But how could it be solved?  Early on various alternatives were suggested:
>
> 1) No docstrings, unless you do foo.__doc__ = '...'.
> 2) The first string is always a docstring.  (Introducing that now
>    would break existing templates.)
> 3) Guess if the first string is a docstring or not.  (Eek!)
> 4) Mark docstrings specially: d"docstring", or something like that.

Is it possible to take the first lines under the function signature that start
with pound signs?  That's how I write the docstrings for my ptl functions
now.

Regards,

Mark