Document how -O3 is handled by GHC
-O2 is the highest value of optimization. -O3 will be reverted to -O2. Refers to #12461 (closed).
Tested a build with:
nix-shell ./ghc.nix/ --run 'hadrian/build.sh -j --flavour=devel2 --freeze1 --verbose docs'
but couldnt get this incremental build command to work:
nix-shell ./ghc.nix/ --run 'hadrian/build.sh -j --flavour=devel2 --freeze1 --verbose _build/docs/pdfs/users_guide.pdf'