Re: Multi-line docstrings

2006-12-24 Thread Lawrence D'Oliveiro
In message <[EMAIL PROTECTED]>, Duncan Booth wrote: > Lawrence D'Oliveiro <[EMAIL PROTECTED]> wrote: > >> The Python docs recommend the use of triple-quoted string literals for >> docstrings, e.g. >> >> def Meet(Alice, Bob) : >> """arranges a meeting between Alice and Bob. >>

Re: Multi-line docstrings

2006-12-23 Thread Duncan Booth
[EMAIL PROTECTED] wrote: > Duncan Booth: >> Not spuriously included: included by design, but sometimes annoying. > > Then it's a design decision I don't understand... > I think the decision is that the doc string should reflect exactly what you entered in the string. i.e. the system shouldn't t

Re: Multi-line docstrings

2006-12-23 Thread bearophileHUGS
Duncan Booth: > Not spuriously included: included by design, but sometimes annoying. Then it's a design decision I don't understand... Bye, bearophile -- http://mail.python.org/mailman/listinfo/python-list

Re: Multi-line docstrings

2006-12-23 Thread Duncan Booth
Lawrence D'Oliveiro <[EMAIL PROTECTED]> wrote: > The Python docs recommend the use of triple-quoted string literals for > docstrings, e.g. > > def Meet(Alice, Bob) : > """arranges a meeting between Alice and Bob. > Returns a reference to the meeting booking object.""" >