Update instructions about including libraries

1 files changed, 14 insertions, 6 deletions

diff --git a/README.md b/README.md
index 0de27c8..da44cf3 100644
--- a/README.md
+++ b/README.md
@@ -6,6 +6,8 @@ If you're using FreeBSD, Debian or Ubuntu, you can find this in the `arduino-mk`
 
 ## Usage
 
+You can also find more [detailed instructions in this guide](http://hardwarefun.com/tutorials/compiling-arduino-sketches-using-makefile) or also checkout the sample makefiles inside the examples/ folder
+
 Download a copy of this repo some where in your system.
 
 On the Mac you might want to set:
@@ -50,14 +52,20 @@ On other systems:
        cpanm Device::SerialPort
        cpanm YAML
 
-You can also find more [detailed instructions in this guide](http://hardwarefun.com/tutorials/compiling-arduino-sketches-using-makefile) or also checkout the sample makefiles inside the examples/ folder
+## Including Libraries
+
+You can specify space separated list of libraries that are needed for your sketch to the variable `ARDUINO_LIBS`.
+
+`ARDUINO_LIBS = Wire SoftwareSerial`
+
+The libraries will be searched in the following places in the following order.
+
+- `/libraries` folder inside your sketchbook folder. Sketchbook folder will be auto detected from your Arduino preference file. You can also manually set it through `ARDUINO_SKETCHBOOK`.
+- `/libraries` folder inside your Arduino folder, which is read from `ARDUINO_DIR`.
 
-## User Libraries
+The libraries inside user folder will take precedence over libraries present in Arduino core folder.
 
-In order to use Arduino libraries installed in the user's sketchbook folder (the
-standard location for custom libraries when using the Arduino IDE), you need to
-set the `ARDUINO_SKETCHBOOK` variable to point to this directory. By default it
-is set to `$HOME/sketchbook`.
+The makefile can autodetect the libraries that are included from your sketch and can include them automatically. But it can't detect libraries that are included from other libraries. (see [issue #93](https://github.com/sudar/Arduino-Makefile/issues/93))
 
 ## avrdude