From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: storm@cua.dk (Kim F. Storm) Newsgroups: gmane.emacs.devel Subject: Re: string-strip Date: Thu, 22 Jun 2006 17:48:31 +0200 Message-ID: References: <449266B2.7030500@easy-emacs.de> <4496E618.8090401@soem.dk> <32964.128.165.123.239.1150741470.squirrel@webmail.lanl.gov> <449796E7.9090808@soem.dk> <44984C66.8090006@easy-emacs.de> <17560.20884.675268.166167@kahikatea.snap.net.nz> <4499782D.4020408@soem.dk> <449A7D35.8040608@easy-emacs.de> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1150991460 15084 80.91.229.2 (22 Jun 2006 15:51:00 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Thu, 22 Jun 2006 15:51:00 +0000 (UTC) Cc: Richard Stallman , emacs-devel Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Jun 22 17:50:57 2006 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1FtRSI-0008TZ-8b for ged-emacs-devel@m.gmane.org; Thu, 22 Jun 2006 17:50:54 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FtRSH-0007Qs-S8 for ged-emacs-devel@m.gmane.org; Thu, 22 Jun 2006 11:50:53 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1FtRS7-0007Ql-9r for emacs-devel@gnu.org; Thu, 22 Jun 2006 11:50:43 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1FtRS5-0007QZ-Gz for emacs-devel@gnu.org; Thu, 22 Jun 2006 11:50:42 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FtRS5-0007QW-Dw for emacs-devel@gnu.org; Thu, 22 Jun 2006 11:50:41 -0400 Original-Received: from [195.41.46.237] (helo=pfepc.post.tele.dk) by monty-python.gnu.org with esmtp (Exim 4.52) id 1FtRd3-0000SZ-Iw; Thu, 22 Jun 2006 12:02:01 -0400 Original-Received: from kfs-l.imdomain.dk.cua.dk (0x503e2644.bynxx3.adsl-dhcp.tele.dk [80.62.38.68]) by pfepc.post.tele.dk (Postfix) with SMTP id 0098B8A001A; Thu, 22 Jun 2006 17:50:33 +0200 (CEST) Original-To: Andreas Roehler In-Reply-To: <449A7D35.8040608@easy-emacs.de> (Andreas Roehler's message of "Thu, 22 Jun 2006 13:21:25 +0200") User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.0.50 (gnu/linux) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:56081 Archived-At: Andreas Roehler writes: >> But I think examples belong in the manual, not in the doc string. > > With regard to emacs beginners: Why not have it in > both places? That may be desireable, but traditionally, we almost never include examples in the doc strings, and for a trivial function like string-strip in particular, I don't see the need (ever). > The manual is fine but too much for the beginner, who > is always in a risk to get drowned (or drunk) with. The manual is no more than 5 keystrokes away... > Just propagate to have a second or third tutorial to ease > the next steps of the beginners (there are some tutorials > in the net which could be checked for that.) Emacs 22 includes the Emacs Lisp Introduction -- a beginner should read that before using string-strip :-) -- Kim F. Storm http://www.cua.dk