[Doc-SIG] which characters to use for docstring markup
Hernan Martinez Foffani
hernan@orgmf.com.ar
Sat, 7 Apr 2001 00:21:38 +0200
Eduard on a mini-markup language for docstrings propose:
"... either C{code}, E{emph} etc.
or `literal` and *one* *word* *emph* (and that's it)..."
Guido: "... I still like C<code> and *multi word emph* better. :-)"
Tim: "... C{code}, E{emph} ..."
Greg: "... C{code} or E<emph> or E{emph} or whatever ..."
And it's just a two-tags markup language! :-)
Sorry guys, it's almost 1:00AM and couldn't resist!
:-)
Seriously now.
Here are my 2 cents just to fill the email with something other than a
stupid joke.
I don't care the tag syntax if:
a) either not many more than the "two-tags ML", or
I don't have to be aware of the rest of the tags while
commenting code.
b) escape = backslash
Again :-)
Have a nice weekend!
-Hernan
--
Hernán Martínez Foffani
hernan@orgmf.com.ar
http://www.orgmf.com.ar/condor/