[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: doc string for face-attribute-relative-p doesn't help

From: Miles Bader
Subject: Re: doc string for face-attribute-relative-p doesn't help
Date: Tue, 27 Jun 2006 12:52:37 +0900

"Drew Adams" <address@hidden> writes:
> I agree, too, that each function's doc string need not try to explain
> everything. If the doc defines the terms it uses (e.g. "underlying",
> "relative") and explains them clearly, then that lessens the burden of
> explanation for doc strings.

I've always wondered if there should be more attempts to link from
docstrings into the elisp manual.  It would reduce the burden
of trying to make docstrings too all-encompassing.

Consider, for instance, if there were automatically added "See
(elisp)FUNCTION-NAME" and/or "See (elisp)faces" links at the bottom of
_every_ face function's docstring.

[I seem to recall that this was discussed in some manner before??
Anybody remember?]


o The existentialist, not having a pillow, goes everywhere with the book by
  Sullivan, _I am going to spit on your graves_.

reply via email to

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