From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Juri Linkov Newsgroups: gmane.emacs.devel Subject: Re: Tutorial: clickable manual references Date: Wed, 12 Mar 2008 12:42:28 +0200 Organization: JURTA Message-ID: <87wso8cizb.fsf@jurta.org> References: <87hcff5p09.fsf@jurta.org> <47D6F7CE.8010803@gmail.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1205319923 26578 80.91.229.12 (12 Mar 2008 11:05:23 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 12 Mar 2008 11:05:23 +0000 (UTC) Cc: emacs-devel@gnu.org To: "Lennart Borgman \(gmail\)" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Mar 12 12:05:51 2008 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 1JZOli-00086z-Vm for ged-emacs-devel@m.gmane.org; Wed, 12 Mar 2008 12:05:30 +0100 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JZOlA-0000FW-JQ for ged-emacs-devel@m.gmane.org; Wed, 12 Mar 2008 07:04:36 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1JZOi5-0007Fb-Uy for emacs-devel@gnu.org; Wed, 12 Mar 2008 07:01:26 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1JZOi3-0007Df-Md for emacs-devel@gnu.org; Wed, 12 Mar 2008 07:01:25 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JZOi3-0007DS-BE for emacs-devel@gnu.org; Wed, 12 Mar 2008 07:01:23 -0400 Original-Received: from relay01.kiev.sovam.com ([62.64.120.200]) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1JZOi2-0004uG-Lz for emacs-devel@gnu.org; Wed, 12 Mar 2008 07:01:22 -0400 Original-Received: from [83.170.232.243] (helo=smtp.svitonline.com) by relay01.kiev.sovam.com with esmtp (Exim 4.67) (envelope-from ) id 1JZOhx-0008kE-WD; Wed, 12 Mar 2008 13:01:20 +0200 In-Reply-To: <47D6F7CE.8010803@gmail.com> (Lennart Borgman's message of "Tue, 11 Mar 2008 22:21:18 +0100") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.60 (x86_64-unknown-linux-gnu) X-Scanner-Signature: 3140350ce96b4815fe22a3a842dc7b15 X-DrWeb-checked: yes X-SpamTest-Envelope-From: juri@jurta.org X-SpamTest-Group-ID: 00000000 X-SpamTest-Header: Not Detected X-SpamTest-Info: Profiles 2383 [Mar 12 2008] X-SpamTest-Info: helo_type=3 X-SpamTest-Info: {HEADERS: header Content-Type found without required header Content-Transfer-Encoding} X-SpamTest-Method: none X-SpamTest-Rate: 11 X-SpamTest-Status: Not detected X-SpamTest-Status-Extended: not_detected X-SpamTest-Version: SMTP-Filter Version 3.0.0 [0255], KAS30/Release X-detected-kernel: by monty-python.gnu.org: FreeBSD 4.8-5.1 (or MacOS X 10.2-10.3) 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:92265 Archived-At: >>>> wouldn't it be useful to make references to the Emacs manual be >>>> "clickable" links? >>> I'm afraid such links in the Tutorial will distract the reader >> >> Good point. >> >>> that should concentrate on the Tutorial and not to switch to >>> reading the Emacs manual. >> >> But when reading it later, there should be such a possibility, I >> think. Maybe we can find a non-intrusive way. > > Maybe put the links at the end of the tutorial? Good idea. Such links could in the Footnotes sections with the primary text referring to it like: Completion is described in Info in the Emacs manual in the node called "Completion" [1]. ... (And at the end of the tutorial) Footnotes: [1] The node "Completion" in the Emacs manual (info "(emacs) Completion") -- Juri Linkov http://www.jurta.org/emacs/