From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Chong Yidong Newsgroups: gmane.emacs.devel Subject: Re: guided tour suggestions Date: Sat, 02 Jun 2007 16:52:51 -0400 Message-ID: <87k5umdqos.fsf@stupidchicken.com> References: <200705031803.l43I3Yd29129@f7.net> <87mz0lfxy5.fsf@phil.mit.edu> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1180817586 2030 80.91.229.12 (2 Jun 2007 20:53:06 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 2 Jun 2007 20:53:06 +0000 (UTC) Cc: emacs-devel@gnu.org To: Phil Sung Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Jun 02 22:53:04 2007 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1Huaau-00038v-99 for ged-emacs-devel@m.gmane.org; Sat, 02 Jun 2007 22:53:04 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Huaat-0002Ct-Nb for ged-emacs-devel@m.gmane.org; Sat, 02 Jun 2007 16:53:03 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Huaap-000288-FN for emacs-devel@gnu.org; Sat, 02 Jun 2007 16:52:59 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Huaao-00024K-6L for emacs-devel@gnu.org; Sat, 02 Jun 2007 16:52:58 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Huaao-000245-14 for emacs-devel@gnu.org; Sat, 02 Jun 2007 16:52:58 -0400 Original-Received: from cyd.mit.edu ([18.115.2.24]) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1Huaan-0003s9-N5 for emacs-devel@gnu.org; Sat, 02 Jun 2007 16:52:57 -0400 Original-Received: by cyd.mit.edu (Postfix, from userid 1000) id A2AB34E50A; Sat, 2 Jun 2007 16:52:51 -0400 (EDT) In-Reply-To: <87mz0lfxy5.fsf@phil.mit.edu> (Phil Sung's message of "Thu\, 03 May 2007 16\:34\:42 -0400") User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/22.0.990 (gnu/linux) X-detected-kernel: Linux 2.6, seldom 2.4 (older, 4) 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:72073 Archived-At: I've just managed to find the time to read through the guided tour. I must say, it's a very impressive job. I have a few suggestions to make: 0. Am I the only one that thinks the parts of the text in are too small to be legible? Or are my Firefox fonts screwed up? 1. The screenshots on http://www.gnu.org/software/emacs/tour/ are too zoomed out to be legible. I guess the reason for this is so that the entire Emacs window can be displayed. I think it would be better if the screenshot images on the main page of the tour are at 100% zoom, and cropped so that only the relevant part of the window is seen. When you click on each image, it should bring you to a bigger imager showing the entire Emacs window. 2. In the Mark section, under the column labelled "When you...", the first entry is "C-SPC". To be grammatical, this should be "type C-SPC". In the same column, the entry "Exit a search (C-s or C-r)" is confusing: these are the keystrokes to enter a search, not exit a search. 3. In the section on Isearch, the sentioned "You can incremental search backwards" is grammatically fishy. Maybe "You can perform a backward incremental search" is better. 4. In "Integration with common tools", I think we should recommend M-x man instead of M-x woman. As far as I know, the latter is only useful on systems where man is unavailable (though that may just be sexism). 5. In the section on Macros, I think we should recommend the F3 and F4 keys new to Emacs 22, since they are easier to use than the old kmacro keys. 6. In the Emacs Help Facilities section, the suggestion to run Info with M-x info can probably use C-h i instead. Also, the sentence "You can also read the GNU Emacs manual in Emacs with (info "(emacs)")" is confusing -- do you mean the menu-bar? Also, I wonder if the tour should mention transient mark mode. Now that font-lock-mode is on by default, transient mark mode is IMHO the reigning champion for Feature That Should Be Turned On By Default But Isn't.