From 09269cb684c37be6d2ac5641b228eb9b76beab8a Mon Sep 17 00:00:00 2001
From: "Eevee (Alex Munroe)" <eevee.git@veekun.com>
Date: Mon, 7 Oct 2013 17:31:38 -0700
Subject: Add new string and list functions from Sass 3.3; update docs re 3.3.

---
 docs/back-matter.rst |  1 +
 docs/syntax.rst      | 30 +++++++++++++++++++++++++++---
 docs/usage.rst       |  4 ++--
 3 files changed, 30 insertions(+), 5 deletions(-)

(limited to 'docs')

diff --git a/docs/back-matter.rst b/docs/back-matter.rst
index 1fcdb8d..f2c98fc 100644
--- a/docs/back-matter.rst
+++ b/docs/back-matter.rst
@@ -113,6 +113,7 @@ New features
 * Python 3 support.  As a result, Python 2.5 no longer works; whether this is a bug or a feature is not yet clear.
 * It's possible to write custom Sass functions in Python, though the API for this is not final.
 * Experimental support for the map type and destructuring ``@each``, both unreleased additions to the Ruby project.
+* Support for the new string and list functions in Sass 3.3.
 * Added ``background-brushed``.
 
 Backwards-incompatible changes
diff --git a/docs/syntax.rst b/docs/syntax.rst
index 4cd21c9..26954d2 100644
--- a/docs/syntax.rst
+++ b/docs/syntax.rst
@@ -7,8 +7,9 @@ pyScss syntax
 Supported Sass features
 =======================
 
-pyScss is mostly compatible with Sass 3.2.  The canonical syntax reference is
-in the Sass documentation:
+pyScss is mostly compatible with Sass 3.2 and has partial support for the
+upcoming Sass 3.3.  The canonical syntax reference is in the Sass
+documentation:
 http://sass-lang.com/docs/yardoc/file.SASS_REFERENCE.html
 
 
@@ -22,7 +23,8 @@ for the SASS (YAML-like) syntax.
 Built-in functions
 ------------------
 
-All of the functions described in `the Sass documentation`_ are supported.
+All of the Sass 3.2 functions described in `the Sass documentation`_ are
+supported.
 
 .. _the Sass documentation: <http://sass-lang.com/docs/yardoc/Sass/Script/Functions.html
 
@@ -460,3 +462,25 @@ considered a bug.
 
 The ``@while`` construct doesn't work at all and will be left intact in the
 output, like any other unrecognized ``@``-rule.
+
+
+CLI
+---
+
+pyScss's command-line arguments are not entirely compatible with those of the
+reference compiler.
+
+
+Sass 3.3
+--------
+
+The following Sass 3.3 improvements are not yet implemented, but are planned
+for the near future:
+
+* Use of ``&`` in expressions.
+* ``@at-root``
+* Source map support.
+* Using ``...`` multiple times in a function call, or passing a map of
+  arguments with ``...``.  Likewise, ``keywords()`` is not implemented.
+* ``unique-id()``, ``call()``, and the various ``*-exists()`` functions are not
+  implemented.
diff --git a/docs/usage.rst b/docs/usage.rst
index 364770a..5287298 100644
--- a/docs/usage.rst
+++ b/docs/usage.rst
@@ -4,8 +4,8 @@ Installation and usage
 Installation
 ------------
 
-pyScss requires only Python 2.5 or later, including Python 3.x.  Install with
-pip::
+pyScss requires only Python 2.5 or later, including Python 3.x.  PyPy is also
+known to work.  Install with pip::
 
     pip install pyScss
 
-- 
cgit v1.2.1