diff --git a/documentation/ref-manual/usingpoky.xml b/documentation/ref-manual/usingpoky.xml
index 3b0940f826..677b5a21a7 100644
--- a/documentation/ref-manual/usingpoky.xml
+++ b/documentation/ref-manual/usingpoky.xml
@@ -545,6 +545,58 @@
busybox-staticdev busybox-locale
+
+
+ Finally, for those recipes that are fetched from a version control
+ system (such as Git) there is a file that lists the source revision(s)
+ specified in the recipe and the actual revision used when building
+ (which may be different when SRCREV is set to
+ ${AUTOREV} for example). Here is an example
+ of one of these files:
+ buildhistory/packages/emenlow-poky-linux/linux-yocto/latest_srcrev):
+
+ # SRCREV_machine = "b5c37fe6e24eec194bb29d22fdd55d73bcc709bf"
+ SRCREV_machine = "b5c37fe6e24eec194bb29d22fdd55d73bcc709bf"
+ # SRCREV_emgd = "caea08c988e0f41103bbe18eafca20348f95da02"
+ SRCREV_emgd = "caea08c988e0f41103bbe18eafca20348f95da02"
+ # SRCREV_meta = "c2ed0f16fdec628242a682897d5d86df4547cf24"
+ SRCREV_meta = "c2ed0f16fdec628242a682897d5d86df4547cf24"
+
+ You can use the buildhistory-collect-srcrevs
+ command to collect the stored SRCREV values
+ from build history and report them in a format suitable for use in
+ global configuration (for example, local.conf or a distro include
+ file) to override floating AUTOREV values to a fixed set of revisions.
+ Here is some example output from this command:
+
+ # emenlow-poky-linux
+ SRCREV_machine_pn-linux-yocto = "b5c37fe6e24eec194bb29d22fdd55d73bcc709bf"
+ SRCREV_emgd_pn-linux-yocto = "caea08c988e0f41103bbe18eafca20348f95da02"
+ SRCREV_meta_pn-linux-yocto = "c2ed0f16fdec628242a682897d5d86df4547cf24"
+ # core2-poky-linux
+ SRCREV_pn-kmod = "62081c0f68905b22f375156d4532fd37fa5c8d33"
+ SRCREV_pn-blktrace = "d6918c8832793b4205ed3bfede78c2f915c23385"
+ SRCREV_pn-opkg = "649"
+
+ Some notes on using the buildhistory-collect-srcrevs
+ command:
+
+ By default only values where the SRCREV was
+ not hardcoded (usually when AUTOREV was used) are reported
+ - use the -a option to see all SRCREV
+ values.
+ The output statements may not have any effect
+ in the face of overrides applied elsewhere in the build system
+ configuration; use the -f option to add the
+ forcevariable override to each output line
+ if you need to work around this.
+ The script does not do any special handling for
+ building for multiple machines; however it does place a
+ comment before each set of values specifying which triplet
+ (for example emenlow-poky-linux) that they
+ belong to as shown above.
+
+