From 1d3b0e2c196a53b8d0e0b8ecabf5b110f666c442 Mon Sep 17 00:00:00 2001 From: Marc Espie Date: Tue, 17 Oct 2000 05:20:14 +0000 Subject: [PATCH] invoke.texi (-shared): Insist on requiring code generation flags to be used along with -shared... 2000-10-17 Marc Espie * invoke.texi (-shared): Insist on requiring code generation flags to be used along with -shared, and document the subtle failure that may occur otherwise. From-SVN: r36896 --- gcc/ChangeLog | 6 ++++++ gcc/invoke.texi | 12 +++++++++--- 2 files changed, 15 insertions(+), 3 deletions(-) diff --git a/gcc/ChangeLog b/gcc/ChangeLog index 76e17bb0351..a93203aa253 100644 --- a/gcc/ChangeLog +++ b/gcc/ChangeLog @@ -1,3 +1,9 @@ +2000-10-17 Marc Espie + + * invoke.texi (-shared): Insist on requiring code generation flags + to be used along with -shared, and document the subtle failure that + may occur otherwise. + 2000-10-16 J. David Anglin * pa.md (return_internal): Move `use' after `return'. diff --git a/gcc/invoke.texi b/gcc/invoke.texi index d7320d187f3..52586dd0447 100644 --- a/gcc/invoke.texi +++ b/gcc/invoke.texi @@ -3307,9 +3307,15 @@ libraries. On other systems, this option has no effect. @item -shared Produce a shared object which can then be linked with other objects to -form an executable. Not all systems support this option. You must -also specify @samp{-fpic} or @samp{-fPIC} on some systems when -you specify this option. +form an executable. Not all systems support this option. For predictable +results, you must also specify the same set of options that were used to +generate code (@samp{-fpic}, @samp{-fPIC}, or model suboptions) +when you specify this option.@footnote{On some systems, @code{gcc -shared} +needs to build supplementary stub code for constructors to work. On +multi-libbed systems, @code{gcc -shared} must select the correct support +libraries to link against. Failing to supply the correct flags may lead +to subtle defects. Supplying them in cases where they are not necessary +is innocuous.} @item -symbolic Bind references to global symbols when building a shared object. Warn -- 2.30.2