sassc 2.0.0 → 2.4.0

data/ext/libsass/docs/api-importer-internal.md

@@ -1,20 +0,0 @@
-```C
-// External import entry
-struct Sass_Import {
-  char* imp_path; // path as found in the import statement
-  char *abs_path; // path after importer has resolved it
-  char* source;
-  char* srcmap;
-  // error handling
-  char* error;
-  size_t line;
-  size_t column;
-};
-
-// Struct to hold importer callback
-struct Sass_Importer {
-  Sass_Importer_Fn importer;
-  double           priority;
-  void*            cookie;
-};
-```

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

@@ -1,86 +0,0 @@
-By using custom importers, Sass stylesheets can be implemented in any possible way, such as by being loaded via a remote server. Please note: this feature is experimental and is implemented differently than importers in Ruby Sass. Imports must be relative to the parent import context and therefore we need to pass this information to the importer callback. This is currently done by passing the complete import string/path of the previous import context.
-
-## Return Imports
-
-You actually have to return a list of imports, since some importers may want to import multiple files from one import statement (ie. a glob/star importer).  The memory you pass with source and srcmap is taken over by LibSass and freed automatically when the import is done. You are also allowed to return `0` instead of a list, which will tell LibSass to handle the import by itself (as if no custom importer was in use).
-
-```C
-Sass_Import_Entry* rv = sass_make_import_list(1);
-rv[0] = sass_make_import(rel, abs, source, srcmap);
-```
-
-Every import will then be included in LibSass. You are allowed to only return a file path without any loaded source. This way you can ie. implement rewrite rules for import paths and leave the loading part for LibSass.
-
-Please note that LibSass doesn't use the srcmap parameter yet. It has been added to not deprecate the C-API once support has been implemented. It will be used to re-map the actual sourcemap with the provided ones.
-
-### Basic Usage
-
-```C
-#include "sass/functions.h"
-```
-
-## Sass Importer API
-
-```C
-// Forward declaration
-struct Sass_Import;
-
-// Forward declaration
-struct Sass_C_Import_Descriptor;
-
-// Typedef defining the custom importer callback
-typedef struct Sass_C_Import_Descriptor (*Sass_C_Import_Callback);
-// Typedef defining the importer c function prototype
-typedef Sass_Import_Entry* (*Sass_C_Import_Fn) (const char* url, const char* prev, void* cookie);
-
-// Creators for custom importer callback (with some additional pointer)
-// The pointer is mostly used to store the callback into the actual function
-Sass_C_Import_Callback sass_make_importer (Sass_C_Import_Fn, void* cookie);
-
-// Getters for import function descriptors
-Sass_C_Import_Fn sass_import_get_function (Sass_C_Import_Callback fn);
-void* sass_import_get_cookie (Sass_C_Import_Callback fn);
-
-// Deallocator for associated memory
-void sass_delete_importer (Sass_C_Import_Callback fn);
-
-// Creator for sass custom importer return argument list
-Sass_Import_Entry* sass_make_import_list (size_t length);
-// Creator for a single import entry returned by the custom importer inside the list
-Sass_Import_Entry sass_make_import_entry (const char* path, char* source, char* srcmap);
-Sass_Import_Entry sass_make_import (const char* rel, const char* abs, char* source, char* srcmap);
-
-// set error message to abort import and to print out a message (path from existing object is used in output)
-Sass_Import_Entry sass_import_set_error(Sass_Import_Entry import, const char* message, size_t line, size_t col);
-
-// Setters to insert an entry into the import list (you may also use [] access directly)
-// Since we are dealing with pointers they should have a guaranteed and fixed size
-void sass_import_set_list_entry (Sass_Import_Entry* list, size_t idx, Sass_Import_Entry entry);
-Sass_Import_Entry sass_import_get_list_entry (Sass_Import_Entry* list, size_t idx);
-
-// Getters for import entry
-const char* sass_import_get_imp_path (Sass_Import_Entry);
-const char* sass_import_get_abs_path (Sass_Import_Entry);
-const char* sass_import_get_source (Sass_Import_Entry);
-const char* sass_import_get_srcmap (Sass_Import_Entry);
-// Explicit functions to take ownership of these items
-// The property on our struct will be reset to NULL
-char* sass_import_take_source (Sass_Import_Entry);
-char* sass_import_take_srcmap (Sass_Import_Entry);
-
-// Getters for import error entries
-size_t sass_import_get_error_line (Sass_Import_Entry);
-size_t sass_import_get_error_column (Sass_Import_Entry);
-const char* sass_import_get_error_message (Sass_Import_Entry);
-
-// Deallocator for associated memory (incl. entries)
-void sass_delete_import_list (Sass_Import_Entry*);
-// Just in case we have some stray import structs
-void sass_delete_import (Sass_Import_Entry);
-```
-
-### More links
-
-- [Sass Importer Example](api-importer-example.md)
-- [Sass Importer Internal](api-importer-internal.md)
-

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

@@ -1,55 +0,0 @@
-## Example operation.c
-
-```C
-#include <stdio.h>
-#include <string.h>
-#include "sass/values.h"
-
-int main( int argc, const char* argv[] )
-{
-
-  // create two new sass values to be added
-  union Sass_Value* string = sass_make_string("String");
-  union Sass_Value* number = sass_make_number(42, "nits");
-
-  // invoke the add operation which returns a new sass value
-  union Sass_Value* total = sass_value_op(ADD, string, number);
-
-  // no further use for the two operands
-  sass_delete_value(string);
-  sass_delete_value(number);
-
-  // this works since libsass will always return a
-  // string for add operations with a string as the
-  // left hand side. But you should never rely on it!
-  puts(sass_string_get_value(total));
-
-  // invoke stringification (uncompressed with precision of 5)
-  union Sass_Value* result = sass_value_stringify(total, false, 5);
-
-  // no further use for the sum
-  sass_delete_value(total);
-
-  // print the result - you may want to make
-  // sure result is indeed a string, altough
-  // stringify guarantees to return a string
-  // if (sass_value_is_string(result)) {}
-  // really depends on your level of paranoia
-  puts(sass_string_get_value(result));
-
-  // finally free result
-  sass_delete_value(result);
-
-  // exit status
-  return 0;
-
-}
-```
-
-## Compile operation.c
-
-```bash
-gcc -c operation.c -o operation.o
-gcc -o operation operation.o -lsass
-./operation # => String42nits
-```

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

@@ -1,76 +0,0 @@
-```C
-struct Sass_Unknown {
-  enum Sass_Tag tag;
-};
-
-struct Sass_Boolean {
-  enum Sass_Tag tag;
-  bool          value;
-};
-
-struct Sass_Number {
-  enum Sass_Tag tag;
-  double        value;
-  char*         unit;
-};
-
-struct Sass_Color {
-  enum Sass_Tag tag;
-  double        r;
-  double        g;
-  double        b;
-  double        a;
-};
-
-struct Sass_String {
-  enum Sass_Tag tag;
-  char*         value;
-};
-
-struct Sass_List {
-  enum Sass_Tag       tag;
-  enum Sass_Separator separator;
-  size_t              length;
-  // null terminated "array"
-  union Sass_Value**  values;
-};
-
-struct Sass_Map {
-  enum Sass_Tag        tag;
-  size_t               length;
-  struct Sass_MapPair* pairs;
-};
-
-struct Sass_Null {
-  enum Sass_Tag tag;
-};
-
-struct Sass_Error {
-  enum Sass_Tag tag;
-  char*         message;
-};
-
-struct Sass_Warning {
-  enum Sass_Tag tag;
-  char*         message;
-};
-
-union Sass_Value {
-  struct Sass_Unknown unknown;
-  struct Sass_Boolean boolean;
-  struct Sass_Number  number;
-  struct Sass_Color   color;
-  struct Sass_String  string;
-  struct Sass_List    list;
-  struct Sass_Map     map;
-  struct Sass_Null    null;
-  struct Sass_Error   error;
-  struct Sass_Warning   warning;
-};
-
-struct Sass_MapPair {
-  union Sass_Value* key;
-  union Sass_Value* value;
-};
-```
-

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
-}
-```