[Bug driver/12602] New: -pthreads and -threads undocumented for Solaris

[sebor at roguewave dot com]

PLEASE REPLY TO gcc-bugzilla@gcc.gnu.org ONLY, *NOT* gcc-bugs@gcc.gnu.org.

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

           Summary: -pthreads and -threads undocumented for Solaris
           Product: gcc
           Version: 3.3
            Status: UNCONFIRMED
          Severity: normal
          Priority: P2
         Component: driver
        AssignedTo: unassigned at gcc dot gnu dot org
        ReportedBy: sebor at roguewave dot com
                CC: gcc-bugs at gcc dot gnu dot org

The target-specific gcc command line options -pthreads and -threads implemented
in gcc 2.95.2 with this patch [1] and still available in gcc 3.3 are not
documented in the gcc manual. This is a request to document the options
according to their historical behavior. Note that it was suggested in this
thread [2] that the options may not be used without reconfiguring the compiler
for the particular thread model. The documention here [3] explains why this
should not be (and a large body of successfully tested code confirms that indeed
it isn't) necessary.

Regards
Martin

PS The suggested documentation might be something along the following lines
(following the documentation of the gcc -threads options for HP-UX):

-pthreads
    Add support for multithreading using the POSIX threads library under
    Solaris. This option sets flags for both the preprocessor and linker.
    This option does not affect the thread safety of object code produced
    by the compiler or that of libraries supplied with it.

-threads
    Add support for multithreading using the Solaris threads library. This
    option sets flags for both the preprocessor and linker. This option does
    not affect the thread safety of object code produced by the compiler or
    that of libraries supplied with it.

The most suitable place for this documentation seems to be here [4].

[1] http://gcc.gnu.org/ml/gcc/1997-09/msg01087.html
[2] http://gcc.gnu.org/ml/libstdc++/2003-10/msg00112.html
[3] http://docs.sun.com/db/doc/805-5080/6j4q7emhs?a=view
[4] http://gcc.gnu.org/onlinedocs/gcc-3.3.1/gcc/SPARC-Options.html#SPARC%20Options