From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Richard Stallman Newsgroups: gmane.emacs.devel Subject: Re: tutorial or guidebook text for some complex topics Date: Wed, 25 Oct 2006 14:03:05 -0400 Message-ID: References: Reply-To: rms@gnu.org NNTP-Posting-Host: main.gmane.org Content-Type: text/plain; charset=ISO-8859-15 X-Trace: sea.gmane.org 1161799447 343 80.91.229.2 (25 Oct 2006 18:04:07 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Wed, 25 Oct 2006 18:04:07 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Oct 25 20:04:02 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 1Gcn6S-0000gA-8y for ged-emacs-devel@m.gmane.org; Wed, 25 Oct 2006 20:03:49 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Gcn6R-0007K9-S9 for ged-emacs-devel@m.gmane.org; Wed, 25 Oct 2006 14:03:47 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Gcn5w-000721-IM for emacs-devel@gnu.org; Wed, 25 Oct 2006 14:03:16 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Gcn5v-00070j-QL for emacs-devel@gnu.org; Wed, 25 Oct 2006 14:03:15 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Gcn5u-000708-Vy for emacs-devel@gnu.org; Wed, 25 Oct 2006 14:03:15 -0400 Original-Received: from [199.232.76.164] (helo=fencepost.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.52) id 1Gcn5u-00030K-2M for emacs-devel@gnu.org; Wed, 25 Oct 2006 14:03:14 -0400 Original-Received: from rms by fencepost.gnu.org with local (Exim 4.34) id 1Gcn5l-0006am-7y; Wed, 25 Oct 2006 14:03:05 -0400 Original-To: "Drew Adams" In-reply-to: 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:61164 Archived-At: I was suggesting more user-guide material or a tutorial - something along the lines of the Emacs-Lisp Intro (but short). The place for such material about keymaps is in the Lisp manual. What concepts about keymaps do you think need further tutorial explanation? I think the documentation of font-lock-keywords is complete. I agree it is hard to grasp, but I don't know how to make it clearer. Does anyone else have an idea? Yes, it is probably complete. I was speaking only to the hard-to-learn part. The best help is provided by walking a reader through examples. Examples are the place to start. Again, see the Emacs-Lisp Intro for a good presentation model. Can you find a few examples in the code that you think would be good for explaining this?