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: Fri, 30 Jan 2009 10:52:10 -0600 Organization: =?utf-8?B?0KLQtdC+0LTQvtGAINCX0LvQsNGC0LDQvdC+0LI=?= @ Cienfuegos Message-ID: <86r62k91ol.fsf@lifelogs.com> References: <867i4pemv5.fsf@lifelogs.com> <86y6x49un4.fsf@lifelogs.com> <86ljt39ysz.fsf@lifelogs.com> <87tz7oxodr.fsf@jurta.org> <86mydd3kzv.fsf@lifelogs.com> <87pri9k64b.fsf@jurta.org> <86ljsw252p.fsf@lifelogs.com> <87hc3kfgb8.fsf@jurta.org> <86r62ne3aq.fsf@lifelogs.com> <86bptrdv4f.fsf@lifelogs.com> <861vuldgmu.fsf@lifelogs.com> <864ozgajtx.fsf@lifelogs.com> <003f01c982f4$be64d4c0$0200a8c0@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1233334289 23079 80.91.229.12 (30 Jan 2009 16:51:29 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 30 Jan 2009 16:51:29 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Jan 30 17:52:43 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 1LSwbh-00053N-3A for ged-emacs-devel@m.gmane.org; Fri, 30 Jan 2009 17:52:41 +0100 Original-Received: from localhost ([127.0.0.1]:54995 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LSwaO-0005D0-VM for ged-emacs-devel@m.gmane.org; Fri, 30 Jan 2009 11:51:20 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1LSwa4-00056j-Bd for emacs-devel@gnu.org; Fri, 30 Jan 2009 11:51:00 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1LSwa2-00055U-Ly for emacs-devel@gnu.org; Fri, 30 Jan 2009 11:50:59 -0500 Original-Received: from [199.232.76.173] (port=56098 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1LSwa2-00055H-F4 for emacs-devel@gnu.org; Fri, 30 Jan 2009 11:50:58 -0500 Original-Received: from main.gmane.org ([80.91.229.2]:52441 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 1LSwa1-0001yn-Oc for emacs-devel@gnu.org; Fri, 30 Jan 2009 11:50:58 -0500 Original-Received: from list by ciao.gmane.org with local (Exim 4.43) id 1LSwZw-0004QQ-VP for emacs-devel@gnu.org; Fri, 30 Jan 2009 16:50:53 +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 ; Fri, 30 Jan 2009 16:50:52 +0000 Original-Received: from tzz by 38.98.147.130 with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Fri, 30 Jan 2009 16:50:52 +0000 X-Injected-Via-Gmane: http://gmane.org/ Original-Lines: 33 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:F/DbBdPz/wxvzTozzVvnO2mmGzI= 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:108414 Archived-At: On Fri, 30 Jan 2009 08:06:42 -0800 "Drew Adams" wrote: DA> 1. When the thing documented in *Help* is also in the manual, then we have a DA> link to the manual from the *Help* buffer. DA> 2. The manual should have such a `See also' cross reference, if any place DA> should. Agreed on both counts. The API I'm providing can be combined with the manual generation to do this, and it will use the manual sections to get the first keyword seeds. I don't want the manual to be the primary source of keywords, that's all. DA> 3. When both the thing doc'd in *Help* and the thing xref'd are in the manual, DA> #1 and #2 would take care of such cross-referencing. Admittedly, passing through DA> the manual represents an indirection, but typically a fruitful one. DA> Dunno if it's worth adding this for cases that are not covered by the manual. It DA> sounds like a helpful feature. I can't speak to the implementation cost. (There DA> is also a doc-maintenance cost to consider.) There are many many packages and functions not covered in the manual that are nevertheless used and useful. They can and should have keywords. So the docstring should be the primary source of keywords, and looking up the function with C-h f should be the primary way to cross-reference functions by keyword. The goal of this API is not to index Emacs' internal functions' keywords. It will cover everything that `mapatoms' returns; I'm considering symbols in addition to functions but I want to get functions working first. Ted