From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Matthew Mundell Newsgroups: gmane.emacs.devel Subject: Re: Documentation for "Clone Buffers" (corrected version) Date: 15 Mar 2004 18:18:12 +0000 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <87wu5mc6u3.fsf@sno.mundell.ukfsn.org> References: NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1079374857 27590 80.91.224.253 (15 Mar 2004 18:20:57 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Mon, 15 Mar 2004 18:20:57 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Mon Mar 15 19:20:52 2004 Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1B2who-0006bW-00 for ; Mon, 15 Mar 2004 19:20:52 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1B2who-0000rZ-00 for ; Mon, 15 Mar 2004 19:20:52 +0100 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.30) id 1B2wgT-0005jV-S6 for emacs-devel@quimby.gnus.org; Mon, 15 Mar 2004 13:19:29 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.30) id 1B2wgN-0005j9-Qb for emacs-devel@gnu.org; Mon, 15 Mar 2004 13:19:23 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.30) id 1B2wfq-0005fr-VM for emacs-devel@gnu.org; Mon, 15 Mar 2004 13:19:22 -0500 Original-Received: from [217.158.120.143] (helo=mail.ukfsn.org) by monty-python.gnu.org with esmtp (Exim 4.30) id 1B2wfK-0005bK-EV; Mon, 15 Mar 2004 13:18:18 -0500 Original-Received: from localhost (lucy.ukfsn.org [127.0.0.1]) by mail.ukfsn.org (Postfix) with ESMTP id 5AB76E6D75; Mon, 15 Mar 2004 18:17:36 +0000 (GMT) Original-Received: from mail.ukfsn.org ([127.0.0.1]) by localhost (lucy.ukfsn.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 29041-10; Mon, 15 Mar 2004 18:17:36 +0000 (GMT) Original-Received: from sno.mundell.ukfsn.org (dsl213-218-239-181.as15444.net [213.218.239.181]) by mail.ukfsn.org (Postfix) with ESMTP id 15574E6D4F; Mon, 15 Mar 2004 18:17:36 +0000 (GMT) Original-Received: from sno.mundell.ukfsn.org ([10.0.0.3]) by sno.mundell.ukfsn.org with esmtp (Exim 3.36 #1 (Debian)) id 1B2wfE-0001UJ-00; Mon, 15 Mar 2004 18:18:12 +0000 Original-To: David Kastrup Original-Lines: 42 User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.3.50 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.4 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:20508 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:20508 David Kastrup writes: > Eli Zaretskii writes: > > > > Date: Thu, 11 Mar 2004 14:55:54 +0000 (GMT) > > > From: Alan Mackenzie > > > > > > 1/- It should be complete and accurate. > > > 2/- The printed and online versions should be the same. > > > 3/- The printed version should not be too big. > > > > > > We can decide upon any two of these, but we can't have all three > > > at the same time. :-( > > > > Yes we can: we could make a separate manual that isn't printed as part > > of the Emacs manual. Then users can print it on their own. > > > > We already do that for several major Emacs features. > > In the TeXbook by Knuth, we have "dangerous bend" sections marked by > the corresponding traffic sign, and "double dangerous bend" marked by > two such signs. Those sections are printed in smaller print and > indicate increasingly complicated material that the normal user will > not usually need to bother himself with. > > If one would mark up sections in the Emacs manual (or other info > manuals) like that, one could generate a normal user manual and a more > expensive (complete) expert manual where the user manual omits the > more complicated stuff. The online version would be complete, but > maybe fold the more intricated stuff unless indicated otherwise by > variable settings or unless a search or index search hits there. With > regard to index searches, one would probably exhaust the "simple" > sections first before going into the "complicated" ones. This could also be used to exclude platform-specific material and references to proprietary work. > > Whether this is a good idea is a different question. > > -- > David Kastrup, Kriemhildstr. 15, 44793 Bochum