diff --git a/README.md b/README.md
index 9fdf6a5..d8be752 100644
--- a/README.md
+++ b/README.md
@@ -58,3 +58,9 @@
 ### Mac OS
 
 Chris Molozian has added DUB to [Homebrew](http://mxcl.github.io/homebrew/). Use `brew install dub` or `brew install dub --HEAD` to install the stable or the git HEAD version respectively.
+
+
+Using DUB as a library
+----------------------
+
+The [DUB package of DUB](http://code.dlang.org/packages/dub) can be used as a library to load or manipulate packages, or to resemble any functionality of the command line tool. The former task can be achieved by using the [Package class](https://github.com/rejectedsoftware/dub/blob/master/source/dub/package_.d#L40). For examples on how to replicate the command line functionality, see [commandline.d](https://github.com/rejectedsoftware/dub/blob/master/source/dub/commandline.d).
\ No newline at end of file