From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: "Eli Zaretskii" Newsgroups: gmane.emacs.devel Subject: Re: Documentation for "Clone Buffers" (corrected version) Date: Sat, 20 Mar 2004 16:04:33 +0200 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <3405-Sat20Mar2004160433+0200-eliz@elta.co.il> References: <200403191747.i2JHlPS28017@f7.net> Reply-To: Eli Zaretskii NNTP-Posting-Host: deer.gmane.org X-Trace: sea.gmane.org 1079791905 29088 80.91.224.253 (20 Mar 2004 14:11:45 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 20 Mar 2004 14:11:45 +0000 (UTC) Cc: juri@jurta.org, monnier@iro.umontreal.ca, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Sat Mar 20 15:11:29 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 1B4hCD-0002OI-00 for ; Sat, 20 Mar 2004 15:11:29 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1B4hCD-0001Vo-00 for ; Sat, 20 Mar 2004 15:11:29 +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 1B4h9O-0006EI-Nm for emacs-devel@quimby.gnus.org; Sat, 20 Mar 2004 09:08:34 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.30) id 1B4h9G-0006Du-Rj for emacs-devel@gnu.org; Sat, 20 Mar 2004 09:08:26 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.30) id 1B4h8k-000643-1i for emacs-devel@gnu.org; Sat, 20 Mar 2004 09:08:25 -0500 Original-Received: from [192.114.186.24] (helo=legolas.inter.net.il) by monty-python.gnu.org with esmtp (Exim 4.30) id 1B4h8j-000631-Ip for emacs-devel@gnu.org; Sat, 20 Mar 2004 09:07:53 -0500 Original-Received: from zaretski ([80.230.144.65]) by legolas.inter.net.il (MOS 3.4.5-GR) with ESMTP id BMR01460; Sat, 20 Mar 2004 16:06:41 +0200 (IST) Original-To: karl@freefriends.org (Karl Berry) X-Mailer: emacs 21.3.50 (via feedmail 8 I) and Blat ver 1.8.9 In-reply-to: <200403191747.i2JHlPS28017@f7.net> (karl@freefriends.org) 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:20639 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:20639 > Date: Fri, 19 Mar 2004 12:47:25 -0500 > From: karl@freefriends.org (Karl Berry) > > Although automatically looking in libc's index would probably work for > 90% of cases in practice, it does not solve the general problem. I'm not even sure it solves 90% of cases, unless all of the cases come from libc functions lookup. > 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. But the Info system is _not_ `man', so some problems don't have a solution that works as ``well'' as `man' does. > 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. That would work, but do we really have the power to enforce such an organization of DIR? Unlike `man', the Info manuals are not written by the same person/team, so coordinating all of them is much more difficult. Even the current guidelines that Karl tries to promote for quite a few years now are not yet as widespread as we'd like them to be. > 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)! I'd suggest instead to invest efforts in producing an Info `apropos'-style database, so that "info printf" could search all of the Info manuals in reasonable time. This is localized to the Texinfo pacakge (assuming Emacs asupports that as well), so its introduction would be much easier.