From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Miles Bader Newsgroups: gmane.emacs.devel Subject: Re: Info tutorial is out of date Date: Fri, 21 Jul 2006 08:10:07 +0900 Message-ID: <87hd1bzxdc.fsf@catnip.gol.com> References: <20060720200631.AADC.SLAWOMIR.NOWACZYK.847@student.lu.se> Reply-To: Miles Bader NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1153437061 15966 80.91.229.2 (20 Jul 2006 23:11:01 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Thu, 20 Jul 2006 23:11:01 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Jul 21 01:10:59 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 1G3hfQ-0008MR-8H for ged-emacs-devel@m.gmane.org; Fri, 21 Jul 2006 01:10:52 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1G3hfP-0000zv-Jp for ged-emacs-devel@m.gmane.org; Thu, 20 Jul 2006 19:10:51 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1G3hes-0000mK-2l for emacs-devel@gnu.org; Thu, 20 Jul 2006 19:10:18 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1G3hep-0000lG-Bf for emacs-devel@gnu.org; Thu, 20 Jul 2006 19:10:16 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1G3heo-0000lA-Nm for emacs-devel@gnu.org; Thu, 20 Jul 2006 19:10:15 -0400 Original-Received: from [203.216.5.72] (helo=smtp02.dentaku.gol.com) by monty-python.gnu.org with esmtps (TLS-1.0:RSA_AES_256_CBC_SHA:32) (Exim 4.52) id 1G3hf5-0006yS-Bh; Thu, 20 Jul 2006 19:10:31 -0400 Original-Received: from 203-216-101-123.dsl.gol.ne.jp ([203.216.101.123] helo=catnip.gol.com) by smtp02.dentaku.gol.com with esmtpa (Dentaku) id 1G3hek-0004vc-DI; Fri, 21 Jul 2006 08:10:10 +0900 Original-Received: by catnip.gol.com (Postfix, from userid 1000) id 377B72F66; Fri, 21 Jul 2006 08:10:07 +0900 (JST) Original-To: Slawomir Nowaczyk System-Type: i686-pc-linux-gnu In-Reply-To: <20060720200631.AADC.SLAWOMIR.NOWACZYK.847@student.lu.se> (Slawomir Nowaczyk's message of "Thu, 20 Jul 2006 21:03:36 +0200") Original-Lines: 24 X-Abuse-Complaints: abuse@gol.com 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:57403 Archived-At: Slawomir Nowaczyk writes: > Well, yes and no... there are a lot of other ways to browse documentation > (web browsers being one example). I think we should be pointing to the > users (in the tutorial, at least) *why* info is *better* than the > alternatives. > > And starting by saying "press 'n' to go to next node" is only going to > get us a "gee, why can't those guys learn what hyperlinks are?" > reaction. Nonetheless, the info browser's far more efficient browsing is a _huge_ advantage over a typical "html in a browser" solution (I use lots of html docs, and am always amazed by how clunky and awkward everything is). Any but the simplest queries can be a nightmare in an html doc tree simply because it's so slow and awkward to move around. The other big benefits of info IMHO are more "global" functionality (cross-node i-search is my number-one method of finding stuff these days), and of course much better integration with the editor. -Miles -- o The existentialist, not having a pillow, goes everywhere with the book by Sullivan, _I am going to spit on your graves_.