Whole Tomato Software Forums
Whole Tomato Software Forums
Main Site | Profile | Register | Active Topics | Members | Search | FAQ
 All Forums
 Visual Assist
 Technical Support
 Document method

You must be registered to post a reply.
Click here to register.

Screensize:
UserName:
Password:
Format: BoldItalicizeUnderlineStrikethrough Align leftCenterAlign right Insert horizontal ruleUpload and insert imageInsert hyperlinkInsert email addressInsert codeInsert quoted textInsert listInsert Emoji
   
Message:

Forum code is on.
Html is off.

 
Check to subscribe to this topic.
   

T O P I C    R E V I E W
mmerkel Posted - May 29 2019 : 04:45:45 AM
Please excuse if this had been discussed earlier, but I'm pretty new to Visual Assist.
I'm looking for a way to generate Doxygen enabled function headers for C source code using 'Quick Actions and Refactoring (VA) -> Document Method' from the context menu when right-clicking on a function prototype. This is nice as is looks though all the function parameters and adds them to the header as \param directives. For \param I also can add the optional attributes [in], [out], etc. that are quite useful for API documentation. Is there any way that I could annotate my C code such that Visual Assist would extract those annotations during method documentation to generate the corresponding Doxygen directives? I�m aware of SAL however despite working from within Visual Studio, I use a makefile project and a GNU ARM compiler that does not seem to be aware of sal.h.
2   L A T E S T    R E P L I E S    (Newest First)
mmerkel Posted - Jun 03 2019 : 02:46:34 AM
Ok, thanks, than we have to live with adding those attributes manually for now.
feline Posted - May 29 2019 : 2:00:55 PM
If I understand correctly then no, this is not an ability VA has.

We are considering allowing Document Method to separate out the SAL information for each parameter, if present, but this has not yet been done:

case=84805

We don't look for any other information like this either.

© 2023 Whole Tomato Software, LLC Go To Top Of Page
Snitz Forums 2000