Re: epydoc reST markup for stdlib docstrings

Barry Warsaw <[email protected]>
Newsgroups gmane.comp.python.documentation
Organization Damn Crazy Followers of the Horn
Message-ID <20100414114142.421d6482@heresy>
On Apr 14, 2010, at 04:56 PM, Michael Foord wrote:

>I would say that reading docstrings in a terminal is the *main* use case 
>- but that is why I tend to value the vertical space highly and 
>personally prefer the less verbose way.

I agree about the vertical whitespace when reading in the terminal.  You also
want compact output for online docs too though.

I'm tempted to say that whatever Georg implements in Sphinx is good enough for
me. :)

-Barry

_______________________________________________
Doc-SIG maillist  -  [email protected]
http://mail.python.org/mailman/listinfo/doc-sig
signature.asc (application/pgp-signature, 836 B)
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.10 (GNU/Linux)

iQIcBAEBCAAGBQJLxeI3AAoJEBJutWOnSwa/NlcP/0R6zTBGEMDITDasfwV2TESV
m0lNyVZWT1u4fkCKHfp/rxCEsBrHV4V/5kcQr3cFUx3c54Q8WewT/84vV/Tn8bag
aZyAjepO/+0TPPbFoMGLYlznVpQxqUZA4JdjXW9NCvemO0GoTd74fOR76RENRE/4
9IyHsJMbVDrfBd2phkRqykkYlKpVw1KzlNqoWZ72oH16Cmmy/1qG4H2fgvSICTMX
RS0ZaimOhnlqBETn5yfK99lysLqJiYUGP+XcUwOoYnNdVmfWHVQIGVg66i+6xrOI
LR1kSp4jVz4uiYtNCXv9n6c/dogjp7h8ivFzZ4CmvQjInHRoYetl+t4mAhBTmlN9
/LA/vl2vFAQN3eKVVTaZzci9O9y9KZ58bxJabOxu9KBebCmMMdM5qaaES69C4gm6
tyakY209ixiPqEeeZqiDd/oFta3DUIlVsUZ9iGiOdngTXZtxOVgDrGRQbE3Y1ao9
j+TIk6YLAvHtxTijGKsKNg4MJ5xwb6NglfJD+aRATf9OvpwJdKrLMzj1YfL3xrhN
MLDwpCzffM2Ab/8Ceu9ZDyFPGWiro5F5dkCjHgf/zoYAgEbCHkilz+bzB9LoWvYs
94/Gg2i95OUjgCj6UDTcOl7Yx8GHs5mKjajd6mhJxH0p9BVUtPpspPhuTa1k1taY
nw+ySnaeHkv1M7ayEKlX
=UOt3
-----END PGP SIGNATURE-----
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.