diff --git a/README.md b/README.md
index 1f615532..ea999ffb 100755
--- a/README.md
+++ b/README.md
@@ -19,6 +19,16 @@ Requires
 - Apache ANT
 - Android SDK [http://developer.android.com](http://developer.android.com)
 
+
+Building
+---
+
+To create your phonegap.jar, run in the framework directory:
+
+    android update project -p . -t android-15
+    ant jar
+
+
 Cordova Android Developer Tools
 ---
 
diff --git a/framework/res/xml/phonegap.xml b/framework/res/xml/phonegap.xml
index f57d9ab5..69e48763 100644
--- a/framework/res/xml/phonegap.xml
+++ b/framework/res/xml/phonegap.xml
@@ -1,6 +1,19 @@
 <?xml version="1.0" encoding="utf-8"?>
 <phonegap>
-    <access origin="http://127.0.0.1*"/>
+	<!--  
+	access elements control the Android whitelist.  
+	Domains are assumed blocked unless set otherwise
+	 -->
+
+    <access origin="http://127.0.0.1*"/> <!-- allow local pages -->
+
+	<!-- <access origin="https://example.com" /> allow any secure requests to example.com -->
+	<!-- <access origin="https://example.com" subdomains="true" /> such as above, but including subdomains, such as www -->
+	<!-- <access origin=".*"/> Allow all domains, suggested development use only -->
+
     <log level="DEBUG"/>
     <render legacy="true" />
 </phonegap>
+
+
+