--- old/doc/building.md 2019-01-15 17:15:50.322892898 +0100 +++ new/doc/building.md 2019-01-15 17:15:49.906891073 +0100 @@ -527,6 +527,34 @@ Use `--with-libffi=` if `configure` does not properly locate your libffi files. +### SoftFloat + +[Berkeley SoftFloat-3](http://www.jhauser.us/arithmetic/SoftFloat.html) +can be used on ARM processors without FPU to slightly enhance +the arithmetic precision of some floating point operations. It is not +required, system softfp routines can be used without any problems. +The precision loss is extremely small, but it can be detected during JCK testing. + + * To build the library, you will have to download its source and build it + for the target platform. To do so, take a look in its + `build/Linux-ARM-VFPv2-GCC` subdirectory. + * Alternatively, + [SoftFloat-3e for OpenJDK](https://github.com/ev3dev-lang-java/softfloat-openjdk) + repository provides a build script and a README for the process. + +You can enable this library by specifying a library prefix +via `--with-sflt=` or by specifying path to softfloat.a +via `--with-sflt-lib=` and path to directory +containing softfloat.h via `--with-sflt-include=`. You +will also need to specify path to the SoftFloat license file with +`--with-sflt-license=`. If you want to use the prefix option, ensure that +`/lib/softfloat.a`, `/include/softfloat.h` and +`/share/softfloat/softfloat.md` exist. However you can override +the defaults by using the options above. + +If you do not enable this library, standard system libraries +will be used instead. + ## Build Tools Requirements ### Autoconf @@ -694,6 +722,8 @@ * `--with-x=` - Set the path to [X11](#x11) * `--with-alsa=` - Set the path to [ALSA](#alsa) * `--with-libffi=` - Set the path to [libffi](#libffi) + * `--with-sflt=` - Enable and set the path to [SoftFloat](#softfloat) + library. * `--with-jtreg=` - Set the path to JTReg. See [Running Tests]( #running-tests)