Программирование в VS 2013 C ++ и наших стандартах doc требует XML-документации, отчасти поэтому комментарии появляются в IntelliSense. Моя проблема в том, что IntelliSense не наследует документацию от базовых классов, поэтому, если у меня есть что-то вроде этого:
class Base {
public:
Base() {}
/// <summary> Really detailed and insightful comments </summary>
virtual void method() = 0;
};
class Derived : public Base {
Derived() {}
void method() override {}
}
Typing
Base b;
b.method(); <- Gives nice IntelliSense tips
Derived d;
d.method(); <- Just shows +1 Override
Я мог бы скопировать и вставить комментарии, но на самом деле не хочу нарушать принцип СУХОГО. У меня есть поиск, а ReFactor и другие инструменты могут помочь синхронизировать комментарии, но наша компания скромна, поэтому на данный момент не вариант. Любой из коробки или бесплатно
предложения? Моя мысль состоит в том, чтобы добавить строку
/// <summary> see base class for documentation </summary>
выше переопределенные методы, но предпочли бы что-то, что показало бы подсказки IntelliSense в базовом классе.
Задача ещё не решена.
Других решений пока нет …