[Doc-SIG] epydoc 1.0 release

David Goodger goodger@users.sourceforge.net
Thu, 26 Sep 2002 21:21:21 -0400


Edward Loper wrote:
> I think that reST uses too many different inline markup constructs,
> that can interact with each other in weird and non-intuitive ways.

You're entitled to your opinion, of course.  But can you back up this
claim of "weird and non-intuitive" interaction?

> But constructs like ``this`` and
> #this# and `this`_ seem significantly less obvious to me.

Correction: #this# has no meaning in reStructuredText.

> I prefer a single unified inline markup syntax, that almost never
> requires any escaping.

To each his own. :-)  But please note that reStructuredText inline
markup rarely requires any escaping.

-- 
David Goodger  <goodger@users.sourceforge.net>  Open-source projects:
  - Python Docutils: http://docutils.sourceforge.net/
    (includes reStructuredText: http://docutils.sf.net/rst.html)
  - The Go Tools Project: http://gotools.sourceforge.net/