flag 'latest' docs with a warning

master/docs/manual/conf.py

@@ -11,7 +11,7 @@
 # All configuration values have a default; values that are commented out
 # serve to show the default.
 
-import sys, os
+import sys, os, textwrap
 
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
@@ -55,6 +55,15 @@
 # The full version, including alpha/beta/rc tags.
 release = version
 
+# add a loud note for anyone loking at the latest docs
+if release == 'latest':
+    rst_prolog = textwrap.dedent("""\
+    .. caution:: This page documents the latest, unreleased version of
+        Buildbot.  For documentation for released versions, see
+        http://buildbot.net/buildbot/docs.
+
+    """)
+
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
 #language = None