How to do block comments in Gherkin?
SyntaxCucumberCommentsSpecflowGherkinSyntax Problem Overview
In gherkin syntax (used by Cucumber and SpecFlow, I can comment out a line by prefixing it with '#'
Is there any way to block-comment multiple lines?
Syntax Solutions
Solution 1 - Syntax
It is not supported by Gherkin, so you have to prefix all lines with #.
If you use the SpecFlow Visual Studio extension (v1.9.2) you can simply select the lines and toggle them into comments and back. The default shortcuts are Ctrl+K,C to comment and Ctrl+K,U to uncomment.
You can also "workaround" this problem in Visual Studio using the multi-line editing feature. (See http://weblogs.asp.net/scottgu/archive/2010/04/26/box-selection-and-multi-line-editing-with-vs-2010.aspx). You just have to select the beginning of the lines with holding ALT and using the mouse. Using this feature you can type in all the selected lines at the same time. You can also remove all of them similarly, selecting all the # characters for deletion.
Solution 2 - Syntax
Yes, there is. It's called PyStrings type comments. See example at http://docs.behat.org/guides/1.gherkin.html#pystrings.
It will work if you use it just after Feature or Scenario and some other elements.
Feature: my feature
""" some block comment
still block comment
""" end of block comment
Scenario: my feature
""" some block comment
still block comment
""" end of block comment
One the other hand it will not work if you want to comment out some steps.
I think you can configure your IDE to comment out a line on standard key combination. For example IntelliJ recognizes *.feature files and allows to comment out line out of the box. The same possible to do with Notepad++ or even VS.
Solution 3 - Syntax
In Eclipse, for commenting single/multiple lines of Gherkin feature file content, we can also do the following.
Add new file association
Windows > Preferences > General > Editors> File Associations > File types: > Add...
and add a new file type as *.feature
Associate an editor for new file type
Associated Editors > > Add...
add Properties File Editor (Default).
Now reopen the file if it's open and it will open in Properties File Editor instead of Text editor.
Doing this allows me select any number of lines and comment-out using the common commenting shortcut Ctrl+Shift+C
Solution 4 - Syntax
Use CTRL + /
It works great. Multiple line comment
Solution 5 - Syntax
For commenting :
Single Line --> #
Multiple Line --> """
Solution 6 - Syntax
Single line comment : #
Mutli line comment : Starts with """ Ends with """
Solution 7 - Syntax
Use Command key + '?' key to comment multiple lines for cucumber scripts in MAC.
Solution 8 - Syntax
There's no block commenting in Gherkin, however you can comment multiple lines at once by selecting that block and hitting ctrl + /
Solution 9 - Syntax
I don't think it's supported, actually. I have been doing Cucumber related work for about 2 years now and I never seen it.
You'll have to do lot of #-lines ;).
I would start reading the great wiki on github (https://github.com/cucumber/cucumber/wiki/Gherkin)
Solution 10 - Syntax
You could achieve it by selecting all the lines that you want to comment and then pressing "Ctrl + plus/equals key + /" keys in eclipse.
Solution 11 - Syntax
In Eclipse, for commenting single/multiple lines of Gherkin feature file content, we can also do the following. Add new file association Windows > Preferences > General > Editors> File Associations > File types: > Add... and add a new file type as *.feature Associate an editor for new file type Associated Editors > > Add... add Properties File Editor (Default). Now reopen the file if it's open and it will open in Properties File Editor instead of Text editor. Doing this allows me select any number of lines and comment-out using the common commenting shortcut Ctrl+Shift+C
Solution 12 - Syntax
Well, I have so far used # to comment the test steps. If you use this, you should individually comment out each and every line, scenarios and examples which ever applicable. Though this is not recommended, still, I dont see anything similar supported in gherkin yet.
Solution 13 - Syntax
Select all the lines you want to comment and press cmd+shift+c.
Solution 14 - Syntax
There's no block commenting in Gherkin, however you can comment multiple lines at once by selecting that block and hitting ctrl + /