docs/95275: Threading libraries in Porter's Handbook

[Jean-Baptiste Quenot]

>Number:         95275
>Category:       docs
>Synopsis:       Threading libraries in Porter's Handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Mon Apr 03 17:30:13 GMT 2006
>Closed-Date:
>Last-Modified:
>Originator:     Jean-Baptiste Quenot
>Release:        FreeBSD 5.5-PRERELEASE i386
>Organization:
>Environment:
System: FreeBSD vision.anyware 5.5-PRERELEASE FreeBSD 5.5-PRERELEASE #1: Thu Mar 9 19:20:53 CET 2006 jbq at vision.anyware:/usr/obj/usr/src/sys/VISION i386
>Description:
The porter's handbook must be improved because it does not state that ld does
not support -pthread, see patch below.  Thanks in advance!
>How-To-Repeat:
>Fix:
--- book.sgml.orig	Mon Apr  3 13:11:37 2006
+++ book.sgml	Mon Apr  3 13:28:39 2006
@@ -9529,6 +9529,14 @@
 	  different values, so do not just hardcode
 	  <literal>-pthread</literal> into patches and always use
 	  <makevar>PTHREAD_LIBS</makevar>.</para>
+
+  <note>
+    <para>FreeBSD may use value <literal>-pthread</literal> for
+      <makevar>PTHREAD_LIBS</makevar>, but <command>ld</command> does not
+      support this.  In this case, it may be desirable to use
+      <command>gcc</command> as linker by setting
+      <makevar>CONFIGURE_ENV</makevar> to <literal>LD=${CC}</literal>.</para>
+  </note>
       </sect1>
 
       <sect1 id="dads-freedback">
>Release-Note:
>Audit-Trail:
>Unformatted: