>>>>> "Robert" == Robert Dodier <robert.dodier at gmail.com> writes:
Robert> Well, this is problematic. (1) Maxima functions are often not associated
Robert> with a function of the same name, or any single function for that matter.
Robert> (2) Even if Maxima docs were implemented with doc strings,
Robert> it doesn't obviate the need for some kind of formatting markup.
Robert> (3) When docs are embedded in the source code, touching the
Robert> docs means touching the source files. Then when you try to trace
Robert> the history of some file you have to disentangle the two kinds of
Robert> changes. (4) Where do we put translations into Spanish, etc?
Robert> (5) What's important to users is generally different from what's
Robert> important to programmers. Trying to smash both into the source
Robert> code seems messy; source code should document stuff that's
Robert> important to programmers.
Sorry, I didn't really mean to imply that the docstrings be the
exclusive source for the actual documentation. While it could be used
as such, there are clearly different needs, as you point out.
Ray