[Zope-dev] STX and underline symbology

[Alastair Burt]

In the current version of STX, the underline symbology is not very good for
documenting Python. In the string "python_function1 does this, and
python_function2 does that", "function1 does this, and python" gets
underlined. I think it would be better if either:

  1) there are no spaces in strings to underline, only more '_'
     (_this_is_an_example_), or

  2) the final "_" should be followed by whitespace or punctuation.

--- Alastair