From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: emacs-Xtra Date: Thu, 13 Apr 2006 11:28:46 +0300 Message-ID: References: <17469.29694.605871.59144@farnswood.snap.net.nz> Reply-To: Eli Zaretskii NNTP-Posting-Host: main.gmane.org X-Trace: sea.gmane.org 1144916956 13957 80.91.229.2 (13 Apr 2006 08:29:16 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Thu, 13 Apr 2006 08:29:16 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Apr 13 10:29:14 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 1FTxCK-00088t-C4 for ged-emacs-devel@m.gmane.org; Thu, 13 Apr 2006 10:29:04 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FTxCJ-0003G0-Q1 for ged-emacs-devel@m.gmane.org; Thu, 13 Apr 2006 04:29:03 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1FTxC1-0003Eq-Ti for emacs-devel@gnu.org; Thu, 13 Apr 2006 04:28:45 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1FTxC0-0003Dz-8e for emacs-devel@gnu.org; Thu, 13 Apr 2006 04:28:45 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1FTxC0-0003Du-2W for emacs-devel@gnu.org; Thu, 13 Apr 2006 04:28:44 -0400 Original-Received: from [192.114.186.20] (helo=nitzan.inter.net.il) by monty-python.gnu.org with esmtp (Exim 4.52) id 1FTxHH-0001cQ-5z for emacs-devel@gnu.org; Thu, 13 Apr 2006 04:34:11 -0400 Original-Received: from HOME-C4E4A596F7 (IGLD-83-130-205-75.inter.net.il [83.130.205.75]) by nitzan.inter.net.il (MOS 3.7.3-GA) with ESMTP id DDC13046 (AUTH halo1); Thu, 13 Apr 2006 11:28:39 +0300 (IDT) Original-To: Nick Roberts In-reply-to: <17469.29694.605871.59144@farnswood.snap.net.nz> (message from Nick Roberts on Thu, 13 Apr 2006 09:41:18 +1200) 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:52817 Archived-At: > From: Nick Roberts > Date: Thu, 13 Apr 2006 09:41:18 +1200 > > I think emacs-Xtra is becoming a bit of a dog's breakfast I tend to agree. > (possibly an ms-dog's breakfast!). I don't understand this part, especially since most of the MS-DOS info is still in an appendix to the main manual. > If I want to find something out about VC, I don't want > to have to search through *two* manuals to find it because I can't guess > where the arbitrary split has been made. > > I think the all the documentation for VC should be in one manual. I agree. And the same goes for Calendar. On top of that, whoever split portions of msdog.texi into emacs-xtra, managed to remove from the main manual important information about setting up printing on Windows. > I have two suggestions: > > 1) VC has its own manual like PCL-CVS does. > > 2) All the programming/development topics are moved to a separate manual > (Emacs IDE?) and only the obscure stuff is left in emacs-Xtra. I have a 3rd suggestion (which I think I already made in the past): 3) Have those ``extra'' sections be part of the on-line manual, but not of the printed manual. In the printed manual, replace the extra sections with an xref to the extra manual. The Texinfo @ifinfo facility should do the trick. This should be a good solution to the original problem, which is that the FSF wants the printed manuals it sells to not be too large.