1428702 - Note on emitting JS only seems incorrect

Status: RESOLVED FIXED

(Developer Documentation Graveyard :: General, defect, P1)

Description

[kestert]

:: Developer Documentation Request

      Request Type: Correction
     Gecko Version: unspecified
 Technical Contact: 

:: Details

I am referring to the following note:

Note: You could specify outputting just JavaScript rather than the full HTML by specifying a .js file instead of an HTML file in the -o flag, e.g. emcc -o hello2.js hello2.c -O3 -s WASM=1. You could then build your custom HTML complete from scratch. This isn't recommended however — Emscripten requires a large variety of JavaScript "glue" code to handle memory allocation, memory leaks, and a host of other problems, which is already included in the provided template. It is easier to use that than having to write it all out yourself, although as you become more experienced at what it all does, you'll be able to create your own customized versions for your needs.

This note starts of describing how to emit JS only instead of JS and HTML.  But then the note states: "This isn't recommended however...".  It's not clear how this warning applies to not generating HTML since the glue code it refers to lives in the JS file not the HTML file.  I suspect "This isn't recommended however..." was intended to refer to only emitting WASM.

Comment 1

[Chris Mills [:cmills]]

I agree with this — the glue file is separate .js anyway. I have updated the note to make the wording more accurate.