The completion menu provided with Eclim, although it works great,
sadly does not allow this feature of Vim to work, because it doesn't
populate the 'info' field.
Ideally the 'info' field would be populated with the function
prototype for functions, plus possibly the header comment above it,
similar to the hover text within Eclipse (but just the prototype would
be a great start).
For variables, the field probably need not be populated, but it would
be pretty awesome if you could somehow stick the definition of the
type in there if the variable has a complex type. It looks like
Eclipse just sticks the variable's declaration into the hover text.
The issue with populating the info field is a matter of performance.
In the case of java completion it would be trivially easy for me to
include the full java docs of the method/field/class but eclipse
doesn't seem to cache that data so grabbing that info for each
completion adds a bit of overhead, which when there are a lot of
completion results, leads to a substantial degradation in performance.
So up to this point I've been limiting the data returned in
completions to what can be obtained with the least amount of impact on
speed.
I've even asked[1] Bram, back when vim's code completion support was
still alpha I believe, for some sort of hook to allow for lazy loading
of completion proposal info, but I apparently failed to convince him.
I'll look over code completion for each language and re-evaluate
what info can be returned, but I can't make any promises.
[1] http://tech.groups.yahoo.com/group/vimdev/message/43114
--
eric
I just updated the c/c++ completion to use the completion's display
string as the completion info if the display string includes the
signature or type information (something more than just the name).
https://github.com/ervandew/eclim/commit/71bed379bed2522a49be1f303dfb9c57e644ef71
--
eric