[Top][All Lists]

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

Re: I think the doc in emacs is too simple in someplaces

From: Eli Zaretskii
Subject: Re: I think the doc in emacs is too simple in someplaces
Date: Mon, 18 Dec 2006 22:06:50 +0200

> From: Ronald <address@hidden>
> Date: Mon, 18 Dec 2006 23:02:04 +0800
> For example:
> c-toggle-electric-state
> c-toggle-electric-state is an interactive compiled Lisp function in 
> `cc-cmds.el'.
> It is bound to C-c C-l, <menu-bar> <C> <Toggle...> <Electric mode>.
> (c-toggle-electric-state &optional ARG)
> Toggle the electric indentation feature.
> Optional numeric ARG, if supplied, turns on electric indentation when
> positive, turns it off when negative, and just toggles it when zero or
> left out.
> It doesn't tell what the function does.
> And the description about ARG is repeated everywhere,
> I supposed it's not good.

I agree, but please submit bug reports such as this one to the correct
forum; "M-x report-emacs-bug RET" will do that for you automatically.
Also, please report specifically each case of insufficient
documentation; ``for example'' is not good enough, because Emacs has
thousands of doc strings, and no one can possibly believe that all of
them are bad.

reply via email to

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