[Top][All Lists]

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

Re: Elisp manual omission?

From: Richard Stallman
Subject: Re: Elisp manual omission?
Date: Sun, 24 Apr 2005 17:22:54 -0400

    > That doesn't necessarily mean they are worth mentioning in the Lisp
    > Manual.

    What does?  If there are some objective criteria, let's hear them.

It's a matter of how useful they are.

I regret that that's not a clear sharp line, but there isn't a good
clear line to use.  If we documented all the functions that we can
invision any Lisp program as having occasion to call, that would be
too much work and make the Lisp Manual too big.

    > Why do you think those are worth documenting?

    I tried to imagine what would I like to know if I needed to write a
    mode with special tooltip support, similar to GUD (whose tooltip
    support is part of tooltip.el).

I think that how to write special tooltip support is too obscure a
topic to be worth documenting in the Emacs Lisp Manual.

The more Lisp functions we document in the manual, the more work
updating the manual will be.  There are many things that in an ideal
world we would document, which in the real world would cost more
trouble to document than they are worth.

reply via email to

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