+2019-01-09 Eric Botcazou <ebotcazou@adacore.com>
+
+ * doc/invoke.texi (-Os): Add reference to -finline-functions.
+ (-finline-small-functions): Add references to -O3 and -Os.
+ (-findirect-inlining): Likewise.
+ (-finline-functions): Add references to -Os, -fprofile-use and
+ -fauto-profile.
+
2019-01-03 Iain Sandoe <iain@sandoe.co.uk>
revert:
@item -Os
@opindex Os
Optimize for size. @option{-Os} enables all @option{-O2} optimizations that
-do not typically increase code size. It also performs further
-optimizations designed to reduce code size.
+do not typically increase code size.
@option{-Os} disables the following optimization flags:
@gccoptlist{-falign-functions -falign-jumps -falign-loops @gol
-falign-labels -freorder-blocks -freorder-blocks-algorithm=stc @gol
-freorder-blocks-and-partition -fprefetch-loop-arrays}
+It also enables @option{-finline-functions}, causes the compiler to tune for
+code size rather than execution speed, and performs further optimizations
+designed to reduce code size.
+
@item -Ofast
@opindex Ofast
Disregard strict standards compliance. @option{-Ofast} enables all
in this way. This inlining applies to all functions, even those not declared
inline.
-Enabled at level @option{-O2}.
+Enabled at level @option{-O2}, @option{-O3}, @option{-Os}.
@item -findirect-inlining
@opindex findirect-inlining
when inlining itself is turned on by the @option{-finline-functions}
or @option{-finline-small-functions} options.
-Enabled at level @option{-O2}.
+Enabled at level @option{-O2}, @option{-O3}, @option{-Os}.
@item -finline-functions
@opindex finline-functions
declared @code{static}, then the function is normally not output as
assembler code in its own right.
-Enabled at level @option{-O3}.
+Enabled at levels @option{-O3}, @option{-Os}. Also enabled
+by @option{-fprofile-use} and @option{-fauto-profile}.
@item -finline-functions-called-once
@opindex finline-functions-called-once