Inaccurate description of optimization levels
It should be described that Level1(2,3,4) is not just a set of optimization flags, but is also an optimization flag itself
In general, it would be good if you describe how optimization for these optimization flags (Level1/2/3/4) occurs if you specify only them (which is possible if you specify for example -O2 and disable everything it includes except -Level2.
Example: -O2 -OoNOCSE -OoNOCONSTS -OoNOREGVAR -OoNOSTACKFRAME -OoNOTAILREC -OoNOLEVEL1
Why is this necessary - because it is misleading
https://gitlab.com/freepascal.org/fpc/documentation/-/blob/main/tex/prog.tex?ref_type=heads#L6886 https://gitlab.com/freepascal.org/fpc/documentation/-/blob/main/tex/prog.tex?ref_type=heads#L1355 https://gitlab.com/freepascal.org/fpc/documentation/-/blob/main/tex/user.tex?ref_type=heads#L1335