程序源代码中的注释经常是一个卧虎藏龙的地方,有人就很喜欢写幽默搞笑的注释内容.解释代码含义的同时,也带给人轻松神经的机会,确实是很有意思的风格,来看看这一辑国外某公司产品中的注释. 注意:看的时候严禁喝水或进食. 1.亲爱的代码维护人员: 当您尝试优化这段代码但发现这是一个极端错误的决定的时候,请修改下面的计时器,以便警示后人. 总计浪费在这段代码的时间 = 16 小时 2.真的很有问题 3.谨以此代码献给我的妻子达琳,感谢她一直支持我,还有我三个孩子和一只狗. 4.神奇代码,请勿改动 5.喝醉…

转载http://www.cnblogs.com/holten/p/5729226.html Lombok介绍及使用方法 lombok简介 lombok是暑假来到公司实习的时候发现的一个非常好用的小工具,刚见到的时候就感觉非常惊艳,有一种相见恨晚的感觉,用了一段时间之后感觉的确挺不错,所以特此来推荐一下. lombok的官方地址:https://projectlombok.org/ lombok的Github地址:https://github.com/rzwitserloot/lombok 那么…

http://blog.xcodev.com/blog/2013/11/01/code-comment-and-doc-gen-tools-for-objc/ 代码注释可以让代码更容易接受和使用,特别是在大型项目合作开发或模块开发中.Objective-C中也有一些很方便的注释插件和文档生成工具.本文推荐两个开源软件:VVDocumenter注释工具和appledoc文档生成工具. VVDocumenter 首先推荐一个Xcode插件VVDocumenter,它可以让我们在代码中快捷的插入通用的…

有时为了信息保密或是单纯阅读代码,我们常常需要删除注释. 之前考虑过正则表达式,但是感觉实现起来相当麻烦.而状态机可以把多种情况归为一类状态再行分解,大大简化问题.本文就是基于状态机实现的. 删除C/C++代码注释 需要考虑的情况 // /* */ //和/* */嵌套(注意不存在/* */和/* */嵌套) 折行注释(用\间隔) 字符中存在的/和* 字符串中存在的//和/* */ 字符串中的折行代码(用\间隔) 头文件中可能存在的/ 状态转移描述 这里的内容参考了博客http://www.cn…

一.用户输入 若你安装的是Python3.x版本,当你在Python IDLE(编辑器) 中输入以下代码: name = input('用户名:') print('Hello',name) 保存并执行后你会发现程序在等待你输入,只有你输入了信息,程序才会继续执行打印. 若你安装的是Python2.x版本,那你在Python IDLE(编辑器) 中应输入以下代码: name = raw_input('用户名:') print 'Hello',name 注意:不管是 Python2.x 还是 Pyt…

在编写代码时,确保您的代码易于被其他人理解时很重要的,给变量,函数起合适的名字以及合理的组织代码都是很好的方法. 使用代码注释时增加代码可读性的另一种方便简单且重要的方法! 1.为什么代码注释如此重要? 2.用Python编写注释的最佳实践 3.希望避免的注释类型 4.如何联系写出更清晰明了的注释 为什么注释代码如此重要 注释是任何程序的一个组成部分,他们可以一注释块的形式或者在代码行中出现,来帮助阐明一个复杂的函数. 在深入研究不同类型的注释之前,让我们仔细看看为什么代码注释如此重要 学会优雅…

原文:http://blog.csdn.net/pleasecallmewhy/article/details/8658795 1 源文件头部注释 列出:版权.作者.编写日期和描述. 每行不要超过80个字符的宽度. 示例: [cpp] view plaincopy /************************************************* Copyright:Call_Me_Why Author:why Date:2010-08-25 Description:Somet…

前言: 一般写完代码之后,还要将各类参数注解写入API文档,方便后续进行对接和测试,这个过程通常都很麻烦,如果有工具可以读取代码注释直接生成API文档的话,那会十分方便. 此前一直都是在使用eolinker的,但自从去年他们家"注释生成文档"的功能下线后,我就一直活在水深火热当中--真的不想写文档啊,真的好累啊. 然而这两天上线后,突然发现这个功能重新上线了!必须给大家安利一波! 官网地址:https://www.eolinker.com 根据官方的解释,这个功能简单来说就是读取 gi…

C# 提供一种机制,使程序员可以使用含有 XML 文本的特殊注释语法为他们的代码编写文档.在源代码文件中,具有某种格式的注释可用于指导某个工具根据这些注释和它们后面的源代码元素生成 XML.使用这类语法的注释称为文档注释 (documentation comment).这些注释后面必须紧跟用户定义类型(如类.委托或接口)或者成员(如字段.事件.属性或方法).XML 生成工具称作文档生成器 (documentation generator).(此生成器可以但不一定必须是 C# 编译器本身.)由文档…

下面是 网友针对“你看到过的最好的代码注释是什么样的?”这个问题给出的回答的前10条: 1. // 亲爱的维护者: // 如果你尝试了对这段程序进行‘优化’, // 并认识到这种企图是大错特错,请增加 // 下面这个计数器的个数,用来对后来人进行警告: // 浪费在这里的总时间 = 39h 2. /** * 致终于来到这里的勇敢的人: 你是被上帝选中的人,英勇的.不辞劳苦的.不眠不修的来修改 我们这最棘手的代码的编程骑士.你,我们的救世主,人中之龙, 我要对你说:永远不要放弃,永远不要对自己失望…