[Bug driver/37786] New: Documentation for `-symbolic' needs fixing

[martinrb at google dot com]

gcc has flags -Bsymbolic and -Bsymbolic-functions
which are documented in the usage message.

 $ gcc -v --help 2>&1 | grep symbolic
  -Bsymbolic                  Bind global references locally
  -Bsymbolic-functions        Bind global function references locally

However, the info pages are incorrect and incomplete.

`-symbolic'
     Bind references to global symbols when building a shared object.
     Warn about any unresolved references (unless overridden by the
     link editor option `-Xlinker -z -Xlinker defs').  Only a few
     systems support this option.

In fact, gcc does not appear to support any such flag `-symbolic'.
`-symbolic' should probably be changed to `-Bsymbolic'.

Also, please add info documentation for `-Bsymbolic-functions'.

A motivating example for these options would be nice as well.
(or maybe a link to any corresponding binutils documentation)


-- 
           Summary: Documentation for `-symbolic' needs fixing
           Product: gcc
           Version: 4.2.3
            Status: UNCONFIRMED
          Severity: normal
          Priority: P3
         Component: driver
        AssignedTo: unassigned at gcc dot gnu dot org
        ReportedBy: martinrb at google dot com
GCC target triplet: x86_64-linux-gnu


http://gcc.gnu.org/bugzilla/show_bug.cgi?id=37786