Re: Defcustoms, how do users find them?

[Lennart Borgman]

On Tue, Nov 17, 2009 at 6:49 PM, Drew Adams <address@hidden> wrote:

> I agree with Lennart that it would be beneficial for users to have the _doc
> strings_ of all (or at least most, if there are particular problems for some)
> vanilla Emacs options available at startup.
>
> IMO, this is as important (no - more important) for `C-h v' and apropos as it 
> is
> for `customize-variable'. The latter would let you see a list of options, but 
> it
> wouldn't tell you anything about them. In this I disagree with Lennart, who 
> said
> that providing all options for completion by `customize-variable' would be
> sufficient.

I also said that help and apropos should load the libraries like
customize do. That would provide the doc strings for those functions,
or?

If it does not then using

  (put 'foo 'variable-documentation "Helpful doc for `foo'.")

as you suggested might be a way.