docs commit: CB-5093 Document versionCode & CFBundleVersion in config.xml

[ka...@apache.org]

Repository: cordova-docs
Updated Branches:
  refs/heads/master 0a5980644 -> 1d07d1d38


CB-5093 Document versionCode & CFBundleVersion in config.xml


Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/1d07d1d3
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/1d07d1d3
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/1d07d1d3

Branch: refs/heads/master
Commit: 1d07d1d38fa485d7d308a7ecbe753ff119ac52f5
Parents: 0a59806
Author: Mark Koudritsky <ka...@gmail.com>
Authored: Tue Jul 22 18:28:38 2014 -0400
Committer: Mark Koudritsky <ka...@gmail.com>
Committed: Tue Jul 22 18:28:38 2014 -0400

----------------------------------------------------------------------
 docs/en/edge/config_ref/index.md | 28 +++++++++++++++++++++++++++-
 1 file changed, 27 insertions(+), 1 deletion(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/1d07d1d3/docs/en/edge/config_ref/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/config_ref/index.md b/docs/en/edge/config_ref/index.md
index 9c32672..0a67d53 100644
--- a/docs/en/edge/config_ref/index.md
+++ b/docs/en/edge/config_ref/index.md
@@ -78,6 +78,10 @@ platforms:
   reverse-domain identifier, and the `version` its full version number
   expressed in major/minor/patch notation.
 
+  The widget tag can also have attributes that specify alternative versions,
+  namely versionCode for Android and CFBundleVersion for iOS. See the
+  Additional Versioning section below for details.
+
 - The `<name>` element specifies the app's formal name, as it appears
   on the device's home screen and within app-store interfaces.
 
@@ -99,6 +103,28 @@ platforms:
   platforms, as listed at the top of this page. The following sections
   detail preferences that apply to more than one platform.
 
+### Additional Versioning
+
+Both, Android and iOS support a second version string (or number) in addition
+to the one visible in app stores,
+[versionCode](http://developer.android.com/tools/publishing/versioning.html)
+for Android and
+[CFBundleVersion](http://stackoverflow.com/questions/4933093/cfbundleversion-in-the-info-plist-upload-error)
+for iOS.
+Below is an example that explicitly sets versionCode and CFBundleVersion
+
+        <widget id="io.cordova.hellocordova"
+          version="0.0.1"
+          android-versionCode="7"
+          ios-CFBundleVersion="3.3.3">
+
+If alternative version is not specified, the following
+defaults will be used:
+
+        // assuming version = MAJOR.MINOR.PATCH-whatever
+        versionCode = PATCH + MINOR * 100 + MAJOR * 10000
+        CFBundleVersion = "MAJOR.MINOR.PATCH"
+
 ## Global Preferences
 
 The following global preferences apply to all platforms:
@@ -151,7 +177,7 @@ all of them:
 
         <preference name="HideKeyboardFormAccessoryBar" value="true"/>
 
-  Applies to iOS and BlackBerry. 
+  Applies to iOS and BlackBerry.
 
 ## The _feature_ Element