Rename feature and tweak its narrative

features/configuration/options_file.feature → features/configuration/read_options_from_file.feature

@@ -1,21 +1,16 @@
-Feature: options file
-
-  To load in configuration options from a file, RSpec will look
-  for a ".rspec" file.
-
-  There are two types of ".rspec" files: local and global. Local
-  exists in the project root directory, while global exists in
-  the system root directory (~). Examples:
+Feature: read command line configuration options from files
+
+  RSpec will read command line configuration options from files in
+  two different locations:
 
-    Local:  "~/path/to/project/.rspec"
-    Global: "~/.rspec"
+    Local:  "./.rspec" (i.e. in the project's root directory)
+    Global: "~/.rspec" (i.e. in the user's home directory)
 
-  The local file will override the global file, while options
-  declared in RSpec.configure will override any ".rspec" file.
+  Options declared in the local file override those in the global file, while
+  those declared in RSpec.configure will override any ".rspec" file.
 
-  NOTE: For backwards compatibility with rspec-1, you can write
-  command line options in a "spec/spec.opts" file and it will be
-  loaded automatically.
+  NOTE: For backwards compatibility with rspec-1, you can write command line
+  options in a "spec/spec.opts" file and it will be loaded automatically.
 
   Scenario: color set in .rspec
     Given a file named ".rspec" with:
@@ -73,4 +68,4 @@ Feature: options file
       end
       """
     When I run "rspec ./spec/example_spec.rb"
-    Then the output should contain "1 example, 0 failures"
+    Then the output should contain "1 example, 0 failures"