From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Alan Mackenzie Newsgroups: gmane.emacs.devel Subject: Re: Low-stress useful project Date: Sat, 12 Aug 2006 18:23:30 +0100 Message-ID: <20060812172329.GA1432@muc.de> References: <20060811085803.GC1233@muc.de> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1155409520 27446 80.91.229.2 (12 Aug 2006 19:05:20 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 12 Aug 2006 19:05:20 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Aug 12 21:05:19 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 1GBynI-0002f5-VU for ged-emacs-devel@m.gmane.org; Sat, 12 Aug 2006 21:05:13 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1GBynI-0006A3-Db for ged-emacs-devel@m.gmane.org; Sat, 12 Aug 2006 15:05:12 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1GBymS-0005Df-SL for emacs-devel@gnu.org; Sat, 12 Aug 2006 15:04:20 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1GBymQ-0005Am-Ui for emacs-devel@gnu.org; Sat, 12 Aug 2006 15:04:20 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1GBymQ-0005AR-Kj for emacs-devel@gnu.org; Sat, 12 Aug 2006 15:04:18 -0400 Original-Received: from [193.149.48.1] (helo=mail.muc.de) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA:32) (Exim 4.52) id 1GByrq-0006MB-7J for emacs-devel@gnu.org; Sat, 12 Aug 2006 15:09:54 -0400 Original-Received: (qmail 53347 invoked from network); 12 Aug 2006 19:04:09 -0000 Original-Received: from acm.muc.de (HELO localhost.localdomain) (Debian-exim@193.149.49.134) by mail.muc.de with SMTP; 12 Aug 2006 19:04:09 -0000 Original-Received: from acm by localhost.localdomain with local (Exim 4.50) id 1GBxCs-0000UD-0b; Sat, 12 Aug 2006 18:23:30 +0100 Original-To: Richard Stallman Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.9i 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:58330 Archived-At: Hi, Richard! On Sat, Aug 12, 2006 at 10:28:03AM -0400, Richard Stallman wrote: > With all due respect to everybody, and so on, but the Bash manual, > the last time I looked at it[*], didn't seem to be one of the > better manuals in the GNU system. It is short on examples, > doesn't seem well organized, and I found it maddeningly difficult > to find out about basic things (how do you write a `while' loop?) > a few years back when I was learning bash. > Would you like to work on improving it? It won't magically change by > itself. A fair response (even if a little bit hackneyed). I'd like to work on it, but that would mean doing less on other things (like Emacs and CC Mode), so I'll just leave it. I wasn't disparaging this manual out of personal frustration or hate or anything like that - I merely wanted anybody contemplating the task (of doing eshell.texi) not to take over the form of bashref.texi uncritically. > The bash man page is much more coherent. > It is ok to copy the text from there, too; it will require rewriting > into Texinfo, though. -- Alan.