From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Lennart Borgman Newsgroups: gmane.emacs.devel Subject: Re: cua-mode and the tutorial Date: Tue, 29 Aug 2006 20:13:36 +0200 Message-ID: <44F483D0.4050702@student.lu.se> References: NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-15; format=flowed Content-Transfer-Encoding: 7bit X-Trace: sea.gmane.org 1156875302 26347 80.91.229.2 (29 Aug 2006 18:15:02 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Tue, 29 Aug 2006 18:15:02 +0000 (UTC) Cc: "Kim F. Storm" , "Richard M. Stallman" , emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Aug 29 20:14:58 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 1GI86H-0007US-Or for ged-emacs-devel@m.gmane.org; Tue, 29 Aug 2006 20:14:14 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1GI86H-0002Zp-5H for ged-emacs-devel@m.gmane.org; Tue, 29 Aug 2006 14:14:13 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1GI866-0002XE-8b for emacs-devel@gnu.org; Tue, 29 Aug 2006 14:14:02 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1GI864-0002Ug-H4 for emacs-devel@gnu.org; Tue, 29 Aug 2006 14:14:01 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1GI864-0002Ud-Ep for emacs-devel@gnu.org; Tue, 29 Aug 2006 14:14:00 -0400 Original-Received: from [81.228.11.159] (helo=pne-smtpout2-sn1.fre.skanova.net) by monty-python.gnu.org with esmtp (Exim 4.52) id 1GI8FA-0001MN-D9; Tue, 29 Aug 2006 14:23:24 -0400 Original-Received: from [192.168.123.121] (83.249.218.244) by pne-smtpout2-sn1.fre.skanova.net (7.2.075) id 44F1FA59000A24BB; Tue, 29 Aug 2006 20:13:37 +0200 User-Agent: Thunderbird 1.5.0.5 (Windows/20060719) 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:59073 Archived-At: Drew Adams wrote: > I haven't been following this closely, so, please, no flames if I'm off the > mark or if this has already been suggested. > > Would this be a good approach? > > 1. Mention in the Emacs tutorial that it applies to the standard (default) > key bindings. > > 2. Perhaps detect non-standard bindings, and draw attention to #1 with an > explicit message. > > 3. Perhaps point out again, in specific sections, that the bindings used > there are the standard ones. Perhaps mention the corresponding commands by > name, so users can nevertheless try them (if appropriate). > Thanks for the suggestions. I think however that these are already covered in the suggestions made earlier. > 4. Provide a separate tutorial for CUA, which complements the Emacs tutorial > and covers the parts of the Emacs tutorial that don't make sense for CUA. > Unless the region is active there is only a few keys (C-v and M-v) that are really different when CUA mode is used. When the region is visible C-x and C-c also works differently. S-C-x and S-C-c can be used instead and this should be explained. Those differences are small so there is no need for a separate tutorial. Instead it should be enough to point them out in the beginning of the tutorial and mark those keys in the tutorial text. At least I think we have come close to an agreement upon this in the discussion. You are welcome to try the tutorial.el that I have sent earlier. However at least two things should be changed there: 1) The yellow part at the top that is shown when some of the standard keys mentioned in the tutorial have been changed should be smaller. To show the more detailed picture a "Details" link should be implemented as suggested by Kim. 2) Those keys changed changed should be marked or replaced in the tutorial text. Probably marking is best. I will work on this and some more smaller changes.