diff --git a/doc/manual.txt b/doc/manual.txt
index d7db09340d6..e870935022b 100644
--- a/doc/manual.txt
+++ b/doc/manual.txt
@@ -176,12 +176,17 @@ rather than additional binary package names.
  True if `xbps-src` is cross compiling a package.
 
 *DESTDIR*::
- Full path to the fake destdir used by the `source section`, set to
+ Full path to the fake destdir used by the source pkg, set to
 `${XBPS_MASTERDIR}/destdir/${sourcepkg}-${version}`.
 
+*FILESDIR*::
+ Full path to the `files` package directory, i.e `srcpkgs/foo/files`.
+ The `files` directory can be used to store additional files to be installed
+ as part of the source package.
+
 *PKGDESTDIR*::
- Full path to the fake destdir used by the `pkg_install()` function in the
-`package section`, set to `${XBPS_MASTERDIR}/destdir/${pkgname}-${version}`.
+ Full path to the fake destdir used by the `pkg_install()` function in
+ `subpackages`, set to `${XBPS_MASTERDIR}/destdir/${pkgname}-${version}`.
 
 *XBPS_MACHINE*::
  The machine architecture as returned by `uname -m`.
@@ -198,11 +203,11 @@ rather than additional binary package names.
 *XBPS_FETCH_CMD*::
  The utility to fetch files from `ftp`, `http` of `https` servers.
 
-Source section
---------------
+Available variables
+-------------------
 Mandatory variables
 ~~~~~~~~~~~~~~~~~~~
-The list of mandatory variables in the `source section`:
+The list of mandatory variables for a template:
 
 *homepage*::
  A string pointing to the `upstream` homepage.
@@ -551,7 +556,7 @@ Run-time dependencies
 ---------------------
 Dependencies for ELF executables or shared libraries are detected
 automatically by `xbps-src`, hence run-time dependencies must not be specified
-in the *package sections* with the following exceptions:
+in templates with the following exceptions:
 
 - ELF binaries using dlopen(3).
 - non ELF objects, i.e perl/python/ruby/etc modules.