diff -r 000000000000 -r 6474c204b198 testing/mozbase/docs/mozversion.rst
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/testing/mozbase/docs/mozversion.rst	Wed Dec 31 06:09:35 2014 +0100
@@ -0,0 +1,78 @@
+:mod:`mozversion` --- Get application information
+=================================================
+
+`mozversion <https://github.com/mozilla/mozbase/tree/master/mozversion>`_
+provides version information such as the application name and the changesets
+that it has been built from. This is commonly used in reporting or for
+conditional logic based on the application under test.
+
+API Usage
+---------
+
+.. automodule:: mozversion
+    :members: get_version
+
+
+Command Line Usage
+------------------
+
+mozversion comes with a command line program, ``mozversion`` which may be used to
+get version information from an application.
+
+Usage::
+
+    mozversion [options]
+
+Options
+```````
+
+---binary
+'''''''''
+
+This is the path to the target application binary. If this is omitted then
+the current directory is checked for the existance of an application.ini file.
+If not found, then it is assumed the target application is a remote Firefox OS
+instance.
+
+
+---sources
+''''''''''
+
+The path to the sources.xml that accompanies the target application (Firefox OS
+only). If this is omitted then the current directory is checked for the
+existance of a sources.xml file.
+
+Examples
+````````
+
+Firefox::
+
+    $ mozversion --binary=/path/to/firefox-bin
+    application_buildid: 20131205075310
+    application_changeset: 39faf812aaec
+    application_name: Firefox
+    application_repository: http://hg.mozilla.org/releases/mozilla-release
+    application_version: 26.0
+    platform_buildid: 20131205075310
+    platform_changeset: 39faf812aaec
+    platform_repository: http://hg.mozilla.org/releases/mozilla-release
+
+Firefox OS::
+
+    $ mozversion --sources=/path/to/sources.xml
+    application_buildid: 20140106040201
+    application_changeset: 14ac61461f2a
+    application_name: B2G
+    application_repository: http://hg.mozilla.org/mozilla-central
+    application_version: 29.0a1
+    build_changeset: 59605a7c026ff06cc1613af3938579b1dddc6cfe
+    device_firmware_date: 1380051975
+    device_firmware_version_incremental: 139
+    device_firmware_version_release: 4.0.4
+    device_id: msm7627a
+    gaia_changeset: 9a222ac02db176e47299bb37112ae40aeadbeca7
+    gaia_date: 1389005812
+    gecko_changeset: 3a2d8af198510726b063a217438fcf2591f4dfcf
+    platform_buildid: 20140106040201
+    platform_changeset: 14ac61461f2a
+    platform_repository: http://hg.mozilla.org/mozilla-central