diff --git a/doc/PKGBUILD.5.txt b/doc/PKGBUILD.5.txt
index 2ca3c98..2efacad 100644
@@ -47,6 +47,11 @@ similar to `$_basekernver`.
The version of the software as released from the author (e.g., '2.7.1').
The variable is not allowed to contain colons or hyphens.
+The `pkgver` variable can be automatically updated by providing a `pkgver()` function
+in the PKGBUILD that outputs the new package version. This is run after downloading
+and extracting the sources so can use those files in determining the new `pkgver`.
+This is most useful when used with sources from version control systems (see below).
This is the release number specific to the Arch Linux release. This