Clean up new Location code

Modify the grammar of some comments and spec descriptions.

Change-Id: I3ea4c82c6bb0e71372add6f451755dbf0017ec09
Reviewed-on: http://gerrit.causes.com/37224
Tested-by: jenkins <[email protected]>
Reviewed-by: Shane da Silva <[email protected]>

Author: Shane da Silva

lib/scss_lint/linter.rb

@@ -36,7 +36,7 @@ def add_lint(node_or_line, message)
                          message)
     end
 
-    # Helper for creating location from a source range
+    # Extract {SCSSLint::Location} from a {Sass::Source::Range}.
     #
     # @param range [Sass::Source::Range]
     # @return [SCSSLint::Location]

lib/scss_lint/location.rb

@@ -1,13 +1,13 @@
 module SCSSLint
-  # Stores a location of [Lint] in a source.
+  # Stores a location of {Lint} in a source.
   class Location
     include Comparable
 
     attr_reader :line, :column, :length
 
-    # @param line [Integer] An one-based index
-    # @param column [Integer] An one-based index
-    # @param length [Integer] A length in the line
+    # @param line [Integer] One-based index
+    # @param column [Integer] One-based index
+    # @param length [Integer] Number of characters, including the first character
     def initialize(line = 1, column = 1, length = 1)
       raise ArgumentError, "Line must be more than 0, passed #{line}" if line < 1
       raise ArgumentError, "Column must be more than 0, passed #{column}" if column < 1

spec/scss_lint/location_spec.rb

@@ -17,7 +17,7 @@
       ]
     end
 
-    it 'enables to sort locations' do
+    it 'allows locations to be sorted' do
       locations.sort.should == [
         SCSSLint::Location.new(1, 1, 1),
         SCSSLint::Location.new(1, 1, 2),