LabWindows/CVI

取消
显示结果 
搜索替代 
您的意思是: 

Guidelines for LabWindows/CVI programming style to simplify documentation

Has anyone considered how to minimize documentation effort thru various LabWindows/CVI programming style guides plus whatever built-in features are available?  There's the HTML generator with the ///HIFUN and so on, but there must be more to do Doxygen-like documentation without excessive effort.  I'm working thru code I had a student intern develop, and of course I provided no guidance for programming style so am having trouble.  I'd like to work thru the code to revise it for readability and correct some functional problems.  Biggest problem is I'll work LabWindows for a bit, then drop it for months to work some other aspect of a project (embedded system design including circuit board design, analog circuits, microcontroller code, and of course user interface with LabWindows).  When I come back, I need to leave some notes to reduce my time to get up-to-speed again.

 

Thanks!

0 项奖励
1 条消息(共 4 条)
4,320 次查看

Hello Mike,

 

Your feedback and suggestions are always welcome, you can post it here:

 

http://forums.ni.com/t5/ideas/v2/ideaexchangepage/blog-id/cviideas

 

Warm regards

 

Mart G

0 项奖励
2 条消息(共 4 条)
4,290 次查看

I just discovered a Doxygen-like open source project called Natural Docs.  It's very unobtrusive to your existing commenting style.  Very small "footprint" in your code and forgiving of individual style.

 

I have not yet implemented it in my code, but I'm going to give it a whirl.

0 项奖励
3 条消息(共 4 条)
3,810 次查看

I've implemented Natural Docs now.  It's is quite nice in that it's mostly painless.  And your code commenting looks very nice too.

 

My source code

 

2014-09-02 08_56_05-code markup.png

 

 

The HTML output

 

 

2014-09-02 08_56_05 output html.png

 

 

Caveat

 

Unfortunately, Natural Docs doesn't parse through lists like enums.  You have to duplicate the members of a data structure in the comment block to then get the formatted descriptions.  That's disappointing to me.  But I love how low-profile the system is.  Your comments dont' get mangled like they do with Doxygen.

0 项奖励
4 条消息(共 4 条)
3,690 次查看