Added documentation for ordered hashes

Author: adamkennedy

Changes

@@ -1,5 +1,10 @@
 Revision history for Perl extension CSS-Tiny
 
+1.19 Fri 3 Sep 2010
+- No functional changes
+- Resolved RT #59037: CSS::Tiny reorders rules
+- The use of Tie::IxHash to achieve ordering is now documented
+
 1.18 Fri 3 Sep 2010
 - Resolved RT #60776: Parsing of multiple whitespace selectors
 - Added test script specifically for RT regression tests

Makefile.PL

@@ -2,7 +2,7 @@ use strict;
 use vars qw{$VERSION};
 BEGIN {
 require 5.004;
-$VERSION = '1.18';
+$VERSION = '1.19';
 }
 use ExtUtils::MakeMaker;
 

lib/CSS/Tiny.pm

@@ -5,7 +5,7 @@ package CSS::Tiny;
 use strict;
 BEGIN {
 require 5.004;
-$CSS::Tiny::VERSION = '1.18';
+$CSS::Tiny::VERSION = '1.19';
 $CSS::Tiny::errstr = '';
 }
 
@@ -285,6 +285,27 @@ so that it can be dropped directly onto an XHTML page.
 When an error occurs, you can retrieve the error message either from the
 C<$CSS::Tiny::errstr> variable, or using the C<errstr> method.
 
+=head1 CAVEATS
+
+=head2 CSS Rule Order
+
+While the order of rules in CSS is important, this is one of the features
+that is sacrificed to keep things small and dependency-free. If you need
+to preserve order yourself, we recommend that you upgrade to the more
+powerful L<CSS> module.
+
+If this is not possible in your case, alternatively it can be done with the
+help of another module such as L<Tie::IxHash>:
+
+ my $css = CSS::Tiny->new;
+ tie %$css, 'Tie::IxHash';
+ $css->read('style.css');
+
+Note: You will also need to remember to add the additional dependency to
+your code or module in this case.
+
+=back
+
 =head1 SUPPORT
 
 Bugs should be reported via the CPAN bug tracker at