[popup] Add advanced formatting and allow additional info/documentation for list items/suggestions

[peta]

PLEASE HELP FUND-RAISING TO MAKE THIS FEATURE-SUGGESTION BECOME TRUE: http://www.indiegogo.com/projects/textmate-dialog2-sprint

---

The formatting options of list items are very limited. Currently only the use of images/icons and a simple text string is possible. Everybody used to full blown IDEs loves (and thus probably misses) decent features like short info strings behind the actual function/method/variable/consant and tooltip with additional informations that appears once a list item is selected for several seconds.

Alan asked for more concrete syntax/API stuff instead of mouthful explainations ... so here we go:
possible API for my suggestions.

In order to better explain my idea/feature-request I just attached a little mockup:

[tiktuk]

Wow, nice work @peta!

[peta]

Please help fund-raising to make this feature-suggestion become true: http://www.indiegogo.com/projects/textmate-dialog2-sprint

[jacob-carlborg]

Have a look at this blog post for possible design of an autocomplete popup: http://www.brandonwalkin.com/blog/2010/06/03/xcode-ui-improvements/ in particular http://brandonwalkin.com/blog/images/Xcode/AnchoredDocs.png

[peta]

@jacob-carlborg Wow, looks great! I have something very very similar in mind ... code/API completion enriched with additional information that keeps the developer's focus straight in the context of coding. But looking slick at the same time. As said in the description of my fundraising-campaign, to make this work (not only in a few but in all bundles that offer auto-completion, we must work out "a common workflow for integrating any kind of 3rd party documentation", so that the barrier to add/edit/update documentation is as low as possible. 

Here again (just for quick reference):