On Wed, May 6, 2009 at 3:42 PM, Leon Timmermans <faw...@gmail.com> wrote: > Most people seem to lean towards the pod comments, though I disagree > with it on a simple ground: aesthetics. Python docstrings aren't just > useful, they are reasonably pretty too, #={} isn't. In fact I'd say > it's pretty fugly. I think that a feature that we intend to be used > often should be more aesthetically pleasing, if only to promote its > use. > > Leon >
You have a point there. Python's triple double-quote (sextuple?) delimiters are neater. I'm not sure what the end-of-line version (see earlier discussion of #=) of that would look like, though. What about using #= for end-of-line docstrings and #== for multiline? Just a suggestion.