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: Split man directory Date: Wed, 05 Sep 2007 02:06:42 +0300 Organization: JURTA Message-ID: <87fy1ut4hp.fsf@jurta.org> References: <87fy1v36be.fsf@neutrino.caeruleus.net> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1188947543 13886 80.91.229.12 (4 Sep 2007 23:12:23 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Tue, 4 Sep 2007 23:12:23 +0000 (UTC) Cc: angeli@caeruleus.net, Eli Zaretskii , emacs-devel@gnu.org To: rms@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Sep 05 01:12:23 2007 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 1IShZC-00032x-4k for ged-emacs-devel@m.gmane.org; Wed, 05 Sep 2007 01:12:18 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1IShZA-0002bu-BZ for ged-emacs-devel@m.gmane.org; Tue, 04 Sep 2007 19:12:16 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1IShXT-0008Pl-HO for emacs-devel@gnu.org; Tue, 04 Sep 2007 19:10:32 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1IShXQ-0008LF-TT for emacs-devel@gnu.org; Tue, 04 Sep 2007 19:10:29 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1IShXP-0008KZ-QM for emacs-devel@gnu.org; Tue, 04 Sep 2007 19:10:27 -0400 Original-Received: from relay02.kiev.sovam.com ([62.64.120.197]) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1IShXH-0003ft-63; Tue, 04 Sep 2007 19:10:19 -0400 Original-Received: from [83.170.232.243] (helo=smtp.svitonline.com) by relay02.kiev.sovam.com with esmtp (Exim 4.67) (envelope-from ) id 1IShX7-000Ggj-7H; Wed, 05 Sep 2007 02:10:17 +0300 In-Reply-To: (Richard Stallman's message of "Tue\, 04 Sep 2007 12\:45\:15 -0400") User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/23.0.50 (gnu/linux) X-Scanner-Signature: 8abf2c83e696415c40c55866f9369f42 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 1433 [September 4 2007] 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: 10 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: 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:77799 Archived-At: > Indeed. But instead of `man', why not use the GNU-standard `doc'? > Thus, we will have > > doc/emacs > doc/lispref > doc/lispintro > doc/contrib (for other manuals) > > This is fine with me (I agree with the person who said `misc' is better > than `contrib'). > > I just wonder whether the added cleanness of creating a directory to > hold these four dirs outweights the disadvantage of moving them down > one level. If there were many of them, such as 8, then it would be > clearly yes. With just 4, it might be more annoyance than it is worth. Some manuals are very large (e.g. calc.texi, gnus.texi). It makes sense to create a separate directory under doc/ for packages with large manuals and split these manuals to smaller files. -- Juri Linkov http://www.jurta.org/emacs/