← Back to branch summary

~ubuntu-branches/ubuntu/vivid/emscripten/vivid

« back to all changes in this revision

Viewing changes to debian/em++.1

  • Committer: Package Import Robot
  • Author(s): Sylvestre Ledru
  • Date: 2013-06-11 15:45:24 UTC
  • mfrom: (1.2.1) (2.1.1 experimental)
  • Revision ID: package-import@ubuntu.com-20130611154524-rppb3w6tixlegv4n
Tags: 1.4.7~20130611~a1eb425-1
* New snapshot release
* Upload to unstable

Show diffs side-by-side

added added

removed removed

Lines of Context:
debian/em++.1
1
 
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.40.10.
2
 
.TH EMCC "1" "May 2013" "emcc (Emscripten GCC-like replacement) 1.3.6 ()" "User Commands"
 
1
.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.41.2.
 
2
.TH EMCC "1" "June 2013" "emcc (Emscripten GCC-like replacement) 1.4.7 ()" "User Commands"
3
3
.SH NAME
4
 
emcc \- manual page for emcc (Emscripten GCC-like replacement) 1.3.6 ()
 
4
emcc \- Emscripten C++ compiler frontend
5
5
.SH DESCRIPTION
6
6
em++ [options] file...
7
7
.SS "Most normal gcc/g++ options will work, for example:"
17
17
No optimizations (default)
18
18
.TP
19
19
\fB\-O1\fR
20
 
Simple optimizations, including LLVM \fB\-O1\fR
 
20
Simple optimizations, including asm.js, LLVM \fB\-O1\fR
21
21
optimizations, and no runtime assertions
22
22
or C++ exception catching (to re\-enable
23
23
C++ exception catching, use
33
33
.TP
34
34
\fB\-O2\fR
35
35
As \fB\-O1\fR, plus the relooper (loop recreation),
36
 
plus LLVM \fB\-O2\fR optimizations
 
36
LLVM \fB\-O2\fR optimizations, and
 
37
.IP
 
38
\fB\-s\fR ALIASING_FUNCTION_POINTERS=1
37
39
.TP
38
40
\fB\-O3\fR
39
41
As \fB\-O2\fR, plus dangerous optimizations that may
40
42
break the generated code! This adds
41
43
.IP
 
44
\fB\-s\fR FORCE_ALIGNED_MEMORY=1
42
45
\fB\-s\fR DOUBLE_MODE=0
43
46
\fB\-s\fR PRECISE_I64_MATH=0
44
47
\fB\-\-closure\fR 1
46
49
.IP
47
50
This is not recommended at all. A better idea
48
51
is to try each of these separately on top of
49
 
\fB\-O2\fR to see what works. See the wiki for more
 
52
\fB\-O2\fR to see what works. See the wiki and
 
53
src/settings.js (for the \fB\-s\fR options) for more
50
54
information.
51
55
.TP
52
56
\fB\-s\fR OPTION=VALUE
71
75
.IP
72
76
\fB\-s\fR DEAD_FUNCTIONS=@/path/to/file
73
77
.IP
74
 
The contents of /path/to/file will be read,
 
78
The contents of \fI/path/to/file\fP will be read,
75
79
JSON.parsed and set into DEAD_FUNCTIONS (so
76
80
the file could contain
77
81
.IP
119
123
may require some changes to the code. This
120
124
is run by default in \fB\-O3\fR.
121
125
.IP
 
126
In asm.js mode, closure will only be used on the
 
127
\&'shell' code around the compiled code (the
 
128
compiled code will be processed by the custom
 
129
asm.js minifier).
 
130
.IP
122
131
Note: If closure compiler hits an out\-of\-memory,
123
132
try adjusting JAVA_HEAP_SIZE in the environment
124
133
(for example, to 4096m for 4GB).
321
330
build, so that adding an external reference
322
331
(also a global property) does not invalidate
323
332
everything.
 
333
.IP
 
334
Note that you should use \fB\-g\fR during the linking
 
335
stage (bitcode to JS), for jcache to work
 
336
(otherwise, JS minification can confuse it).
324
337
.TP
325
338
\fB\-\-clear\-cache\fR
326
339
Manually clears the cache of compiled