Halsafar
Halsafar

Reputation: 2640

Eclipse Auto Generate Doxygen Comments Configuration

It seems Eclipse has Doxygen support somewhat natively now. Go to C/C++ -> Editors -> Documentation Tool Comments: Doxygen.

However it appears to only act on /** */ comments for auto generating.

In our project we use triple slash /// to generate doxygen comments.

It seems there is no way to configure Doxygen comment generation in Eclipse. Any tips? Is there a config file we can alter? Some way to force it.

Upvotes: 5

Views: 9419

Answers (2)

greywolf82
greywolf82

Reputation: 22173

Old question but it's better to add a fresh answer, currently eclipse cdt 9.10 in 2019-12 fully support /// and //! styles, in 2020-03 has been added few options to customize doxygen behavior

Upvotes: 3

Halsafar
Halsafar

Reputation: 2640

Unfortunately as of posting this answer there is no solution. The doxygen comment style is apparently hard coded in Eclipse Juno and previous. You can see a bug report here: https://bugs.eclipse.org/bugs/show_bug.cgi?id=333134

There are workarounds but none support the auto doxygen comments generated in eclipse by merely typing '///[enter]'. See here for some attempts: Change doxygen comment style in Eclipse

A C++ code template is a good attempt but leaves a lot to be desired.

Until this changes this is the accepted answer.

Upvotes: 4

Related Questions