[Top][All Lists]

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

Re: doc of defining minor modes

From: Stefan Monnier
Subject: Re: doc of defining minor modes
Date: Fri, 19 May 2006 12:43:06 -0400
User-agent: Gnus/5.11 (Gnus v5.11) Emacs/22.0.50 (gnu/linux)

> It's not obvious to readers of the doc why we provide an :init-value
> possibility and yet we warn people not to use it (except in a rare case).
> There needs to be a good explanation of this uncommon coupling.
> The explanation needs to indicate how the problem that the admonition
> hopes to prevent could arise, that is, _how_ a library might get loaded
> without being loaded directly by the user.  That is not obvious.

I don't think it's worth the trouble to write a long explanation.
It's perfectly OK to have arguments and features marked as "don't ever use
this unless you really know what you're doing".


reply via email to

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