From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Thien-Thi Nguyen Newsgroups: gmane.emacs.devel Subject: Re: Info tutorial is out of date Date: 16 Jul 2006 04:29:42 -0400 Message-ID: References: NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1153038626 6566 80.91.229.2 (16 Jul 2006 08:30:26 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sun, 16 Jul 2006 08:30:26 +0000 (UTC) Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sun Jul 16 10:30:25 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 1G2215-0005cF-Cq for ged-emacs-devel@m.gmane.org; Sun, 16 Jul 2006 10:30:19 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1G2213-0005xe-OY for ged-emacs-devel@m.gmane.org; Sun, 16 Jul 2006 04:30:18 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1G220X-0005wa-RS for emacs-devel@gnu.org; Sun, 16 Jul 2006 04:29:45 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1G220V-0005wM-PJ for emacs-devel@gnu.org; Sun, 16 Jul 2006 04:29:44 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1G220V-0005wI-5y for emacs-devel@gnu.org; Sun, 16 Jul 2006 04:29:43 -0400 Original-Received: from [67.59.132.6] (helo=mail.agora-net.com) by monty-python.gnu.org with esmtps (TLS-1.0:RSA_AES_256_CBC_SHA:32) (Exim 4.52) id 1G222u-0005E0-15 for emacs-devel@gnu.org; Sun, 16 Jul 2006 04:32:12 -0400 Original-Received: from ttn by mail.agora-net.com with local (Exim 4.50) id 1G220U-0005Dl-FV for emacs-devel@gnu.org; Sun, 16 Jul 2006 04:29:42 -0400 Original-To: "Emacs-Devel" In-Reply-To: Original-Lines: 36 User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.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:57083 Archived-At: "Drew Adams" writes: > Do we need to call each other names? a name is gratuitous, but w/o it, we become statistics (moreso than we already are). anyway, aside from mouse/nomouse, i agree that moving `i' more towards the beginning is a good idea. we can keep the node about invisible text and use it to introduce `i' (and `l'): Although info manuals are organized like a tree, you can jump directly to a specific topic using @kbd{i}. Read the following key sequence and then try it! @example Type Explanation ------------------------------------------------------------ i You see the prompt "Index topic:". invisible A topic not immediately visible from here. RET You visit node "Help-Inv" and Emacs displays a message where "invisible" was found. l You return here. @end example You can now revisit the node with @kbd{r}, or use OTHER-SEARCH-METHODS, etc... i think this fits in w/ your point that it is best to DO something in a tutorial rather than just talk about it, and that navigation tasks are of lower priority than search tasks (if those were indeed your points). btw, i use @example for this email; the actual texinfo would probably use @table and more extensive explanation, w/ @xref and so on. thi