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: Emacs cvs newbie problems Date: Wed, 2 Oct 2002 09:36:15 -0400 Sender: emacs-devel-admin@gnu.org Message-ID: <200210021336.g92DaF814104@f7.net> NNTP-Posting-Host: localhost.gmane.org X-Trace: main.gmane.org 1033662909 8478 127.0.0.1 (3 Oct 2002 16:35:09 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Thu, 3 Oct 2002 16:35:09 +0000 (UTC) Cc: eliz@is.elta.co.il, hattons@speakeasy.net, emacs-devel@gnu.org Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by main.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 17x8wN-0002Ca-00 for ; Thu, 03 Oct 2002 18:35:07 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian)) id 17x9hb-00069t-00 for ; Thu, 03 Oct 2002 19:23:55 +0200 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.10) id 17x8wk-00040h-00; Thu, 03 Oct 2002 12:35:30 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.10) id 17wjfp-0000qb-00 for emacs-devel@gnu.org; Wed, 02 Oct 2002 09:36:21 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.10) id 17wjfk-0000nD-00 for emacs-devel@gnu.org; Wed, 02 Oct 2002 09:36:19 -0400 Original-Received: from consort.superb.net ([209.61.216.22] helo=f7.net) by monty-python.gnu.org with esmtp (Exim 4.10) id 17wjfk-0000mt-00; Wed, 02 Oct 2002 09:36:16 -0400 Original-Received: (from karl@localhost) by f7.net (8.11.6/8.11.6) id g92DaF814104; Wed, 2 Oct 2002 09:36:15 -0400 Original-To: rms@gnu.org Errors-To: emacs-devel-admin@gnu.org X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.0.11 Precedence: bulk List-Help: List-Post: List-Subscribe: , List-Id: Emacs development discussions. List-Unsubscribe: , List-Archive: Xref: main.gmane.org gmane.emacs.devel:8336 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:8336 Where is this list? It is in the Texinfo manual. Since I made up the list at the same time we added the @dircategory/@direntry feature, I figured it would be better to get some experience with it before trying to promulgate anything too widely as a standard. Those don't seem like useful categories. Useful categories relate to jobs the user wants to find out how to do. Well, I think they do. Here was my thinking: if the user is a programmer, then they are looking for programming tools, or libraries, or documentation. If the user is using emacs, then they might look for Emacs packages; and if they don't use emacs, they have no interest in emacs packages. (Pretend `GNU Emacs Lisp' is just `Emacs', which is what you actually use.) If the user is not a programmer, then they're interested in all the "other" packages. Since you don't like those, can you give some specific examples of the broad categories that you would prefer, and how maintainers should choose categories? FYI, here is the real list from my system, including numerous categories from various packages I've installed on my system, such as gettext, lilypond, and a2ps. So you can get a sense of what maintainers are actually doing. (`Individual utilities' is important; it has an entry for each program like cp/rm/sort/etc. This is so people can say "info cp" or whatever and get something useful. There's also an entry for the general manual -- coreutils or whatever.) GNU Packages Texinfo documentation system Printing Tools GNU programming tools Emacs GNU Gettext Utilities GNU programming support GNU libraries GNU programming documentation GNU organization GNU music project TeX DOS Other things Individual utilities Any advice gratefully received ... k