sass 3.3.0.alpha.195 → 3.3.0.alpha.196

data/REVISION

@@ -1 +1 @@
-a1dbbf37b919e9b45043a2ade97e7d355609f9de
+3815575f97174247159cff208be7ef0d7feed874

data/VERSION

@@ -1 +1 @@
-3.3.0.alpha.195
+3.3.0.alpha.196

data/VERSION_DATE

@@ -1 +1 @@
-19 June 2013 23:49:23 GMT
+02 July 2013 23:14:47 GMT

data/lib/sass.rb

@@ -19,7 +19,7 @@ require 'sass/version'
 module Sass
   # The global load paths for Sass files. This is meant for plugins and
   # libraries to register the paths to their Sass stylesheets to that they may
-  # be `@imported`. This load path is used by every instance of [Sass::Engine].
+  # be `@imported`. This load path is used by every instance of {Sass::Engine}.
   # They are lower-precedence than any load paths passed in via the
   # {file:SASS_REFERENCE.md#load_paths-option `:load_paths` option}.
   #
@@ -56,9 +56,6 @@ module Sass
 
   # Compile a file on disk to CSS.
   #
-  # @param filename [String] The path to the Sass, SCSS, or CSS file on disk.
-  # @param options [{Symbol => Object}] An options hash;
-  #   see {file:SASS_REFERENCE.md#sass_options the Sass options documentation}
   # @raise [Sass::SyntaxError] if there's an error in the document
   # @raise [Encoding::UndefinedConversionError] if the source encoding
   #   cannot be converted to UTF-8
@@ -67,11 +64,17 @@ module Sass
   # @overload compile_file(filename, options = {})
   #   Return the compiled CSS rather than writing it to a file.
   #
+  #   @param filename [String] The path to the Sass, SCSS, or CSS file on disk.
+  #   @param options [{Symbol => Object}] An options hash;
+  #     see {file:SASS_REFERENCE.md#sass_options the Sass options documentation}
   #   @return [String] The compiled CSS.
   #
   # @overload compile_file(filename, css_filename, options = {})
   #   Write the compiled CSS to a file.
   #
+  #   @param filename [String] The path to the Sass, SCSS, or CSS file on disk.
+  #   @param options [{Symbol => Object}] An options hash;
+  #     see {file:SASS_REFERENCE.md#sass_options the Sass options documentation}
   #   @param css_filename [String] The location to which to write the compiled CSS.
   def self.compile_file(filename, *args)
     options = args.last.is_a?(Hash) ? args.pop : {}

data/lib/sass/cache_stores/base.rb

@@ -46,7 +46,7 @@ module Sass
       #
       # @param key [String] The key to store it under.
       # @param sha [String] The checksum for the contents that are being stored.
-      # @param obj [Object] The object to cache.
+      # @param root [Object] The root node to cache.
       def store(key, sha, root)
         _store(key, Sass::VERSION, sha, Marshal.dump(root))
       rescue TypeError, LoadError => e

data/lib/sass/css.rb

@@ -317,7 +317,7 @@ module Sass
     #       bar, baz
     #         color: blue
     #
-    # @param rule [Tree::RuleNode] The candidate for flattening
+    # @param root [Tree::Node] The parent node
     def fold_commas(root)
       prev_rule = nil
       root.children.map! do |child|

data/lib/sass/exec.rb

@@ -134,9 +134,9 @@ module Sass
         STDOUT.flush
       end
 
-      # Same as \{Kernel.puts}, but doesn't print anything if the `--quiet` option is set.
+      # Same as `Kernel.puts`, but doesn't print anything if the `--quiet` option is set.
       #
-      # @param args [Array] Passed on to \{Kernel.puts}
+      # @param args [Array] Passed on to `Kernel.puts`
       def puts(*args)
         return if @options[:for_engine][:quiet]
         Kernel.puts(*args)

data/lib/sass/features.rb

@@ -1,8 +1,7 @@
 require 'set'
-
-# Provides `Sass.has_feature?` which allows for simple feature detection
-# by providing a feature name.
 module Sass
+  # Provides `Sass.has_feature?` which allows for simple feature detection
+  # by providing a feature name.
   module Features
 
     # This is the set of features that can be detected.

data/lib/sass/media.rb

@@ -2,7 +2,7 @@
 module Sass::Media
   # A comma-separated list of queries.
   #
-  #   media_query [ ',' S* media_query ]*
+  #     media_query [ ',' S* media_query ]*
   class QueryList
     # The queries contained in this list.
     #
@@ -62,7 +62,7 @@ module Sass::Media
 
   # A single media query.
   #
-  #   [ [ONLY | NOT]? S* media_type S* | expression ] [ AND S* expression ]*
+  #     [ [ONLY | NOT]? S* media_type S* | expression ] [ AND S* expression ]*
   class Query
     # The modifier for the query.
     #
@@ -201,7 +201,7 @@ module Sass::Media
 
   # Converts an interpolation array to source.
   #
-  # @param [Array<String, Sass::Script::Tree::Node>] The interpolation array to convert.
+  # @param interp [Array<String, Sass::Script::Tree::Node>] The interpolation array to convert.
   # @param options [{Symbol => Object}] An options hash (see {Sass::CSS#initialize}).
   # @return [String]
   def self._interp_to_src(interp, options)

data/lib/sass/plugin/configuration.rb

@@ -1,9 +1,8 @@
-# We keep configuration in its own self-contained file
-# so that we can load it independently in Rails 3,
-# where the full plugin stuff is lazy-loaded.
-
 module Sass
   module Plugin
+    # We keep configuration in its own self-contained file
+    # so that we can load it independently in Rails 3,
+    # where the full plugin stuff is lazy-loaded.
     module Configuration
 
       # Returns the default options for a {Sass::Plugin::Compiler}.

data/lib/sass/script/functions.rb

@@ -119,7 +119,7 @@ module Sass::Script
   # \{#str_index str-index($string, $substring)}
   # : Returns the index where a substring is found in another string or 0 if not found.
   #
-  # \{#str_extract str-slice($string, $start, $end)}
+  # \{#str_slice str-slice($string, $start, $end)}
   # : Extracts a substring of characters from $string
   #
   # \{#to_upper_case to-upper-case($string)}
@@ -171,7 +171,7 @@ module Sass::Script
   # \{#index index($list, $value)}
   # : Returns the position of a value within a list, or false.
   #
-  # \{#list-separator list-separator(#list)}
+  # \{#list_separator list-separator(#list)}
   # : Returns the separator of a list.
   #
   # ## Introspection Functions
@@ -196,7 +196,7 @@ module Sass::Script
   # \{#if if($condition, $if-true, $if-false)}
   # : Returns one of two values, depending on whether or not a condition is true.
   #
-  # \{#unique-id unique-id()}
+  # \{#unique_id unique-id()}
   # : Returns a unique CSS identifier.
   #
   # ## Adding Custom Functions
@@ -221,7 +221,7 @@ module Sass::Script
   # Value objects are also expected to be returned.
   # This means that Ruby values must be unwrapped and wrapped.
   #
-  # Most Value objects support the {Value#value value} accessor for getting
+  # Most Value objects support the {Value::Base#value value} accessor for getting
   # their Ruby values. Color objects, though, must be accessed using
   # {Sass::Script::Value::Color#rgb rgb}, {Sass::Script::Value::Color#red red},
   # {Sass::Script::Value::Color#blue green}, or {Sass::Script::Value::Color#blue
@@ -246,7 +246,7 @@ module Sass::Script
   # ### Caveats
   #
   # When creating new {Value} objects within functions, be aware that it's not
-  # safe to call {Value#to_s #to_s} (or other methods that use the string
+  # safe to call {Value::Base#to_s #to_s} (or other methods that use the string
   # representation) on those objects without first setting {Tree::Node#options=
   # the #options attribute}.
   module Functions
@@ -649,18 +649,21 @@ module Sass::Script
     end
     declare :lightness, [:color]
 
-    # Returns the alpha component (opacity) of a color.
-    # This is 1 unless otherwise specified.
+    # @overload alpha(color)
+    #   Returns the alpha component (opacity) of a color.
+    #   This is 1 unless otherwise specified.
     #
-    # This function also supports the proprietary Microsoft
-    # `alpha(opacity=20)` syntax.
+    #   @param color [Sass::Script::Value::Color]
+    #   @return [Sass::Script::Value::Number]
+    #   @see #opacify
+    #   @see #transparentize
+    #   @raise [ArgumentError] If `color` isn't a color
     #
-    # @overload def alpha(color)
-    # @param color [Sass::Script::Value::Color]
-    # @return [Sass::Script::Value::Number]
-    # @see #opacify
-    # @see #transparentize
-    # @raise [ArgumentError] If `color` isn't a color
+    # @overload alpha(microsoft_string)
+    #   Support for the proprietary Microsoft `alpha(opacity=20)` syntax.
+    #
+    #   @param microsoft_string A special literal representing the
+    #     css-incompatible microsoft syntax
     def alpha(*args)
       if args.all? do |a|
           a.is_a?(Sass::Script::Value::String) && a.type == :identifier &&
@@ -821,10 +824,10 @@ module Sass::Script
     #   adjust-hue(hsl(120, 30%, 90%), 60deg) => hsl(180, 30%, 90%)
     #   adjust-hue(hsl(120, 30%, 90%), 060deg) => hsl(60, 30%, 90%)
     #   adjust-hue(#811, 45deg) => #886a11
-    # @param color [Sass::Script::Value::Color]
-    # @param amount [Sass::Script::Value::Number]
-    # @return [Sass::Script::Value::Color]
-    # @raise [ArgumentError] If `color` isn't a color, or `number` isn't a number
+    # @param color [Sass::Script::Value::Color] The color to adjust.
+    # @param degrees [Sass::Script::Value::Number] The number of degrees to shift the hue.
+    # @return [Sass::Script::Value::Color] The transformed color.
+    # @raise [ArgumentError] If `color` isn't a color, or `degrees` isn't a number
     def adjust_hue(color, degrees)
       assert_type color, :Color
       assert_type degrees, :Number
@@ -867,13 +870,13 @@ module Sass::Script
     #   adjust-color(#102030, $red: -5, $blue: 5) => #0b2035
     #   adjust-color(hsl(25, 100%, 80%), $lightness: -30%, $alpha: -0.4) => hsla(25, 100%, 50%, 0.6)
     # @param color [Sass::Script::Value::Color]
-    # @param red [Sass::Script::Value::Number]
-    # @param green [Sass::Script::Value::Number]
-    # @param blue [Sass::Script::Value::Number]
-    # @param hue [Sass::Script::Value::Number]
-    # @param saturation [Sass::Script::Value::Number]
-    # @param lightness [Sass::Script::Value::Number]
-    # @param alpha [Sass::Script::Value::Number]
+    # @option kwargs [Sass::Script::Value::Number] "red" The amount by which the red component should change.
+    # @option kwargs [Sass::Script::Value::Number] "green" The amount by which the green component should change.
+    # @option kwargs [Sass::Script::Value::Number] "blue" The amount by which the blue component should change.
+    # @option kwargs [Sass::Script::Value::Number] "hue" The number of degrees by which the hue should change.
+    # @option kwargs [Sass::Script::Value::Number] "saturation" The amount by which the saturation should change.
+    # @option kwargs [Sass::Script::Value::Number] "lightness" The amount by which the lightness should change.
+    # @option kwargs [Sass::Script::Value::Number] "alpha" The amount by which the alpha channel should change.
     # @return [Sass::Script::Value::Color]
     # @raise [ArgumentError] if `color` is not a color,
     #   if any keyword argument is not a number,
@@ -937,12 +940,12 @@ module Sass::Script
     #   scale-color(rgb(200, 150, 170), $green: -40%, $blue: 70%) => rgb(200, 90, 229)
     #   scale-color(hsl(200, 70, 80), $saturation: -90%, $alpha: -30%) => hsla(200, 7, 80, 0.7)
     # @param color [Sass::Script::Value::Color]
-    # @param red [Sass::Script::Value::Number]
-    # @param green [Sass::Script::Value::Number]
-    # @param blue [Sass::Script::Value::Number]
-    # @param saturation [Sass::Script::Value::Number]
-    # @param lightness [Sass::Script::Value::Number]
-    # @param alpha [Sass::Script::Value::Number]
+    # @option kwargs [Sass::Script::Value::Number] "red" The amount by which the red component should scale.
+    # @option kwargs [Sass::Script::Value::Number] "green" The amount by which the green component should scale.
+    # @option kwargs [Sass::Script::Value::Number] "blue" The amount by which the blue component should scale.
+    # @option kwargs [Sass::Script::Value::Number] "saturation" The amount by which the saturation should scale.
+    # @option kwargs [Sass::Script::Value::Number] "lightness" The amount by which the lightness should scale.
+    # @option kwargs [Sass::Script::Value::Number] "alpha" The amount by which the alpha channel should scale.
     # @return [Sass::Script::Value::Color]
     # @raise [ArgumentError] if `color` is not a color,
     #   if any keyword argument is not a percentage between 0% and 100%,
@@ -997,13 +1000,13 @@ module Sass::Script
     #   change-color(#102030, $red: 120, $blue: 5) => #782005
     #   change-color(hsl(25, 100%, 80%), $lightness: 40%, $alpha: 0.8) => hsla(25, 100%, 40%, 0.8)
     # @param color [Sass::Script::Value::Color]
-    # @param red [Sass::Script::Value::Number]
-    # @param green [Sass::Script::Value::Number]
-    # @param blue [Sass::Script::Value::Number]
-    # @param hue [Sass::Script::Value::Number]
-    # @param saturation [Sass::Script::Value::Number]
-    # @param lightness [Sass::Script::Value::Number]
-    # @param alpha [Sass::Script::Value::Number]
+    # @option kwargs [Sass::Script::Value::Number] "red" The amount by which the red component should change.
+    # @option kwargs [Sass::Script::Value::Number] "green" The amount by which the green component should change.
+    # @option kwargs [Sass::Script::Value::Number] "blue" The amount by which the blue component should change.
+    # @option kwargs [Sass::Script::Value::Number] "hue" The number of degrees by which the hue should change.
+    # @option kwargs [Sass::Script::Value::Number] "saturation" The amount by which the saturation should change.
+    # @option kwargs [Sass::Script::Value::Number] "lightness" The amount by which the lightness should change.
+    # @option kwargs [Sass::Script::Value::Number] "alpha" The amount by which the alpha channel should change.
     # @return [Sass::Script::Value::Color]
     # @raise [ArgumentError] if `color` is not a color,
     #   if any keyword argument is not a number,
@@ -1688,11 +1691,10 @@ module Sass::Script
     declare :unique_id, []
 
     # This function only exists as a workaround for IE7's [`content:counter`
-    # bug][bug]. It works identically to any other plain-CSS function, except it
+    # bug](http://jes.st/2013/ie7s-css-breaking-content-counter-bug/).
+    # It works identically to any other plain-CSS function, except it
     # avoids adding spaces between the argument commas.
     #
-    # [bug]: http://jes.st/2013/ie7s-css-breaking-content-counter-bug/
-    #
     # @example
     #   counter(item, ".") => counter(item,".")
     def counter(*args)

data/lib/sass/script/lexer.rb

@@ -16,7 +16,7 @@ module Sass
       # `value`: \[`Object`\]
       # : The Ruby object corresponding to the value of the token.
       #
-      # `source_range`: [`Sass::Source::Range`\]
+      # `source_range`: \[`Sass::Source::Range`\]
       # : The range in the source file in which the token appeared.
       #
       # `pos`: \[`Fixnum`\]

data/lib/sass/script/parser.rb

@@ -65,7 +65,7 @@ module Sass
       # Parses a SassScript expression,
       # ending it when it encounters one of the given identifier tokens.
       #
-      # @param [#include?(String)] A set of strings that delimit the expression.
+      # @param tokens [#include?(String)] A set of strings that delimit the expression.
       # @return [Script::Tree::Node] The root node of the parse tree
       # @raise [Sass::SyntaxError] if the expression isn't valid SassScript
       def parse_until(tokens)

data/lib/sass/script/tree/funcall.rb

@@ -161,7 +161,7 @@ module Sass::Script::Tree
       raise Sass::SyntaxError.new("#{message} for `#{name}'")
     end
 
-    # Compass historically overrode this before it changed name to {#to\_value}.
+    # Compass historically overrode this before it changed name to {Funcall#to_value}.
     # We should get rid of it in the future.
     def to_literal(args)
       to_value(args)

data/lib/sass/script/tree/interpolation.rb

@@ -25,12 +25,12 @@ module Sass::Script::Tree
 
     # Interpolation in a property is of the form `before #{mid} after`.
     #
-    # @param before [Node] See {#before}
-    # @param mid [Node] See {#mid}
-    # @param after [Node] See {#after}
-    # @param wb [Boolean] See {#whitespace\_before}
-    # @param wa [Boolean] See {#whitespace\_after}
-    # @param originally_text [Boolean] See {#originally\_text}
+    # @param before [Node] See {Interpolation#before}
+    # @param mid [Node] See {Interpolation#mid}
+    # @param after [Node] See {Interpolation#after}
+    # @param wb [Boolean] See {Interpolation#whitespace_before}
+    # @param wa [Boolean] See {Interpolation#whitespace_after}
+    # @param originally_text [Boolean] See {Interpolation#originally_text}
     def initialize(before, mid, after, wb, wa, originally_text = false)
       @before = before
       @mid = mid

data/lib/sass/script/tree/literal.rb

@@ -11,7 +11,8 @@ module Sass::Script::Tree
 
     # Creates a new literal value.
     #
-    # @param [Sass::Script::Value::Base] see {#value}
+    # @param value [Sass::Script::Value::Base]
+    # @see #value
     def initialize(value)
       @value = value
     end

data/lib/sass/script/value/color.rb

@@ -407,7 +407,7 @@ module Sass::Script::Value
     # : Adds each of the RGB color channels together.
     #
     # {Value}
-    # : See {Value#plus}.
+    # : See {Value::Base#plus}.
     #
     # @param other [Value] The right-hand side of the operator
     # @return [Color] The resulting color
@@ -430,7 +430,7 @@ module Sass::Script::Value
     # : Subtracts each of the other color's RGB color channels from this color's.
     #
     # {Value}
-    # : See {Value#minus}.
+    # : See {Value::Base#minus}.
     #
     # @param other [Value] The right-hand side of the operator
     # @return [Color] The resulting color
@@ -473,7 +473,7 @@ module Sass::Script::Value
     # : Divides each of this color's RGB color channels by the other color's.
     #
     # {Value}
-    # : See {Value#div}.
+    # : See {Value::Base#div}.
     #
     # @param other [Value] The right-hand side of the operator
     # @return [Color] The resulting color

data/lib/sass/script/value/number.rb

@@ -76,7 +76,7 @@ module Sass::Script::Value
     # : Adds this number to each of the RGB color channels.
     #
     # {Value}
-    # : See {Value#plus}.
+    # : See {Value::Base#plus}.
     #
     # @param other [Value] The right-hand side of the operator
     # @return [Value] The result of the operation
@@ -98,7 +98,7 @@ module Sass::Script::Value
     # : Subtracts this number from the other, converting units if possible.
     #
     # {Value}
-    # : See {Value#minus}.
+    # : See {Value::Base#minus}.
     #
     # @param other [Value] The right-hand side of the operator
     # @return [Value] The result of the operation
@@ -154,7 +154,7 @@ module Sass::Script::Value
     # : Divides this number by the other, converting units appropriately.
     #
     # {Value}
-    # : See {Value#div}.
+    # : See {Value::Base#div}.
     #
     # @param other [Value] The right-hand side of the operator
     # @return [Value] The result of the operation
@@ -291,7 +291,6 @@ module Sass::Script::Value
     #   number.is_unit?("px") => true
     #   number.is_unit?(nil) => false
     #
-    # @param number [Number] The number to check
     # @param unit [::String, nil] The unit the number should have or nil if the number should be unitless.
     # @see Number#unitless? The unitless? method may be more readable.
     def is_unit?(unit)

data/lib/sass/selector.rb

@@ -21,8 +21,6 @@ module Sass
     # The base used for calculating selector specificity. The spec says this
     # should be "sufficiently high"; it's extremely unlikely that any single
     # selector sequence will contain 1,000 simple selectors.
-    #
-    # @type [Fixnum]
     SPECIFICITY_BASE = 1_000
 
     # A parent-referencing selector (`&` in Sass).
@@ -318,7 +316,7 @@ module Sass
       # @param namespace [Array<String, Sass::Script::Tree::Node>, nil] See \{#namespace}
       # @param operator [String] The matching operator, e.g. `"="` or `"^="`
       # @param value [Array<String, Sass::Script::Tree::Node>] See \{#value}
-      # @param value [Array<String, Sass::Script::Tree::Node>] See \{#flags}
+      # @param flags [Array<String, Sass::Script::Tree::Node>] See \{#flags}
       def initialize(name, namespace, operator, value, flags)
         @name = name
         @namespace = namespace
@@ -428,8 +426,8 @@ module Sass
       # @return [Selector::Sequence]
       attr_reader :selector
 
-      # @param [String] The name of the pseudoclass
-      # @param [Selector::CommaSequence] The selector argument
+      # @param name [String] The name of the pseudoclass
+      # @param selector [Selector::CommaSequence] The selector argument
       def initialize(name, selector)
         @name = name
         @selector = selector

data/lib/sass/selector/simple_sequence.rb

@@ -21,7 +21,7 @@ module Sass
       # and the generated selector `c.foo.bar.baz` has `{b.bar, c.baz}` as its
       # `sources` set.
       #
-      # This is populated during the {#do_extend} process.
+      # This is populated during the {Sequence#do_extend} process.
       #
       # @return {Set<Sequence>}
       attr_accessor :sources
@@ -125,7 +125,7 @@ module Sass
       # that matches both this selector and the input selector.
       #
       # @param sels [Array<Simple>] A {SimpleSequence}'s {SimpleSequence#members members array}
-      # @param subject [Boolean] Whether the {SimpleSequence} being merged is a subject.
+      # @param other_subject [Boolean] Whether the other {SimpleSequence} being merged is a subject.
       # @return [SimpleSequence, nil] A {SimpleSequence} matching both `sels` and this selector,
       #   or `nil` if this is impossible (e.g. unifying `#foo` and `#bar`)
       # @raise [Sass::SyntaxError] If this selector cannot be unified.
@@ -170,7 +170,7 @@ module Sass
       end
 
       # Return a copy of this simple sequence with `sources` merged into the
-      # {#sources} set.
+      # {SimpleSequence#sources} set.
       #
       # @param sources [Set<Sequence>]
       # @return [SimpleSequence]

data/lib/sass/source/map.rb

@@ -71,7 +71,7 @@ module Sass::Source
     # assumption that the local file system has the same layout as the server.
     #
     # If any source stylesheets use the default filesystem importer, sourcemap
-    # generation will fail unless the ``:sourcemap_path` option is specified.
+    # generation will fail unless the `:sourcemap_path` option is specified.
     # The layout of the local file system is assumed to be the same as the
     # layout of the server for the purposes of linking to source stylesheets
     # that use the filesystem importer.

data/lib/sass/supports.rb

@@ -4,7 +4,7 @@ module Sass::Supports
   class Condition
     # Runs the SassScript in the supports condition.
     #
-    # @param env [Sass::Environment] The environment in which to run the script.
+    # @param environment [Sass::Environment] The environment in which to run the script.
     def perform(environment); Sass::Util.abstract(self); end
 
     # Returns the CSS for this condition.
@@ -133,20 +133,19 @@ module Sass::Supports
 
   # A declaration condition (e.g. `(feature: value)`).
   class Declaration < Condition
-    # The feature name.
-    #
-    # @param [Sass::Script::Tree::Node]
+    # @return [Sass::Script::Tree::Node] The feature name.
     attr_accessor :name
 
-    # The name of the feature after any SassScript has been resolved.
-    # Only set once \{Tree::Visitors::Perform} has been run.
+    # @!attribute resolved_name
+    #   The name of the feature after any SassScript has been resolved.
+    #   Only set once \{Tree::Visitors::Perform} has been run.
     #
-    # @return [String]
+    #   @return [String]
     attr_accessor :resolved_name
 
     # The feature value.
     #
-    # @param [Sass::Script::Tree::Node]
+    # @return [Sass::Script::Tree::Node]
     attr_accessor :value
 
     # The value of the feature after any SassScript has been resolved.
@@ -190,7 +189,7 @@ module Sass::Supports
   class Interpolation < Condition
     # The SassScript expression in the interpolation.
     #
-    # @param [Sass::Script::Tree::Node]
+    # @return [Sass::Script::Tree::Node]
     attr_accessor :value
 
     # The value of the expression after it's been resolved.

data/lib/sass/tree/css_import_node.rb

@@ -10,7 +10,7 @@ module Sass::Tree
     attr_accessor :uri
 
     # The text of the URI being imported after any interpolated SassScript has
-    # been resolved. Only set once \{Tree::Visitors::Perform} has been run.
+    # been resolved. Only set once {Tree::Visitors::Perform} has been run.
     #
     # @return [String]
     attr_accessor :resolved_uri
@@ -22,8 +22,8 @@ module Sass::Tree
     # @return [Array<String, Sass::Script::Tree::Node>]
     attr_accessor :query
 
-    # The media query for this rule, without any unresolved interpolation. It's
-    # only set once {Tree::Node#perform} has been called.
+    # The media query for this rule, without any unresolved interpolation.
+    # It's only set once {Tree::Visitors::Perform} has been run.
     #
     # @return [Sass::Media::QueryList]
     attr_accessor :resolved_query

data/lib/sass/tree/each_node.rb

@@ -10,7 +10,7 @@ module Sass::Tree
     attr_reader :var
 
     # The parse tree for the list.
-    # @param [Script::Tree::Node]
+    # @return [Script::Tree::Node]
     attr_accessor :list
 
     # @param var [String] The name of the loop variable

data/lib/sass/tree/extend_node.rb

@@ -31,7 +31,7 @@ module Sass::Tree
     #   The CSS selector to extend,
     #   interspersed with {Sass::Script::Tree::Node}s
     #   representing `#{}`-interpolation.
-    # @param optional [Boolean] See \{#optional}
+    # @param optional [Boolean] See \{ExtendNode#optional?}
     # @param selector_source_range [Sass::Source::Range] The extended selector source range.
     def initialize(selector, optional, selector_source_range)
       @selector = selector

data/lib/sass/tree/media_node.rb

@@ -16,7 +16,7 @@ module Sass::Tree
     attr_accessor :query
 
     # The media query for this rule, without any unresolved interpolation. It's
-    # only set once {Tree::Node#perform} has been called.
+    # only set once {Tree::Visitors::Perform} has been run.
     #
     # @return [Sass::Media::QueryList]
     attr_accessor :resolved_query

data/lib/sass/tree/return_node.rb

@@ -5,7 +5,8 @@ module Sass
     # @see Sass::Tree
     class ReturnNode < Node
       # The expression to return.
-      # @type [Script::Tree::Node]
+      #
+      # @return [Script::Tree::Node]
       attr_accessor :expr
 
       # @param expr [Script::Tree::Node] The expression to return

data/lib/sass/tree/rule_node.rb

@@ -19,7 +19,8 @@ module Sass::Tree
     # The CSS selector for this rule,
     # without any unresolved interpolation
     # but with parent references still intact.
-    # It's only set once {Tree::Node#perform} has been called.
+    # It's only set once {Tree::Visitors::Perform} has been run.
+    #
     #
     # @return [Selector::CommaSequence]
     attr_accessor :parsed_rules

data/lib/sass/tree/trace_node.rb

@@ -7,6 +7,7 @@ module Sass::Tree
   # @see Sass::Tree
   class TraceNode < Node
     # The name of the trace entry to add.
+    #
     # @return [String]
     attr_reader :name
 
@@ -19,7 +20,7 @@ module Sass::Tree
 
     # Initializes this node from an existing node.
     # @param name [String] The name of the trace entry to add.
-    # @param mixin [Node] The node to copy information from.
+    # @param node [Node] The node to copy information from.
     # @return [TraceNode]
     def self.from_node(name, node)
       trace = new(name)

data/lib/sass/tree/visitors/cssize.rb

@@ -94,7 +94,7 @@ class Sass::Tree::Visitors::Cssize < Sass::Tree::Visitors::Base
   end
 
   # A simple struct wrapping up information about a single `@extend` instance. A
-  # single [ExtendNode] can have multiple Extends if either the parent node or
+  # single {ExtendNode} can have multiple Extends if either the parent node or
   # the extended selector is a comma sequence.
   #
   # @attr extender [Sass::Selector::Sequence]

data/lib/sass/tree/visitors/to_css.rb

@@ -1,7 +1,7 @@
 # A visitor for converting a Sass tree into CSS.
 class Sass::Tree::Visitors::ToCss < Sass::Tree::Visitors::Base
   # The source mapping for the generated CSS file. This is only set if
-  # `build_source_mapping` is passed to the constructor and \{#render} has been
+  # `build_source_mapping` is passed to the constructor and \{Sass::Engine#render} has been
   # run.
   attr_reader :source_mapping
 

data/lib/sass/util.rb

@@ -235,7 +235,7 @@ module Sass
     end
 
     # Performs the equivalent of `enum.group_by.to_a`, but with a guaranteed
-    # order. Unlike [#hash_to_a], the resulting order isn't sorted key order;
+    # order. Unlike {Util#hash_to_a}, the resulting order isn't sorted key order;
     # instead, it's the same order as `#group_by` has under Ruby 1.9 (key
     # appearance order).
     #
@@ -259,7 +259,7 @@ module Sass
 
     # Returns a sub-array of `minuend` containing only elements that are also in
     # `subtrahend`. Ensures that the return value has the same order as
-    # `minuend`, even on Rubinius where that's not guaranteed by {Array#-}.
+    # `minuend`, even on Rubinius where that's not guaranteed by `Array#-`.
     #
     # @param minuend [Array]
     # @param subtrahend [Array]
@@ -273,7 +273,7 @@ module Sass
     # Returns a string description of the character that caused an
     # `Encoding::UndefinedConversionError`.
     #
-    # @param [Encoding::UndefinedConversionError]
+    # @param e [Encoding::UndefinedConversionError]
     # @return [String]
     def undefined_conversion_error_char(e)
       # Rubinius (as of 2.0.0.rc1) pre-quotes the error character.

data/lib/sass/version.rb

@@ -14,7 +14,7 @@ module Sass
     # The `:name` key has the name of the version.
     # The `:string` key contains a human-readable string representation of the version.
     # The `:number` key is the major, minor, and teeny keys separated by periods.
-    # The `:date` key, which is not guaranteed to be defined, is the [DateTime] at which this release was cut.
+    # The `:date` key, which is not guaranteed to be defined, is the `DateTime` at which this release was cut.
     # If Sass is checked out from Git, the `:rev` key will have the revision hash.
     # For example:
     #

metadata

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification 
 name: sass
 version: !ruby/object:Gem::Version 
-  hash: 592302731
+  hash: 592302725
   prerelease: 6
   segments: 
   - 3
   - 3
   - 0
   - alpha
-  - 195
-  version: 3.3.0.alpha.195
+  - 196
+  version: 3.3.0.alpha.196
 platform: ruby
 authors: 
 - Nathan Weizenbaum
@@ -19,7 +19,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2013-06-19 00:00:00 -04:00
+date: 2013-07-02 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -94,13 +94,14 @@ files:
 - lib/sass/environment.rb
 - lib/sass/error.rb
 - lib/sass/exec.rb
+- lib/sass/media.rb
 - lib/sass/importers.rb
 - lib/sass/importers/base.rb
 - lib/sass/importers/filesystem.rb
 - lib/sass/logger.rb
 - lib/sass/logger/base.rb
 - lib/sass/logger/log_level.rb
-- lib/sass/media.rb
+- lib/sass/util.rb
 - lib/sass/plugin.rb
 - lib/sass/plugin/compiler.rb
 - lib/sass/plugin/configuration.rb
@@ -152,7 +153,9 @@ files:
 - lib/sass/selector/simple_sequence.rb
 - lib/sass/shared.rb
 - lib/sass/supports.rb
-- lib/sass/util.rb
+- lib/sass/source/map.rb
+- lib/sass/source/position.rb
+- lib/sass/source/range.rb
 - lib/sass/tree/charset_node.rb
 - lib/sass/tree/comment_node.rb
 - lib/sass/tree/content_node.rb
@@ -187,9 +190,6 @@ files:
 - lib/sass/tree/visitors/to_css.rb
 - lib/sass/tree/warn_node.rb
 - lib/sass/tree/while_node.rb
-- lib/sass/source/map.rb
-- lib/sass/source/position.rb
-- lib/sass/source/range.rb
 - lib/sass/util/multibyte_string_scanner.rb
 - lib/sass/util/subset_map.rb
 - lib/sass/version.rb