[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.


The car has become... an article of dress without which we feel uncertain,
unclad, and incomplete.  [Marshall McLuhan, Understanding Media, 1964]

reply via email to

[Prev in Thread] Current Thread [Next in Thread]