近段时间,一直在学习华为C语言编程规范(2011版),在“注释”这一章中发现了一种“Doxygen”的注释转文档工具,查看诸多相关资料,并进行编程实践,终于可以利用Doxygen给C程序生成注释文档.在使用过程中,我已经深深地喜欢Doxygen,并在写代码时使用Javadoc注释风格. 本文由三部分组成:1)工具下载及安装:2)编写Doxygen可识别的注释:3)利用Doxygen工具将注释转换成API文档. 1.工具下载及安装 (1)Doxygen可以从一套源文件开始,生成HTML格式的在线类

一.摘要 在本系列的第一篇文章介绍了.NET中XML注释的用途, 本篇文章将讲解如何使用XML注释生成与MSDN一样的帮助文件.主要介绍NDoc的继承者:SandCastle. .SandCastle简介 在上一篇文章中的帮助文件截图都是使用SandCastle生成的,比如下面的截图: SandCastle是一个微软发布的工具,它通过反射程序集中的源代码以及添加代码中的XML注释来创建MSDN形式的API文档. 这个工具的源代码可以在CodePlex中以微软公开许可协议(Microsoft Pu

问题描述 为了在oracle中新增表,在PDM中建表,使用其生成的sql语句,但是建表不能成功,提示 ORA-00906: 缺失左括号 原因是多了clustered 关键字 情景重现 1. 新建一个pdm文件 2. 建表后预览sql 是有clustered 这个关键字的 3. 建表时报错 问题解决 调查发现数据库的问题,右键数据库属性 查看DBMS 发现是 SQL SERVER ! 解决办法就是切换DBMS: 点击确定 再次查看sql语句,一切正常.问题最终解决.

C++注释 C++的注释只有两种: 单行注释,以“//”开头: 段落注释,以“/*”开始,以“*/”结束. int value; // value是一个整型变量,这是一句单行注释 /* Test是一个测试用的类 这是一段注释中的一行 这是一段注释中的另一行 */ class Test { }; doxygen注释:记住下面3点语法规则就够了 参照上文C++注释的分类方式,doxygen注释可以这样划分: 前置单行注释,以“///”开头: 后置单行注释,以“///<”开头,紧跟代码后面: 段落注释

背景 这一块的内容更多的是作为了解,但是可以以这样的规范作为自己的编程注释习惯,提高自己的软实力. Doxygen注释语法 注释格式 块注释建议统一使用 /** -- ***/ 行注释建议统一使用 ///< - /** -- */ Doxygen常用注释命令 @exception <exception-object> {exception description} 对一个异常对象进行注释. @warning {warning message } 一些需要注意的事情 @todo { thi

日常我们在阅读一些PDF文章时候,我们会发现有些PDF文章带有非常多的注释,显得非常不美观,影响了阅读体验.那么PDF文章里的批注应该怎么进行删除呢?怎样批量删除PDF文件中的注释?   操作教程: 1．首先我们点击安装在电脑上的PDF编辑器,运行程序,我在看见软件界面之后,我们点击软件界面的“打开”选项.添加并打开我们需要进行编辑的PDF文件.   2．PDF文件打开以后,在软件的工具栏里找到“注释”按钮,单击按钮,会弹出一个下拉框,然后选择“显示注释列表”功能,即可进行批量删除注释操作.  

1.使用java代码动态配置与xml文件结合的方式使用mybatis-generator生成代码配置 2.上代码:在resources目录下新建:generatorConfiguration.xml文件 <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE generatorConfiguration PUBLIC "-//mybatis.org//DTD MyBatis Generator C

导语 作者李志宇,腾讯云后台开发工程师,日常负责集群节点和运行时相关的工作,熟悉 containerd.docker.runc 等运行时组件.近期在为某位客户提供技术支持过程中,遇到了 containerd 镜像丢失文件问题,经过一系列分析.推断.复现.排查,最终成功找到根因并给出解决方案.现将整个详细处理过程整理成文分享出来,希望能够为大家提供一个有价值的问题处理思路以及帮助大家更好地理解相关原理. containerd 镜像丢失文件问题说明 近期有客户反映某些容器镜像出现了文件丢失的奇怪现象

https://blog.csdn.net/weixin_40539125/article/details/81430801 打开VS2015 ,新建VS win32工程,前面步骤很简单,不再阐述 下面直接开始: 新建一个VC++ win32的程序, 在源文件加下添加.cpp文件,一般放main函数   #include <iostream>   #include <locale>   #include "human.h"   using namespace s

今天在做mybatis项目的时候,给映射文件添加了中文注释后,程序就报错.把中文注释删除后,程序又可以正常执行.解决方法在下文提到. 我的xml映射文件如下: <?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE mapper PUBLIC "-//mybatis.orggetStudent//DTD Config 3.0//EN" "http://mybatis.org/

Android 5.0之后需要AIDL和生成的java文件要分开存放,否则生成can't fin symbol class.但是4.3没有这个限制.被这个弄了一天,跟老大讨论了一下才豁然开朗.

eclipse 代码中文注释乱码 求解决 将别人的项目或JAVA文件导入到自己的Eclipse中时,常常会出现JAVA文件的中文注释变成乱码的情况,主要原因就是别人的IDE编码格式和自己的Eclipse编码格式不同.总结网上的建议和自己的体会,可以参考以下几种解决方式: 1 改变整个文件类型的编码格式 1) eclipse->window->preferences->General->Content Types 2) 找到要修改的文件的类型(JAVA,JSP等等),在下面有个Def

/** * 传入文件数组,压缩文件,在指定路径下生成指定文件名的压缩文件 * * @param files * 文件数组 * @param strZipName * 压缩文件路径及文件名 * @throws IOException */ public static void zipFiles(List

问题:代码写完后,在一台服务器上运行没有问题.换到另外一台服务器上,找不到signalr/hubs,显示404错误. SignalR版本:2.0.3 VS版本:2013 服务器:Windows Server2008 IIS:7.0 解决:把http://stackoverflow.com网站上相关的问题都看了一个遍,各种方法都试了.包括: 1. 在powershell里运行清理 net stop w3svc Remove-Item -Path "C:\Windows\Microsoft.NET\

这是IE6 出现的奇怪现象.这是由于css 和html 的编码不同所引致. 满足下面条件就会引起 注释下面的样式不起作用:1. css有中文注释2. css为ANSI编码3. html为utf-8编码 解决方法:1. 去掉中文注释,用英文注释2. 统一css 和 html 的编码 建议采用第二种解决方法 ps: css为uft-8  html 为ANSI 不会出现失效的情况. 参考文章:冯子胡说 的 http://vontall.blogbus.com/logs/4366443.html 转载请

在每个代码块内,注释的时候,需要使用各自语言的注释语法去注释(HTML.CSS.JavaScript.Jade 等).在文件最顶部注释的时候用HTML的注释语法:<!- 在这里写注释的内容 --> . html 注释: <!-- 注释,单行或多行 --> pug(html) 注释:https://pugjs.org/zh-cn/language/comments.html // 单行注释 //- 不输出的单行注释 div // 块注释,下级的内容都会被注释掉 随便写多少字 都没关系

问题: SharePoint 2013上传AI格式文件,再次下载后变成了PS格式文件 需要下载副本才能显示AI格式 解决办法有两个: 第一种,在客户端机器1. Click Start, click Run, type regedit, and then click OK.  2. Locate and then click the following registry subkey:  HKEY_CLASSES_ROOT\MIME\Database\Content Type\applicatio

前言 学习xss的时候翻阅资料发现了一个文件上传漏洞fuzz字典生成脚本小工具,试了试还不错,分享一下 配置 需要python2环境 工具地址:https://github.com/c0ny1/upload-fuzz-dic-builder 使用方法 $ python upload-fuzz-dic-builder.py -h usage: upload-fuzz-dic-builder [-h] [-n] [-a] [-l] [-m] [--os] [-d] [-o] optional arg

很久之前我在Github上搞了一个LeetCode的仓库,但一直没怎么维护.最近发现自己刷了不少LC的题目了,想搬运到这个仓库上. 玩Github最重要的当然是写README了,MD的逼格决定了项目牛逼不牛逼.但是让我一个一个去手写项目中的链接那是不可能的,这辈子都不可能手写,只有写脚本自动生成才能满足装逼的样子. import os import os.path # 根目录 rootdir="E:/gitTest/LeetCode/" list=[] result=[] # 定义链接

在 http://www.cnblogs.com/heroius/p/8270004.html 中,通过编辑csproj文件可以移除对旧版nuget独立程序的依赖. 实际上,通过编辑项目文件的方式可以解决很多与项目编译相关的问题. 例如,在以前的项目中使用了FxCop的话,会在项目文件中留下匹配当时生成位置的路径信息. 这些信息在卸载了FxCop后依然残留下来,并且(当然)不会随生成位置的改变而改变. 这就导致了原来指定的生成位置已经不再使用,但加载项目时依然会创建文件夹. 例如,原本的生成位置

项目里新建表时model,mapper以及mapper.xml基本都是用Mybatis Generator(以下简称为MBG)自动生成的,但是MBG自动生成的model的注释实在有点非人类,至少中国人是完全接受不了的,在配置中禁用掉注释吧,倒是简单了,可是生成的model类光秃秃的,啥都没有,字段方法没有注释,使用很不方便,别人看也不知道这个字段是啥含义,到最后还是要自己添加,一张表多点几十个字段,特么添加累死了,不能这么干,得想法子,百度了一下网上,基本有两种方法,第一种,就是直接修改MGB的