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 | <20100414114349.304cae1d@heresy> |
On Apr 14, 2010, at 11:13 PM, Ralf Gommers wrote: >You're a core developer (I think). But for the *average* user, do you really >think tags are fine? Earlier in this thread there was a mention of people >that love to read XML. I'm exaggerating a bit of course, but this is >similar. Whitespace beats tags for readability. Well, I would think that help output, whether in a terminal or online would use the raw text to do a nicer job of formatting. It's source code readability that concerns 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) iQIcBAEBCAAGBQJLxeK1AAoJEBJutWOnSwa/C3EQALfp1nRmVzzjILmz+gIhduSL bH7Qle0zE9fqE2h1td84acduP3G78gti8Xl7VOkV3h9kY63QMsOLYrm5fr7p8dsR d4nayWTqv+sA+b99SRYHmUBc9b2WPZ3pTxFsHn6Amb5ZV7hPVhDF3zjAwWqfJEP1 dtDB6bnsuOCCPThpLwVJ7THVb/Gl5dnwjfKY23F1MHF5t+dz/EFIIrD2UaDGW7Xr Tie/Qyz54locmkdfb2SnYcdT9FH9czSBlyEqsrOpBOaGYePzcsFqixWC6ExHZrsW 7yt85zfnR91aQEk7r/DiUb7+eet+3NAjQ8bNPYQrUghmycFieeNEt97pP/9QnC49 zkVNtK5AetpB/1Usfmih588uf3xsrRjgVWS9VGve0V96SLi5+eE8AifonXUU3GpF 4c/1QtKE4Z6PJgX3w+2QNl5776XKW8m21bFYty/Mx1wR8nxE+TMubRt6l3bhrJ9x usEpt2Me60qD1OCQCrGqH15EzchKJMLzLAayTpycsBBd+qF4j14CSviWxeJCd8qn JdBY+eI76iyxkpBae4pq3CAFdyJ7f8t1x4Rkalc6vCdkJhZBxCtIwKq2+E1TiZ31 UyKBK77ZNvNtbjf7DKU0O14bkX9tQ8KXOqMd83eZAhjIFx+yKiI/ZTfcKjcV6vfy GUBBy+0YMxvZQXR0eASK =Svpr -----END PGP SIGNATURE-----