Update README and bump dependencies

Author: mgreter

Changes

@@ -1,7 +1,9 @@
 CSS::Sass (3.3.5)
 
   * Fix spec runner to pass on linux (unicode issue)
+  * Fix broken unicode test comparing on some systems
   * Add missing test dependency in meta files (YAML::XS)
+  * Update README for Module::Build to ExtUtils::MM switch
 
 CSS::Sass (3.3.4)
 

README.md

@@ -4,8 +4,8 @@ CSS::Sass
 ### Compile .scss and .sass files using libsass
 
 CSS::Sass provides a perl interface to [libsass][1], a fairly complete Sass
-compiler written in C++.  It is currently somewhere around ruby sass 3.2/3.3
-feature parity and heading towards 3.4. It can compile .scss and .sass files.
+compiler written in C++. It is currently around ruby sass 3.3/3.4 feature parity and
+heading towards full 3.4 compatibility. It can compile .scss and .sass files.
 
 [1]: https://github.com/sass/libsass
 
@@ -16,14 +16,40 @@ Installation
 [![Coverage Status](https://img.shields.io/coveralls/sass/perl-libsass.svg)](https://coveralls.io/r/sass/perl-libsass?branch=master)
 [![CPAN version](https://badge.fury.io/pl/CSS-Sass.svg)](http://badge.fury.io/pl/CSS-Sass)
 
-To install this module type the following:
+Manual installation:
+```bash
+  git clone https://github.com/sass/libsass
+  cd libsass
+  perl Makefile.PL
+  make verbose=1
+  make test verbose=1
+  make install verbose=1
+```
+
+Standard CPAN:
+```bash
+  cpan CSS::Sass
+```
+
+CPAN-Minus*:
+```bash
+  cpanm CSS::Sass
+```
+
+CPAN-Minus* directly via github:
+```bash
+  cpanm https://github.com/sass/perl-libsass/archive/latest.tar.gz
+```
 
-    perl Build.PL
-    ./Build verbose=1
-    ./Build test verbose=1
-    ./Build install verbose=1
+(*) CPAN-Minus may not be installed by default, but there is a good
+chance your distribution has a package for it:
+```bash
+  # example for ubuntu:
+  apt install cpanminus
+```
 
-On windows you may need to install [Strawberry Perl](http://strawberryperl.com/).
+On windows I recommend [Strawberry Perl](http://strawberryperl.com/).
+You then also need to use `dmake` instead of `make` for manual installs.
 
 Documentation
 -------------
@@ -40,14 +66,6 @@ Or view [converted markdown version][1]
 
 [1]: https://github.com/sass/perl-libsass/blob/master/lib/CSS/Sass.md
 
-Dependencies
-------------
-
-This module requires these other modules and libraries:
-
-  * Module::Build
-  * Test::More
-
 Command line utility
 --------------------
 

lib/CSS/Sass.md

@@ -74,8 +74,8 @@ CSS::Sass - Compile .scss files using libsass
 # DESCRIPTION
 
 CSS::Sass provides a perl interface to libsass, a fairly complete Sass
-compiler written in C++. It is currently somewhere around ruby sass 3.3/3.4
-feature parity and heading towards 3.4. It can compile .scss and .sass files.
+compiler written in C++. It is currently around ruby sass 3.3/3.4 feature parity and
+heading towards full 3.4 compatibility. It can compile .scss and .sass files.
 
 # OBJECT ORIENTED INTERFACE
 
@@ -207,7 +207,7 @@ feature parity and heading towards 3.4. It can compile .scss and .sass files.
 - `plugin_paths`
 
     This is an arrayref that holds a list of paths to search for third-party
-    plugins. It will automatically load any <dll> or <so> library within that
+    plugins. It will automatically load any &lt;dll> or &lt;so> library within that
     directory. This is currently a highly experimental libsass feature!
 
 - `dont_die`
@@ -372,8 +372,8 @@ feature parity and heading towards 3.4. It can compile .scss and .sass files.
 
 # AUTHOR
 
-David Caldwell <[email protected]>  
-Marcel Greter <[email protected]>
+David Caldwell &lt;[email protected]>  
+Marcel Greter &lt;[email protected]>
 
 # LICENSE
 

lib/CSS/Sass.pm

@@ -273,8 +273,8 @@ CSS::Sass - Compile .scss files using libsass
 =head1 DESCRIPTION
 
 CSS::Sass provides a perl interface to libsass, a fairly complete Sass
-compiler written in C++. It is currently somewhere around ruby sass 3.3/3.4
-feature parity and heading towards 3.4. It can compile .scss and .sass files.
+compiler written in C++. It is currently around ruby sass 3.3/3.4 feature parity and
+heading towards full 3.4 compatibility. It can compile .scss and .sass files.
 
 =head1 OBJECT ORIENTED INTERFACE
 

lib/CSS/Sass/Value.md

@@ -1,83 +1,83 @@
 # NAME
 
-CSS::Sass::Type - Data Types for custom Sass Functions
+CSS::Sass::Value - Data Types for custom Sass Functions
 
 # Mapping `Sass_Values` to perl data structures
 
 You can use `maps` and `lists` like normal `hash` or `array` references. Lists
 can have two different separators used for stringification. This is detected by
-checking if the object is derived from `CSS::Sass::Type::List::Space`. The default
-is a comma separated list, which you get by instantiating `CSS::Sass::Type::List`
-or `CSS::Sass::Type::List::Comma`.
-
-    my $null = CSS::Sass::Type->new(undef); # => 'null'
-    my $number = CSS::Sass::Type->new(42.35); # => 42.35
-    my $string = CSS::Sass::Type->new("foobar"); # => 'foobar'
-    my $map = CSS::Sass::Type->new({ key => "foobar" }); # 'key: foobar'
-    my $list = CSS::Sass::Type->new([ "foo", 42, "bar" ]); # 'foo, 42, bar'
-    my $space = CSS::Sass::Type::List::Space->new("foo", "bar"); # 'foo bar'
-    my $comma = CSS::Sass::Type::List::Comma->new("foo", "bar"); # 'foo, bar'
+checking if the object is derived from `CSS::Sass::Value::List::Space`. The default
+is a comma separated list, which you get by instantiating `CSS::Sass::Value::List`
+or `CSS::Sass::Value::List::Comma`.
+
+    my $null = CSS::Sass::Value->new(undef); # => 'null'
+    my $number = CSS::Sass::Value->new(42.35); # => 42.35
+    my $string = CSS::Sass::Value->new("foobar"); # => 'foobar'
+    my $map = CSS::Sass::Value->new({ key => "foobar" }); # 'key: foobar'
+    my $list = CSS::Sass::Value->new([ "foo", 42, "bar" ]); # 'foo, 42, bar'
+    my $space = CSS::Sass::Value::List::Space->new("foo", "bar"); # 'foo bar'
+    my $comma = CSS::Sass::Value::List::Comma->new("foo", "bar"); # 'foo, bar'
 
 You can also return these native perl types from custom functions. They will
-automatically be upgraded to real `CSS::Sass::Type` objects. All types
+automatically be upgraded to real `CSS::Sass::Value` objects. All types
 overload the `stringify` and `eq` operators (so far).
 
-## CSS::Sass::Type
+## CSS::Sass::Value
 
 Acts as a base class for all other types and is mainly an abstract class.
 It only implements a generic constructor, which accepts native perl data types
-(undef, numbers, strings, array-refs and hash-refs) and `CSS::Sass::Type` objects.
+(undef, numbers, strings, array-refs and hash-refs) and `CSS::Sass::Value` objects.
 
-## CSS::Sass::Type::Null
+## CSS::Sass::Value::Null
 
-    my $null = CSS::Sass::Type::Null->new;
+    my $null = CSS::Sass::Value::Null->new;
     my $string = "$null"; # eq 'null'
     my $value = $null->value; # == undef
 
-## CSS::Sass::Type::Boolean
+## CSS::Sass::Value::Boolean
 
-    my $bool = CSS::Sass::Type::Boolean->new(42);
+    my $bool = CSS::Sass::Value::Boolean->new(42);
     my $string = "$bool"; # eq 'true'
     my $value = $bool->value; # == 1
 
-## CSS::Sass::Type::Number
+## CSS::Sass::Value::Number
 
-    my $number = CSS::Sass::Type::Boolean->new(42, 'px');
+    my $number = CSS::Sass::Value::Boolean->new(42, 'px');
     my $string = "$number"; # eq '42px'
     my $value = $number->value; # == 42
     my $unit = $number->unit; # eq 'px'
 
-## CSS::Sass::Type::String
+## CSS::Sass::Value::String
 
-    my $string = CSS::Sass::Type->new("foo bar"); # => "foo bar"
+    my $string = CSS::Sass::Value->new("foo bar"); # => "foo bar"
     my $quoted = "$string"; # eq '"foo bar"'
     my $unquoted = $string->value; # eq 'foo bar'
 
-## CSS::Sass::Type::Color
+## CSS::Sass::Value::Color
 
-    my $color = CSS::Sass::Type::Color->new(64, 128, 32, 0.25);
+    my $color = CSS::Sass::Value::Color->new(64, 128, 32, 0.25);
     my $string = "$color"; # eq 'rgba(64, 128, 32, 0.25)'
     my $r = $color->r; # == 64
     my $g = $color->g; # == 128
     my $b = $color->b; # == 32
     my $a = $color->a; # == 0.25
 
-## CSS::Sass::Type::Map
+## CSS::Sass::Value::Map
 
-    my $map = CSS::Sass::Type::Map->new(key => 'value');
-    my $string = "$map"; # eq 'key: value'
-    my $value = $map->{'key'}; # eq 'value'
+    my $map = CSS::Sass::Value::Map->new(key => 'value');
+    my $string = "$map"; # eq 'key: "value"'
+    my $value = $map->{'key'}; # eq '"value"'
 
-## CSS::Sass::Type::List::Comma
+## CSS::Sass::Value::List::Comma
 
-    my $list = CSS::Sass::Type::List::Comma->new('foo', 'bar');
-    my $string = "$list"; # eq 'foo, bar'
+    my $list = CSS::Sass::Value::List::Comma->new('foo', 'bar');
+    my $string = "$list"; # eq '"foo", "bar"'
     my $value = $list->[0]; # eq 'foo'
 
-## CSS::Sass::Type::List::Space
+## CSS::Sass::Value::List::Space
 
-    my $list = CSS::Sass::Type::List::Space->new('foo', 'bar');
-    my $string = "$list"; # eq 'foo bar'
+    my $list = CSS::Sass::Value::List::Space->new('foo', 'bar');
+    my $string = "$list"; # eq '"foo" "bar"'
     my $value = $list->[-1]; # eq 'bar'
 
 # SEE ALSO
@@ -86,8 +86,8 @@ It only implements a generic constructor, which accepts native perl data types
 
 # AUTHOR
 
-David Caldwell <[email protected]>  
-Marcel Greter <[email protected]>
+David Caldwell &lt;[email protected]>  
+Marcel Greter &lt;[email protected]>
 
 # LICENSE
 

lib/CSS/Sass/Value.pm

@@ -423,7 +423,7 @@ L<CSS::Sass>
 
 =head1 AUTHOR
 
-David Caldwell E<lt>[email protected]E<gt>
+David Caldwell E<lt>[email protected]E<gt>  
 Marcel Greter E<lt>[email protected]E<gt>
 
 =head1 LICENSE