Skip to content

Commit 7984ce5

Browse files
committedNov 18, 2015
Merge pull request WebAssembly#463 from WebAssembly/tf-consistency
Mention consistency on the web as a factor in the text format
2 parents ec06eeb + 149abe4 commit 7984ce5

File tree

1 file changed

+8
-1
lines changed

1 file changed

+8
-1
lines changed
 

‎TextFormat.md

+8-1
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,14 @@ statements and expressions (instead of the linear list of instructions most
2222
assembly languages have).
2323

2424
There is no requirement to use JavaScript syntax; this format is not intended to
25-
be evaluated or translated directly into JavaScript.
25+
be evaluated or translated directly into JavaScript. There may also be
26+
substantive reasons to use notation that is different than JavaScript (for
27+
example, WebAssembly has a 32-bit integer type, and it should be represented
28+
in the text format, since that is the natural thing to do for WebAssembly,
29+
regardless of JavaScript not having such a type). On the other hand,
30+
when there are no substantive reasons and the options are basically
31+
bikeshedding, then it does make sense for the text format to match existing
32+
conventions on the Web (for example, curly braces, as in JavaScript and CSS).
2633

2734
The text format isn't uniquely representable. Multiple textual files can assemble
2835
to the same binary file, for example whitespace isn't relevant and memory initialization

0 commit comments

Comments
 (0)