Skip to content

Commit 3b1b68a

Browse files
authored
Adjust section headers in SIMD doc (emscripten-core#26145)
This makes them match the other docs (e.g. pthreads) and makes the index levels match, so that under the "Porting" section in the index there is just one element for SIMD, which expands when you click on it.
1 parent 8c3abf4 commit 3b1b68a

File tree

1 file changed

+6
-6
lines changed

1 file changed

+6
-6
lines changed

site/source/docs/porting/simd.rst

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -33,15 +33,15 @@ See `WebAssembly Roadmap <https://webassembly.org/roadmap/>`_ for details about
3333

3434
An upcoming `Relaxed SIMD proposal <https://github.com/WebAssembly/relaxed-simd/tree/main/proposals/relaxed-simd>`_ will add more SIMD instructions to WebAssembly.
3535

36-
================================
36+
3737
GCC/Clang SIMD Vector Extensions
3838
================================
3939

4040
At the source level, the GCC/Clang `SIMD Vector Extensions <https://gcc.gnu.org/onlinedocs/gcc/Vector-Extensions.html>`_ can be used and will be lowered to WebAssembly SIMD instructions where possible.
4141

4242
This enables developers to create custom wide vector types via typedefs, and use arithmetic operators (+,-,*,/) on the vectorized types, as well as allow individual lane access via the vector[i] notation. However, the `GCC vector built-in functions <https://gcc.gnu.org/onlinedocs/gcc/x86-Built-in-Functions.html>`_ are not available. Instead, use the WebAssembly SIMD Intrinsics functions below.
4343

44-
===========================
44+
4545
WebAssembly SIMD Intrinsics
4646
===========================
4747

@@ -72,7 +72,7 @@ Pass flag ``-msimd128`` at compile time to enable targeting WebAssembly SIMD Int
7272

7373
Pass ``-mrelaxed-simd`` to target WebAssembly Relaxed SIMD Intrinsics. C/C++ code can use the built-in preprocessor define ``#ifdef __wasm_relaxed_simd__`` to detect when this target is active.
7474

75-
======================================
75+
7676
Limitations and behavioral differences
7777
======================================
7878

@@ -88,7 +88,7 @@ When porting native SIMD code, it should be noted that because of portability co
8888

8989
SIMD-related bug reports are tracked in the `Emscripten bug tracker with the label SIMD <https://github.com/emscripten-core/emscripten/issues?q=is%3Aopen+is%3Aissue+label%3ASIMD>`_.
9090

91-
===========================
91+
9292
Optimization considerations
9393
===========================
9494

@@ -140,7 +140,7 @@ When developing SIMD code to use WebAssembly SIMD, implementors should be aware
140140
- Included for orthogonality, these instructions have no equivalent x86 instruction and are `emulated with 10 x86 instructions in v8 <https://github.com/v8/v8/blob/b6520eda5eafc3b007a5641b37136dfc9d92f63d/src/compiler/backend/x64/code-generator-x64.cc#L2834-L2858>`_.
141141

142142

143-
=======================================================
143+
144144
Compiling SIMD code targeting x86 SSE* instruction sets
145145
=======================================================
146146

@@ -1231,7 +1231,7 @@ All the 128-bit wide instructions from AVX2 instruction set are listed.
12311231
Only a small part of the 256-bit AVX2 instruction set are listed, most of the
12321232
256-bit wide AVX2 instructions are emulated by two 128-bit wide instructions.
12331233

1234-
======================================================
1234+
12351235
Compiling SIMD code targeting ARM NEON instruction set
12361236
======================================================
12371237

0 commit comments

Comments
 (0)