comments相关内容

将python源代码转换为带有完整注释的AST的简单方法

我已经对如何在保留注释的情况下捕获 python AST 进行了大量搜索.建议的方法包括使用 ast 和 tokenize 库来完成工作. 我在按照我的要求使用这些库方面取得了相当大的成功,但我觉得必须有更好的方法. 这个想法源于lib2to3 将python2代码转换为python3代码并带有注释保存.此外,该过程被称为 Source-Code-in-Python2 -> AST - ..
发布时间:2021-11-26 17:47:38 Python

是否“/*(非 javadoc)"有一个很好理解的意思吗?

/* (non-javadoc) 除了向源代码的读者指出注释块故意不是 Javadoc 注释之外,是否还有意义?最近我看到很多这样的代码: /**(非javadoc)** 此方法将小部件转换为小玩意*/公共 Foo bar() {... 这是某种既定的惯例吗?如果是,它是什么意思(超出明显的字面意思)以及何时使用? 解决方案 根据 我能找到的信息,这是为了修复旧版本的 JavaDoc ..
发布时间:2021-11-22 17:08:40 Java Web开发

是否应该将 Javadoc 注释添加到实现中?

在界面中添加Javadoc注释并在实现中添加非Javadoc注释是否正确做法? 当您自动生成注释时,大多数 IDE 会为实现生成非 JavaDoc 注释.具体方法不应该有说明吗? 解决方案 对于仅用于实现(而不是覆盖)的方法,当然,为什么不呢,尤其是如果它们是公共的. 如果您有一个压倒一切的情况并且您要复制任何文本,那么绝对不会.复制是导致差异的万无一失的方式.因此,用户会根据 ..
发布时间:2021-11-22 17:04:53 Java Web开发

简单的 Getter/Setter 注释

您使用什么约定来评论 getter 和 setter?这是我想了很长时间的事情,例如: /*** (1a) 你在这里放了什么?* @param 薪水 (1b) 你把什么放在这里?*/public void setSalary(浮动工资);/** (2a) 你在这里放了什么?* @return (2b)*/公共浮动 getSalary(); 我总是发现我为 1a/b 和 2a/b 编写了完全相同 ..
发布时间:2021-11-22 17:03:45 Java Web开发

如何引用“*/"在 JavaDocs 中

我需要在我的 JavaDoc 注释中包含 */.问题是这也是关闭评论的相同顺序.引用/转义这个的正确方法是什么? 示例: /*** 如果指定的字符串包含“*/",则返回 true.*/public boolean containsSpecialSequence(String str) 跟进:看来我可以使用 / 作为斜线.唯一的缺点是,直接在文本编辑器中查看代码时,这并不是那么易读 ..
发布时间:2021-11-22 17:00:51 Java Web开发

Java 注释中的/** 和/*

和 有什么区别 /*** 评论***/ 和 /*** 评论**/ 在Java中?我应该什么时候使用它们? 解决方案 第一种形式称为 Javadoc.当您为您的代码编写正式的 API 时,您可以使用它,这些 API 是由 javadoc 工具生成的.例如,Java 7 API 页面使用 Javadoc 并由该工具生成. 您会在 Javadoc 中看到的一些常见元素包括: ..
发布时间:2021-11-22 17:00:34 Java Web开发

如何更改在 Kotlin 上生成的函数 TODO() 的主体?

我需要在我的代码上留下一些事情要做,并且 TODO() 自动生成会产生一个很长的评论,如 follow TODO("not implementation")//改变创建的函数体使用 File |设置 |文件模板. 上面一行告诉我去File ->设置 ->File Template 来改变它,但这个选项不存在于 TODO() 函数.如何解决? 解决方案 转到 Android Studio ..
发布时间:2021-11-21 21:11:57 Android

如何从 Android Studio 中的特定文件中删除所有评论?

我的项目中有一些大文件,其中注释了很多行. 通常,当我更改代码中的某些内容时,我会先注释不必要的行,然后在测试后将其删除. 但是有时候最后一个大文件里的注释太多了,很难去掉. 因此,Android Studio 中可能有一些功能可以从注释中“清理"文件(当然不包括 javadoc 注释),例如“组织导入"以删除文件中未使用的导入. 或者,也许是某种突出显示的注释行,以便我可以轻松查看要 ..
发布时间:2021-11-21 20:29:40 Android

在 Aptana Studio 3.0 中查找快捷方式来注释代码

我在 Aptana Studio 3.0 中找不到任何注释我的代码的快捷方式.我需要快捷方式来评论单行和评论选定的代码块. 有些人告诉我尝试在我的 Windows 操作系统上使用快捷方式 WIN +/ 进行评论,但这似乎不可行. 解决方案 这取决于您使用哪种语言编写(是 CSS、Javascript、HTML?) 对于 JavaScript: Ctrl-/ 为单行代码或多 ..
发布时间:2021-11-17 01:09:02 其他开发

在Android中编译java文件后注释会发生什么?

Android 编译器是如何工作的?是否会在编译时删除 Java 代码和 Android XML 文件中的注释? 解决方案 Java 文件中的注释在编译为类文件时会被删除或忽略.类文件不适合人类阅读 - 它们经过优化以在虚拟机上高效运行.如果保留注释,它们只会导致类文件比所需的大,而且没有额外的好处(即编译器和虚拟机不理解注释,所以为什么要包含它们) 对于 XML 文件,通常会保留注 ..
发布时间:2021-11-15 21:27:06 其他开发

尝试使用 PyGithub 库访问 Github 问题评论

我正在尝试使用 PyGithub 库访问问题评论. 这是我实现的功能, def get_issue_comments_dict(self, repository):"""获取问题评论输出 reponame:问题标题、问题 URL、评论返回类型:字典"""repo = self.user_obj.get_repo(repository)问题 = repo.get_issues()问题_di ..
发布时间:2021-11-15 03:17:13 其他开发

是否可以使用 Google Spreadsheet API 在单元格中添加注释?

我正在查看 CellEntry API (https://developers.google.com/gdata/javadoc/com/google/gdata/data/spreadsheet/CellEntry) 以了解如何添加评论(最好还添加注释)) 到一个单元格,但看不到任何明显的东西,如“addComment()". 有人有想法吗? 谢谢 解决方案 借助 googl ..
发布时间:2021-11-15 01:19:22 其他开发

以编程方式发布 Facebook 评论

我的应用程序已获得 Facebook 用户的 publish_stream 权限. 我想允许用户直接从我的移动应用程序中对目标 URL 发表评论,而不是打开一个嵌入式浏览器,然后显示 评论框插件.也就是说,用户不一定要发布指向其供稿的链接,而是希望参与围绕该网址的任何 Facebook 评论讨论. 当然,我可以通过 Graph API 阅读任何 URL 的评论(例如:一篇技术紧要文章) ..
发布时间:2021-11-15 01:02:38 其他开发

apache poi 插入带图片的评论

我有一个应用程序,我正在编辑一个 excel xls 文件.我想要一段代码来演示如何添加包含 png 图像的评论.我已经找到了显示如何向单元格添加注释的示例代码.我不确定如何在评论中添加图片. 解决方案 我从这个例子开始:https://poi.apache.org/spreadsheet/quick-guide.html(参见 Cell Comments - HSSF 和 XSSF)并找 ..
发布时间:2021-11-12 05:10:45 其他开发

POI 3.17 在克隆工作表中创建单元格注释会导致 xlsx 不一致

我使用了 cloneSheet 方法来复制同一个工作簿中已经包含注释的工作表.之后将新评论添加到此新工作表并保存 excel. 当用 Excel 365 打开文件时,它抱怨 /xl/comments1.xml 并恢复了文件.新创建的评论可用.在恢复过程中删除了来自克隆的注释. 打开 zip 文件并查看 /xl/comments1.xml,它显示出不同. 这是 cloneSheet ..
发布时间:2021-11-12 04:42:50 其他开发

向 .htaccess 添加注释

为什么这样做: RewriteRule (.+)/$ $1 和这项工作: RewriteRule (.+)/$ $1 [L] #bla bla bla 但这不起作用: RewriteRule (.+)/$ $1 #bla bla bla 解决方案 .htaccess 中的注释必须位于自己的行,不能附加到其他语句中. 最后一条规则不起作用,因为评论并不是真正的评论.htacces ..
发布时间:2021-11-11 05:32:07 其他开发

ANTLR 禁用评论中的特定用户路径并返回

总是当我从我的语法文件生成解析器和词法分析器时,一切正常,而不是问题,ANTLR 会自动将整个用户目录添加到任何返回和评论中.这是不好的.例如: return "C:\\Users\\##\\workspace\\project\\src\\Grammar.g" 这个工具对任何评论也做同样的事情: //$ANTLR 3.4 C:\\Users\\##\\workspace\\project\ ..
发布时间:2021-11-11 03:55:15 其他开发

解析注释行

鉴于以下基本语法,我想了解如何处理注释行.缺少的是 的处理,它通常会终止注释行——唯一的例外是 EOF 之前的最后一个注释行,例如.: # 注释abcd := 12 ;# 没有的评论eof 语法 CommentLine1a;//==========================================================//选项//=== ..
发布时间:2021-11-11 03:36:57 其他开发

使用 ANTLR 捕获(并保留)所有评论

我正在 ANTLR 中编写语法,将 Java 源文件解析为 AST 以供以后分析.与其他解析器(如 JavaDoc)不同,我试图保留所有注释.这是很难的注释,可以在代码中的任何地方使用.如果源代码中某处的注释与语法不匹配,则 ANTLR 无法完成文件的解析. 有没有办法让 ANTLR 自动将它找到的任何注释添加到 AST 中?我知道词法分析器可以使用 {skip();} 或通过将文本发送到隐 ..
发布时间:2021-11-11 03:34:09 其他开发

我可以在我的 Jar 文件(由 Ant 生成)中保存评论信息吗?

当我使用 Ant 将我的项目构建为 Jar 文件时,我同时生成了 javadoc. 但是当我在一个新项目中使用这个 Jar 时,我在 Eclipse 中看不到 Jar 的注释(按 F2). 因此,我尝试在新项目属性的“javadoc 位置"中添加 javadoc 文件的位置路径,但它不起作用,即使 Eclipse 告诉我“位置可能有效". 当我在浏览器中打开它时,网址就像 fil ..
发布时间:2021-11-11 03:06:13 其他开发