From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.devel Subject: Re: Documentation for "Clone Buffers" (corrected version) Date: 22 Mar 2004 11:10:05 -0500 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: References: <200403191747.i2JHlPS28017@f7.net> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1079977822 2311 80.91.224.253 (22 Mar 2004 17:50:22 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Mon, 22 Mar 2004 17:50:22 +0000 (UTC) Cc: juri@jurta.org, eliz@elta.co.il, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Mon Mar 22 18:50:14 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 1B5TZ0-0004Xu-00 for ; Mon, 22 Mar 2004 18:50:14 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1B5TZ0-0001W4-00 for ; Mon, 22 Mar 2004 18:50:14 +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 1B5TWI-0007cZ-8t for emacs-devel@quimby.gnus.org; Mon, 22 Mar 2004 12:47:26 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.30) id 1B5TVY-0007Zn-OS for emacs-devel@gnu.org; Mon, 22 Mar 2004 12:46:40 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.30) id 1B5TUr-0007JQ-Um for emacs-devel@gnu.org; Mon, 22 Mar 2004 12:46:29 -0500 Original-Received: from [206.47.199.163] (helo=simmts5-srv.bellnexxia.net) by monty-python.gnu.org with esmtp (Exim 4.30) id 1B5TUr-0007JH-M6 for emacs-devel@gnu.org; Mon, 22 Mar 2004 12:45:57 -0500 Original-Received: from empanada.local ([67.68.216.177]) by simmts5-srv.bellnexxia.net (InterMail vM.5.01.06.05 201-253-122-130-105-20030824) with ESMTP id <20040322164304.WRSD6718.simmts5-srv.bellnexxia.net@empanada.local>; Mon, 22 Mar 2004 11:43:04 -0500 Original-Received: by empanada.local (Postfix, from userid 502) id A5FCA13BEFF; Mon, 22 Mar 2004 11:10:05 -0500 (EST) Original-To: karl@freefriends.org (Karl Berry) In-Reply-To: <200403191747.i2JHlPS28017@f7.net> Original-Lines: 41 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:20737 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:20737 > info to include libc's index by default, you can just say `info strcpy' > Although automatically looking in libc's index would probably work for > 90% of cases in practice, it does not solve the general problem. Without reading the user's mind, there's no way to handle `info strcpy' 100%, and neither does `man' handle it 100% (for the same reason). So what you're saying here is not a criticism, unless you mean some specific problem, but I can't read your mind either. > Thus my original idea (although I guess I did not fully explain it): > 1have one subnode of dir for commands, one for library functions, one for > file formats, etc., analogous to the man sections. Keep the top level > dir itself for the manuals as a whole. The subnodes would be other menu > entries as usual: >>From a speed point of view, it might be good to put those many items in subnodes of `dir', but then comes the problem of keeping those entries up to date when updating manuals. So unless there's a way to "rebuild `dir' from scratch" in a completely automatic way (which AFAIK, there is not right now), it would be much better to not include copies of all those entries but instead to just add some pointers to big menus in the manuals themselves. Such pointers could point either to the manual's toplevel menu or to some index. > Such a Functions node will get very big (there are 6200 entries in my > /usr/share/man/man3) but I don't see another answer. Note that there is no copying invloved with `man' (unless you build the whatis database), so nothing to keep consistent, whereas in your case you'd have to make sure the Functions node doesn't hold stale data. > We would have to change the Texinfo language and the install-info > program to allow for installing entries in such a subnode of dir. > @dircategory/@direntry do not suffice. My suggestion doesn't require any such thing: just add to the `dir' node (or somesuch) the list of (index or toplevel) subnodes to look up by default and you're done. Stefan