sassc 2.0.1 → 2.1.0.pre1

data/ext/libsass/docs/api-value.md

@@ -1,154 +0,0 @@
-`Sass_Values` are used to pass values and their types between the implementer
-and LibSass. Sass knows various different value types (including nested arrays
-and hash-maps). If you implement a binding to another programming language, you
-have to find a way to [marshal][1] (convert) `Sass_Values` between the target
-language and C. `Sass_Values` are currently only used by custom functions, but
-it should also be possible to use them without a compiler context.
-
-[1]: https://en.wikipedia.org/wiki/Marshalling_%28computer_science%29
-
-### Basic Usage
-
-```C
-#include "sass/values.h"
-```
-
-```C
-// Type for Sass values
-enum Sass_Tag {
-  SASS_BOOLEAN,
-  SASS_NUMBER,
-  SASS_COLOR,
-  SASS_STRING,
-  SASS_LIST,
-  SASS_MAP,
-  SASS_NULL,
-  SASS_ERROR,
-  SASS_WARNING
-};
-
-// Tags for denoting Sass list separators
-enum Sass_Separator {
-  SASS_COMMA,
-  SASS_SPACE,
-  // only used internally to represent a hash map before evaluation
-  // otherwise we would be too early to check for duplicate keys
-  SASS_HASH
-};
-
-// Value Operators
-enum Sass_OP {
-  AND, OR,                   // logical connectives
-  EQ, NEQ, GT, GTE, LT, LTE, // arithmetic relations
-  ADD, SUB, MUL, DIV, MOD,   // arithmetic functions
-  NUM_OPS                    // so we know how big to make the op table
-};
-```
-
-### Sass Value API
-
-```C
-// Forward declaration
-union Sass_Value;
-
-// Creator functions for all value types
-union Sass_Value* sass_make_null    (void);
-union Sass_Value* sass_make_boolean (bool val);
-union Sass_Value* sass_make_string  (const char* val);
-union Sass_Value* sass_make_qstring (const char* val);
-union Sass_Value* sass_make_number  (double val, const char* unit);
-union Sass_Value* sass_make_color   (double r, double g, double b, double a);
-union Sass_Value* sass_make_list    (size_t len, enum Sass_Separator sep, bool is_bracketed);
-union Sass_Value* sass_make_map     (size_t len);
-union Sass_Value* sass_make_error   (const char* msg);
-union Sass_Value* sass_make_warning (const char* msg);
-
-// Generic destructor function for all types
-// Will release memory of all associated Sass_Values
-// Means we will delete recursively for lists and maps
-void sass_delete_value (union Sass_Value* val);
-
-// Make a deep cloned copy of the given sass value
-union Sass_Value* sass_clone_value (const union Sass_Value* val);
-
-// Stringify a Sass_Values and also return the result as a Sass_Value (of type STRING)
-union Sass_Value* sass_value_stringify (const union Sass_Value* a, bool compressed, int precision);
-
-// Execute an operation for two Sass_Values and return the result as a Sass_Value too
-union Sass_Value* sass_value_op (enum Sass_OP op, const union Sass_Value* a, const union Sass_Value* b);
-
-// Return the sass tag for a generic sass value
-// Check is needed before accessing specific values!
-enum Sass_Tag sass_value_get_tag (const union Sass_Value* v);
-
-// Check value to be of a specific type
-// Can also be used before accessing properties!
-bool sass_value_is_null (const union Sass_Value* v);
-bool sass_value_is_number (const union Sass_Value* v);
-bool sass_value_is_string (const union Sass_Value* v);
-bool sass_value_is_boolean (const union Sass_Value* v);
-bool sass_value_is_color (const union Sass_Value* v);
-bool sass_value_is_list (const union Sass_Value* v);
-bool sass_value_is_map (const union Sass_Value* v);
-bool sass_value_is_error (const union Sass_Value* v);
-bool sass_value_is_warning (const union Sass_Value* v);
-
-// Getters and setters for Sass_Number
-double sass_number_get_value (const union Sass_Value* v);
-void sass_number_set_value (union Sass_Value* v, double value);
-const char* sass_number_get_unit (const union Sass_Value* v);
-void sass_number_set_unit (union Sass_Value* v, char* unit);
-
-// Getters and setters for Sass_String
-const char* sass_string_get_value (const union Sass_Value* v);
-void sass_string_set_value (union Sass_Value* v, char* value);
-bool sass_string_is_quoted(const union Sass_Value* v);
-void sass_string_set_quoted(union Sass_Value* v, bool quoted);
-
-// Getters and setters for Sass_Boolean
-bool sass_boolean_get_value (const union Sass_Value* v);
-void sass_boolean_set_value (union Sass_Value* v, bool value);
-
-// Getters and setters for Sass_Color
-double sass_color_get_r (const union Sass_Value* v);
-void sass_color_set_r (union Sass_Value* v, double r);
-double sass_color_get_g (const union Sass_Value* v);
-void sass_color_set_g (union Sass_Value* v, double g);
-double sass_color_get_b (const union Sass_Value* v);
-void sass_color_set_b (union Sass_Value* v, double b);
-double sass_color_get_a (const union Sass_Value* v);
-void sass_color_set_a (union Sass_Value* v, double a);
-
-// Getter for the number of items in list
-size_t sass_list_get_length (const union Sass_Value* v);
-// Getters and setters for Sass_List
-enum Sass_Separator sass_list_get_separator (const union Sass_Value* v);
-void sass_list_set_separator (union Sass_Value* v, enum Sass_Separator value);
-bool sass_list_get_is_bracketed (const union Sass_Value* v);
-void sass_list_set_is_bracketed (union Sass_Value* v, bool value);
-// Getters and setters for Sass_List values
-union Sass_Value* sass_list_get_value (const union Sass_Value* v, size_t i);
-void sass_list_set_value (union Sass_Value* v, size_t i, union Sass_Value* value);
-
-// Getter for the number of items in map
-size_t sass_map_get_length (const union Sass_Value* v);
-// Getters and setters for Sass_Map keys and values
-union Sass_Value* sass_map_get_key (const union Sass_Value* v, size_t i);
-void sass_map_set_key (union Sass_Value* v, size_t i, union Sass_Value*);
-union Sass_Value* sass_map_get_value (const union Sass_Value* v, size_t i);
-void sass_map_set_value (union Sass_Value* v, size_t i, union Sass_Value*);
-
-// Getters and setters for Sass_Error
-char* sass_error_get_message (const union Sass_Value* v);
-void sass_error_set_message (union Sass_Value* v, char* msg);
-
-// Getters and setters for Sass_Warning
-char* sass_warning_get_message (const union Sass_Value* v);
-void sass_warning_set_message (union Sass_Value* v, char* msg);
-```
-
-### More links
-
-- [Sass Value Example](api-value-example.md)
-- [Sass Value Internal](api-value-internal.md)
-

data/ext/libsass/docs/build-on-darwin.md

@@ -1,27 +0,0 @@
-To install LibSass, make sure the OS X build tools are installed:
-
-    xcode-select --install
-
-## Homebrew
-
-To install homebrew, see [http://brew.sh](http://brew.sh)
-
-    ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
-
-You can install the latest version of LibSass quite easily with brew.
-
-    brew install --HEAD libsass
-
-To update this, do:
-
-    brew reinstall --HEAD libsass
-
-Brew will build static and shared libraries, and a `libsass.pc` file in `/usr/local/lib/pkgconfig`.
-
-To use `libsass.pc`, make sure this path is in your `PKG_CONFIG_PATH`
-
-    export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig
-
-## Manually
-
-See the linux instructions [Building-with-autotools](build-with-autotools.md) or [Building-with-makefiles](build-with-makefiles.md)

data/ext/libsass/docs/build-on-gentoo.md

@@ -1,55 +0,0 @@
-Here are two ebuilds to compile LibSass and sassc on gentoo linux. If you do not know how to use these ebuilds, you should probably read the gentoo wiki page about [portage overlays](http://wiki.gentoo.org/wiki/Overlay).
-
-## www-misc/libsass/libsass-9999.ebuild
-```ebuild
-EAPI=4
-
-inherit eutils git-2 autotools
-
-DESCRIPTION="A C/C++ implementation of a Sass compiler."
-HOMEPAGE="http://libsass.org/"
-EGIT_PROJECT='libsass'
-EGIT_REPO_URI="https://github.com/sass/libsass.git"
-LICENSE="MIT"
-SLOT="0"
-KEYWORDS=""
-IUSE=""
-DEPEND=""
-RDEPEND="${DEPEND}"
-DEPEND="${DEPEND}"
-
-pkg_pretend() {
-    # older gcc is not supported
-    local major=$(gcc-major-version)
-    local minor=$(gcc-minor-version)
-    [[ "${MERGE_TYPE}" != "binary" && ( $major > 4 || ( $major == 4 && $minor < 5 ) ) ]] && \
-        die "Sorry, but gcc earlier than 4.5 will not work for LibSass."
-}
-
-src_prepare() {
-   eautoreconf
-}
-```
-
-## www-misc/sassc/sassc-9999.ebuild
-```ebuild
-EAPI=4
-
-inherit eutils git-2 autotools
-
-DESCRIPTION="Command Line Tool for LibSass."
-HOMEPAGE="http://libsass.org/"
-EGIT_PROJECT='sassc'
-EGIT_REPO_URI="https://github.com/sass/sassc.git"
-LICENSE="MIT"
-SLOT="0"
-KEYWORDS=""
-IUSE=""
-DEPEND="www-misc/libsass"
-RDEPEND="${DEPEND}"
-DEPEND="${DEPEND}"
-
-src_prepare() {
-   eautoreconf
-}
-```

data/ext/libsass/docs/build-on-windows.md

@@ -1,139 +0,0 @@
-We support builds via MingGW and via Visual Studio Community 2013.
-Both should be considered experimental (MinGW was better tested)!
-
-## Building via MingGW (makefiles)
-
-First grab the latest [MinGW for windows][1] installer. Once it is installed, you can click on continue or open the Installation Manager via `bin\mingw-get.exe`.
-
-You need to have the following components installed:
-![Visualization of components installed in the interface](https://cloud.githubusercontent.com/assets/282293/5525466/947bf396-89e6-11e4-841d-4aa916f14de1.png)
-
-Next we need to install [git for windows][2]. You probably want to check the option to add it to the global path, but you do not need to install the unix tools.
-
-If you want to run the spec test-suite you also need [ruby][3] and a few gems available. Grab the [latest installer][3] and make sure to add it the global path. Then install the missing gems:
-
-```bash
-gem install minitest
-```
-
-### Mount the mingw root directory
-
-As mentioned in the [MinGW Getting Started](http://www.mingw.org/wiki/Getting_Started#toc5) guide, you should edit `C:\MinGW\msys\1.0\etc\fstab` to contain the following line:
-
-```
-C:\MinGW   /mingw
-```
-
-### Starting a "MingGW" console
-
-Create a batch file with this content:
-```bat
-@echo off
-set PATH=C:\MinGW\bin;%PATH%
-REM only needed if not already available
-set PATH=%PROGRAMFILES%\git\bin;%PATH%
-REM C:\MinGW\msys\1.0\msys.bat
-cmd
-```
-
-Execute it and make sure these commands can be called: `git`, `mingw32-make`, `rm` and `gcc`! Once this is all set, you should be ready to compile `libsass`!
-
-### Get the sources
-
-```bash
-# using git is preferred
-git clone https://github.com/sass/libsass.git
-# only needed for sassc and/or testsuite
-git clone https://github.com/sass/sassc.git libsass/sassc
-git clone https://github.com/sass/sass-spec.git libsass/sass-spec
-```
-
-### Decide for static or shared library
-
-`libsass` can be built and linked as a `static` or as a `shared` library. The default is `static`. To change it you can set the `BUILD` environment variable:
-
-```bat
-set BUILD="shared"
-```
-
-### Compile the library
-```bash
-mingw32-make -C libsass
-```
-
-### Results can be found in
-```bash
-$ ls libsass/lib
-libsass.a  libsass.dll  libsass.so
-```
-
-### Run the spec test-suite
-```bash
-mingw32-make -C libsass test_build
-```
-
-## Building via MingGW 64bit (makefiles)
-Building libass to dll on window 64bit.
-
-+ downloads  [MinGW64 for windows7 64bit](http://sourceforge.net/projects/mingw-w64/files/Toolchains%20targetting%20Win64/Personal%20Builds/mingw-builds/4.9.2/threads-win32/seh/x86_64-4.9.2-release-win32-seh-rt_v3-rev0.7z/download) , and unzip to "C:\mingw64".
-
-+ Create a batch file with this content:
-
-```bat
-@echo off
-set PATH=C:\mingw64\bin;%PATH%
-set CC=gcc
-REM only needed if not already available
-set PATH=%PROGRAMFILES%\Git\bin;%PATH%
-REM C:\MinGW\msys\1.0\msys.bat
-cmd
-```
-
-+ By default , mingw64 dll will depends on "​m​i​n​g​w​m​1​0​.​d​l​l​、​ ​l​i​b​g​c​c​_​s​_​d​w​2​-​1​.​d​l​l​" , we can modify Makefile to fix this:(add "-static")
-
-``` bash
-lib/libsass.dll: $(COBJECTS) $(OBJECTS) $(RCOBJECTS)
-	$(MKDIR) lib
-	$(CXX) -shared $(LDFLAGS) -o $@ $(COBJECTS) $(OBJECTS) $(RCOBJECTS) $(LDLIBS) -s -static -Wl,--subsystem,windows,--out-implib,lib/libsass.a
-```
-
-+ Compile the library
-
-```bash
-mingw32-make -C libsass
-```
-
-By the way , if you are using java jna , [JNAerator](http://jnaerator.googlecode.com/) is a good tool.
-
-## Building via Visual Studio Community 2013
-
-Open a Visual Studio 2013 command prompt:
-- `VS2013 x86 Native Tools Command Prompt`
-
-Note: When I installed the community edition, I only got the 2012 command prompts. I copied them from the Startmenu to the Desktop and adjusted the paths from `Visual Studio 11.0` to `Visual Studio 12.0`. Since `libsass` uses some `C++11` features, you need at least a MSVC 2013 compiler (v120).
-
-### Get the source
-```bash
-# using git is preferred
-git clone https://github.com/sass/libsass.git
-git clone https://github.com/sass/sassc.git libsass/sassc
-# only needed if you want to run the testsuite
-git clone https://github.com/sass/sass-spec.git libsass/sass-spec
-```
-
-### Compile sassc
-
-Sometimes `msbuild` seems not available from the command prompt. Just search for it and add it to the global path. It seems to be included in the .net folders too.
-
-```bat
-cd libsass
-REM set PATH=%PATH%;%PROGRAMFILES%\MSBuild\12.0\Bin
-msbuild /m:4 /p:Configuration=Release win\libsass.sln
-REM running the spec test-suite manually (needs ruby and minitest gem)
-ruby sass-spec\sass-spec.rb -V 3.5 -c win\bin\sassc.exe -s --impl libsass sass-spec/spec
-cd ..
-```
-
-[1]: http://sourceforge.net/projects/mingw/files/latest/download?source=files
-[2]: https://msysgit.github.io/
-[3]: http://rubyinstaller.org/

data/ext/libsass/docs/build-shared-library.md

@@ -1,35 +0,0 @@
-This page is mostly intended for people that want to build a system library that gets distributed via RPMs or other means. This is currently in a experimental phase, as we currently do not really guarantee any ABI forward compatibility. The C API was rewritten to make this possible in the future, but we want to wait some more time till we can call this final and stable.
-
-Building via autotools
---
-
-You want to build a system library only via autotools, since it will create the proper `libtool` files to make it loadable on multiple systems. We hope this works correctly, but nobody of the `libsass` core team has much knowledge in this area. Therefore we are open for comments or improvements by people that have more experience in that matter (like package maintainers from various linux distributions).
-
-```bash
-apt-get install autoconf libtool
-git clone https://github.com/sass/libsass.git
-cd libsass
-autoreconf --force --install
-./configure \
-  --disable-tests \
-  --disable-static \
-  --enable-shared \
-  --prefix=/usr
-make -j5 install
-cd ..
-```
-
-This should install these files
-```bash
-# $ ls -la /usr/lib/libsass.*
-/usr/lib/libsass.la
-/usr/lib/libsass.so -> libsass.so.0.0.9
-/usr/lib/libsass.so.0 -> libsass.so.0.0.9
-/usr/lib/libsass.so.0.0.9
-# $ ls -la /usr/include/sass*
-/usr/include/sass.h
-/usr/include/sass2scss.h
-/usr/include/sass/context.h
-/usr/include/sass/functions.h
-/usr/include/sass/values.h
-```

data/ext/libsass/docs/build-with-autotools.md

@@ -1,78 +0,0 @@
-### Get the sources
-```bash
-# using git is preferred
-git clone https://github.com/sass/libsass.git
-# only needed for sassc and/or testsuite
-git clone https://github.com/sass/sassc.git libsass/sassc
-git clone https://github.com/sass/sass-spec.git libsass/sass-spec
-```
-
-### Prerequisites
-
-In order to run autotools you need a few tools installed on your system.
-```bash
-yum install automake libtool # RedHat Linux
-emerge -a automake libtool # Gentoo Linux
-pkgin install automake libtool # SmartOS
-```
-
-
-### Create configure script
-```bash
-cd libsass
-autoreconf --force --install
-cd ..
-```
-
-### Create custom makefiles
-```bash
-cd libsass
-./configure \
-  --disable-tests \
-  --disable-shared \
-  --prefix=/usr
-cd ..
-```
-
-### Build the library
-```bash
-make -C libsass -j5
-```
-
-### Install the library
-The library will be installed to the location given as `prefix` to `configure`. This is standard behavior for autotools and not `libsass` specific.
-```bash
-make -C libsass -j5 install
-```
-
-### Configure options
-The `configure` script is created by autotools. To get an overview of available options you can call `./configure --help`. When you execute this script, it will create specific makefiles, which you then use via the regular make command.
-
-There are some `libsass` specific options:
-
-```
-Optional Features:
-  --enable-tests              enable testing the build
-  --enable-coverage           enable coverage report for test suite
-  --enable-shared             build shared libraries [default=yes]
-  --enable-static             build static libraries [default=yes]
-
-Optional Packages:
-  --with-sassc-dir=<dir>      specify directory of sassc sources for
-                              testing (default: sassc)
-  --with-sass-spec-dir=<dir>  specify directory of sass-spec for testing
-                              (default: sass-spec)
-```
-
-### Build sassc and run spec test-suite
-
-```bash
-cd libsass
-autoreconf --force --install
-./configure \
-  --enable-tests \
-  --enable-shared \
-  --prefix=/usr
-make -j5 test_build
-cd ..
-```