Bug 149141 - [javadoc][assist] code completion of javadoc tags when comment is not ended
Summary: [javadoc][assist] code completion of javadoc tags when comment is not ended
Status: CLOSED WONTFIX
Alias: None
Product: JDT
Classification: Eclipse Project
Component: Core (show other bugs)
Version: 3.2   Edit
Hardware: PC All
: P5 minor (vote)
Target Milestone: ---   Edit
Assignee: David Audel CLA
QA Contact:
URL:
Whiteboard: stalebug
Keywords:
Depends on: 139621
Blocks:
  Show dependency tree
 
Reported: 2006-06-29 08:40 EDT by Maxime Daniel CLA
Modified: 2020-01-11 07:21 EST (History)
3 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Maxime Daniel CLA 2006-06-29 08:40:06 EDT
Build id: I20060620-1010

Type the following:

public class X {
  /** @sin

Press Ctrl-Space.
I would expect @since to be proposed, and this is not the case.
Note that:
- when you press enter at the end of the first line, a closing bracket is 
  inserted automagically (not shown here);
- the 'sin' characters are presented in bold face, which augments the urge to
  press Ctrl-Space;
- if you add a method or a field, code assist proposes @since.

Also applies to other tags.

The workaround exists and is obvious.

Discussed a bit the subject with David. I admit that we cannot guess which tags are legal and which are not at this point (or simply dubious - I detected this using @deprecated, which is seldom used upon brand new members!). Yet, a programmer who has a clear view of what he is about to do should not be ampered by the tool. Here, the bold face tells him he can go with Ctrl-Space, and he gets no suggestion at all... in effect, while he believes typing @siCtrl-Space will save him time, he looses some.
(In fact, the bold face is used after /** @, whichever letters you type, which is misleading by itself - but this bug specifically discusses the case of a legal prefix.)
Comment 1 Frederic Fusier CLA 2006-06-29 10:23:21 EDT
There's 2 things here:
1) complete after /** @sin
   When comment is not ended, code is invalid and even scanner does not recognize
   any comment here (InvalidInputException). So, there's obviously no parse and no
   way to propose anything with current parse structure.
   I think that CompletionEngine here needs to be involved either to make proposals
   without using Javadoc parse or create a pseudo Javadoc node and parse it...
2) complete /** @sin<Ctrl+Space> */ without any declaration after.
   This point has been already raised: see bug 139621
Comment 2 Frederic Fusier CLA 2006-11-13 07:17:54 EST
Defer
Comment 3 Frederic Fusier CLA 2006-12-01 07:37:08 EST
Update summary as comment 1 problem 2) is now addressed...
Comment 4 Frederic Fusier CLA 2007-06-21 10:56:45 EDT
Reopen as LATER is deprecated...
Comment 5 Eclipse Genie CLA 2020-01-11 07:21:38 EST
This bug hasn't had any activity in quite some time. Maybe the problem got resolved, was a duplicate of something else, or became less pressing for some reason - or maybe it's still relevant but just hasn't been looked at yet.

If you have further information on the current state of the bug, please add it. The information can be, for example, that the problem still occurs, that you still want the feature, that more information is needed, or that the bug is (for whatever reason) no longer relevant.

--
The automated Eclipse Genie.