gaoxuexidan0307的博客

前篇已经说到，使用Matlab的print功能导出模型详细设计，相关的配置。若想生成的详细设计内容完整，格式清晰有条理，就需在模型的注释上下功夫。这次来分享一下在这方面的一些经验。 首先，模型中有很多种注释的方式，当然，不是每一种都能显示在print导出的详细设计中。大家可以自己尝试注释，然后看下在print导出的详设中显示的情况。本文推荐的均为当前我觉得最合适的在详设中看起来最舒服的方式。

同C代码通过工具生成软件详细设计，模型开发也可通过工具导出详细设计。MATLAB有单独用于生成软件详细设计的工具包Simulink Report Generator，奈何暂时买不起，所以自己研究了一下，退而求其次，用matlab的print功能导出详细设计，要求不高勉强够用，本文就介绍了一下print如何导出及报告的内容。

前面已经单独一篇文章讲了，若想通过Doxygen工具生成C代码的软件详细设计文档，需要C代码注释的格式，并推荐了注释规范，以满足Doxygen工具识别格式，且符合ASPICE对详细设计的内容要求，且尽可能使注释内容简洁并生成报告好看。 本文接下来讲，若想通过Doxygen工具生成C代码的软件详细设计文档，需要下载哪些软件，软件包放在资源中需要自取，Doxygen工具该如何配置，若想生成报告成功需要注意什么。配置过程经常会因为一些细节问题导致生成报告出现问题，本文的配置亲测有效。.........

Doxygen工具就提供了一种通过给代码注释的方式，导出详细设计文档，至于导出什么内容，主要取决于注释的内容。当然这里注释的格式是有要求的。 结合Doxygen注释格式的要求，以及ASPICE对详细设计内容的要求，制定此C代码注释规范。.........