Doxygen使用教程

2 篇文章 0 订阅
1 篇文章 0 订阅
  1. 安装
    sudo apt-get install doxygen doxygen-gui 

  2. 运行

    运行可视化工具

    doxywizard

    加载保存好的配置文件

    doxywizard Doxyfile

  3. 配置
    第一步配置Wizard:
    Project:

    Mode:

    Output
  4. 第二步配置Expert:
    Project:

    Build:

    第三步运行:生成index.html
  5. 注释书写规范
        /** 
         * @file 文件名
         * @brief 简易说明
         * @details 详细说明
         * @author 作者
         * @version 版本
         * @date 日期
         */
    
        /**
         * 我的自订类别详细说明 ...
         */
        class MyClass {
            public:
                int member1 ; ///< 第一个member说明 ...
                int member2:  ///< 第二个member说明 ...
                int member_function(int a, int b);
        };
         
        /**
         * @brief member_function函数简易说明 ...
         * 函数详细说明 ...
         *
         * @param a 参数a的说明
         * @param b 参数b的说明
         *
         * @return 传回a+b。
         */ 
        int MyClass::member_function( int a, int b ) 
        {
            return a+b ;
        }
        

 

 

 

 

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
Doxygen是一款流行的代码文档生成工具,它可以从源代码中自动生成详细和易于阅读的文档。下面是使用Doxygen的简单教程: 1. 安装Doxygen:首先,你需要从Doxygen的官方网站(https://www.doxygen.nl/)下载并安装Doxygen。根据你的操作系统选择合适的版本进行安装。 2. 创建配置文件:在你的项目根目录下创建一个名为`Doxyfile`的配置文件。可以使用以下命令生成默认的配置文件: ``` doxygen -g Doxyfile ``` 3. 配置文件设置:打开`Doxyfile`配置文件,在其中可以修改一些选项以满足你的需求。以下是一些常用的配置选项: - `PROJECT_NAME`:设置项目的名称。 - `INPUT`:指定要生成文档的源代码目录或文件。 - `OUTPUT_DIRECTORY`:指定生成的文档输出目录。 - `EXTRACT_ALL`:设置为`YES`以提取所有文档,包括没有注释的。 - `GENERATE_HTML`:设置为`YES`以生成HTML格式的文档。 - `GENERATE_LATEX`:设置为`YES`以生成LaTeX格式的文档。 4. 生成文档:运行以下命令来生成文档: ``` doxygen Doxyfile ``` 5. 查看文档:完成上述步骤后,Doxygen将会在指定的输出目录中生成文档。你可以在浏览器中打开生成的HTML文件来查看文档。 这只是一个简单的Doxygen教程,Doxygen还提供了更多高级配置选项和功能,如自定义模板、图形化界面等。你可以参考Doxygen的官方文档以获取更详细的信息和进一步的学习资源。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值