[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Your last change to browse-url is bogus.
From: |
Stefan Monnier |
Subject: |
Re: Your last change to browse-url is bogus. |
Date: |
Thu, 13 Sep 2007 17:44:00 -0400 |
User-agent: |
Gnus/5.11 (Gnus v5.11) Emacs/23.0.50 (gnu/linux) |
>> > I tend to agree with Yamamoto-san, because even if the string->string
>> > maps were identical, having the names specify the intended domain
>> > helps with deciding when to apply them at all.
>>
>> I beg to disagree: a function's name and docstring should reflect what the
>> function *does* rather than how it is used.
> That's what I said. I'm a categorist: functions with different
> domains are different functions, they do different things even if they
> happen to agree on the intersection of their domains.
> As for the docstring, we'll have to agree to disagree. There is no
> real cost to having a docstring that warns about improper usage any
> more, it's a matter of style. You prefer a style that assumes that
> people only need to be reminded of the arguments; others should refer
> to the manual. I think that's what skeletons etc are for, and prefer
> more verbose docstrings, more like Unix man pages in sections 2 and 3.
You lost me. I guess we were just not talking about the same thing.
Stefan
- Re: Your last change to browse-url is bogus., (continued)
- Re: Your last change to browse-url is bogus., Michaël Cadilhac, 2007/09/12
- Re: Your last change to browse-url is bogus., YAMAMOTO Mitsuharu, 2007/09/12
- Re: Your last change to browse-url is bogus., Michaël Cadilhac, 2007/09/12
- Re: Your last change to browse-url is bogus., YAMAMOTO Mitsuharu, 2007/09/12
- Re: Your last change to browse-url is bogus., Michaël Cadilhac, 2007/09/12
- Re: Your last change to browse-url is bogus., YAMAMOTO Mitsuharu, 2007/09/17
- Re: Your last change to browse-url is bogus., Michaël Cadilhac, 2007/09/17
- Re: Your last change to browse-url is bogus., Stephen J. Turnbull, 2007/09/12
- Re: Your last change to browse-url is bogus., Stefan Monnier, 2007/09/12
- Re: Your last change to browse-url is bogus., Stephen J. Turnbull, 2007/09/13
- Re: Your last change to browse-url is bogus.,
Stefan Monnier <=
- Re: Your last change to browse-url is bogus., Davis Herring, 2007/09/12