Updated Working for Web (HTML5) (markdown)

Working-for-Web-(HTML5).md

@@ -7,25 +7,39 @@ Download emscripten SDK from [here](http://kripken.github.io/emscripten-site/doc
     emsdk install git-1.9.4
     emsdk update
     emsdk list
-    emsdk install sdk-1.37.21-64bit
+    emsdk install sdk-1.38.6-64bit
 
-_NOTE: If a newer preconpiled SDK version (newer than sdk-1.37.21-64bit) is available, install new version. Precompiled SDK already includes latest version of clang, emscripten, python and node.js, so you don't have to install it separately._
+_NOTE: If a newer preconpiled SDK version (newer than sdk-1.38.6-64bit) is available, install new version. Precompiled SDK already includes version of **clang**, **emscripten**, **python**, **java JDK** and **node.js**, so you don't have to install it separately._
 
 ### Compiling raylib source code
 
-Before compiling your game, raylib library must be recompiled for HTML5. By default, when you install raylib using the Windows Installer, an already pre-compiled raylib HTML5 version is found in `C:\raylib\raylib\src\libraylib.bc`. Notepad++ uses this version but you can regenerate it just recompiling raylib for web (in case you have modified raylib sources or you updated it with GitHub develop branch sources).
+Before compiling your game, raylib library must be recompiled for HTML5. By default, when you install raylib using the *Windows Installer*, an already pre-compiled raylib HTML5 version is found in `C:\raylib\raylib\release\libs\html5\libraylib.bc`. Notepad++ uses this version but you can regenerate it just recompiling raylib for web (in case you have modified raylib sources or you updated it wit latesth GitHub sources).
+
+To compile raylib source code, just execute Notepad++ script: `raylib_makefile` and `SET PLATFORM=PLATFORM_WEB`. That script just calls the following `make` line (in case you're are working on a custom environment):
+
+    make PLATFORM=PLATFORM_WEB -B
+
+Generated `libraylib.bc` is copied in `..\release\libs\html5\libraylib.bc` directory.
 
 ### Preparing your raylib game for web
 
-To compile your game for web, code must be slightly adapted. Basically it implies moving all your Update and Draw code to an external function. The reason for that is the way web games work within a browser; the browser needs to control the game loop and just allow and Update-Draw cycle when the tab is active or browser is not minimized. 
+To compile your game for web, code must be slightly adapted. Basically it implies moving all your Update and Draw code to an external function. The reason for that is the way web games work within a browser; the browser needs to control the game loop and just allow and Update-Draw in a time-frame and lock the execution when the tab is not active or browser is minimized. More details [here](https://kripken.github.io/emscripten-site/docs/porting/emscripten-runtime-environment.html#browser-main-loop)
 
 To see how code should be refactored to fit compilation for web, check [core_basic_window_web.c](https://github.com/raysan5/raylib/blob/master/examples/core/core_basic_window_web.c) example.
 
+*NOTE: We are looking for some mechanism to avoid that code refactoring! [Here](https://kripken.github.io/emscripten-site/docs/porting/emterpreter.html#emterpreter-async-run-synchronous-code) it is a possible solution, despite a hit on performance.*
+
 ### Compiling raylib game
 
-Just open your raylib web-prepared game code and run the Notepad++ script named `raylib_compile_emscripten`. Note that script defines some paths to the required tools, check you are using the correct versions of those tools!
+Just open your raylib web-prepared game code and run the Notepad++ script named `raylib_makefile`, set `PLATFORM=PLATFORM_WEB`.
+
+Note that script defines some paths to the required tools, check you are using the correct versions of those tools!
 
 Note also that required resources should be embedded into a .data file using the compiler parameter `--preload-file filename.ext` or `--preload-file folder`.
 
 ### Testing raylib game
-To test the newly created .html file (and its .js and .data), just create a localhost (you can do it using python) and open the web in the browser (required google chrome).
+To test the newly created `.html` file (and its .js and .data), just create a localhost (you can do it using python) and open the web in the browser (required google chrome).
+
+Create localhost using python, make sure you set the local host from the same folder where your .html file is placed or keep in mind that the directory from which you set the localhost is the base directory for browser access:
+
+    python -m SimpleHTTPServer 8080