diff --git a/doc/BINPKG_REPOSITORY b/doc/BINPKG_REPOSITORY
index 72359065041..74b52a452ff 100644
--- a/doc/BINPKG_REPOSITORY
+++ b/doc/BINPKG_REPOSITORY
@@ -63,3 +63,46 @@ Here's how the package index plist file shall look like in a repository:
 		...
 	</array>
 </dict>
+
+To build binary packages from all currently installed packages in
+XBPS_MASTERDIR:
+
+	$ xbps-src.sh build-pkg all
+
+To generate the repository package index in default location
+XBPS_PACKAGESDIR (an additional path can be specified for another
+alternate location):
+
+	$ xbps-src.sh genindex
+
+After this you can add your own local repository with binary packages:
+
+	$ xbps-bin repo-add /path/to/dir
+	Added repository at /path/to/dir (1.0) with 6 packages.
+	$
+
+Once it's registered, you can start searching/installing/removing
+binary packages. You can add multiple repositories, the order for searching
+is the same than they were added; check it with:
+
+	$ xbps-bin repo-list
+	/storage/xbps/binpkgs
+	/path/to/dir
+	$
+
+The first repository that has the metadata for a package wins, if not found
+it will search in all them until it's found. A repository can also be
+unregistered from the pool:
+
+	$ xbps-bin repo-rm /path/to/dir
+
+To show information about available packages in the repository pool:
+
+	$ xbps-bin show package
+
+To search for binary packages by specifying a string:
+
+	$ xbps-bin search mypkg
+
+------------------------------------------------------------------------------
+	Juan Romero Pardines <xtraeme@gmail.com>