From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Jeff Clough Newsgroups: gmane.emacs.devel Subject: Re: Guile in Emacs Date: Thu, 15 Apr 2010 07:59:46 -0400 Message-ID: References: <4B8147A9.7030504@gmail.com> <873a0cyv3r.fsf@lola.goethe.zz> <87aauiho3y.fsf_-_@lifelogs.com> <1271028837.6164.55.camel@dell-desktop.example.com> <1271102739.6067.38.camel@dell-desktop.example.com> <8039yz34ka.fsf@tiny.isode.net> <1271173887.6067.53.camel@dell-desktop.example.com> <87FA5F05CB9C41409B9E72BD06D7C8CF@us.oracle.com> <87fx2xp839.fsf@lola.goethe.zz> <3EFDD45EB5AD4018B8FEA8F13CFEDA32@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: dough.gmane.org 1271332814 5484 80.91.229.12 (15 Apr 2010 12:00:14 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Thu, 15 Apr 2010 12:00:14 +0000 (UTC) Cc: 'David Kastrup' , emacs-devel@gnu.org To: "Drew Adams" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Apr 15 14:00:03 2010 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.69) (envelope-from ) id 1O2Njl-0006A5-5N for ged-emacs-devel@m.gmane.org; Thu, 15 Apr 2010 14:00:01 +0200 Original-Received: from localhost ([127.0.0.1]:56773 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1O2Njk-0005yz-NC for ged-emacs-devel@m.gmane.org; Thu, 15 Apr 2010 08:00:00 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1O2Njf-0005yb-AW for emacs-devel@gnu.org; Thu, 15 Apr 2010 07:59:55 -0400 Original-Received: from [140.186.70.92] (port=59980 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1O2Njc-0005xj-3i for emacs-devel@gnu.org; Thu, 15 Apr 2010 07:59:54 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1O2NjZ-0004lW-LG for emacs-devel@gnu.org; Thu, 15 Apr 2010 07:59:51 -0400 Original-Received: from hrndva-omtalb.mail.rr.com ([71.74.56.123]:62000) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1O2NjZ-0004lG-Ae; Thu, 15 Apr 2010 07:59:49 -0400 X-Authority-Analysis: v=1.1 cv=wzQuF8Yqs4IO6CYUtTy28yZyBjSHZbbofww7aEg0rsQ= c=1 sm=0 a=kj9zAlcOel0A:10 a=wN3dDBks/ChO7xvezkoALQ==:17 a=yPCof4ZbAAAA:8 a=ujaRjeqjJI2vA6wOj0cA:9 a=YPSvS6MbMEhwf31C-7AA:7 a=vexkZiMDyvyfWnU4L-LsMVqlq8MA:4 a=CjuIK1q_8ugA:10 a=7DSvI1NPTFQA:10 a=wN3dDBks/ChO7xvezkoALQ==:117 X-Cloudmark-Score: 0 X-Originating-IP: 74.70.71.134 Original-Received: from [74.70.71.134] ([74.70.71.134:58465] helo=logrus.localdomain) by hrndva-oedge01.mail.rr.com (envelope-from ) (ecelerity 2.2.2.39 r()) with ESMTP id 6C/D1-06126-2BFF6CB4; Thu, 15 Apr 2010 11:59:47 +0000 In-Reply-To: <3EFDD45EB5AD4018B8FEA8F13CFEDA32@us.oracle.com> (Drew Adams's message of "Wed, 14 Apr 2010 23:54:35 -0700") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.1.95 (gnu/linux) X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. 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:123705 Archived-At: "Drew Adams" writes: > It is a choice whether we want clicking a cross-reference in an Emacs manual to > take you (a) to a section of the same manual or another manual available locally > or (b) to a section of a manual that might be on the Web. A cross reference > might well be to a non-local or a non-GNU manual or specification. What is > important is that we give users access to the specific info they need. It is also important for that information to be available in one place. When the information you need is split between two (or more) manuals, a wiki, a HOW-TO and Wonder Tommy's blog, it sucks, no matter how well cross-referenced or searchable it is. There's a better way and Emacs has it (for the most part). I've never subscribed to the theory that just because a feature is described on some web page out there, and not in the official manual, that it's "documented". Why people want to see this as the success of the internet rather than as a failure of the documentation is beyond me. Keep the information itself in one place that I can put on a tablet as a PDF, or print out and take with me on an overnight. Not everyone reads their docs from within Emacs all of the time. For what it's worth. Jeff