diff --git a/doc/manual.txt b/doc/manual.txt
index 5edd3382b3..b72528d022 100644
--- a/doc/manual.txt
+++ b/doc/manual.txt
@@ -60,6 +60,21 @@ in a directory matching `$pkgname`, i.e: `xbps-packages/srcpkgs/foo/template`.
 If everything went fine after running `xbps-src build-pkg` a binary package
 called `foo-1.0_1.<arch>.xbps` will be generated in the local repository.
 
+Additional binary packages (those defined in `_package() blocks` need a
+symlink to the `main` package, like this:
+
+----------------------------------
+
+ /srcpkgs
+  |- foo <- directory
+  |  |- template
+  |- foo-devel <- symlink to `foo`
+
+----------------------------------
+
+Otherwise dependencies requiring those packages won't find its `template`
+file.
+
 Package build phases
 --------------------
 Building a package consist of the following phases: