1.1 --- a/docs/README-ios.md	Sun Aug 27 19:10:30 2017 -0700
     1.2 +++ b/docs/README-ios.md	Sun Aug 27 22:15:57 2017 -0400
     1.3 @@ -7,9 +7,12 @@
     1.4  
     1.5  Requirements: Mac OS X 10.8 or later and the iOS 7+ SDK.
     1.6  
     1.7 -Instructions:
     1.8 -1.  Open SDL.xcodeproj (located in Xcode-iOS/SDL) in Xcode.
     1.9 -2.  Select your desired target, and hit build.
    1.10 +Instructions:
    1.11 +
    1.12 +1.  Either download [Molten](https://moltengl.com/free-trial/) and unzip it or download the Vulkan headers from Khronos's [Vulkan-Docs](https://github.com/KhronosGroup/Vulkan-Docs/tree/1.0/src/vulkan) repo and put them in a directory hierarchy `include/vulkan`.
    1.13 +2.  Open SDL.xcodeproj (located in Xcode-iOS/SDL) in Xcode.
    1.14 +3.  Set a `VULKAN_SDK` custom path in the Xcode preferences. Select *Custom Paths* on the *Locations* tab. The value should be either the `MoltenVK` directory within the unzipped Molten package or the parent of the `include/vulkan` hierarchy.
    1.15 +4.  Select your desired target, and hit build.
    1.16  
    1.17  There are three build targets:
    1.18  - libSDL.a:
    1.19 @@ -24,7 +27,9 @@
    1.20  Build SDL for iOS from the command line
    1.21  ==============================================================================
    1.22  
    1.23 -1. cd (PATH WHERE THE SDL CODE IS)/build-scripts
    1.24 +1. Follow step 1 above.
    1.25 +2. Either create and export a `VULKAN_SDK` environment variable with the value described in step 3 above or open Xcode, set the custom path described in step 3 above and close Xcode.
    1.26 +3. cd (PATH WHERE THE SDL CODE IS)/build-scripts
    1.27  2. ./iosbuild.sh
    1.28  
    1.29  If everything goes fine, you should see a build/ios directory, inside there's