From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Ted Zlatanov Newsgroups: gmane.emacs.devel Subject: tags for functions Date: Tue, 20 Jan 2009 14:36:14 -0600 Organization: =?utf-8?B?0KLQtdC+0LTQvtGAINCX0LvQsNGC0LDQvdC+0LI=?= @ Cienfuegos Message-ID: <867i4pemv5.fsf@lifelogs.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1232483957 20733 80.91.229.12 (20 Jan 2009 20:39:17 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 20 Jan 2009 20:39:17 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Jan 20 21:40:29 2009 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1LPNOd-0001F4-QX for ged-emacs-devel@m.gmane.org; Tue, 20 Jan 2009 21:40:28 +0100 Original-Received: from localhost ([127.0.0.1]:47723 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LPNNM-00054I-NF for ged-emacs-devel@m.gmane.org; Tue, 20 Jan 2009 15:39:08 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1LPNJb-0000ne-M4 for emacs-devel@gnu.org; Tue, 20 Jan 2009 15:35:15 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1LPNJa-0000m1-Hd for emacs-devel@gnu.org; Tue, 20 Jan 2009 15:35:14 -0500 Original-Received: from [199.232.76.173] (port=42697 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LPNJa-0000lj-Dm for emacs-devel@gnu.org; Tue, 20 Jan 2009 15:35:14 -0500 Original-Received: from main.gmane.org ([80.91.229.2]:39226 helo=ciao.gmane.org) by monty-python.gnu.org with esmtps (TLS-1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1LPNJZ-00046k-W8 for emacs-devel@gnu.org; Tue, 20 Jan 2009 15:35:14 -0500 Original-Received: from list by ciao.gmane.org with local (Exim 4.43) id 1LPNJX-0006xl-Qk for emacs-devel@gnu.org; Tue, 20 Jan 2009 20:35:12 +0000 Original-Received: from 38.98.147.130 ([38.98.147.130]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Tue, 20 Jan 2009 20:35:11 +0000 Original-Received: from tzz by 38.98.147.130 with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Tue, 20 Jan 2009 20:35:11 +0000 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 39 Original-X-Complaints-To: usenet@ger.gmane.org X-Gmane-NNTP-Posting-Host: 38.98.147.130 X-Face: bd.DQ~'29fIs`T_%O%C\g%6jW)yi[zuz6; d4V0`@y-~$#3P_Ng{@m+e4o<4P'#(_GJQ%TT= D}[Ep*b!\e,fBZ'j_+#"Ps?s2!4H2-Y"sx" User-Agent: Gnus/5.110011 (No Gnus v0.11) Emacs/23.0.60 (gnu/linux) Cancel-Lock: sha1:bNECdCKKmLIqA4ODmFh4S/vIsVI= X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6, seldom 2.4 (older, 4) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:108018 Archived-At: Ted Z wrote in comp.emacs and gnu.emacs.help: > On Sat, 17 Jan 2009 10:29:45 -0800 (PST) Xah Lee wrote: > > XL> Note that listing related functions in a function's doc is in many > XL> programing manuals. e.g Mathematica, MS's JScript, PHP ... they are > XL> quite useful. Because for those not expert yet of a lang (which is > XL> majority), often they do not know similar functions or do not know if > XL> there's manual section that list such, and often are confused about > XL> the differences of many functions that seems the same .... > > I agree this would be useful. It's best done with tags IMO, rather > than explicitly listing the related functions. For example, motion > commands should be tagged "motion" and then every command with that > tag can automatically list every motion command. The key is that the > extra work is in classification, not in tediously listing every > command's peers. > > Tags I could use: motion, file, coding-system, menu, buffer, process > > Each package should probably tag its commands with the package name. > > Short tags are not always descriptive enough, but long tags get > unpleasantly verbose so the real art is in balancing between the two. > > Anything more hierarchical than tags is painful to manage in the long run. A tangential discussion about the inconsistent naming of motion commands led me to the proposal above. I think it would be a nice addition to Emacs. I did a search and didn't find prior relevant discussions. Every package with a comment stating Keywords: at the beginning could automatically give those keywords as tags to its functions. That would probably be 50% or less of the total needed tags, but it's an easy start. Ted