sassc 1.8.3 → 1.8.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4711ad9a2cb9091ae22ff8fb0c373f767212dbec
-  data.tar.gz: 5d51cbb258d5855a729028c1db0ce35871e991cb
+  metadata.gz: 8fe1d16ee2088d1a7579e272a1a7e06ec45fcfc4
+  data.tar.gz: fdf4b18309732cf9657becf31f4cf42170cce51c
 SHA512:
-  metadata.gz: ea92abeccd8eda5bd3c7c7dfa7e64bd8bab8182891ff6bb9fcb11f995ab2b6e45c6bb5a0a2260c5eb55131e4ef409bf9754aae6ef50524e2c3f0ea3900bd18a0
-  data.tar.gz: 4d3defd176979708077f1f80fb549643e471092097f201f86e0cf702ec23e90407173bafde4abee9d697ee9ba5f42cf33cf17e1b2f9dc0a9a3138d4395540684
+  metadata.gz: 9182f4bbf92967e5dae1c870427d372d1bb672f7fab914a4b412d032ab2391456a2989dc5313e71f9e50d476e905d16ee72de22038136ead8674c58a074a38cb
+  data.tar.gz: 80fe5528ca2af133a4075ee84b9b3aafd0f1c8eb11aa73ac827eaf96cdedbd349ad933f5f0a990fffeb43ce96b866de0b2bed50f3b5c809dfe5f22f9dde6096f

data/README.md

@@ -6,7 +6,7 @@ This gem combines the speed of `libsass`, the [Sass C implementation](https://gi
 
 ### libsass Version
 
-[3.3.2](https://github.com/sass/libsass/releases/tag/3.3.2)
+[3.3.3](https://github.com/sass/libsass/releases/tag/3.3.3)
 
 ## Usage
 
@@ -25,6 +25,8 @@ and [awesome contributors](https://github.com/bolandrm/sassc-ruby/graphs/contrib
 
 ## Changelog
 
+- **1.8.4**
+  - Update to Libsass 3.3.3
 - **1.8.3**
   - [Passing empty string into engine does not raise error](https://github.com/sass/sassc-ruby/pull/31)
 - **1.8.2**

data/ext/libsass/.editorconfig

@@ -10,6 +10,6 @@ insert_final_newline = true
 indent_style = spaces
 indent_size = 2
 
-[{Makefile, Makefile.am}]
+[{Makefile, GNUmakefile.am}]
 indent_style = tab
 indent_size = 4

data/ext/libsass/.gitignore

@@ -50,6 +50,7 @@ libsass/*
 *.a
 *.suo
 *.sdf
+*.opendb
 *.opensdf
 a.out
 libsass.js

data/ext/libsass/LICENSE

@@ -1,5 +1,5 @@
 
-Copyright (C) 2012 by Hampton Catlin
+Copyright (C) 2012-2016 by Hampton Catlin
 
 Permission is hereby granted, free of charge, to any person obtaining a copy of
 this software and associated documentation files (the "Software"), to deal in

data/ext/libsass/Makefile

@@ -1,3 +1,4 @@
+OS       ?= $(shell uname -s)
 CC       ?= gcc
 CXX      ?= g++
 RM       ?= rm -f
@@ -5,6 +6,11 @@ CP       ?= cp -a
 MKDIR    ?= mkdir
 RMDIR    ?= rmdir
 WINDRES  ?= windres
+# Solaris/Illumos flavors
+# ginstall from coreutils
+ifeq ($(OS),SunOS)
+INSTALL  ?= ginstall
+endif
 INSTALL  ?= install
 CFLAGS   ?= -Wall
 CXXFLAGS ?= -Wall
@@ -20,14 +26,14 @@ CAT      ?= $(if $(filter $(OS),Windows_NT),type,cat)
 ifneq (,$(findstring /cygdrive/,$(PATH)))
 	UNAME := Cygwin
 else
-	ifneq (,$(findstring WINDOWS,$(PATH)))
+	ifneq (,$(findstring Windows_NT,$(OS)))
 		UNAME := Windows
 	else
 		ifneq (,$(findstring mingw32,$(MAKE)))
-			UNAME := MinGW
+			UNAME := Windows
 		else
 			ifneq (,$(findstring MINGW32,$(shell uname -s)))
-				UNAME = MinGW
+				UNAME = Windows
 			else
 				UNAME := $(shell uname -s)
 			endif
@@ -57,7 +63,7 @@ ifneq ($(LIBSASS_VERSION),)
 endif
 
 # enable mandatory flag
-ifeq (MinGW,$(UNAME))
+ifeq (Windows,$(UNAME))
 	ifneq ($(BUILD),shared)
 		STATIC_ALL     ?= 1
 	endif
@@ -117,7 +123,7 @@ ifeq ($(UNAME),Darwin)
 	LDFLAGS += -stdlib=libc++
 endif
 
-ifneq (MinGW,$(UNAME))
+ifneq (Windows,$(UNAME))
 	ifneq (FreeBSD,$(UNAME))
 		LDFLAGS += -ldl
 		LDLIBS += -ldl
@@ -128,14 +134,17 @@ ifneq ($(BUILD),shared)
 	BUILD = static
 endif
 
-ifeq (,$(PREFIX))
-	ifeq (,$(TRAVIS_BUILD_DIR))
-		PREFIX = /usr/local
+ifeq (,$(TRAVIS_BUILD_DIR))
+	ifeq ($(OS),SunOS)
+		PREFIX ?= /opt/local
 	else
-		PREFIX = $(TRAVIS_BUILD_DIR)
+		PREFIX ?= /usr/local
 	endif
+else
+	PREFIX ?= $(TRAVIS_BUILD_DIR)
 endif
 
+
 SASS_SASSC_PATH ?= sassc
 SASS_SPEC_PATH ?= sass-spec
 SASS_SPEC_SPEC_DIR ?= spec
@@ -145,7 +154,7 @@ RUBY_BIN = ruby
 LIB_STATIC = $(SASS_LIBSASS_PATH)/lib/libsass.a
 LIB_SHARED = $(SASS_LIBSASS_PATH)/lib/libsass.so
 
-ifeq (MinGW,$(UNAME))
+ifeq (Windows,$(UNAME))
 	ifeq (shared,$(BUILD))
 		CFLAGS     += -D ADD_EXPORTS
 		CXXFLAGS   += -D ADD_EXPORTS
@@ -159,9 +168,6 @@ else
 	endif
 endif
 
-ifeq (MinGW,$(UNAME))
-	SASSC_BIN = $(SASS_SASSC_PATH)/bin/sassc.exe
-endif
 ifeq (Windows,$(UNAME))
 	SASSC_BIN = $(SASS_SASSC_PATH)/bin/sassc.exe
 endif
@@ -171,7 +177,7 @@ include Makefile.conf
 RESOURCES =
 STATICLIB = lib/libsass.a
 SHAREDLIB = lib/libsass.so
-ifeq (MinGW,$(UNAME))
+ifeq (Windows,$(UNAME))
 	RESOURCES += res/resource.rc
 	SHAREDLIB  = lib/libsass.dll
 	ifeq (shared,$(BUILD))

data/ext/libsass/Makefile.conf

@@ -37,7 +37,6 @@ SOURCES = \
 	sass2scss.cpp \
 	source_map.cpp \
 	to_c.cpp \
-	to_string.cpp \
 	to_value.cpp \
 	units.cpp \
 	utf8_string.cpp \

data/ext/libsass/Readme.md

@@ -1,7 +1,7 @@
 LibSass
 =======
 
-by Aaron Leung ([@akhleung]) and Hampton Catlin ([@hcatlin])
+by Aaron Leung ([@akhleung]), Hampton Catlin ([@hcatlin]), Marcel Greter ([@mgreter]) and Michael Mifsud ([@xzyfer])
 
 [![Linux CI](https://travis-ci.org/sass/libsass.png?branch=master)](https://travis-ci.org/sass/libsass)
 [![Windows CI](https://ci.appveyor.com/api/projects/status/github/sass/libsass?svg=true)](https://ci.appveyor.com/project/sass/libsass/branch/master)
@@ -89,6 +89,8 @@ Our MIT license is designed to be as simple, and liberal as possible.
 [@akhleung]: https://github.com/akhleung
 [@chriseppstein]: https://github.com/chriseppstein
 [@nex3]: https://github.com/nex3
+[@mgreter]: https://github.com/mgreter
+[@xzyfer]: https://github.com/xzyfer
 
 sass2scss was originally written by [Marcel Greter](@mgreter)
 and he happily agreed to have it merged into the project.

data/ext/libsass/appveyor.yml

@@ -1,4 +1,4 @@
-os: Visual Studio 2015
+os: Visual Studio 2015
 
 environment:
   CTEST_OUTPUT_ON_FAILURE: 1
@@ -27,9 +27,7 @@ install:
       if ($env:Compiler -eq "mingw" -AND -Not (Test-Path "C:\mingw64")) {
         # Install MinGW.
         $file = "x86_64-4.9.2-release-win32-seh-rt_v4-rev3.7z"
-        $url  = "https://bintray.com/artifact/download/drewwells/generic/"
-        $url += $file
-        Invoke-WebRequest -UserAgent wget -Uri $url -OutFile $file
+        wget https://bintray.com/artifact/download/drewwells/generic/$file -OutFile $file
         &7z x -oC:\ $file > $null
       }
   - set PATH=C:\mingw64\bin;%PATH%
@@ -53,18 +51,28 @@ build_script:
 
 test_script:
   - ps: |
-      $PRNR = [System.Environment]::ExpandEnvironmentVariables("%APPVEYOR_PULL_REQUEST_NUMBER%")
-      if ($PRNR -ne "") {
+      $PRNR = $env:APPVEYOR_PULL_REQUEST_NUMBER
+      if ($PRNR) {
         echo "Fetching info for PR $PRNR"
-        $request = (New-Object System.Net.WebClient)
-        $request.headers['User-Agent'] = "Mozilla/5.0"
-        $request.DownloadFile( "https://api.github.com/repos/sass/libsass/pulls/$PRNR", 'pr.json')
-        $json = [IO.File]::ReadAllText('pr.json')
+        wget https://api.github.com/repos/sass/libsass/pulls/$PRNR -OutFile pr.json
+        $json = cat pr.json -Raw
         $SPEC_PR = [regex]::match($json,'sass\/sass-spec(#|\/pull\/)([0-9]+)').Groups[2].Value
-        if ($SPEC_PR -ne "") {
+        if ($SPEC_PR) {
           echo "Checkout sass spec PR $SPEC_PR"
           git -C sass-spec fetch -q -u origin pull/$SPEC_PR/head:ci-spec-pr-$SPEC_PR
           git -C sass-spec checkout -q --force ci-spec-pr-$SPEC_PR
         }
       }
       ruby sass-spec/sass-spec.rb -c $env:TargetPath -s --ignore-todo sass-spec/spec
+
+      Write-Host "Explicitly testing the case when cwd has Cyrillic characters: " -nonewline
+      # See comments in gh-1774 for details.
+      $env:TargetPath =  Join-Path $pwd.Path $env:TargetPath
+      cd sass-spec/spec/libsass/Sáss-UŢF8/
+      &$env:TargetPath ./input.scss 2>&1>$null
+      if(-not($?)) {
+        echo "Failed!"
+        exit 1
+      } else {
+        echo "Success!"
+      }

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

@@ -75,7 +75,7 @@ Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_
   // swallows »@import "http://…"« pass-through
   // (arguably a bug)
   Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry(url, 0, 0);
+  list[0] = sass_make_import_entry(path, 0, 0);
   return list;
 }
 
@@ -83,7 +83,7 @@ Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_
   // return an error to halt execution
   Sass_Import_List list = sass_make_import_list(1);
   const char* message = "some error message";
-  list[0] = sass_make_import_entry(url, 0, 0);
+  list[0] = sass_make_import_entry(path, 0, 0);
   sass_import_set_error(list[0], strdup(message), 0, 0);
   return list;
 }
@@ -110,1236 +110,3 @@ Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_
   return list;
 }
 ```
-## Example importer.c
-
-```C
-#include <stdio.h>
-#include <string.h>
-#include "sass/context.h"
-
-Sass_Import_List sass_importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp)
-{
-  // get the cookie from importer descriptor
-  void* cookie = sass_importer_get_cookie(cb);
-  Sass_Import_List list = sass_make_import_list(2);
-  const char* local = "local { color: green; }";
-  const char* remote = "remote { color: red; }";
-  list[0] = sass_make_import_entry("/tmp/styles.scss", strdup(local), 0);
-  list[1] = sass_make_import_entry("http://www.example.com", strdup(remote), 0);
-  return list;
-}
-
-int main( int argc, const char* argv[] )
-{
-
-  // get the input file from first argument or use default
-  const char* input = argc > 1 ? argv[1] : "styles.scss";
-
-  // create the file context and get all related structs
-  struct Sass_File_Context* file_ctx = sass_make_file_context(input);
-  struct Sass_Context* ctx = sass_file_context_get_context(file_ctx);
-  struct Sass_Options* ctx_opt = sass_context_get_options(ctx);
-
-  // allocate custom importer
-  Sass_Importer_Entry c_imp =
-    sass_make_importer(sass_importer, 0, 0);
-  // create list for all custom importers
-  Sass_Importer_List imp_list = sass_make_importer_list(1);
-  // put the only importer on to the list
-  sass_importer_set_list_entry(imp_list, 0, c_imp);
-  // register list on to the context options
-  sass_option_set_c_importers(ctx_opt, imp_list);
-  // context is set up, call the compile step now
-  int status = sass_compile_file_context(file_ctx);
-
-  // print the result or the error to the stdout
-  if (status == 0) puts(sass_context_get_output_string(ctx));
-  else puts(sass_context_get_error_message(ctx));
-
-  // release allocated memory
-  sass_delete_file_context(file_ctx);
-
-  // exit status
-  return status;
-
-}
-```
-
-Compile importer.c
-
-```bash
-gcc -c importer.c -o importer.o
-gcc -o importer importer.o -lsass
-echo "@import 'foobar';" > importer.scss
-./importer importer.scss
-```
-
-## Importer Behavior Examples
-
-```C
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass handle the import request
-  return NULL;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass handle the request
-  // swallows »@import "http://…"« pass-through
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry(url, 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // return an error to halt execution
-  Sass_Import_List list = sass_make_import_list(1);
-  const char* message = "some error message";
-  list[0] = sass_make_import_entry(url, 0, 0);
-  sass_import_set_error(list[0], strdup(message), 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass load the file identifed by the importer
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry("/tmp/file.scss", 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // completely hide the import
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // completely hide the import
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry(0, 0, 0);
-  return list;
-}
-```
-## Example importer.c
-
-```C
-#include <stdio.h>
-#include <string.h>
-#include "sass/context.h"
-
-Sass_Import_List sass_importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp)
-{
-  // get the cookie from importer descriptor
-  void* cookie = sass_importer_get_cookie(cb);
-  Sass_Import_List list = sass_make_import_list(2);
-  const char* local = "local { color: green; }";
-  const char* remote = "remote { color: red; }";
-  list[0] = sass_make_import_entry("/tmp/styles.scss", strdup(local), 0);
-  list[1] = sass_make_import_entry("http://www.example.com", strdup(remote), 0);
-  return list;
-}
-
-int main( int argc, const char* argv[] )
-{
-
-  // get the input file from first argument or use default
-  const char* input = argc > 1 ? argv[1] : "styles.scss";
-
-  // create the file context and get all related structs
-  struct Sass_File_Context* file_ctx = sass_make_file_context(input);
-  struct Sass_Context* ctx = sass_file_context_get_context(file_ctx);
-  struct Sass_Options* ctx_opt = sass_context_get_options(ctx);
-
-  // allocate custom importer
-  Sass_Importer_Entry c_imp =
-    sass_make_importer(sass_importer, 0, 0);
-  // create list for all custom importers
-  Sass_Importer_List imp_list = sass_make_importer_list(1);
-  // put the only importer on to the list
-  sass_importer_set_list_entry(imp_list, 0, c_imp);
-  // register list on to the context options
-  sass_option_set_c_importers(ctx_opt, imp_list);
-  // context is set up, call the compile step now
-  int status = sass_compile_file_context(file_ctx);
-
-  // print the result or the error to the stdout
-  if (status == 0) puts(sass_context_get_output_string(ctx));
-  else puts(sass_context_get_error_message(ctx));
-
-  // release allocated memory
-  sass_delete_file_context(file_ctx);
-
-  // exit status
-  return status;
-
-}
-```
-
-Compile importer.c
-
-```bash
-gcc -c importer.c -o importer.o
-gcc -o importer importer.o -lsass
-echo "@import 'foobar';" > importer.scss
-./importer importer.scss
-```
-
-## Importer Behavior Examples
-
-```C
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass handle the import request
-  return NULL;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass handle the request
-  // swallows »@import "http://…"« pass-through
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry(url, 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // return an error to halt execution
-  Sass_Import_List list = sass_make_import_list(1);
-  const char* message = "some error message";
-  list[0] = sass_make_import_entry(url, 0, 0);
-  sass_import_set_error(list[0], strdup(message), 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass load the file identifed by the importer
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry("/tmp/file.scss", 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // completely hide the import
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // completely hide the import
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry(0, 0, 0);
-  return list;
-}
-```
-## Example importer.c
-
-```C
-#include <stdio.h>
-#include <string.h>
-#include "sass/context.h"
-
-Sass_Import_List sass_importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp)
-{
-  // get the cookie from importer descriptor
-  void* cookie = sass_importer_get_cookie(cb);
-  Sass_Import_List list = sass_make_import_list(2);
-  const char* local = "local { color: green; }";
-  const char* remote = "remote { color: red; }";
-  list[0] = sass_make_import_entry("/tmp/styles.scss", strdup(local), 0);
-  list[1] = sass_make_import_entry("http://www.example.com", strdup(remote), 0);
-  return list;
-}
-
-int main( int argc, const char* argv[] )
-{
-
-  // get the input file from first argument or use default
-  const char* input = argc > 1 ? argv[1] : "styles.scss";
-
-  // create the file context and get all related structs
-  struct Sass_File_Context* file_ctx = sass_make_file_context(input);
-  struct Sass_Context* ctx = sass_file_context_get_context(file_ctx);
-  struct Sass_Options* ctx_opt = sass_context_get_options(ctx);
-
-  // allocate custom importer
-  Sass_Importer_Entry c_imp =
-    sass_make_importer(sass_importer, 0, 0);
-  // create list for all custom importers
-  Sass_Importer_List imp_list = sass_make_importer_list(1);
-  // put the only importer on to the list
-  sass_importer_set_list_entry(imp_list, 0, c_imp);
-  // register list on to the context options
-  sass_option_set_c_importers(ctx_opt, imp_list);
-  // context is set up, call the compile step now
-  int status = sass_compile_file_context(file_ctx);
-
-  // print the result or the error to the stdout
-  if (status == 0) puts(sass_context_get_output_string(ctx));
-  else puts(sass_context_get_error_message(ctx));
-
-  // release allocated memory
-  sass_delete_file_context(file_ctx);
-
-  // exit status
-  return status;
-
-}
-```
-
-Compile importer.c
-
-```bash
-gcc -c importer.c -o importer.o
-gcc -o importer importer.o -lsass
-echo "@import 'foobar';" > importer.scss
-./importer importer.scss
-```
-
-## Importer Behavior Examples
-
-```C
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass handle the import request
-  return NULL;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass handle the request
-  // swallows »@import "http://…"« pass-through
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry(url, 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // return an error to halt execution
-  Sass_Import_List list = sass_make_import_list(1);
-  const char* message = "some error message";
-  list[0] = sass_make_import_entry(url, 0, 0);
-  sass_import_set_error(list[0], strdup(message), 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass load the file identifed by the importer
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry("/tmp/file.scss", 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // completely hide the import
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // completely hide the import
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry(0, 0, 0);
-  return list;
-}
-```
-## Example importer.c
-
-```C
-#include <stdio.h>
-#include <string.h>
-#include "sass/context.h"
-
-Sass_Import_List sass_importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp)
-{
-  // get the cookie from importer descriptor
-  void* cookie = sass_importer_get_cookie(cb);
-  Sass_Import_List list = sass_make_import_list(2);
-  const char* local = "local { color: green; }";
-  const char* remote = "remote { color: red; }";
-  list[0] = sass_make_import_entry("/tmp/styles.scss", strdup(local), 0);
-  list[1] = sass_make_import_entry("http://www.example.com", strdup(remote), 0);
-  return list;
-}
-
-int main( int argc, const char* argv[] )
-{
-
-  // get the input file from first argument or use default
-  const char* input = argc > 1 ? argv[1] : "styles.scss";
-
-  // create the file context and get all related structs
-  struct Sass_File_Context* file_ctx = sass_make_file_context(input);
-  struct Sass_Context* ctx = sass_file_context_get_context(file_ctx);
-  struct Sass_Options* ctx_opt = sass_context_get_options(ctx);
-
-  // allocate custom importer
-  Sass_Importer_Entry c_imp =
-    sass_make_importer(sass_importer, 0, 0);
-  // create list for all custom importers
-  Sass_Importer_List imp_list = sass_make_importer_list(1);
-  // put the only importer on to the list
-  sass_importer_set_list_entry(imp_list, 0, c_imp);
-  // register list on to the context options
-  sass_option_set_c_importers(ctx_opt, imp_list);
-  // context is set up, call the compile step now
-  int status = sass_compile_file_context(file_ctx);
-
-  // print the result or the error to the stdout
-  if (status == 0) puts(sass_context_get_output_string(ctx));
-  else puts(sass_context_get_error_message(ctx));
-
-  // release allocated memory
-  sass_delete_file_context(file_ctx);
-
-  // exit status
-  return status;
-
-}
-```
-
-Compile importer.c
-
-```bash
-gcc -c importer.c -o importer.o
-gcc -o importer importer.o -lsass
-echo "@import 'foobar';" > importer.scss
-./importer importer.scss
-```
-
-## Importer Behavior Examples
-
-```C
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass handle the import request
-  return NULL;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass handle the request
-  // swallows »@import "http://…"« pass-through
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry(url, 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // return an error to halt execution
-  Sass_Import_List list = sass_make_import_list(1);
-  const char* message = "some error message";
-  list[0] = sass_make_import_entry(url, 0, 0);
-  sass_import_set_error(list[0], strdup(message), 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass load the file identifed by the importer
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry("/tmp/file.scss", 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // completely hide the import
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // completely hide the import
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry(0, 0, 0);
-  return list;
-}
-```
-## Example importer.c
-
-```C
-#include <stdio.h>
-#include <string.h>
-#include "sass/context.h"
-
-Sass_Import_List sass_importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp)
-{
-  // get the cookie from importer descriptor
-  void* cookie = sass_importer_get_cookie(cb);
-  Sass_Import_List list = sass_make_import_list(2);
-  const char* local = "local { color: green; }";
-  const char* remote = "remote { color: red; }";
-  list[0] = sass_make_import_entry("/tmp/styles.scss", strdup(local), 0);
-  list[1] = sass_make_import_entry("http://www.example.com", strdup(remote), 0);
-  return list;
-}
-
-int main( int argc, const char* argv[] )
-{
-
-  // get the input file from first argument or use default
-  const char* input = argc > 1 ? argv[1] : "styles.scss";
-
-  // create the file context and get all related structs
-  struct Sass_File_Context* file_ctx = sass_make_file_context(input);
-  struct Sass_Context* ctx = sass_file_context_get_context(file_ctx);
-  struct Sass_Options* ctx_opt = sass_context_get_options(ctx);
-
-  // allocate custom importer
-  Sass_Importer_Entry c_imp =
-    sass_make_importer(sass_importer, 0, 0);
-  // create list for all custom importers
-  Sass_Importer_List imp_list = sass_make_importer_list(1);
-  // put the only importer on to the list
-  sass_importer_set_list_entry(imp_list, 0, c_imp);
-  // register list on to the context options
-  sass_option_set_c_importers(ctx_opt, imp_list);
-  // context is set up, call the compile step now
-  int status = sass_compile_file_context(file_ctx);
-
-  // print the result or the error to the stdout
-  if (status == 0) puts(sass_context_get_output_string(ctx));
-  else puts(sass_context_get_error_message(ctx));
-
-  // release allocated memory
-  sass_delete_file_context(file_ctx);
-
-  // exit status
-  return status;
-
-}
-```
-
-Compile importer.c
-
-```bash
-gcc -c importer.c -o importer.o
-gcc -o importer importer.o -lsass
-echo "@import 'foobar';" > importer.scss
-./importer importer.scss
-```
-
-## Importer Behavior Examples
-
-```C
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass handle the import request
-  return NULL;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass handle the request
-  // swallows »@import "http://…"« pass-through
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry(url, 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // return an error to halt execution
-  Sass_Import_List list = sass_make_import_list(1);
-  const char* message = "some error message";
-  list[0] = sass_make_import_entry(url, 0, 0);
-  sass_import_set_error(list[0], strdup(message), 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass load the file identifed by the importer
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry("/tmp/file.scss", 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // completely hide the import
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // completely hide the import
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry(0, 0, 0);
-  return list;
-}
-```
-## Example importer.c
-
-```C
-#include <stdio.h>
-#include <string.h>
-#include "sass/context.h"
-
-Sass_Import_List sass_importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp)
-{
-  // get the cookie from importer descriptor
-  void* cookie = sass_importer_get_cookie(cb);
-  Sass_Import_List list = sass_make_import_list(2);
-  const char* local = "local { color: green; }";
-  const char* remote = "remote { color: red; }";
-  list[0] = sass_make_import_entry("/tmp/styles.scss", strdup(local), 0);
-  list[1] = sass_make_import_entry("http://www.example.com", strdup(remote), 0);
-  return list;
-}
-
-int main( int argc, const char* argv[] )
-{
-
-  // get the input file from first argument or use default
-  const char* input = argc > 1 ? argv[1] : "styles.scss";
-
-  // create the file context and get all related structs
-  struct Sass_File_Context* file_ctx = sass_make_file_context(input);
-  struct Sass_Context* ctx = sass_file_context_get_context(file_ctx);
-  struct Sass_Options* ctx_opt = sass_context_get_options(ctx);
-
-  // allocate custom importer
-  Sass_Importer_Entry c_imp =
-    sass_make_importer(sass_importer, 0, 0);
-  // create list for all custom importers
-  Sass_Importer_List imp_list = sass_make_importer_list(1);
-  // put the only importer on to the list
-  sass_importer_set_list_entry(imp_list, 0, c_imp);
-  // register list on to the context options
-  sass_option_set_c_importers(ctx_opt, imp_list);
-  // context is set up, call the compile step now
-  int status = sass_compile_file_context(file_ctx);
-
-  // print the result or the error to the stdout
-  if (status == 0) puts(sass_context_get_output_string(ctx));
-  else puts(sass_context_get_error_message(ctx));
-
-  // release allocated memory
-  sass_delete_file_context(file_ctx);
-
-  // exit status
-  return status;
-
-}
-```
-
-Compile importer.c
-
-```bash
-gcc -c importer.c -o importer.o
-gcc -o importer importer.o -lsass
-echo "@import 'foobar';" > importer.scss
-./importer importer.scss
-```
-
-## Importer Behavior Examples
-
-```C
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass handle the import request
-  return NULL;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass handle the request
-  // swallows »@import "http://…"« pass-through
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry(url, 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // return an error to halt execution
-  Sass_Import_List list = sass_make_import_list(1);
-  const char* message = "some error message";
-  list[0] = sass_make_import_entry(url, 0, 0);
-  sass_import_set_error(list[0], strdup(message), 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass load the file identifed by the importer
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry("/tmp/file.scss", 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // completely hide the import
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // completely hide the import
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry(0, 0, 0);
-  return list;
-}
-```
-## Example importer.c
-
-```C
-#include <stdio.h>
-#include <string.h>
-#include "sass/context.h"
-
-Sass_Import_List sass_importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp)
-{
-  // get the cookie from importer descriptor
-  void* cookie = sass_importer_get_cookie(cb);
-  Sass_Import_List list = sass_make_import_list(2);
-  const char* local = "local { color: green; }";
-  const char* remote = "remote { color: red; }";
-  list[0] = sass_make_import_entry("/tmp/styles.scss", strdup(local), 0);
-  list[1] = sass_make_import_entry("http://www.example.com", strdup(remote), 0);
-  return list;
-}
-
-int main( int argc, const char* argv[] )
-{
-
-  // get the input file from first argument or use default
-  const char* input = argc > 1 ? argv[1] : "styles.scss";
-
-  // create the file context and get all related structs
-  struct Sass_File_Context* file_ctx = sass_make_file_context(input);
-  struct Sass_Context* ctx = sass_file_context_get_context(file_ctx);
-  struct Sass_Options* ctx_opt = sass_context_get_options(ctx);
-
-  // allocate custom importer
-  Sass_Importer_Entry c_imp =
-    sass_make_importer(sass_importer, 0, 0);
-  // create list for all custom importers
-  Sass_Importer_List imp_list = sass_make_importer_list(1);
-  // put the only importer on to the list
-  sass_importer_set_list_entry(imp_list, 0, c_imp);
-  // register list on to the context options
-  sass_option_set_c_importers(ctx_opt, imp_list);
-  // context is set up, call the compile step now
-  int status = sass_compile_file_context(file_ctx);
-
-  // print the result or the error to the stdout
-  if (status == 0) puts(sass_context_get_output_string(ctx));
-  else puts(sass_context_get_error_message(ctx));
-
-  // release allocated memory
-  sass_delete_file_context(file_ctx);
-
-  // exit status
-  return status;
-
-}
-```
-
-Compile importer.c
-
-```bash
-gcc -c importer.c -o importer.o
-gcc -o importer importer.o -lsass
-echo "@import 'foobar';" > importer.scss
-./importer importer.scss
-```
-
-## Importer Behavior Examples
-
-```C
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass handle the import request
-  return NULL;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass handle the request
-  // swallows »@import "http://…"« pass-through
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry(url, 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // return an error to halt execution
-  Sass_Import_List list = sass_make_import_list(1);
-  const char* message = "some error message";
-  list[0] = sass_make_import_entry(url, 0, 0);
-  sass_import_set_error(list[0], strdup(message), 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass load the file identifed by the importer
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry("/tmp/file.scss", 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // completely hide the import
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // completely hide the import
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry(0, 0, 0);
-  return list;
-}
-```
-## Example importer.c
-
-```C
-#include <stdio.h>
-#include <string.h>
-#include "sass/context.h"
-
-Sass_Import_List sass_importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp)
-{
-  // get the cookie from importer descriptor
-  void* cookie = sass_importer_get_cookie(cb);
-  Sass_Import_List list = sass_make_import_list(2);
-  const char* local = "local { color: green; }";
-  const char* remote = "remote { color: red; }";
-  list[0] = sass_make_import_entry("/tmp/styles.scss", strdup(local), 0);
-  list[1] = sass_make_import_entry("http://www.example.com", strdup(remote), 0);
-  return list;
-}
-
-int main( int argc, const char* argv[] )
-{
-
-  // get the input file from first argument or use default
-  const char* input = argc > 1 ? argv[1] : "styles.scss";
-
-  // create the file context and get all related structs
-  struct Sass_File_Context* file_ctx = sass_make_file_context(input);
-  struct Sass_Context* ctx = sass_file_context_get_context(file_ctx);
-  struct Sass_Options* ctx_opt = sass_context_get_options(ctx);
-
-  // allocate custom importer
-  Sass_Importer_Entry c_imp =
-    sass_make_importer(sass_importer, 0, 0);
-  // create list for all custom importers
-  Sass_Importer_List imp_list = sass_make_importer_list(1);
-  // put the only importer on to the list
-  sass_importer_set_list_entry(imp_list, 0, c_imp);
-  // register list on to the context options
-  sass_option_set_c_importers(ctx_opt, imp_list);
-  // context is set up, call the compile step now
-  int status = sass_compile_file_context(file_ctx);
-
-  // print the result or the error to the stdout
-  if (status == 0) puts(sass_context_get_output_string(ctx));
-  else puts(sass_context_get_error_message(ctx));
-
-  // release allocated memory
-  sass_delete_file_context(file_ctx);
-
-  // exit status
-  return status;
-
-}
-```
-
-Compile importer.c
-
-```bash
-gcc -c importer.c -o importer.o
-gcc -o importer importer.o -lsass
-echo "@import 'foobar';" > importer.scss
-./importer importer.scss
-```
-
-## Importer Behavior Examples
-
-```C
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass handle the import request
-  return NULL;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass handle the request
-  // swallows »@import "http://…"« pass-through
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry(url, 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // return an error to halt execution
-  Sass_Import_List list = sass_make_import_list(1);
-  const char* message = "some error message";
-  list[0] = sass_make_import_entry(url, 0, 0);
-  sass_import_set_error(list[0], strdup(message), 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass load the file identifed by the importer
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry("/tmp/file.scss", 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // completely hide the import
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // completely hide the import
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry(0, 0, 0);
-  return list;
-}
-```
-## Example importer.c
-
-```C
-#include <stdio.h>
-#include <string.h>
-#include "sass/context.h"
-
-Sass_Import_List sass_importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp)
-{
-  // get the cookie from importer descriptor
-  void* cookie = sass_importer_get_cookie(cb);
-  Sass_Import_List list = sass_make_import_list(2);
-  const char* local = "local { color: green; }";
-  const char* remote = "remote { color: red; }";
-  list[0] = sass_make_import_entry("/tmp/styles.scss", strdup(local), 0);
-  list[1] = sass_make_import_entry("http://www.example.com", strdup(remote), 0);
-  return list;
-}
-
-int main( int argc, const char* argv[] )
-{
-
-  // get the input file from first argument or use default
-  const char* input = argc > 1 ? argv[1] : "styles.scss";
-
-  // create the file context and get all related structs
-  struct Sass_File_Context* file_ctx = sass_make_file_context(input);
-  struct Sass_Context* ctx = sass_file_context_get_context(file_ctx);
-  struct Sass_Options* ctx_opt = sass_context_get_options(ctx);
-
-  // allocate custom importer
-  Sass_Importer_Entry c_imp =
-    sass_make_importer(sass_importer, 0, 0);
-  // create list for all custom importers
-  Sass_Importer_List imp_list = sass_make_importer_list(1);
-  // put the only importer on to the list
-  sass_importer_set_list_entry(imp_list, 0, c_imp);
-  // register list on to the context options
-  sass_option_set_c_importers(ctx_opt, imp_list);
-  // context is set up, call the compile step now
-  int status = sass_compile_file_context(file_ctx);
-
-  // print the result or the error to the stdout
-  if (status == 0) puts(sass_context_get_output_string(ctx));
-  else puts(sass_context_get_error_message(ctx));
-
-  // release allocated memory
-  sass_delete_file_context(file_ctx);
-
-  // exit status
-  return status;
-
-}
-```
-
-Compile importer.c
-
-```bash
-gcc -c importer.c -o importer.o
-gcc -o importer importer.o -lsass
-echo "@import 'foobar';" > importer.scss
-./importer importer.scss
-```
-
-## Importer Behavior Examples
-
-```C
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass handle the import request
-  return NULL;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass handle the request
-  // swallows »@import "http://…"« pass-through
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry(url, 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // return an error to halt execution
-  Sass_Import_List list = sass_make_import_list(1);
-  const char* message = "some error message";
-  list[0] = sass_make_import_entry(url, 0, 0);
-  sass_import_set_error(list[0], strdup(message), 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass load the file identifed by the importer
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry("/tmp/file.scss", 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // completely hide the import
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // completely hide the import
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry(0, 0, 0);
-  return list;
-}
-```
-## Example importer.c
-
-```C
-#include <stdio.h>
-#include <string.h>
-#include "sass/context.h"
-
-Sass_Import_List sass_importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp)
-{
-  // get the cookie from importer descriptor
-  void* cookie = sass_importer_get_cookie(cb);
-  Sass_Import_List list = sass_make_import_list(2);
-  const char* local = "local { color: green; }";
-  const char* remote = "remote { color: red; }";
-  list[0] = sass_make_import_entry("/tmp/styles.scss", strdup(local), 0);
-  list[1] = sass_make_import_entry("http://www.example.com", strdup(remote), 0);
-  return list;
-}
-
-int main( int argc, const char* argv[] )
-{
-
-  // get the input file from first argument or use default
-  const char* input = argc > 1 ? argv[1] : "styles.scss";
-
-  // create the file context and get all related structs
-  struct Sass_File_Context* file_ctx = sass_make_file_context(input);
-  struct Sass_Context* ctx = sass_file_context_get_context(file_ctx);
-  struct Sass_Options* ctx_opt = sass_context_get_options(ctx);
-
-  // allocate custom importer
-  Sass_Importer_Entry c_imp =
-    sass_make_importer(sass_importer, 0, 0);
-  // create list for all custom importers
-  Sass_Importer_List imp_list = sass_make_importer_list(1);
-  // put the only importer on to the list
-  sass_importer_set_list_entry(imp_list, 0, c_imp);
-  // register list on to the context options
-  sass_option_set_c_importers(ctx_opt, imp_list);
-  // context is set up, call the compile step now
-  int status = sass_compile_file_context(file_ctx);
-
-  // print the result or the error to the stdout
-  if (status == 0) puts(sass_context_get_output_string(ctx));
-  else puts(sass_context_get_error_message(ctx));
-
-  // release allocated memory
-  sass_delete_file_context(file_ctx);
-
-  // exit status
-  return status;
-
-}
-```
-
-Compile importer.c
-
-```bash
-gcc -c importer.c -o importer.o
-gcc -o importer importer.o -lsass
-echo "@import 'foobar';" > importer.scss
-./importer importer.scss
-```
-
-## Importer Behavior Examples
-
-```C
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass handle the import request
-  return NULL;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass handle the request
-  // swallows »@import "http://…"« pass-through
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry(url, 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // return an error to halt execution
-  Sass_Import_List list = sass_make_import_list(1);
-  const char* message = "some error message";
-  list[0] = sass_make_import_entry(url, 0, 0);
-  sass_import_set_error(list[0], strdup(message), 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass load the file identifed by the importer
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry("/tmp/file.scss", 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // completely hide the import
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // completely hide the import
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry(0, 0, 0);
-  return list;
-}
-```
-## Example importer.c
-
-```C
-#include <stdio.h>
-#include <string.h>
-#include "sass/context.h"
-
-Sass_Import_List sass_importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp)
-{
-  // get the cookie from importer descriptor
-  void* cookie = sass_importer_get_cookie(cb);
-  Sass_Import_List list = sass_make_import_list(2);
-  const char* local = "local { color: green; }";
-  const char* remote = "remote { color: red; }";
-  list[0] = sass_make_import_entry("/tmp/styles.scss", strdup(local), 0);
-  list[1] = sass_make_import_entry("http://www.example.com", strdup(remote), 0);
-  return list;
-}
-
-int main( int argc, const char* argv[] )
-{
-
-  // get the input file from first argument or use default
-  const char* input = argc > 1 ? argv[1] : "styles.scss";
-
-  // create the file context and get all related structs
-  struct Sass_File_Context* file_ctx = sass_make_file_context(input);
-  struct Sass_Context* ctx = sass_file_context_get_context(file_ctx);
-  struct Sass_Options* ctx_opt = sass_context_get_options(ctx);
-
-  // allocate custom importer
-  Sass_Importer_Entry c_imp =
-    sass_make_importer(sass_importer, 0, 0);
-  // create list for all custom importers
-  Sass_Importer_List imp_list = sass_make_importer_list(1);
-  // put the only importer on to the list
-  sass_importer_set_list_entry(imp_list, 0, c_imp);
-  // register list on to the context options
-  sass_option_set_c_importers(ctx_opt, imp_list);
-  // context is set up, call the compile step now
-  int status = sass_compile_file_context(file_ctx);
-
-  // print the result or the error to the stdout
-  if (status == 0) puts(sass_context_get_output_string(ctx));
-  else puts(sass_context_get_error_message(ctx));
-
-  // release allocated memory
-  sass_delete_file_context(file_ctx);
-
-  // exit status
-  return status;
-
-}
-```
-
-Compile importer.c
-
-```bash
-gcc -c importer.c -o importer.o
-gcc -o importer importer.o -lsass
-echo "@import 'foobar';" > importer.scss
-./importer importer.scss
-```
-
-## Importer Behavior Examples
-
-```C
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass handle the import request
-  return NULL;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass handle the request
-  // swallows »@import "http://…"« pass-through
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry(url, 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // return an error to halt execution
-  Sass_Import_List list = sass_make_import_list(1);
-  const char* message = "some error message";
-  list[0] = sass_make_import_entry(url, 0, 0);
-  sass_import_set_error(list[0], strdup(message), 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // let LibSass load the file identifed by the importer
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry("/tmp/file.scss", 0, 0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // completely hide the import
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(0);
-  return list;
-}
-
-Sass_Import_List importer(const char* path, Sass_Importer_Entry cb, struct Sass_Compiler* comp) {
-  // completely hide the import
-  // (arguably a bug)
-  Sass_Import_List list = sass_make_import_list(1);
-  list[0] = sass_make_import_entry(0, 0, 0);
-  return list;
-}
-```
-