Jarkko Hietaniemi <[EMAIL PROTECTED]> writes:
[...]
> > Another alternative would be Javadoc / doxygen / ... style comments
> > (say #@ introduces a comment to be extracted).
>
> Yuk. More magic to remember. Me hate.
What magic? The program that does the documentation isn't going to be
called `perl' (`perl' is the name of the program that exhibits the
bugs in what you wrote). We already have 3 ways of getting Perl to
ignore things (comments, =BLAH, and void context; do we really need
another 3?
> I say bring the documentation so close to the thing it documents
> that they can see each others' nose hair.
Have you looked at the documentation that SWIG auto-generates?
--
Ariel Scolnicov |"GCAAGAATTGAACTGTAG" | [EMAIL PROTECTED]
Compugen Ltd. |Tel: +972-2-6795059 (Jerusalem) \ We recycle all our Hz
72 Pinhas Rosen St. |Tel: +972-3-7658514 (Main office)`---------------------
Tel-Aviv 69512, ISRAEL |Fax: +972-3-7658555 http://3w.compugen.co.il/~ariels