From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Juri Linkov Newsgroups: gmane.emacs.devel Subject: Re: tags for functions Date: Tue, 27 Jan 2009 01:55:32 +0200 Organization: JURTA Message-ID: <87pri9k64b.fsf@jurta.org> References: <867i4pemv5.fsf@lifelogs.com> <86y6x49un4.fsf@lifelogs.com> <86ljt39ysz.fsf@lifelogs.com> <87tz7oxodr.fsf@jurta.org> <86mydd3kzv.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 1233014699 24408 80.91.229.12 (27 Jan 2009 00:04:59 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 27 Jan 2009 00:04:59 +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 27 01:06:12 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 1LRbRU-0002pr-W6 for ged-emacs-devel@m.gmane.org; Tue, 27 Jan 2009 01:04:37 +0100 Original-Received: from localhost ([127.0.0.1]:59624 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LRbQD-0004wa-9q for ged-emacs-devel@m.gmane.org; Mon, 26 Jan 2009 19:03:17 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1LRbKl-0002HD-QP for emacs-devel@gnu.org; Mon, 26 Jan 2009 18:57:39 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1LRbKi-0002FY-Pt for emacs-devel@gnu.org; Mon, 26 Jan 2009 18:57:38 -0500 Original-Received: from [199.232.76.173] (port=57073 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LRbKi-0002F7-Iy for emacs-devel@gnu.org; Mon, 26 Jan 2009 18:57:36 -0500 Original-Received: from relay01.kiev.sovam.com ([62.64.120.200]:2907) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1LRbKh-0002jM-Os for emacs-devel@gnu.org; Mon, 26 Jan 2009 18:57:36 -0500 Original-Received: from [83.170.232.243] (helo=smtp.svitonline.com) by relay01.kiev.sovam.com with esmtp (Exim 4.69) (envelope-from ) id 1LRbKf-0008Rv-0B; Tue, 27 Jan 2009 01:57:33 +0200 In-Reply-To: <86mydd3kzv.fsf@lifelogs.com> (Ted Zlatanov's message of "Mon, 26 Jan 2009 13:50:12 -0600") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.60 (x86_64-pc-linux-gnu) X-Scanner-Signature: 88f972a75cd389d721acc69b695bb680 X-DrWeb-checked: yes X-detected-operating-system: by monty-python.gnu.org: FreeBSD 4.8-5.1 (or MacOS X 10.2-10.3) 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:108274 Archived-At: > JL> finder.el extracts package keywords from the comments in the file > JL> header. Doing the same for function keywords means placing them in > JL> the comments before the function definition. Many modern > JL> programming languages use the @-syntax for documentation tags. > JL> [...] add them in doc strings like: > > JL> (defun my-move-defun () > JL> "Docstring. > JL> @tag1 > JL> @tag2" > JL> ...) > > That's probably the least intrusive approach, I like it. So finder.el > will be the central place for getting all keywords, which works fine for > me. It's nice that it's already called everywhere needed, so I just > need to hook into that infrastructure. Does anyone have a problem with it? finder.el scans source files for keywords in comments. So we don't need finder.el with tags in doc strings because it's easy to collect tags from the `documentation' property of all function symbols. -- Juri Linkov http://www.jurta.org/emacs/