diff --git a/docs/caps.md b/docs/caps.md
index 2fb405f5c5e..8a4ed16ff4e 100644
--- a/docs/caps.md
+++ b/docs/caps.md
@@ -20,7 +20,7 @@ Appium server capabilities
 |`app-package`| Java package of the Android app you want to run|`com.example.android.myApp`, `com.android.settings`|
 |`app-wait-activity`| Activity name for the Android activity you want to wait for|`SplashActivity`|
 |`device-ready-timeout`| Timeout in seconds while waiting for device to become ready|`5`|
-|`compressXml`| [setCompressedLayoutHeirarchy(true)](http://developer.android.com/tools/help/uiautomator/UiDevice.html#setCompressedLayoutHeirarchy(boolean\))| `true`|
+|`compressXml`| [setCompressedLayoutHeirarchy(true)](http://developer.android.com/tools/help/uiautomator/UiDevice.html#setCompressedLayoutHeirarchy%28boolean%29)| `true`|
 |`androidCoverage`| Fully qualified instrumentation class. Passed to -w in adb shell am instrument -e coverage true -w | `com.my.Pkg/com.my.Pkg.instrumentation.MyInstrumentation`|
 
 --
@@ -34,8 +34,11 @@ Appium server capabilities
 |`language`| (Sim-only) Language to set for the iOS Simulator|e.g. `fr`|
 |`launchTimeout`| Amount of time in ms to wait for instruments before assuming it hung and failing the session|e.g. `20000`|
 |`locale`| (Sim-only) Locale to set for the iOS Simulator|e.g. `fr_CA`|
-|`locationServicesEnabled`| (Sim-only) Force location services to be either on or off|`true` or `false`|
-|`locationServicesAuthorized`| (Sim-only) Set location services to be authorized or not authorized for app via plist, so that location services alert doesn't pop up|`true` or `false`|
-|`autoAcceptAlerts`| Accept iOS privacy access permission alerts (e.g., location, contacts, photos) automatically if they pop up. Default is false.|
-|`nativeInstrumentsLib`| Use native intruments lib (ie disable instruments-without-delay).|
-|`nonSyntheticWebClick`| (Sim-only) Enable/Disable non synthetic web clicks in Safari.|
+|`locationServicesEnabled`| (Sim-only) Force location services to be either on or off. Default is to keep current sim setting.|`true` or `false`|
+|`locationServicesAuthorized`| (Sim-only) Set location services to be authorized or not authorized for app via plist, so that location services alert doesn't pop up. Default is to keep current sim setting.|`true` or `false`|
+|`autoAcceptAlerts`| Accept iOS privacy access permission alerts (e.g., location, contacts, photos) automatically if they pop up. Default is false.|`true` or `false`|
+|`nativeInstrumentsLib`| Use native intruments lib (ie disable instruments-without-delay).|`true` or `false`|
+|`nonSyntheticWebClick`| (Sim-only) Enable/Disable non synthetic web clicks in Safari.|`true` or `false`|
+|`safariAllowPopups`| (Sim-only) Allow javascript to open new windows in Safari. Default keeps current sim setting|`true` or `false`|
+|`safariIgnoreFraudWarning`| (Sim-only) Prevent Safari from showing a fraudulent website warning. Default keeps current sim setting.|`true` or `false`|
+|`safariOpenLinksInBackground`| (Sim-only) Whether Safari should allow links to open in new windows. Default keeps current sim setting.|`true` or `false`|