[Doc-SIG] docstring grammar

[Daniel Larsson]

Hmm, I think I had an old email address on the list, and since the latest
employment
haven't enabled me to do much Python programming :-(, I sort of forgot to
fix the
problem. I'll fix that. There is an archive for the list, right? So I can
catch up
on what you all are talking about.

Daniel Larsson

----- Original Message -----
From: Robin Friedrich <friedrich@pythonpros.com>
To: David Ascher <da@ski.org>
Cc: <doc-sig@python.org>; <Daniel.Larsson@telia.com>
Sent: Monday, November 29, 1999 8:44 PM
Subject: Re: [Doc-SIG] docstring grammar


> http://www.python.org/sigs/doc-sig/status.html
>
> Contains an old summary of the formatting rules for Structured Text use in
> doc strings.
>
> Oddly Dan's subscription to this list is disabled, probably from an old
> address. The latest address I have for him is Daniel.Larsson@telia.com
>
> ----- Original Message -----
> From: David Ascher <da@ski.org>
> To: Robin Friedrich <friedrich@pythonpros.com>
> Cc: <doc-sig@python.org>; Daniel Larsson
> <Daniel.Larsson@vasteras.mail.telia.com>
> Sent: Monday, November 29, 1999 1:22 PM
> Subject: Re: [Doc-SIG] docstring grammar
>
>
> > On Mon, 29 Nov 1999, Robin Friedrich wrote:
> >
> > > Some people on this list should remember the development days of
gendoc
> and
> > > it's cleaner successor pythondoc written by Dan Larsson (gosh I hope
I'm
> not
> > > the only one)!
> >
> > Yes, I remember it.  Thanks for the reminder and pointer, Robin!
> >
> > > We pleaded back then for ideas/opinions/hacked code to help improve
the
> > > working code Dan wrote but got little response.
> >
> > FWIW, I think that one problem gendoc/pythondoc had in terms of strategy
> > was that it was billed as a 'tool'.  I think that if we establish a
> > 'blessed standard' then any standard-compliant tool has a guaranteed
user
> > base, and has a far greater likelihood of long-term success.  Also, once
> > the format is documented, then folks who don't like gendoc or for
whatever
> > reason want to do it 'their own way' can still do it in a compatible
way.
> >
> > I'll start digging in gendoc to see the differences between its format
and
> > what I've been discussing.  I'd love to leverage it to build a reference
> > implementation.
> >
> > Dan Larsson, are you reading this discussion?  We could use your
> > experience here!
> >
> > --david
> >
>
>