From c3904476cb1ad67c6a663f7b1e9f6e9f9de42e02 Mon Sep 17 00:00:00 2001
From: Konrad Rosenbaum <konrad@silmor.de>
Date: Mon, 19 Dec 2011 13:35:08 +0100
Subject: [PATCH] add info file for version info

---
 doc/versioninfo.txt |   51 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 51 insertions(+), 0 deletions(-)
 create mode 100644 doc/versioninfo.txt

diff --git a/doc/versioninfo.txt b/doc/versioninfo.txt
new file mode 100644
index 0000000..7b63ffc
--- /dev/null
+++ b/doc/versioninfo.txt
@@ -0,0 +1,51 @@
+Version Info Algorithms
+#########################
+
+Below you'll find some hints on how version info is
+collected. 
+
+All
+=====
+
+QString versionInfo(enum VersionInfo)...
+
+does:
+1) comm version self/need (VersionComm,VersionCommNeeded)
+2) HR version (VersionHumanReadable/VersionHR)
+3) date/time of generating wob files (VersionGenTime)
+4) version of Woc and QtBase itself (VersionWoc, VersionLib)
+5) version control system (VersionSystem: svn, git, none)
+
+SVN Version Info
+==================
+
+does:
+1) SVN URL (svn info --xml) (VersionURL)
+2) ...Repo Root (VersionRootURL)
+3) Revision ID Range (svn stat -v --xml) (VersionNumber)
+4) ...modified flag (VersionLocallyModified)
+
+Could also:
+5) ...date/time (range) of commit (VersionTime)
+6) ...author(s) (VersionAuthor)
+
+GIT Version Info
+=================
+
+1) checked out local branch (git branch -v)
+2) checked out revision (git log -1 --format=raw) (VersionNumber)
+3) ...author/committer (VersionAuthor)
+4) ...date/time of commit (VersionTime)
+5) local repo (hostname -f; pwd) (VersionURL, VersionRootURL)
+6) remote repo/branch (git config -l) (VersionRootURL)
+7) remote revision and diff (git log .... (remotes/dings/da)) (VersionAuthor,VersionTime,VersionNumber)
+
+use remote vs. local: if remote and local are identical use remote, otherwise local; no diff for now
+
+None Version Info
+==================
+
+1) host and path (VersionURL == VersionRootURL)
+2) local user (VersionAuthor)
+3) current time (VersionTime)
+4) modification flag (VersionLocallyModified=='local')
-- 
1.7.2.5