[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: (fn ...) - please fill it at the point of generation
From: |
Miles Bader |
Subject: |
Re: (fn ...) - please fill it at the point of generation |
Date: |
Sat, 29 Dec 2007 22:32:28 +0900 |
"Drew Adams" <address@hidden> writes:
>> Why don't you just wrap them yourself, in the code that calls
>> `documentation'? Wrapping is, in general, a display thing, so it seems
>> best to not add hair in more primitive code to worry about it.
>
> 1. It's not so easy in my particular context. But this is not about me. It's
> about any code that uses doc strings (and cares about line length). Why
> change all such code, instead of preventing the bug in the first place? Code
> that generates user doc should be smart enough to respect the GNU Emacs
> convention for line length. What's the big deal?
Why do you assume that applications _want_ it wrapped? It's really not
part of the doc string as such, it's an interface description. Wrapping
it simply introduces extra noise.
> 2. Pretty much all other lines of every doc string are correct in this
> regard. Why should this be the lone exception and force all code that uses
> doc-strings to patch things up after the fact?
See above.
-Miles
--
The car has become... an article of dress without which we feel uncertain,
unclad, and incomplete. [Marshall McLuhan, Understanding Media, 1964]
Re: (fn ...) - please fill it at the point of generation, Richard Stallman, 2007/12/29
- RE: (fn ...) - please fill it at the point of generation, Drew Adams, 2007/12/29
- Re: (fn ...) - please fill it at the point of generation, Thien-Thi Nguyen, 2007/12/29
- RE: (fn ...) - please fill it at the point of generation, Drew Adams, 2007/12/29
- Re: (fn ...) - please fill it at the point of generation, Thien-Thi Nguyen, 2007/12/29
- RE: (fn ...) - please fill it at the point of generation, Drew Adams, 2007/12/29
- Re: (fn ...) - please fill it at the point of generation, Thien-Thi Nguyen, 2007/12/29