Documentation/Comments 1 Documentation 如果某个函数不是简单地O(1)操作，那么最好就是为该函数添加一些注释文档，这样能有效地提高代码的可读性与可维护性。之前有个非常不错的文档工具VVDocumenter。推荐阅读Apple的官方指南中的描述：described in Apple’s Documentation. Guidelines: 1.1 每行不应超过1

tomcat报如下错误： Cause: com.ibatis.common.xml.NodeletException: Error parsing XML.   Cause: java.lang.RuntimeException: Error parsing XPath '/sqlMapConfig/sqlMap'.   Cause: com.ibatis.common.xml.NodeletEx

在使用mybatis-generator 生成代码时，配置文件中有中文注释，会报错XML Parser Error on line 11: The string "--" is not permitted within comments.，去掉中文注释和英文注释，可以顺利执行，后来发现是因为注释内容紧挨着注释的符号，如<!--这是注释-->。 解决方法： 在注释内容和注释标签中间加上空格。 <!-

最近使用了DNN的Repository模块,在文档中有写到 "Administrators will see pencil icons to the left of each user comment. Clicking on the pencil next to a particular comment will allow you to edit or delete the comment."