DLib: Compiling without AVX Support

doc/packages/dlib.section.md

8d8e08e14119ac5e8b786075db0c2d10abd0b633ba286717000000030000024f

# DLib {#dlib}

[DLib](http://dlib.net/) is a modern, C++\-based toolkit which provides several machine learning algorithms.

## Compiling without AVX support {#compiling-without-avx-support}

Especially older CPUs don't support [AVX](https://en.wikipedia.org/wiki/Advanced_Vector_Extensions) (Advanced Vector Extensions) instructions that are used by DLib to optimize their algorithms.

On the affected hardware, errors like `Illegal instruction` will occur. In those cases, AVX support needs to be disabled:

```nix
self: super: { dlib = super.dlib.override { avxSupport = false; }; }
```

Chunks

532c5b32 (1st chunk of `doc/packages/dlib.section.md`)

Title: DLib: Compiling without AVX Support

Summary

DLib is a modern C++ toolkit offering various machine learning algorithms. For older CPUs that lack Advanced Vector Extensions (AVX) support, DLib's optimized algorithms can cause `Illegal instruction` errors. To prevent this, AVX support can be disabled during compilation by overriding the `dlib` package with `avxSupport = false;`.