#423 Make Docstring, replace "@" with ":"

[Jari Pennanen]

Hi!

"Make Docstring" functionality is awesome time saver, but since Sphinx doc generation starts to be de-facto (it's even in official Python!) it would be nice to be able to use Sphinx syntax, so replace the @something with :something... Difference of EpyDoc and Sphinx syntax is pretty much only that, the @-sign is replaced with :-character.

Maybe make a option to settings to replace "@" with ":".

[Glyph Lefkowitz]

Ideally this would be controlled via the __docformat__ variable.

http://www.python.org/dev/peps/pep-0258/#choice-of-docstring-format

Despite this specification's explicit rejection of package->module cascading, IMHO it would be nice if packages could specify a __docformat__ for themselves.

Although personally, since Twisted uses epytext, I'm happy for things to stay how they are. :)