tagged [comments]

Commenting out whole file

Commenting out whole file Sometimes, I need to comment out a whole file. Normally, I'd just wrap the class in `/* */`, but that doesn't work if there's already existing comments inside the class: Is t...

25 Jan at 10:56

What does 3 '/'s in a row do in C#?

What does 3 '/'s in a row do in C#? I was coding along in lala land when suddenly I typed a 3'd '/' in a comment. Originally a comment goes with 2 '/'s ![Subject1](https://i.stack.imgur.com/YvNS8.png)...

3 May at 21:43

Should you XML Comment on private methods?

Should you XML Comment on private methods? So I use XML Comments in my code to help explain Public Methods and Public Members, another developer has mentioned that not all of my methods have XML Comme...

9 Oct at 09:30

Jinja2 inline comments

Jinja2 inline comments How can I put comments inside Jinja2 argument list declaration ? Everything I have tried gives an error: ``` {{ Switch('var', [('1', 'foo'), # comment 1 ('2', 'bar'), ## c...

4 Nov at 18:23

.NET // vs /// Comments convention

.NET // vs /// Comments convention I am just checking out F#, so apologies if this is a silly question, but in the VS2008 F# CTP 1.9.6.2 'Tutorial' project, both // and /// are used for commenting cod...

12 Jan at 14:57

How do I comment a publicly visible type Enum?

How do I comment a publicly visible type Enum? How do I comment this Enum so that the warning does not appear? Yes I realize that comments are unnecessary, but if commenting is easy and it resolves th...

22 Jul at 14:45

How to write a comment in a Razor view?

How to write a comment in a Razor view? How to write a comment in a MVC view, that won't be transmitted to the final HTML (i.e.,to browser, to response). One can make a comment with: but, it is visibl...

1 Oct at 07:18

A way to link to a class,a method, especially a specific code line in C# comment

A way to link to a class,a method, especially a specific code line in C# comment I want to build sort of documentation using links in code that point to a target. The target could be a `Class` or a `M...

What is the common header format of Python files?

What is the common header format of Python files? I came across the following header format for Python source files in a document about Python coding guidelines: Is this the standard format of headers...

28 Apr at 10:34

Inline comments for Bash?

Inline comments for Bash? I'd like to be able to comment out a single flag in a one-line command. Bash only seems to have `from # till end-of-line` comments. I'm looking at tricks like: It's ugly, but...

7 Mar at 12:28

How to refer to array types in documentation comments

How to refer to array types in documentation comments [I just posted this question](https://stackoverflow.com/questions/2367357/how-to-add-items-enclosed-by-to-documentation-comments) and learned abou...

How do I add comments to package.json for npm install?

How do I add comments to package.json for npm install? I've got a simple package.json file and I want to add a comment. Is there a way to do this, or are there any hacks to make this work? ``` { "nam...

7 Aug at 05:26

comments compiled into .exe in .net?

comments compiled into .exe in .net? I know you can use a .net reflector to view code created with .net but if I put something in the comments for my own personal reminder is that compiled in the exe ...

How to comment multiple lines with space or indent

How to comment multiple lines with space or indent In Visual Studio 2010, I have multiple lines of text to be commented: Using ++ to comment out multiple lines, I get I would like to have a space (or ...

6 Mar at 09:29

Comment the interface, implementation or both?

Comment the interface, implementation or both? I imagine that we all (when we can be bothered!) comment our interfaces. e.g. Do you also comment the implementation (which may als

17 Apr at 09:19

C# XML /// Comments, where does <returns></returns> tag show up?

C# XML /// Comments, where does tag show up? I am currently a programming student, and obviously my question is simple, but I haven't been able to find the answer to it online. So here it is: In XML /...

4 Dec at 07:21

Is it possible to obtain class summary at runtime?

Is it possible to obtain class summary at runtime? Is it possible to obtain class summary at runtime in C#? I would like to obtain class summary through reflection and then write it to console. By cla...

26 Feb at 19:54

How can I comment a single line in XML?

How can I comment a single line in XML? This rather is a verification just not to miss out. Is/n't there a line-comment in XML? So, one without a closer, like "//" the compiler uses. I saw [How do I c...

16 Dec at 22:22

C# hide and unhide comments

C# hide and unhide comments I am trying to find solution how to hide and unhide comments in VS2010. What i found is: and: [http://holyhoehle.wordpress.com/2010/01/17/hide-comments-in-visual-studio/](h...

2 Jan at 00:50

Inheriting comments from an interface in an implementing class?

Inheriting comments from an interface in an implementing class? Suppose I have this interface And this class ``` public class Foo : IFoo {

19 Jan at 15:30

Why doesn't Python have multiline comments?

Why doesn't Python have multiline comments? OK, I'm aware that triple-quotes strings can serve as multiline comments. For example, and But technically speaking these are strings, correct? I've googled...

19 Mar at 05:58

Is it possible insert image to a code comment?

Is it possible insert image to a code comment? My question is probably an insane idea, however, it's very valuable when I write code for educational purpose. Especially when the code is relevant to ma...

11 Feb at 17:2

Is there a shortcut to make a block comment in Xcode?

Is there a shortcut to make a block comment in Xcode? I'm writing ANSI-compatible C code, and hence I can't use the line (`//`) comment. I'm using Xcode. In Sublime Text and Eclipse, and I think most ...

2 May at 17:5

Do standard windows .ini files allow comments?

Do standard windows .ini files allow comments? Are comments allowed in Windows ini files? (...assuming you're using the [GetPrivateProfileString](http://msdn.microsoft.com/en-us/library/ms724353%28VS....

4 Sep at 10:6

using see cref with < > characters in XML Documentation?

using see cref with characters in XML Documentation? > [How to reference generic classes and methods in xml documentation](https://stackoverflow.com/questions/532166/how-to-reference-generic-classes-...