From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Andreas Roehler Newsgroups: gmane.emacs.devel Subject: Re: string-strip Date: Thu, 22 Jun 2006 13:21:25 +0200 Message-ID: <449A7D35.8040608@easy-emacs.de> 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> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-15; format=flowed Content-Transfer-Encoding: 8bit X-Trace: sea.gmane.org 1151003098 25533 80.91.229.2 (22 Jun 2006 19:04:58 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Thu, 22 Jun 2006 19:04:58 +0000 (UTC) Cc: Richard Stallman , emacs-devel Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Jun 22 21:04:51 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 1FtUSs-0005Gr-Hf for ged-emacs-devel@m.gmane.org; Thu, 22 Jun 2006 21:03:42 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FtUSs-0005bK-55 for ged-emacs-devel@m.gmane.org; Thu, 22 Jun 2006 15:03:42 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1FtN7d-0007IE-O3 for emacs-devel@gnu.org; Thu, 22 Jun 2006 07:13:17 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1FtN7c-0007Hy-8o for emacs-devel@gnu.org; Thu, 22 Jun 2006 07:13:17 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FtN7c-0007Hv-4M for emacs-devel@gnu.org; Thu, 22 Jun 2006 07:13:16 -0400 Original-Received: from [212.227.126.188] (helo=moutng.kundenserver.de) by monty-python.gnu.org with esmtp (Exim 4.52) id 1FtNIX-0008Rn-69; Thu, 22 Jun 2006 07:24:34 -0400 Original-Received: from [84.190.197.122] (helo=[192.168.178.23]) by mrelayeu.kundenserver.de (node=mrelayeu0) with ESMTP (Nemesis), id 0MKwh2-1FtN7W05G9-0007kO; Thu, 22 Jun 2006 13:13:10 +0200 User-Agent: Thunderbird 1.5.0.4 (X11/20060516) Original-To: "Kim F. Storm" In-Reply-To: X-Provags-ID: kundenserver.de abuse@kundenserver.de login:62d13292e0fce6aaed56aaadcb96352d X-Mailman-Approved-At: Thu, 22 Jun 2006 15:03:31 -0400 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:56082 Archived-At: Kim F. Storm schrieb: > Lars Hansen writes: > > >> Johan Bockgård wrote: >> >> >>> Or how about if it worked like `split-string'? >>> >> Brilliant idea. How about this? >> > > Looks good to me. > > 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? Function docs are a very quick and easy to use tool. Information there helps a lot. The manual is fine but too much for the beginner, who is always in a risk to get drowned (or drunk) with. __ Andreas Roehler PS.: As already mentioned: there is a gap between the tutorial and the manual in the didactic sense (which does not concern functioning and should not delay the upcoming release...) Also I don't conceive the manual as to big as such - on the contrary: the more information available, the better. 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.)