guybedford · gamtiq · Jun 28, 2014 · Sep 28, 2014 · Oct 10, 2014 · Apr 27, 2015
diff --git a/README.md b/README.md
@@ -1,14 +1,14 @@
 require-less
-===========
+============
 
-Optimizable LESS requiring with RequireJS
+Optimizable [LESS](http://lesscss.org) requiring with [RequireJS](http://requirejs.org).
 
 Based on the ideas from [require-css module](https://github.com/guybedford/require-css), read the documentation there for further usage instructions.
 
 Basic Overview
 --------------
 
-Allows the construction of scripts that can require LESS files, using the simple RequireJS syntax:
+Allows the construction of scripts that can require LESS files, using the simple [AMD](https://github.com/amdjs/amdjs-api/blob/master/AMD.md) syntax:
 
 ```javascript
 define(['less!styles/main'], function() {
@@ -18,6 +18,8 @@ define(['less!styles/main'], function() {
 
 When run the in the browser, less is downloaded, parsed and injected. When running a build with the RequireJS optimizer, less is compiled into the build layers dynamically as css with compression support, or into a separate file with the `separateCSS` build option.
 
+The plugin also can be used alongside with [curl](https://github.com/cujojs/curl) to load and process less files.
+
 Normalization
 ---
 
@@ -50,6 +52,45 @@ map: {
 
 Package configuration can also be used here alternatively.
 
+Configuration
+-------------
+
+You can specify [Less options](http://lesscss.org/usage/#using-less-in-the-browser-client-side-options) using `less` key in [require configuration object](http://requirejs.org/docs/api.html#config).
+For example:
+
+```javascript
+require.config({
+  ...
+  less: {
+    globalVars: {
+      var1: 'value1',
+      var2: 'value2',
+    },
+    ...
+  }
+});
+```
+
+Besides [Less options](http://lesscss.org/usage/#using-less-in-the-browser-client-side-options) you can set the following options to customize work of the plugin:
+
+* `fileExt`: `String` - the extension that should be added when the resource name does not have `.css` extension; default value is `.less`
+* `importOption`: `String` - the [import option](http://lesscss.org/features/#import-options) that should be used to load and parse the resource; default value is `multiple`
+
+For example, those options together allow using Less in `.css` files:
+
+```javascript
+require.config({
+  ...
+  less: {
+    ...
+    fileExt: '.css',
+    importOption: 'less'
+  }
+});
+```
+
+See `example-2` for details.
+
 Builds
 ------
 

diff --git a/example-2/css/1.css b/example-2/css/1.css
@@ -0,0 +1,6 @@
+@import (less) "2.css";
+
+h1 {
+    color: @textcolor;
+    font-size: @font-size;
+}
diff --git a/example-2/css/2.css b/example-2/css/2.css
@@ -0,0 +1,5 @@
+@font-size: 50px;
+
+body {
+    background: @background;
+}
diff --git a/example-2/index.html b/example-2/index.html
@@ -0,0 +1,35 @@
+<!doctype html>
+<html>
+<!--script type='text/javascript' src='../lessc.js'></script-->
+<script type='text/javascript' src='lib/require.js'></script>
+<script>
+  require.config({
+    baseUrl: '.',
+    packages: [
+      {
+        name: 'less',
+        location: '..',
+        main: 'less'
+      }
+    ],
+    less: {
+        globalVars: {
+            textcolor: '#0c0',
+            background: '#002'
+        },
+        fileExt: '.css',
+        importOption: 'less'
+    }
+  });
+</script>
+
+<script>
+  require(['less!css/1'], function() {
+    document.getElementById("header").innerHTML = "Less styles applied!";
+  });
+</script>
+
+<body>
+<h1 id="header">test</h1>
+</body>
+</html>