diff --git a/changelog.markdown b/changelog.markdown
index afac2b54..75ee2880 100644
--- a/changelog.markdown
+++ b/changelog.markdown
@@ -11,6 +11,7 @@ This is a major release containing four new features:
 - Support for lock files.
 - Download tarballs when downloading packages from GitHub.
 - A setup command.
+- Added a `--package, -p` command line option.
 
 ## 0.13.0
 
diff --git a/readme.markdown b/readme.markdown
index f6e1707b..6432d8dc 100644
--- a/readme.markdown
+++ b/readme.markdown
@@ -436,7 +436,12 @@ files.
 The `run` command can be used to build and run any binary specified in your
 package's `bin` list. The binary needs to be specified after any compilation flags
 if there are several binaries defined. Any flags after the binary or `--`
-are passed to the binary when it is run.
+are passed to the binary when it is run. It is possible to run a binary from some
+dependency package. To do this pass the `--package, -p` option to Nimble. For example:
+
+```
+nimble --package:foo run <compilation_flags> bar <run_flags>
+```
 
 ### nimble c