标签: comments

如何在WPF中的Xaml文件中添加注释?

我使用这种语法,因为我发现在线,但它抛出一个错误:

xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
<!-- Cool comment -->
xmlns:System="clr-namespace:System;assembly=mscorlib"
Run Code Online (Sandbox Code Playgroud)

'名称不能以'<'字符开头,十六进制值0x3C.第4行,第5位.' XML无效.

.net c# wpf xaml comments

73
推荐指数
4
解决办法
15万
查看次数

Javadoc:没有HTML标签的换行符?

对不起有一个可能的FAQ问题,但我找不到答案.

据我记得Eclipse,Javadoc注释中的空行显示(在源代码中的Javadoc弹出窗口中)作为换行符(具有额外的垂直间距).

然而,在Netbeans中,情况并非如此.

我可以配置Javadoc将空行解释为换行符吗?

其他问题:我可以覆盖源内Javadoc弹出窗口的默认Netbeans行为(与此相关)吗?

我在说的是:

资源

/**
 * Paragraph One
 *
 * Paragraph Two
 */
 void someMethod() { }
Run Code Online (Sandbox Code Playgroud)

Eclipse解释

 Paragraph One

 Paragraph Two
Run Code Online (Sandbox Code Playgroud)

Netbeans解释

 Paragraph One Paragraph Two
Run Code Online (Sandbox Code Playgroud)

java comments netbeans javadoc

72
推荐指数
4
解决办法
8万
查看次数

Todo任务没有出现在visual studio 2012的任务列表中

我最近升级到Visual Studio 2012并且没有任何问题,因为以"// todo"开头的注释不再显示在任务列表中.我完全不知道从哪里开始寻找这个问题的解决方案,因为所有关键字都过于笼统.

我碰到其他类似的问题,如果回答是,该文件没有打开包含// TODO注释,但不适合我的情况.即使文件在我面前打开,我的待办事项评论也不会显示.

c# comments visual-studio-2012

72
推荐指数
4
解决办法
3万
查看次数

从C/C++代码中删除注释

有没有一种简单的方法可以从C/C++源文件中删除注释而无需进行任何预处理.(也就是说,我认为你可以使用gcc -E,但这会扩展宏.)我只想要删除注释的源代码,不应该改变任何其他内容.

编辑:

对现有工具的偏好.我不想用正则表达式自己写这个,我预见代码中有太多的惊喜.

c c++ comments

67
推荐指数
4
解决办法
6万
查看次数

如何评论if-else结构?

让我们说你有:

if(condition) {
    i = 1;
} else {
    i = 2;
}
Run Code Online (Sandbox Code Playgroud)

你需要发表评论解释ifelse阻止.什么是最易读的方式,所以有人可以在第一眼就轻松拿起它们?

我通常这样做:

//check for condition
if(condition) {
    i = 1;
} else {
    //condition isn't met
    i = 2;
}
Run Code Online (Sandbox Code Playgroud)

由于评论位于不同的级别,我觉得不够好,所以快速浏览一下你就会发现if评论和else评论看起来像是属于某种内部结构.

把它们像这样:

if(condition) {
    //check for condition
    i = 1;
} else {
    //condition isn't met
    i = 2;
}
Run Code Online (Sandbox Code Playgroud)

对我来说也不好看,因为看起来整个结构都没有评论(条件可能很大并且需要多行).

像这样的东西:

//check for condition
if(condition) {
    i = 1;
//condition isn't met
} else {
    i = 2; …
Run Code Online (Sandbox Code Playgroud)

comments coding-style

66
推荐指数
7
解决办法
2万
查看次数

评论会减慢解释语言的速度吗?

我问这个是因为我使用Python,但它也适用于其他解释语言(Ruby,PHP,JavaScript).

每当我在代码中留下评论时,我是否会放慢口译员的速度?根据我对解释器的有限理解,它以字符串形式读取程序表达式,然后将这些字符串转换为代码.似乎每次解析评论时都会浪费时间.

是这样的吗?在解释语言中是否有一些评论惯例,或者效果可以忽略不计?

python interpreter comments interpreted-language

66
推荐指数
6
解决办法
1万
查看次数

HTML中的单行注释

有没有办法在行开头使用转义序列在HTML中注释掉一行?与使用#//其他语言类似?或者是<!-- ... -->在HTML中评论的唯一选择?

html comments

65
推荐指数
4
解决办法
10万
查看次数

有什么区别; 和;; 在Clojure代码评论?

在Clojure中发表评论;和之间的区别是什么;;?我看到我的文本编辑器对它们进行了不同的着色,所以我假设在理论上存在一些差异.

我也看到Marginalia以不同的方式对待他们:

; Stripped entirely
;; Appears in text section of marginalia
(defn foobar []
   ; Appears in code section of marginalia output
   ;; Again, appears in code section of marginalia output
   6)
Run Code Online (Sandbox Code Playgroud)

comments clojure marginalia

65
推荐指数
6
解决办法
1万
查看次数

SQL注释标题示例

还想看看人们的存储过程/功能等注释标题是什么样的(所以发布你的例子)......我只是真正看到了SQL Server Management Studio创建的内容,但我对其他人看起来感兴趣...格式,使用的字符,程序信息/细节等我猜是真正让他们与众不同的......

SQL Server Management Studio(版本9)存储过程注释标头默认值:

-- =============================================
-- Author:      Name
-- Create date: 
-- Description: 
-- =============================================
Run Code Online (Sandbox Code Playgroud)

sql comments

64
推荐指数
7
解决办法
9万
查看次数

Python:在csv.DictReader中跳过标有#的注释行

使用csv.DictReader处理CSV文件非常棒 - 但是我有带有注释行的CSV文件(在行的开头用哈希表示),例如:

# step size=1.61853
val0,val1,val2,hybridisation,temp,smattr
0.206895,0.797923,0.202077,0.631199,0.368801,0.311052,0.688948,0.597237,0.402763
-169.32,1,1.61853,2.04069e-92,1,0.000906546,0.999093,0.241356,0.758644,0.202382
# adaptation finished

csv模块不包含任何跳过此类行的方法.

我可以很容易地做一些hacky,但我想有一种很好的方法可以将csv.DicReader包装在一些其他迭代器对象周围,该对象预处理以丢弃这些行.

python csv comments

63
推荐指数
3
解决办法
2万
查看次数