[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/