The //* /*/ //*/ comment toggle trick
DISCLAIMER:
This is a trick. Do not adopt this trick in production code. Use it wisely while you're doing proof of concept and the like.
So, I guess I'm not the only one that need some way of easily toggling code in and out of the code.
This trick below can be used to toggle between two sets of code, with one symbol in the code with no additional short-keys to learn, and no tool dependencies!
//* /*
someCode(); someCode();
/*/ /*/
someOtherCode(); someOtherCode();
//*/ //*/
Here is a version for simply commenting code in and out:
Activated:
//*
someCode();
//*/
Deactivated / commented out:
/*
someCode();
//*/
Written by Alexander Brevig
Related protips
27 Responses
Nice! I've used a similar method in JavaScript like this:
// On!
/**/
var foo = "bar";
/**/
// Off!
/** /
var foo = "bar";
/**/
The trick is to toggle the space after the second asterisk in the first multiline comment block. Interesting to see other ways to do this as well!
A much safer alternative is to use feature flags - http://code.flickr.net/2009/12/02/flipping-out/
@wildlyinaccurate feature flippers do not prevent code from being built, and thus the code is available in the binary. What's safest depends on the definition of save, and the specs of the project. Feature flippers solves a problem (highly relevant to the open/closed principle) but not the problem this trick solves.
Nice trick, thank you for sharing ! One little reserve: at least in C, this fails if the code to toggle contains comments itself:
//*
spawn_unicorns();
/*/
slay_the_unicorns(); /* FIXME: This function kills unicorns ! */
launch_missile();
//*/
In this code, you won't kill unicorns, but you will always launch a missile, which is not what was intented.
It only works in C/C++, but I tend to prefer:
#if 1
spawn_unicorns();
#else
slay_the_unicorns(); /* FIXME: please don't to that. */
launch_missile();
#endif
You just have to change "1" to "0" to toggle between nice and evil code, and it has no restriction regarding embedded comments.
That said, I'll remember your solution for Java, Javascript and others.
I wouldn't normally comment, but this has a lot of people looking at it. Don't do this. For reasons why, see the hacker news thread https://news.ycombinator.com/item?id=5625490
What editor are you using?
@cguillemette I'm using 8 editors, Visual Studio, Sublime Text 2/3, Mono Develop, Notepad++, Eclipse, NetBeans, MS SQL Management Studio and Vim.
I came to mention the #if 0 version only to find that it was already mentioned. Too bad it doesn't work in other languages as well :(
oh god. this is what my old company used to control database connections. jdbc in development (tomcat) and jndi lookup everywhere else (websphere i think?). yes, we had to modify code to move to another environment! I couldn't explain this enough to my manager that this was a bad thing.
that was the least of the issues. it was on the whole, written by people who didn't know how the hell to use java. (probably former SQL devs?)
I just have a shortcut in emacs that comments and uncomments things in all languages seamlessly.
I just sat in sublime text for like 15 minutes with my mouth agape as I typed forward slash and backspace over and over, watching the syntax highlighting flip back and forth with each keypress. This is beautiful.
I agree that commented-out code should not be part of production code.
But I use this trick all the time while writing/debugging/updating/fixing code.
It makes enabling/disabling code blocks extremely quick and easy.
Sublime text 2 also does that by default :)
@ralphholzmann Super-slick trick!
I would hate having to work on code with this trick. It would be hugely confusing.
I accept that your probably a lot smarter than me so have no problem with it but I always strive to write code like other people are going to read it. Part of that is not writing cleverly so much as writing clearly.
Nice to see it published...but this trick has been around for a quite a few years now.
@mikbe you should never work on production code with this trick. Then someone is doing something wrong. This is just a trick that's fun to use while testing out two different approaches. Such as an iterative versus a recursive algorithm.
I see no issues with this as long as you don't check it in or deploy to production like this. For local/debug development, this can be quite useful. If you need a reminder, you could add a commented line with a reminder (like "TODO: remove toggle") and do a Find before checking in.
I also have been doing this PHP. @ralphholzmann's version is a better one in my opinion, because it can be used multiple times after each other. Allowing you to toggle multiple stacks.
@nekwebdev Sublime Text 2 is the best, but Brackets is definitely close behind! I love Brackets so far but JSLint pisses me off, haha. If you haven't tried Brackets out yet, I strongly suggest that you do: http://brackets.io/
This one is awesome!
is it really hard to cmd-slash ?
For those writing JavaScript with r.js compiler, pragmas can be very useful for this kind of thing.
Thanks .
In eclipse ,
select text to comment and press Shift+Ctrl+/
select text to uncomment and press Shift+Ctrl+\
what is the advantage of this over single and multi-line commenting by clicking the line number, or selecting multiple lines then pressing "command(or ctrl) + /"?
That's what I expected to see here. Thanks!