From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: karl@freefriends.org (Karl Berry) Newsgroups: gmane.emacs.devel Subject: Re: Documentation for "Clone Buffers" (corrected version) Date: Fri, 19 Mar 2004 12:47:25 -0500 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <200403191747.i2JHlPS28017@f7.net> References: NNTP-Posting-Host: deer.gmane.org X-Trace: sea.gmane.org 1079719412 28006 80.91.224.253 (19 Mar 2004 18:03:32 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 19 Mar 2004 18:03:32 +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 Fri Mar 19 19:03:23 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 1B4OL4-0006F8-00 for ; Fri, 19 Mar 2004 19:03:22 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1B4OL0-0004Mz-00 for ; Fri, 19 Mar 2004 19:03:22 +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 1B4OKc-0004XW-1B for emacs-devel@quimby.gnus.org; Fri, 19 Mar 2004 13:02:54 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.30) id 1B4OKD-0004Pb-Np for emacs-devel@gnu.org; Fri, 19 Mar 2004 13:02:29 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.30) id 1B4OJd-00049j-92 for emacs-devel@gnu.org; Fri, 19 Mar 2004 13:02:25 -0500 Original-Received: from [209.61.216.22] (helo=f7.net) by monty-python.gnu.org with esmtp (Exim 4.30) id 1B4OAh-0002WO-1p for emacs-devel@gnu.org; Fri, 19 Mar 2004 12:52:39 -0500 Original-Received: (from karl@localhost) by f7.net (8.11.7-20030920/8.11.7) id i2JHlPS28017; Fri, 19 Mar 2004 12:47:25 -0500 Original-To: monnier@iro.umontreal.ca In-Reply-To: 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:20620 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:20620 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. My model here is `man' I agree, we need a procedure for this that works as well as man's does, without having to load thousands of dir entries by default. 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: * Menu: * Commands:: * Functions:: ... * Emacs (emacs). ... ... Then info commands printf vs. info functions printf will get the right thing. That is, from the cmd line. I don't know what the best interface would be for Emacs. As a bonus, we could make info 1 printf also work by letting `1' mean the first menu entry on the cmd line (as it does interactively)! The search order for "info printf" could be defined externally, a la man. 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. 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.