--- Comment #5 from Andrew Pinski <pinskia at gcc dot gnu.org> ---
(In reply to Eric Gallager from comment #4)
> That's confusing. Is there anywhere in the documentation or somewhere that
> this could be clarified? Maybe a "Commonly Confused Compiler Options" page
> in the wiki or something?
The documentation is clear here and even mentions -pie option for the link
These options are similar to -fpic and -fPIC, but the generated
position-independent code can be only linked into executables. Usually these
options are used to compile code that will be linked using the -pie GCC option.
-fpie and -fPIE both define the macros __pie__ and __PIE__. The macros have the
value 1 for -fpie and 2 for -fPIE.
---- CUT ---
I think someone did not read the documentation after all.