`
我改名了
  • 浏览: 90008 次
  • 性别: Icon_minigender_1
  • 来自: 济南
社区版块
存档分类
最新评论

代码中特殊的注释技术

 
阅读更多

代码中特殊的注释技术——TODO、FIXME和XXX的用处

本博客网址:http://blog.csdn.net/reille/,转载本博客原创文章请注明出处。

本文内容概要: 代码中特殊的注释技术——TODO、FIXME和XXX的用处。

 

前言:
今天在阅读Qt  Creator的源代码时,发现一些注释中有FIXME英文单词,用英文词典居然查不到其意义!
实际上,在阅读一些开源代码时,我们常会碰到诸如:TODO、FIXME和XXX的单词,它们是有其特殊含义的。、

TODO: + 说明
如果代码中有该标识,说明在标识处有功能代码待编写,待实现的功能在说明中会简略说明。

FIXME: + 说明
如果代码中有该标识,说明识处代码需要修正,甚至代码是错误的,不能工作,需要修复,如何修正会在说明中简略说明。

XXX: + 说明
如果代码中有该标识,说明识处代码虽然实现了功能,但是实现的方法有待商榷,希望将来能改进,要改进的地方会在说明中简略说明。

eclipse中特殊的注释:
在eclipse中,TODO、FIXME和XXX都会被eclipse的task视图所收集。在项目发布前,检查一下task视图是一个很好的习惯。此外,在eclipse中,我们可自定义自己的特殊注释标签。如在C/C++中,进入window—>preferences—>C/C++—>Task Tags窗口即可添加特殊标签,默认只有TODO、FIXME和XXX。

分享到:
评论

相关推荐

    删除代码中的注释

    在编程世界中,注释是源代码的重要组成部分,它们用于解释代码的功能,帮助开发者理解和维护程序。然而,在某些情况下,如构建最小化可部署的代码或优化代码性能时,可能会有需求移除代码中的注释。这个过程被称为...

    去除注释 去注释

    本篇文章将详细探讨如何去除C++代码中的单行注释(//注释)和多行注释(/**/注释),以及可能涉及到的相关技术。 首先,我们要理解C++中的注释结构。单行注释以`//`开始,直到行尾结束;而多行注释则以`/*`开始,`*...

    删除源代码注释

    本主题将深入探讨如何批量删除C/C++源代码中的注释,以及涉及到的相关技术。 首先,我们需要了解C/C++语言中的注释类型。主要有两种: 1. 单行注释:以`//`开始,到行尾结束。例如: ```cpp // 这是一个单行注释...

    代码注释生成器.rar

    在当今的软件开发中,代码注释的重要性不言而喻。它不仅有助于提升代码的可读性,还能够在团队协作和长期维护中发挥关键作用。然而,手写注释的过程往往耗时且枯燥,这便是“代码注释生成器”出现的原因。这款工具的...

    C语言代码注释专用版 py

    在C语言中,通常使用"// "来进行单行注释,但在一些特殊情况下,比如想要提高代码的可读性或为了兼容其他语言的注释风格,可能会需要将这种单行注释替换为C语言标准的多行注释形式 "/**/”。由于手动替换大量文件中...

    STM32 启动代码注释分析

    ### STM32启动代码注释分析 #### 一、引言 在嵌入式系统开发过程中,理解微控制器(如STM32)的启动过程至关重要。本文将详细解析STM32启动代码的主要部分,帮助读者深入理解STM32启动机制。 #### 二、STM32启动...

    C#开发注释规

    C#编程语言在开发过程中,良好的注释习惯是确保代码可读性、可维护性和团队协作效率的关键。本文档旨在定义一套完整的C#开发注释规范,涵盖注释的内容、格式以及适用场景,帮助开发者遵循统一的标准,提升代码质量。...

    怎么在.js文件里写中文注释

    1. **避免中文标点符号**:尽管在注释中使用中文标点符号在技术上是可行的,但由于不同环境对中文标点的支持程度不一,建议使用英文标点符号以确保兼容性。 2. **代码风格指南**:对于团队项目而言,最好制定一套...

    Linux源代码注释

    ### Linux源代码注释——操作系统基础与进程管理 #### 操作系统存在基础 在深入了解Linux源代码之前,我们首先需要明确一点:操作系统之所以存在,是因为它解决了计算机硬件资源的管理和调度问题,使得用户可以...

    FPGA PCI代码模块详解:完整实现与详尽注释,FPGA pci代码,模块完整,注释完整 ,FPGA; PCI代码; 模块完整; 注释完整;,"FPGA PCI代码全集:模块完备,详尽注释的编程宝

    这套文档被封装在一个压缩包中,包含了一系列文件,这些文件不仅包括了详细代码模块和完整的注释,还配有一系列相关的图片和文本描述。 首先,FPGA是一种特殊的半导体装置,它可以通过编程来配置其逻辑功能,适用于...

    C注释&标签规则.pdf

    - OCR 技术在文档识别过程中可能出现字识别错误或遗漏,编译者需具备一定的理解能力,确保生成的注释内容准确无误。 ### 总结 在 C 语言开发中,遵循注释和标签规则对于创建易于理解和维护的代码至关重要。...

    javadoc 生成注释 和 检查注释的文档

    在Java源代码中,JavaDoc注释以`/**`开头,`*/`结尾,位于你想要为其生成文档的元素之前。例如,对于一个类: ```java /** * 这是一个简单的示例类,用于展示JavaDoc的使用。 */ public class SimpleExample { /...

    SpringBoot源码分析--项目里有超详细的中文代码注释,中文注释会随着每篇Spri

    中文代码注释则更加方便了中文母语者或汉语学习者的学习和理解。 在进行SpringBoot源码分析时,通常会从SpringBoot的核心功能开始,比如自动配置、SpringBoot应用入口、SpringBoot启动流程、配置文件的读取、内嵌...

    注释转换机

    在编程世界中,注释是源代码中不可或缺的一部分,它为其他开发者提供了理解代码功能和逻辑的线索。C++和C语言虽然有许多相似之处,但它们的注释风格却有所不同。C++支持单行和多行注释,而C语言只支持单行注释(始于...

    java文档注释要求

    在软件开发领域,编写高质量的代码不仅是技术实力的体现,更是职业素养的重要标志之一。其中,文档注释(JavaDoc Comments)作为源代码的一部分,对于提升项目的可维护性和可读性具有不可忽视的作用。本文将详细介绍...

    Java写的双色球选号+银行密码产生源代码 详细注释

    在源代码中,详细注释是非常重要的,它可以帮助读者理解每一部分代码的功能和工作原理。对于初学者,阅读并理解注释可以帮助他们更快地掌握编程概念和技术。在Java中,注释可以使用`//`单行注释或`/* */`多行注释来...

    "DT决策树回归预测MATLAB代码详解:Excel数据读取与简洁上手指南",DT决策树回归预测MATLAB代码 代码注释清楚 可以读取本地EXCEL数据 很方便,初学者容易上手 温馨提示

    代码中的注释部分会详细解释每一步的作用和实现方式,以便初学者可以跟随注释逐步理解和掌握代码的运行机制。通过这样的代码示例,初学者可以更容易地了解决策树模型的工作原理和应用过程,以及如何在MATLAB中进行...

    基于MATLAB的LSTM文本分类代码(100%可用含中文注释)

    LSTM是一种特殊的循环神经网络(RNN),它解决了传统RNN在网络训练过程中可能出现的梯度消失或梯度爆炸问题。LSTM通过引入门控机制(输入门、遗忘门和输出门)来控制信息的流动,从而能够记住长期依赖关系,这使得...

    "分布式自适应滤波器仿真研究:基于D-LMS算法的实现与Matlab代码注释",分布式自适应滤波器的仿真,D-LMS,保证可以使用 .有自己写的注释,ATC和CTA版本都有. Matlab代码,简单易

    Matlab代码中包含的注释对于理解算法的实现细节至关重要,特别是对于复杂的分布式自适应滤波器。注释有助于代码的维护和后续的研究者理解算法的逻辑,也便于初学者学习和入门。 此外,提到的ATC(Algorithm to Code...

    C语言注释删除

    在提供的压缩包文件中,"注释"可能是实现这一功能的源代码文件,通过阅读和分析这部分代码,可以进一步了解如何运用编译原理和C语言技术来实现注释删除的功能。对于初学者,这是一个很好的实践机会,不仅可以加深对...

Global site tag (gtag.js) - Google Analytics