[Doc-SIG] Some random thoughts

[David Ascher]

> I nearly did that, but my personal preference is to cut down on
> these sorts of assumptions where possible. My thinking was (without
wishing to start a
> flame war), this sort of auto-pseudo-intelligence is quite Perl like and
> tends to lead one into troubles in the future when one finds a
> need to break the assumption to allow something else to work...

At the risk of offending, it doesn't matter what your aesthetics are.  If
you want your code to become the standard doc-processing tool, it should
process the standard docstrings appropriately -- alternatively, you can
submit one mondo patch and fight that battle.

--david