标签: commenting

注释/取消注释一段代码的键盘快捷键在其他编程IDE中常用于Java,.Net等语言.我发现它是一种非常有用的技术,在通过试验和错误进行实验时,可以暂时注释掉并取消注释代码的行,单词和部分,以找出什么是无效的.

我在版本7的Mathematica前端找不到任何这样的键盘快捷键.我知道可以通过选择代码注释掉代码,单击鼠标右键并从出现的菜单中选择取消/注释但这太慢了编码.

我尝试使用键盘上的菜单键 访问它,Menu但Mathematica前端不响应或识别此键与其他应用程序不同,这可能允许用于评论的组合键.其他人可以验证这不是我的机器所独有的,并且mathematica无法识别该密钥.我查看了这个问题并查看了KeyEventTranslations.tr文件,但我认为没有办法创建一个快捷方式来执行此操作(？).我应该忍受它吗？

还有其他建议吗？

(我已经看到有一个Emacs版本的mathematica,我从来没有尝试过Emacs或者这个Mma版本,并且想象它会有这种能力但是不想去安装它的麻烦和不确定性.我也猜想Wolfram Workbench可以做到这一点,但这可能不值得投资.)

LaTeX有%,html有<! -

纺织品是否还有评论文字？我找不到一个,看起来这将是一个很好的功能.

/*
 *
 * This is a long comment. I broke it into lines, but that made it impossible to edit without screwing up the formatting. Is there a way to make Netbeans add line breaks automatically?
 *
 */

读:这是一个很长的评论.我把它分成了几行,但这使得在不搞砸格式化的情况下无法进行编辑.有没有办法让Netbeans自动添加换行符？

有人可以解释html5shim脚本的开头和结尾是如何工作的吗？

脚本/*@以@*/这样开头 并结束:

/*@cc_on(function(a,b){function ........ (this,document);@*/

什么是/*@ @*/做什么？

我希望/**/序列可以注释掉它们之间的所有行,但是自从脚本执行以来,这种情况不可能出现在这里吗？我糊涂了.

发现于:

http://html5shim.googlecode.com/svn/trunk/html5.js

可能重复:
评论是否会降低解释语言的速度？

如果超过75%的代码行被正确评论,那么在执行大型.py文件时会出现明显的性能下降吗？

我将在这里假设答案是'不',但由于我实际上没有找到答案,我问.

基本上,我想要做的就是在我的文件中留下一些HTML评论"仅限作者眼睛",只是为了让以后编辑文件更加愉快.

<!-- Doing it like this --> 留下很好的干净注释,但它们在输出后查看页面源时出现.

我正在使用PHP,所以在技术上我可能<?PHP /* wrap comments in PHP tags */ ?>会阻止它们输出,但如果可能的话,我想避免在整个文件中注释所需的所有额外的任意PHP标记.毕竟,评论的目的是使文档更简洁,更有条理.

还有什么我可以尝试或者这些是我最好的选择吗？

我的python代码与许多用于(调试|分析|跟踪等)的函数调用隔行扫描,例如:

import logging

logging.root.setLevel(logging.DEBUG)
logging.debug('hello')
j = 0
for i in range(10):
    j += i
    logging.debug('i %d j %d' % (i,j))
print(j)
logging.debug('bye')

我想#define代码中的这些资源消耗函数.像c等价的东西

#define logging.debug(val)

是的,我知道日志模块日志记录级别机制可用于屏蔽低于设置日志级别的日志记录.但是,我要求一般方法让python解释器跳过功能(即使他们不做太多也需要时间运行)

一个想法是重新定义我想要注释到空函数的函数:

def lazy(*args): pass
logging.debug = lazy

上述想法仍然会调用一个函数,并可能产生无数其他问题

我在PHP代码中使用@since注释.我对它的使用有疑问.假设我有一个执行特定任务的函数,它已在1.0版本中实现.

所以我现在有@since 1.0.

现在我继续更改函数的名称,尽管里面的代码保持不变.它应该现在说@since 3.0(当前版本)还是@since 1.0？

在过去的两个月里,我一直在学习PHP,我发现有两种以上的样式用来评论代码!我没有看到太多的一致性......我认为这通常意味着工作中的艺术家.所以我想知道:评论的有效方法是什么仍然可读/实用？并排查看1个地方的所有有效可能性将提供我正在寻求改进评论的概述

/*
|  This is what I now use (5chars/3lines) I name it star*wars
\*

我正在敲打我的头,我想知道是否有人能够帮助我.

我的目标是创建一个评论线程,该评论线程在评论评分系统中起作用.

首先,我将解释我目前的情况.

假设我们在一篇文章中有一个评论主题,看起来像下面的例子.parenthasis中的数字是该注释的ID.ID由数据库自动分配,并按时间顺序递增,并发布每个附加注释.注释文本前的短划线数量会重新显示注释深度.

(01)"This is a top level comment." 
(02)-"This is a second level comment. A reply to the top level comment above."
(06)-"This is also a second level comment / another reply to comment 01."
(07)--"This is a reply to comment 06."
(03)"This is a different top level comment."
(05)-"This is a reply to the comment above."
(08)--"This is a reply to that comment in turn."
(10)---"This is a deeper comment still."
(04)"This is one more top level …