Doxygen基础篇(四)——增加宏定义
Doxygen基础篇(四)——增加宏定义前言: c/c++这样带宏定义的编程语言经常会用到预编译宏,部分代码是由宏控制的可选代码,但要让Doxygen正确处理这些代码可能需要手动添加宏定义。 1 代码被Doxygen忽视 预编译宏中的代码可能被Doxygen忽视,生成的文档中不含有这部分代码的说明。如果一段代码被预编译宏控制为可选代码,预编译宏在其他文件甚至编译器的配置中定义,那么Doxygen不能解析到该宏定义,导致不能生成这段代码的文档说明,解决办法需要手动在Doxygen中添加相关的宏定义。 2 添加宏定义 &emps;打开Doxygen向导,找到关于预定义宏的设置项。 Expert -> Topics -> Preprocessor -> PREDEFINED 。在该项中添加需要的宏设置。 当定义的宏带值时,使用 = 进行赋值,但等号前后不能加空格,否则无法识别。例如: SWITCH=1
Doxygen基础篇(三)——增加导航窗口
Doxygen基础篇(三)——增加导航窗口前言: 为了更方便查看,Doxygen生成的HTML文档可以增加导航栏显示。 1 导航栏配置 打开Doxygen向导,选择 Wizard -> Topics -> Output ,勾选 with navigation panel 选项,该选项表示生成带有导航窗口的文档。 重新生成文档,效果如下。
Python3进阶篇(四)——log日志模块
Python3进阶篇(四)——log日志模块前言: 软件调试的一大利器就是输出日志,多年前看到大佬调试软件,终端密密麻麻输出五颜六色的日志就觉得很高大上,羡慕不已。这篇文章带你学会使用python的日志模块。 1 日志等级 python自带日志模块 logging ,通过在代码中添加 import logging 使用日志模块。该日志模块支持按不同等级输出日志。以下代码为logging的5种日志等级输出。 1234567import logginglogging.debug("debug")logging.info("info")logging.warning("warning")logging.error("error")logging.critical("critical") 可以发现 DEBUG 和 INFO 两个等级的日志信息没有输出,这是因为logging模块默认只输出 WARNING...
Git基础篇(十九)——修改分支名
Git基础篇(十九)——修改分支名前言: 有时候需要想要修改Git已创建分支的分支名,这篇文章介绍修改分支名的方法。 1 修改本地分支名 在Git bash中执行以下指令修改分支名。 1git branch -m <OldBranchName> <NewBranchName> 2 将远程分支删除 如果在本地删除的分支也存在于远程服务器,如果要将远程的该分支删除可执行以下指令。 1git push origin --delete <OldBranchName> 该指令之际是将对已删除分支的操作推送到远程服务器。 3 将新名称的分支推送到远程服务器 分支名被修改后,远程服务器还不知道新的分支名,需要将新的分支名推送到远程服务器。 1git push --set-upstream origin <NewBranchName>
Git基础篇(十八)——给分支添加说明
Git基础篇(十八)——给分支添加说明前言: Git的一大有势是分支开发,当分支太多时光靠分支名已经难以记忆每个分支创建时的意图,为了解决此问题Git支持给分支添加说明。 1 给分支添加描述1.1 给当前分支添加描述 执行以下指令给当前分支添加描述信息。 1git branch --edit-description 执行该指令后,将在进入编辑模式(默认是Vim模式)编辑描述信息。 1.2 给指定分支添加描述信息&emps; 可通过指定分支名的方式给特定分支添加描述信息,描述信息写在双引号内。 1git config branch.<BranchName>.description "<Description>" <BranchName> 为指定的分支名, <Description> 为描述信息。 也可以执行以下指令在编辑模式中给指定分支添加描述信息。 1git branch...
Git终端显示中文乱码问题
Git终端显示中文乱码问题前言: Git终端安装好后显示中文时遇到乱码问题,本篇文章为解决此问题。 1 Git终端显示中文乱码 在Git bash中显示中文乱码,效果如下, 2 解决乱码 打开Git bash终端,在界面中点击鼠标右键弹出菜单,点击 Options 选项,选择 Text ,设置 Locale选项为 zh_CN ,设置 Character set 选项为 UTF-8 ,之后点击 Save 保存。 中文路径或中文文件名也会显示乱码,在Git bash中输入以下指令配置。 1git config --global core.quotepath false
主动笔自适应屏信号周期
主动笔自适应屏信号周期前言: 不同的屏或不同的屏厂生产的屏,其屏信号周期会有一些偏差或不同。当屏与笔的周期不同步时,可能会导致通讯异常最终在书写体验上表现为断线甚至无法书写。本篇文章致力于讨论解决屏笔周期同步的问题。 1...
兼顾动静特性的ADC采样滤波
兼顾动静特性的ADC采样滤波前言: 嵌入式开发中ADC是十分常用的外设,常见运用比如电量检测、温度检测、压力检测等。ADC采样易收到较多干扰导致采样不准,比如ADC时钟不准、参考电压不准、被测电压存在漂移等,这时候可通过软件算法滤波,降低噪声干扰。 1...
Doxygen基础篇(二)——配置Doxygen
Doxygen基础篇(二)——配置Doxygen前言: 在Windows上可以方便的通过GUI配置Doxygen,按照配置生成代码帮助手册。 1 配置Wizard1.1 配置Project 打开 Doxygen GUI frontend ,选择 Wizard 标签页下 Project 选项进行该页面的配置,该选项下是关于项目的一些基础设置。 Specify the working directory from which doxygen will run: 为安装的Doxygen的工作目录,路径要选到安装目录下的bin目录; Project name: 该项目的名称; Project synopsis: 该项目的项目简介; Project version or id: 项目版本或id; Project logo: 选择项目的logo图标,文件为图片格式; Source code directory: 工程源代码的目录,需要被提取注释生成文档的代码应该在此目录下; Scan recursively:...
Doxygen基础篇(一)——安装Doxygen
Doxygen基础篇(一)——安装Doxygen前言: Doxygen可以像JavaDoc那样提取代码中的注释生成文档手册,它不仅是一种文档生成工具,更是一种注释的规范,要写出规范的代码掌握Doxygen是必要的。 1 Doxygen简介 Doxygen 是一种开源跨平台的代码文档生成工具。Doxygen可将按照其规定格式编辑的注释信息提取转换生成方便阅读的说明文档,文档格式有LATEX、RTF等,支持C, Objective-C, C#, PHP, Java, Python等语言。 2 安装Doxygen2.1 Windows下安装Doxygen Windows下载官网找到exe文件下载安装,它捆绑了32位和64位版本,根据操作系统自动选择合适的版本安装。里面包含了手册和GUI。 在点击 I accept the agreement 然后点击 Next...









