From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Lennart Borgman Newsgroups: gmane.emacs.devel Subject: Re: tags for functions Date: Tue, 20 Jan 2009 21:44:29 +0100 Message-ID: References: <867i4pemv5.fsf@lifelogs.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1232484313 21889 80.91.229.12 (20 Jan 2009 20:45:13 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 20 Jan 2009 20:45:13 +0000 (UTC) Cc: emacs-devel@gnu.org To: Ted Zlatanov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Jan 20 21:46:26 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 1LPNUP-000341-4L for ged-emacs-devel@m.gmane.org; Tue, 20 Jan 2009 21:46:25 +0100 Original-Received: from localhost ([127.0.0.1]:46881 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LPNT7-0002wJ-Ox for ged-emacs-devel@m.gmane.org; Tue, 20 Jan 2009 15:45:05 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1LPNSa-0002ig-Ni for emacs-devel@gnu.org; Tue, 20 Jan 2009 15:44:32 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1LPNSZ-0002i8-EE for emacs-devel@gnu.org; Tue, 20 Jan 2009 15:44:31 -0500 Original-Received: from [199.232.76.173] (port=39653 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LPNSZ-0002i5-9a for emacs-devel@gnu.org; Tue, 20 Jan 2009 15:44:31 -0500 Original-Received: from fg-out-1718.google.com ([72.14.220.154]:19853) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1LPNSY-0004vm-Kt for emacs-devel@gnu.org; Tue, 20 Jan 2009 15:44:31 -0500 Original-Received: by fg-out-1718.google.com with SMTP id l26so1706385fgb.30 for ; Tue, 20 Jan 2009 12:44:29 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:mime-version:received:in-reply-to:references :date:message-id:subject:from:to:cc:content-type :content-transfer-encoding; bh=6pndl4foOTPjZSuak0vJCDmJXJ3MRwy9cEZKwF28Yjg=; b=bna4ZleyIdiIgxarjVRIGSK4J6gWqaPeX5woazWF8ZW4KfvcJl+VD3ihNX9NXrHa1e CdAY/XORP/rjy8x37Mxe7lqljqUVi4R6t8drDQHhl1/nMXrb8R8Dj7rCp7RQMgei4IaJ VzERgsGcjXZl5bcjJccQYtVspwK+nUdcomOCM= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type:content-transfer-encoding; b=ezneXpe4NJTgAt6Pc6TV2FNtcPRAqR8u1u+P6bo4WipuhUbbKi5PE8vkJIdYqxesIC Th4g899wKtbuBqMyplyopP70aRwMk/wPAkbCKLDaWv+sOI5Rv6slZs2rkvXvfdojIKb9 03QzYQ0KaW06tHawGEOv81YDqd45NGNUp6+ew= Original-Received: by 10.86.89.20 with SMTP id m20mr1523018fgb.71.1232484269752; Tue, 20 Jan 2009 12:44:29 -0800 (PST) In-Reply-To: <867i4pemv5.fsf@lifelogs.com> X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 2) 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:108019 Archived-At: On Tue, Jan 20, 2009 at 9:36 PM, Ted Zlatanov wrote: > 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. I think the idea is nice, but maybe keywords should be used (like in defcustom etc) for the implementation?