emacs-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: tags for functions


From: Juri Linkov
Subject: Re: tags for functions
Date: Tue, 27 Jan 2009 01:55:32 +0200
User-agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.60 (x86_64-pc-linux-gnu)

> 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/




reply via email to

[Prev in Thread] Current Thread [Next in Thread]