From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Documentation for "Clone Buffers" (corrected version) Date: 15 Mar 2004 08:52:16 +0200 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: References: <87ekru8z8v.fsf@mail.jurta.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: deer.gmane.org X-Trace: sea.gmane.org 1079333608 19474 80.91.224.253 (15 Mar 2004 06:53:28 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Mon, 15 Mar 2004 06:53:28 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Mon Mar 15 07:53:21 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 1B2lyR-0001Qa-00 for ; Mon, 15 Mar 2004 07:53:19 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1B2lyQ-0003uo-00 for ; Mon, 15 Mar 2004 07:53:18 +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 1B2lwr-0008Ph-BE for emacs-devel@quimby.gnus.org; Mon, 15 Mar 2004 01:51:41 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.30) id 1B2lwB-0008H1-CV for emacs-devel@gnu.org; Mon, 15 Mar 2004 01:50:59 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.30) id 1B2lvS-0007K5-Vb for emacs-devel@gnu.org; Mon, 15 Mar 2004 01:50:46 -0500 Original-Received: from [207.232.27.5] (helo=WST0054) by monty-python.gnu.org with asmtp (Exim 4.30) id 1B2lv9-0006ov-AD; Mon, 15 Mar 2004 01:49:55 -0500 Original-To: Juri Linkov In-reply-to: <87ekru8z8v.fsf@mail.jurta.org> (message from Juri Linkov on Mon, 15 Mar 2004 07:18:08 +0200) 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:20490 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:20490 > From: Juri Linkov > Date: Mon, 15 Mar 2004 07:18:08 +0200 > > Eli Zaretskii writes: > > 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. > > Making a separate manual is reasonable only for a big Emacs package > like Ediff, Eshell, Gnus, or other 30 packages currently having a > separate Info manual. However, placing smaller Emacs features into > a separate manual is very inconvenient for users, because when they > are trying for find a needed Emacs feature by searching the Emacs > manual or by looking its index they might miss them. We could add a feature that would look in those other manuals as well. In fact, it would be a good idea even now, as packages like Eshell and Gnus are parts of Emacs, so there's no need to force the user to know how we subdivide the Emacs docs. We already do something similar for "C-h F", for example. > Currently, > there is only one Info manual that don't correspond to a separate > Emacs package: it is Autotype. It describes some small Emacs features, > and even most of its references lead to the Emacs manual, so it really > looks like a part of the Emacs manual. I think Autotype should be > moved to the Emacs manual. That was already discussed a few years ago, and Richard asked not to include it in the manual, for the same reasons he explained in this thread the other day: the sheer volume of the printed manual and its price. > BTW, is there a reason for not including references to SES and SMTP > manuals into the `emacs/info/dir' file? A simple omission; these manuals are relatively new additions. (It is IMHO the job of the person who adds a new manual to update info/dir.) Feel free to add them.