Eclipse 中的 C++ 代码浏览器

Question

我在使用 C++ 编程时使用 Eclipse Indigo。我正在使用提供大量 doxygen 注释的代码。我希望能够在 eclipse 中看到它们，而不必使用外部浏览器。我认为对应的 javadoc 是 shift+F2，但它不适用于 c++ doxygen。

换句话说，当我的鼠标悬停在一个类的方法上时，工具提示提供函数的实现(在.cpp 中找到)，而不是它的声明和与之相关的注释(在.cpp 中找到)在 .h) 中。我希望在我的工具提示中看到后者。

是否有针对 C++ 用户的解决方案？

谢谢

Answer 1

不幸的是，这不可能，而且我怀疑将来是否有可能。要详细解释，请进一步阅读。
在 C++ 中，您可以通过两种方式编写函数。

1. 直接定义函数(可以是extern、inline或static)
2. 在标题中声明函数，然后在中定义函数实现文件

现在 Eclipse 始终选择实现，原因是一致性。在 C++ 中(与 Java 不同)，您可以在多个头文件中对一个函数进行多次前向声明，但定义始终为 1 (ODR)。
如果你把函数放在鼠标下，那么选择哪个声明？所以最好选择一个定义。虽然在类方法的情况下可能不会出现此问题。

回到你的问题:

the tool tip provides the implementation of the function, instead of its declaration and the comments associated with it

最好的方法是在函数的实现中嵌入注释。换句话说，从下面选择 style-2:

样式-1

class A {
 ...
public:
  /*
   * description of the function
   */
  void foo ();
};
void A::foo ()
{
...
}

风格2

class A {
 ...
public:
  void foo ();
};

/*
 * description of the function
 */
void A::foo ()
{
...
}

解决方法:按两次 F3 键，它将引导您通过定义进行声明。