[CEDET-devel] C++ Documentation lookup with Semantic

[Alastair R. <ala...@gi...>]

Hi,

I'm trying to use Semantic to get better documentation lookup for C++. For example, let's say I have the following file:

#include <vector>
void foo()
{
    std::vector<char> vec;
    vec.push_back('c');
}

I would like to be able to put my cursor on the vector<char> type declaration, OR on the push_back method and invoke a function which would open reference documentation for either that type or that method.

By reference documentation, I mean some form of web-based resource which I can associate with the namespace of the type in question. So for example, I might want to refer to http://cppreference.com for any types in the "std" namespace. 

The semantic-ia-get-doc method works fine, but for C++ it generally relies on snarfing documentation out of source comments. Unfortunately many standard library implementations (including libstdc++) have fairly limited comments. The web-based documentation is generally the best resource in these cases.

So my initial attempt is here:

https://gist.github.com/randomphrase/9177867

This defines the semantic-browse-c++-doc function which you can bind to whatever key. I have mine bound to C-c Q, because it complements semantic-ia-get-doc which is bound to C-c q.

Comments welcome.