From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.org!not-for-mail
From: Ronald <followait@163.com>
Newsgroups: gmane.emacs.help
Subject: Re: I think the doc in emacs is too simple in someplaces
Date: Tue, 19 Dec 2006 08:18:09 +0800
Organization: Bentium Ltd. (CN99)
Message-ID: <em7b41$bcd$2@news.yaako.com>
References: <em6aht$v4q$1@news.yaako.com>
	<mailman.2081.1166472416.2155.help-gnu-emacs@gnu.org>
NNTP-Posting-Host: main.gmane.org
Mime-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
X-Trace: sea.gmane.org 1166488983 14406 80.91.229.2 (19 Dec 2006 00:43:03 GMT)
X-Complaints-To: usenet@sea.gmane.org
NNTP-Posting-Date: Tue, 19 Dec 2006 00:43:03 +0000 (UTC)
Original-X-From: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org Tue Dec 19 01:42:56 2006
Return-path: <help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org>
Envelope-to: geh-help-gnu-emacs@m.gmane.org
Original-Received: from lists.gnu.org ([199.232.76.165])
	by ciao.gmane.org with esmtp (Exim 4.43)
	id 1GwT2S-0001LW-Of
	for geh-help-gnu-emacs@m.gmane.org; Tue, 19 Dec 2006 01:41:01 +0100
Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.43)
	id 1GwT2R-0002kr-DQ
	for geh-help-gnu-emacs@m.gmane.org; Mon, 18 Dec 2006 19:40:59 -0500
Original-Path: shelby.stanford.edu!newsfeed.stanford.edu!bloom-beacon.mit.edu!news.cn99.com!news.yaako.com!not-for-mail
Original-Newsgroups: gnu.emacs.help
Original-Lines: 34
Original-NNTP-Posting-Host: 222.125.193.25
Original-X-Trace: news.yaako.com 1166487489 11661 222.125.193.25 (19 Dec 2006 00:18:09
	GMT)
Original-X-Complaints-To: usenet@news.yaako.com
Original-NNTP-Posting-Date: Tue, 19 Dec 2006 00:18:09 +0000 (UTC)
User-Agent: Thunderbird 1.5.0.8 (X11/20061117)
In-Reply-To: <mailman.2081.1166472416.2155.help-gnu-emacs@gnu.org>
Original-Xref: shelby.stanford.edu gnu.emacs.help:144116
Original-To: help-gnu-emacs@gnu.org
X-BeenThere: help-gnu-emacs@gnu.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Users list for the GNU Emacs text editor <help-gnu-emacs.gnu.org>
List-Unsubscribe: <http://lists.gnu.org/mailman/listinfo/help-gnu-emacs>,
	<mailto:help-gnu-emacs-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/pipermail/help-gnu-emacs>
List-Post: <mailto:help-gnu-emacs@gnu.org>
List-Help: <mailto:help-gnu-emacs-request@gnu.org?subject=help>
List-Subscribe: <http://lists.gnu.org/mailman/listinfo/help-gnu-emacs>,
	<mailto:help-gnu-emacs-request@gnu.org?subject=subscribe>
Original-Sender: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org
Errors-To: help-gnu-emacs-bounces+geh-help-gnu-emacs=m.gmane.org@gnu.org
Xref: news.gmane.org gmane.emacs.help:39719
Archived-At: <http://permalink.gmane.org/gmane.emacs.help/39719>

Eli Zaretskii wrote:
>> From: Ronald <followait@163.com>
>> 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.
> 
> 
Yes, I should try.
I'm a newbie in Linux.
Thanks.