From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Ralf Angeli Newsgroups: gmane.emacs.devel Subject: Re: Split man directory Date: Mon, 03 Sep 2007 21:19:32 +0200 Message-ID: <87fy1v36be.fsf@neutrino.caeruleus.net> References: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1188847198 4956 80.91.229.12 (3 Sep 2007 19:19:58 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Mon, 3 Sep 2007 19:19:58 +0000 (UTC) Cc: Andreas Schwab , rms@gnu.org, emacs-devel@gnu.org To: Glenn Morris Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Sep 03 21:19:57 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 1ISHSd-00019X-Sc for ged-emacs-devel@m.gmane.org; Mon, 03 Sep 2007 21:19:48 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1ISHSc-0007Ug-FH for ged-emacs-devel@m.gmane.org; Mon, 03 Sep 2007 15:19:46 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1ISHSY-0007SM-Ky for emacs-devel@gnu.org; Mon, 03 Sep 2007 15:19:42 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1ISHSX-0007SA-Oy for emacs-devel@gnu.org; Mon, 03 Sep 2007 15:19:41 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1ISHSX-0007S7-JI for emacs-devel@gnu.org; Mon, 03 Sep 2007 15:19:41 -0400 Original-Received: from moutng.kundenserver.de ([212.227.126.188]) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1ISHSR-0005wX-Cl; Mon, 03 Sep 2007 15:19:35 -0400 Original-Received: from p54A50FCC.dip0.t-ipconnect.de [84.165.15.204] (helo=neutrino.caeruleus.net) by mrelayeu.kundenserver.de (node=mrelayeu5) with ESMTP (Nemesis), id 0ML25U-1ISHSP2BIX-0007wH; Mon, 03 Sep 2007 21:19:33 +0200 In-Reply-To: (Glenn Morris's message of "Mon, 03 Sep 2007 14:42:19 -0400") User-Agent: Gnus/5.110007 (No Gnus v0.7) Emacs/22.1.50 (gnu/linux) X-Provags-ID: V01U2FsdGVkX19x9evhJbtajHm8MyuMiNU8Q6Xr9TDnFolk5cc xD6kZ7ldNMLGSk2JnZSEOmKI5gyvwn7ISB+QIfOlVhbLSpP2BU 04u+9OAW1HBXFs+CenCCg== X-Detected-Kernel: Linux 2.6? (barebone, rare!) 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:77678 Archived-At: * Glenn Morris (2007-09-03) writes: > Richard Stallman wrote: > >> Since the Emacs Manual is the main manual for Emacs, and the others >> are secondary, I'd rather do it as I said before. > > It's only a directory name, what difference does it make? The "man" > directory is confusingly named, IMO, because it has nothing to do with > the traditional Unix "man" directory. It doesn't even contain sources > for man pages. > > emacsref/man/doc and miscref/man/doc? If the manuals are supposed to be stored in a central place I'd suggest a "man/" directory structure. The result would be "man/emacs", "man/lispref", and perhaps "man/other". If a manual is split into several files this could be supported by adding a directory for it below "man" or "man/other". (BTW, the RefTeX manual was split some time ago in the AUCTeX repository.) A completely different approach would be to put the documentation of libraries or packages where the code is and have a per package directory structure like "lib//lisp" and "lib//doc". I hope I don't blow this discussion out of proportion with such a suggestion. -- Ralf