[Doc-SIG] Re: Docstrings [was: On David Ascher's Rant]
Manuel Gutierrez Algaba
Manuel Gutierrez Algaba <firstname.lastname@example.org>
Mon, 29 Nov 1999 16:30:13 +0000 (GMT)
On Sun, 28 Nov 1999, David Ascher wrote:
> Some reactions to this weekend's posts:
> 1) Manuel's proposal is interesting, but IMHO much broader in scope than
> what I feel is needed and doable. Indexing ideas is a
> larger-than-encyclopedic endeavor, and I could but won't argue its
> impracticality on statistical grounds alone. Suffice it to say that I
> agree with Manuel that people are lazy and that it won't work.
But, if we can do it, then that'll be great!!!
> More positively, Manuel, do you agree that the kind of markup that I
> advocate (a la POD/javadoc) is a subset of yours (in other words that
> "Author" and "Argument 1" are 'trivial ideas', hence belong to the set
> of ideas? And that if this 'minimal' markup is used, then you can use
> the tags too along with the other, higher-level notions that you
That's not my original idea, but if we can handle indexes with
attributions, simple ideas when attributions, then yes!
The simplest syntax is just indexes, then indexes with attributes,
then indexes with complex attributes, then XML-ish stuff
www.ctv.es/USERS/irmina /TeEncontreX.html /texpython.htm
If something has not yet gone wrong then it would ultimately have been beneficial for it to go wrong.