Files
wuffs/doc
Claude f33e9f3377 std/softfloat: add bit-exact IEEE 754 binary64/binary32 arithmetic
Wuffs the Language has no floating point types, but some reference
implementations (notably the brotli encoder) make decisions with double and
float arithmetic and libm's log2. Porting them with byte-identical output
needs bit-exact floating point results.

This package implements f64 and f32 add, sub, mul, div, fma, comparisons,
min/max, integer conversions and f64<->f32 conversions on bit patterns,
with round-to-nearest-even, subnormals, infinities and NaNs, following the
structure of Berkeley SoftFloat 3. It also ports glibc 2.39's x86-64
__log2_fma log2 implementation (the variant selected on CPUs with FMA and
AVX2), following the shipped machine code's fused operations.

Verification: test/c/std/softfloat.c checks every operation against the C
compiler's native arithmetic on edge cases and random operands. The
script/manual-test-softfloat-*.c programs run 10^8 random operations per
operation group and compare log2_u64 against libm for every integer in
[1, 2^32) plus 10^7 larger values; all with zero mismatches.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011NoosQNe7DKWnqDCBeqw1p
2026-10-26 22:46:32 +00:00
..
2020-11-03 15:46:46 +11:00
2026-10-20 14:33:59 +11:00
2022-09-04 00:54:21 +10:00
2023-01-26 15:56:07 +11:00
2026-10-20 14:32:33 +11:00
2020-08-16 23:40:50 +10:00
2022-10-17 19:13:19 +11:00

This directory contains documentation about Wuffs' two aspects:

"Getting Started" has some suggestions if you're new. The top level README also has some general remarks. Its sections include:

  • Goals and Non-Goals
  • Hermeticity
  • What Does Wuffs Code Look Like?
  • What Does Compile Time Checking Look Like?
  • Directory Layout
  • Building
  • Documentation
  • Non-C/C++ Languages
  • Status
  • Discussion
  • Contributing
  • License
  • Disclaimer