Update rspec --help to include more detail about filtering.

- Clarify location filtering.
- Add info about id filtering.

Author: myronmarston

.rubocop.yml

@@ -25,7 +25,7 @@ Lint/LiteralInInterpolation:
 
 # This should go down over time.
 MethodLength:
-  Max: 155
+  Max: 40
 
 # Exclude the default spec_helper to make it easier to uncomment out
 # default settings (for both users and the Cucumber suite).

lib/rspec/core/option_parser.rb

@@ -21,6 +21,7 @@ def parse(args)
       options
     end
 
+    # rubocop:disable MethodLength
     def parser(options)
       OptionParser.new do |parser|
         parser.banner = "Usage: rspec [options] [files or directories]\n\n"
@@ -143,11 +144,15 @@ def parser(options)
 
   **** Filtering/tags ****
 
-    In addition to the following options for selecting specific files, groups,
-    or examples, you can select a single example by appending the line number to
+    In addition to the following options for selecting specific files, groups, or
+    examples, you can select individual examples by appending the line number(s) to
     the filename:
 
-      rspec path/to/a_spec.rb:37
+      rspec path/to/a_spec.rb:37:87
+
+    You can also pass example ids enclosed in square brackets:
+
+      rspec path/to/a_spec.rb[1:5,1:6] # run the 5th and 6th examples/groups defined in the 1st group
 
 FILTERING
 
@@ -224,5 +229,6 @@ def parser(options)
 
       end
     end
+    # rubocop:enable MethodLength
   end
 end