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: Re: tags for functions Date: Thu, 22 Jan 2009 08:47:01 -0600 Organization: =?utf-8?B?0KLQtdC+0LTQvtGAINCX0LvQsNGC0LDQvdC+0LI=?= @ Cienfuegos Message-ID: <86prif9z4q.fsf@lifelogs.com> References: NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1232636692 32378 80.91.229.12 (22 Jan 2009 15:04:52 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 22 Jan 2009 15:04:52 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Jan 22 16:06:04 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 1LQ17l-00013A-Fw for ged-emacs-devel@m.gmane.org; Thu, 22 Jan 2009 16:05:58 +0100 Original-Received: from localhost ([127.0.0.1]:54128 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LQ16U-0003Nv-21 for ged-emacs-devel@m.gmane.org; Thu, 22 Jan 2009 10:04:22 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1LQ0op-0007tW-FG for emacs-devel@gnu.org; Thu, 22 Jan 2009 09:46:07 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1LQ0on-0007qv-Al for emacs-devel@gnu.org; Thu, 22 Jan 2009 09:46:06 -0500 Original-Received: from [199.232.76.173] (port=56805 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LQ0on-0007qi-3j for emacs-devel@gnu.org; Thu, 22 Jan 2009 09:46:05 -0500 Original-Received: from main.gmane.org ([80.91.229.2]:33771 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 1LQ0om-0003qW-5u for emacs-devel@gnu.org; Thu, 22 Jan 2009 09:46:04 -0500 Original-Received: from list by ciao.gmane.org with local (Exim 4.43) id 1LQ0og-000700-9U for emacs-devel@gnu.org; Thu, 22 Jan 2009 14:45:58 +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 ; Thu, 22 Jan 2009 14:45:58 +0000 Original-Received: from tzz by 38.98.147.130 with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Thu, 22 Jan 2009 14:45:58 +0000 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 43 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:/JS3yJ+XMHlyLPM58vC3AHO0qAI= 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:108093 Archived-At: On Thu, 22 Jan 2009 03:07:23 -0500 MON KEY wrote: >> 2) refine the keywords into a simple taxonomy that is not too big nor too small. >> The first question I have is, how to associate keywords with a function? MK> Keep in mind that a taxonomic description of code's content/concepts MK> is entirely different from a coded object class hierarchy - the MK> distinction is subtle and all to often overlooked... esp. by MK> programmers who *are* in fact quite adept at creating taxonomy in MK> code. MK> Please consider examining the following standard for a comprehensive MK> approach to accomplishing this task with optimal consideration of TRT. MK> ANSI/NISO Z39.19-2005 MK> Guidelines for the Construction, Format, and Management of Monolingual MK> Controlled Vocabularies MK> ISBN: 1-880124-65-3 MK> Available here: http://www.niso.org/standards/resources/Z39-19-2005.pdf Well, at 180 pages of dense information this is a serious standard. Also it defines "taxonomy" as a structural hierarchical classification, whereas I've used it loosely to mean a tag space. I'll use "tag space" from now on to be clear. Since we're not classifying general knowledge but a very specific domain (Emacs Lisp functions) I don't think the standard needs to be applied. It makes some good points, but things like a full hierarchy are overkill, and others like proper name conventions just don't apply. I'll try to be consistent with its naming recommendations, at least. It brings up "synonym rings" which may be necessary: I propose 50% of the effort is to come from each package's predeclared Keywords header. That's determined by the package author so it's not easy to enforce a particular tag space over all of Emacs. With synonym rings, we can associate synonymous keywords together. Once the list of keywords is established, you should take a look to see if you agree with it or have suggestions for improvements. I'll post here. Ted