[Doc-SIG] ``invisible`` reST-directive

David Goodger goodger at python.org
Mon May 31 13:28:21 EDT 2004


Felix Wiemann wrote:
 > I propose adding a new directive 'invisible' to the reST-syntax,
 > which translates to the already existing doctree element 'comment'.

I don't like the name "invisible".  Why not "comment"?  There's a
possible objection that it might be confused with admonition
directives, like "note" and "caution", but I consider that to be
minor.

+1 with the name "comment".

And please, let's use another thread for the syntax discussion.

-- 
David Goodger <http://python.net/~goodger>



More information about the Doc-SIG mailing list