Mailing-List: contact commits-help@cordova.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@cordova.apache.org
Content-Type: text/plain; charset="us-ascii"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
From: filmaj@apache.org
To: commits@cordova.apache.org
Date: Thu, 18 Jul 2013 20:47:50 -0000
Message-Id: <5e1bbac15ce241caa139b4d06ed7c73b@git.apache.org>
Subject: [1/4] git commit: [CB-4286] Added known windows issue to README.md

Updated Branches:
  refs/heads/3.0.x 5fdc7e5fe -> 39f704fad


[CB-4286] Added known windows issue to README.md


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

Branch: refs/heads/3.0.x
Commit: a8c3fdccd06fae2867d07b5fcffed1a5a90c5935
Parents: 5fdc7e5
Author: ldeluca <ldeluca@us.ibm.com>
Authored: Wed Jul 17 14:55:48 2013 -0400
Committer: Fil Maj <maj.fil@gmail.com>
Committed: Thu Jul 18 13:46:38 2013 -0700

----------------------------------------------------------------------
 README.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/cordova-cli/blob/a8c3fdcc/README.md
----------------------------------------------------------------------
diff --git a/README.md b/README.md
index bafebe7..3d0bc5e 100644
--- a/README.md
+++ b/README.md
@@ -175,6 +175,31 @@ Please check [Cordova issues with the CLI Component](http://issues.cordova.io).
 - Which mobile SDKs you have installed, and which version. Related to this: which Xcode version if you are submitting issues related to iOS
 - Any error stack traces you received
 
+## Known Issues and Troubleshooting
+
+#Windows
+When trying to add a platform on a Windows machine if you run into the following error message:
+    cordova library for "android" already exists. No need to download. Continuing.
+    Checking if platform "android" passes minimum requirements...
+    Checking Android requirements...
+    Running "android list target" (output to follow)
+    
+    Error: The command `android` failed. Make sure you have the latest Android SDK installed, and the `android` command (inside the tools/ folder) added t
+    o your path. Output:
+    at C:\Users\me\AppData\Roaming\npm\node_modules\cordova\src\platform.js:185:42
+    at C:\Users\me\AppData\Roaming\npm\node_modules\cordova\src\metadata\android_parser.js:50:13
+    at C:\Users\me\AppData\Roaming\npm\node_modules\cordova\node_modules\shelljs\shell.js:1707:7
+    at exithandler (child_process.js:633:7)
+    at ChildProcess.errorhandler (child_process.js:649:5)
+    at ChildProcess.EventEmitter.emit (events.js:95:17)
+    at Process.ChildProcess._handle.onexit (child_process.js:787:12)
+
+run the command "android list target".  If you see:
+    'xcopy' is not recognized as an internal or external command,
+    operable program or batch file.
+
+at the beginning of the command output, it means you will need to update your Windows Path variable to include xcopy. This location is typically under C:\Windows\System32. 
+
 ## Contributors
 
 Thanks to everyone for contributing! For a list of people involved, please see the `package.json` file.