MakeDoxygen

作者: 吴梦龙

1 什么是MakeDoxygen

首先它是个linux工程 Makefile模板 ，其次它也像是字符界面的IDE，它不主动创造轮子，除非世界上本没有合适的轮子，它的“代码风格审查”特性就是个使用现有轮子的实例，风格支持Linux Kernel标准、Google标准。

与普遍的linux开源工程不一样的是，它只拥有一个Makefile来构建，而无需在各个子目录下散落Makefile。如果你实在想保留金典的散落Makefile风格，MakeDoxygen也可以满足你，这两篇文章会给你启示

2 怎样用到你的工程

在决定使用MakeDoxygen前，先验证你的环境是否符合《环境验证》

了解MakeDoxygen工作方式《MakeDoxygen结构》

快速入门《3min搭建Hello World》

最后看看MakeDoxygen可以干些什么《Makefile都有些什么》

3 以下情况你可以考虑选择MakeDoxygen

3.1 管理多子工程

教程《listprj.mk多工程列表》
教程《common.mk子工程公共配置》
教程《project.mk 子工程特有配置》
教程《filelist.mk 文件树》

$ make lp
        pi1=script/default
                pi1_arg=elf
        pi2=script/prj_liba
                pi2_arg=mlib
        pi3=script/prj_libb
                pi3_arg=mlib
        pi4=script/prj_qt
                pi4_arg=elf
        pi5=script/prj_cpp_c
                pi5_arg=elf
        pi6=script/prj_moc
                pi6_arg=elf
        pi7=script/prj_printl
                pi7_arg=elf

3.2 快速配置程序特性

教程

图像化配置程序各种版本特性（调试版本、功能特性、发布版本）

3.3 编译过程高亮

3.4 警告、错误高亮

教程

3.5 版本控制信息

教程

用户反馈产品有缺陷，对于数周发布一新版本的产品线，我怎么知道用户当前使用的是哪个版本，每个应用程序都有编号，编号与版本控制对应

3.6 预编译机制

教程

提高代码再次编译速度，缩短头文件包含依赖

3.7 多类型输出文件

教程

root@UbuntuServer:MakeDoxygen → develop
$ ls release-x86/
default.elf  
root@UbuntuServer:MakeDoxygen → develop
$ ls lib-x86/
libla.a  libla.so
root@UbuntuServer:MakeDoxygen → develop

3.8 代码风格审查

教程

 1 /**
 2  * Copyright 2015-2017 MenglongWoo@aliyun.com
 3  * @file  src/smain.c
 4  * @brief  example for MakeDoxygen
 5 */
 6 
 7 void fun(void)
 8 {
 9   int a=1;
10   int *p = (int *)&a;
11 }
12

支持 Linux Kernel 代码风格审查