[Doc-SIG] <tt> tagging (was Re: Some random thoughts)

[Laurence Tratt]

Peter Funk wrote:

> Well.  I think you missunderstood me.  So I will try to explain
> it again:  From my observations and personal use of doc-strings I
> see no necessity for a construct to markup arbitray *in-paragraph*
> code sequences, because they are not really often needed.  So I've
> no objections against the idea to using #code code# for markup of
> such sequences.  But I really don't care much.
> 
> What is far more often needed is to markup *in-paragraph* uses of
> identifiers

Although I'm nowhere near as worried about this as Eddy, I do think that a
reasonable amount of doc strings might use "func(args)" in a paragraph quite
legitimitely. I don't know if that means we should necessarily allow
arbitrary chunks of code via # # or not (personally I don't see it being
used much[0]), but I think we need to think carefully before not including
the func(arg) use.


Laurie

[0] Except by Eddy :)