From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Eric M. Ludlam" Newsgroups: gmane.emacs.devel Subject: Re: Completions in Semantic Date: Wed, 21 Oct 2009 13:35:50 -0400 Message-ID: <1256146550.6961.1159.camel@projectile.siege-engine.com> References: <1255969613.6961.1056.camel@projectile.siege-engine.com> <1255980824.6961.1075.camel@projectile.siege-engine.com> <1255990628.6961.1084.camel@projectile.siege-engine.com> <1256070021.6961.1107.camel@projectile.siege-engine.com> <20091021105840.GD2964@ginnungagap.pc.ac.upc.edu> <1256128529.6961.1138.camel@projectile.siege-engine.com> <20091021132847.GA20406@ginnungagap.pc.ac.upc.edu> Reply-To: eric@siege-engine.com NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1256146647 7329 80.91.229.12 (21 Oct 2009 17:37:27 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 21 Oct 2009 17:37:27 +0000 (UTC) Cc: emacs-devel@gnu.org To: Lluis Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Oct 21 19:37:17 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 1N0f7c-0007Dn-CJ for ged-emacs-devel@m.gmane.org; Wed, 21 Oct 2009 19:37:16 +0200 Original-Received: from localhost ([127.0.0.1]:50984 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1N0f7b-0006sI-Or for ged-emacs-devel@m.gmane.org; Wed, 21 Oct 2009 13:37:15 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1N0f7T-0006mm-Eu for emacs-devel@gnu.org; Wed, 21 Oct 2009 13:37:07 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1N0f7S-0006lQ-G8 for emacs-devel@gnu.org; Wed, 21 Oct 2009 13:37:06 -0400 Original-Received: from [199.232.76.173] (port=58549 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1N0f7S-0006lA-7t for emacs-devel@gnu.org; Wed, 21 Oct 2009 13:37:06 -0400 Original-Received: from static-71-184-83-10.bstnma.fios.verizon.net ([71.184.83.10]:51912 helo=projectile.siege-engine.com) by monty-python.gnu.org with esmtps (TLS-1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1N0f5K-0007CT-P8 for emacs-devel@gnu.org; Wed, 21 Oct 2009 13:34:55 -0400 Original-Received: from projectile.siege-engine.com (localhost [127.0.0.1]) by projectile.siege-engine.com (8.14.3/8.14.3/Debian-6) with ESMTP id n9LHZpvo024106; Wed, 21 Oct 2009 13:35:51 -0400 Original-Received: (from zappo@localhost) by projectile.siege-engine.com (8.14.3/8.14.3/Submit) id n9LHZoRa024105; Wed, 21 Oct 2009 13:35:50 -0400 X-Authentication-Warning: projectile.siege-engine.com: zappo set sender to eric@siege-engine.com using -f In-Reply-To: <20091021132847.GA20406@ginnungagap.pc.ac.upc.edu> X-Mailer: Evolution 2.26.1 X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 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:116294 Archived-At: On Wed, 2009-10-21 at 15:28 +0200, Lluis wrote: > > Just as an FYI about the semantic tag info (which you seem to be > > alluding to), is that it provides all that info, though not > necessarily > > from the completion engine via a UI. > > Well, it's been a long time since I played with the completion > interfaces > provided in CEDET, but I already knew all that information was > available > somewhere in semantic :) > > I just didn't know documentation was also available as one of the > tag's > attributes, which reminds me that: > 1) One-liner doxygen description shows up with the `*/' at the end > 2) Descriptions of the form: /*< description */ > are not assigned to the correct variable > 3) One more nice feature would be to have the "show long > documentation" > parse doxygen-specific commands such that parameters > descriptions are > shown more clearly The doc in Semantic tags is only for languages that have explicit doc, like Emacs Lisp. For other languages, when doc is requested of a tag, there is some code that goes and looks for comments. It doesn't follow doxygen style rules though. On the flip side, the srecode tool has a documentation feature that can do doxygen style comment reading/modification, going so far as to take boring comments and convert them to be doxygen compatible. You can use it with srecode-document-insert-comment, or C-c / C if srecode minor mode is on. I think I only created templates for C/C++, and Java. I suppose it would make sense to merge the comment reader pieces back together. For folks hacking Emacs C code, if there is a comment style/behavior that is repetitive/special in some way, it should be possible to create srecode template specialization for it. I've been interested in having EDE provided project template specializations, but haven't had a use case since I only use the GNUish or doxygen ones which are language specific. > I also tried with `completion-ui', `auto-complete' and `company-mode', > which are > the ones I've found that provide completion UIs through overlays (hope > I'm using > the correct term), which is the form i feel more comfortable with. > > But as far as I've been able to see, none of these three provide the > features > I've mentioned, although they do provide semantic-based backends for > completion. Those tools are pretty generic completion engines, and thus don't have any special features that use the extra tagging info. That I know of anyway. Eric