Skip to main content

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index] [List Home]
Re: [cdt-dev] Doxygen

Would it actually do anything when you do the Format command? If not, I think maybe C/C++->Editor > Doxygen might be OK or maybe C/C++ > Code Style > Doxygen

Then Code Style should also be configurable per project, but that’s another issue…

Cheers,
Marc-André

> On Jan 6, 2020, at 5:58 AM, marco <marco.stornelli@xxxxxxxxx> wrote:
> 
> Hi all,
> 
> I'm working on improvement of Doxygen support in CDT. We need to add new options in order to let the user fine tune the behavior. At the moment I could see four or five options like:
> 
> 1) Use structured commands, @class, @struct and so on;
> 2) Use javadoc style for tags '@' instead of '\'
> 3) Use different style for enums like //< or /**< and so on
> 4) Use always @brief or not
> 5) If brief is enabled, an option for a new line or not after for detailed description
> 
> The question: where should we add these options? The only option we have now is under C/C++->Editor where the user can  switch the doc owner for project/workspace. Maybe a new page C/C++->Doxygen?? Or maybe adding the options under the comment section of formatter? In JDT Javadoc options are there but Java and C/C++ are quite different because Javadoc is built-in, Doxygen is an external tool not strict related with C/C++.
> If we not add the options to the formatter (where I'm more familiar with), is there any common framework to manage options in CDT about load/save? I was looking at DocCommentOwnerManager but I don't know if the right class.
> Any hint is welcome.
> 
> Regards.
> _______________________________________________
> cdt-dev mailing list
> cdt-dev@xxxxxxxxxxx
> To change your delivery options, retrieve your password, or unsubscribe from this list, visit
> https://www.eclipse.org/mailman/listinfo/cdt-dev



Back to the top