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: 21 Mar 2004 07:55:56 +0200 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: References: <200403201415.i2KEFNq19043@f7.net> <7494-Sat20Mar2004171547+0200-eliz@elta.co.il> <20040320192709.GA31243@fencepost> Reply-To: Eli Zaretskii NNTP-Posting-Host: deer.gmane.org X-Trace: sea.gmane.org 1079848566 24339 80.91.224.253 (21 Mar 2004 05:56:06 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sun, 21 Mar 2004 05:56:06 +0000 (UTC) Cc: juri@jurta.org, emacs-devel@gnu.org, karl@freefriends.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Sun Mar 21 06:56:02 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 1B4vwI-0002j1-00 for ; Sun, 21 Mar 2004 06:56:02 +0100 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1B4vwH-0006yE-00 for ; Sun, 21 Mar 2004 06:56:01 +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 1B4vuY-0004SR-SD for emacs-devel@quimby.gnus.org; Sun, 21 Mar 2004 00:54:14 -0500 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.30) id 1B4vuT-0004RX-Pw for emacs-devel@gnu.org; Sun, 21 Mar 2004 00:54:09 -0500 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.30) id 1B4vtx-0003wb-6r for emacs-devel@gnu.org; Sun, 21 Mar 2004 00:54:08 -0500 Original-Received: from [207.232.27.5] (helo=WST0054) by monty-python.gnu.org with asmtp (Exim 4.30) id 1B4vtw-0003wH-LD; Sun, 21 Mar 2004 00:53:36 -0500 Original-To: Miles Bader In-reply-to: <20040320192709.GA31243@fencepost> (message from Miles Bader on Sat, 20 Mar 2004 14:27:09 -0500) 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:20672 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:20672 > Date: Sat, 20 Mar 2004 14:27:09 -0500 > From: Miles Bader > > Consider a toolkit that come with 34 different libraries (which normally you > just always link against); it's fairly likely that it comes with just one > info manual covering everything. This is probably good: the programmer is > more likely to think of the function as being in `that toolkit', than he is > to quickly remember which library it's in (though he can probably figure it > out). In that case, "info toolkit FOO" would do the job, and is the right command for the case when all those libraries are described in a single manual. > Anyway, the point is that the mapping is often fuzzy Are you saying that it's easier to remember the mapping of man sections? > why not take advantage of that and reduce the burden on the > programmer when looking up documentation? The question is, how to do that without imposing too heavy penalties on all parties involved (i.e. the end user in terms of run-time performance, the Texinfo maintainers, and manual authors).