From stolz@i2.informatik.rwth-aachen.de  Thu Nov  3 14:26:12 2005
Return-Path: <stolz@i2.informatik.rwth-aachen.de>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 85A3316A41F
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  3 Nov 2005 14:26:12 +0000 (GMT)
	(envelope-from stolz@i2.informatik.rwth-aachen.de)
Received: from atlas.informatik.rwth-aachen.de (atlas.informatik.RWTH-Aachen.DE [137.226.194.2])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 5C68A43D88
	for <FreeBSD-gnats-submit@freebsd.org>; Thu,  3 Nov 2005 14:26:05 +0000 (GMT)
	(envelope-from stolz@i2.informatik.rwth-aachen.de)
Received: from i2.informatik.rwth-aachen.de (menelaos.informatik.RWTH-Aachen.DE [137.226.194.73])
	by atlas.informatik.rwth-aachen.de (8.12.10/8.12.10/SuSE Linux 0.7) with ESMTP id jA3EQ4XB010668
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 3 Nov 2005 15:26:04 +0100
Received: (from stolz@localhost)
	by i2.informatik.rwth-aachen.de (8.13.1/8.13.1/Submit) id jA3EQ4Gg023679;
	Thu, 3 Nov 2005 15:26:04 +0100 (CET)
	(envelope-from stolz)
Message-Id: <200511031426.jA3EQ4Gg023679@i2.informatik.rwth-aachen.de>
Date: Thu, 3 Nov 2005 15:26:04 +0100 (CET)
From: Volker Stolz <vs@freebsd.org>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [patch] Porter's Handbook: Update sec. on Shared Libraries
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         88454
>Category:       docs
>Synopsis:       [patch] Porter's Handbook: Update sec. on Shared Libraries
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Thu Nov 03 14:30:12 GMT 2005
>Closed-Date:    Fri Nov 04 09:23:50 GMT 2005
>Last-Modified:  Fri Nov 04 09:23:50 GMT 2005
>Originator:     Volker Stolz
>Release:        FreeBSD 4.11-STABLE i386
>Organization:
Lehrstuhl fr Informatik II; RWTH Aachen Universitt
>Environment:
System: FreeBSD menelaos.informatik.rwth-aachen.de 4.11-STABLE FreeBSD 4.11-STABLE #23: Fri Jan 14 09:26:11 CET 2005 root@menelaos.informatik.rwth-aachen.de:/usr/obj/usr/src/sys/MENELAOS i386


>Description:
Clarify unexpected consequences of setting LDCONFIG_DIRS.
Please review, I hope I got the markup right (compiling works).
>How-To-Repeat:
>Fix:
--- shlibs.diff begins here ---
Index: book.sgml
===================================================================
RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v
retrieving revision 1.625
diff -u -u -r1.625 book.sgml
--- book.sgml	2 Nov 2005 21:43:56 -0000	1.625
+++ book.sgml	3 Nov 2005 14:22:43 -0000
@@ -3869,6 +3869,16 @@
 	<programlisting>INSTALLS_SHLIB= yes
 LDCONFIG_DIRS=  %%PREFIX%%/lib/foo %%PREFIX%%/lib/bar</programlisting>
 
+	<para>Remember that non-standard directories will not be passed to
+	  <literal>/sbin/ldconfig</literal> on a reboot! If any port really
+	  needs this to work, install a startup-script as
+	  <literal>x11/kdelibs3</literal> does. Please double-check, often
+	  this is not necessary at all or can be avoided through
+	  <literal>-rpath</literal> or setting <makevar>LD_RUN_PATH</makevar>
+	  during linking (see <literal>lang/moscow_ml</literal> for an example),
+	  or through a shell-wrapper which sets <makevar>LD_LIBRARY_PATH</makevar>
+	  before invoking the binary, like <literal>www/mozilla</literal> does.</para>
+
 	<para>Note that content of <makevar>LDCONFIG_DIRS</makevar> is passed
 	  through &man.sed.1; just like the rest of <filename>pkg-plist</filename>,
 	  so <makevar>PLIST_SUB</makevar> substitutions also apply here.  It is
--- shlibs.diff ends here ---
>Release-Note:
>Audit-Trail:

From: "Simon L. Nielsen" <simon@FreeBSD.org>
To: Volker Stolz <vs@FreeBSD.org>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/88454: [patch] Porter's Handbook: Update sec. on Shared Libraries
Date: Thu, 3 Nov 2005 20:28:02 +0100

 --BXVAT5kNtrzKuDFl
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 Content-Transfer-Encoding: quoted-printable
 
 On 2005.11.03 15:26:04 +0100, Volker Stolz wrote:
 
 > --- shlibs.diff begins here ---
 > Index: book.sgml
 > =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=
 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D
 > RCS file: /home/dcvs/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml=
 ,v
 > retrieving revision 1.625
 > diff -u -u -r1.625 book.sgml
 > --- book.sgml	2 Nov 2005 21:43:56 -0000	1.625
 > +++ book.sgml	3 Nov 2005 14:22:43 -0000
 > @@ -3869,6 +3869,16 @@
 >  	<programlisting>INSTALLS_SHLIB=3D yes
 >  LDCONFIG_DIRS=3D  %%PREFIX%%/lib/foo %%PREFIX%%/lib/bar</programlisting>
 > =20
 > +	<para>Remember that non-standard directories will not be passed to
 
 I would suggest "Note that" instead.  Just sounds better IMO.
 
 > +	  <literal>/sbin/ldconfig</literal> on a reboot! If any port really
 
 You should use &man.ldconfig.8; instead of <literal>/...</literal>.
 Also I would suggest simply saying "boot" instead of "reboot".  Also
 you should use double space before new sentence (IE. after the "!").
 
 > +	  needs this to work, install a startup-script as
 > +	  <literal>x11/kdelibs3</literal> does. Please double-check, often
 
 Use <filename role=3D"package">x11/kdelibs3</filename> and double space
 after ".".
 
 > +	  this is not necessary at all or can be avoided through
 > +	  <literal>-rpath</literal> or setting <makevar>LD_RUN_PATH</makevar>
 
 Since LD_LIBRARY_PATH is an environment variable you should use <envar>.
 
 > +	  during linking (see <literal>lang/moscow_ml</literal> for an example),
 
 <filename role=3D"package"> again.
 
 > +	  or through a shell-wrapper which sets <makevar>LD_LIBRARY_PATH</makev=
 ar>
 > +	  before invoking the binary, like <literal>www/mozilla</literal> does.=
 </para>
 
 <filename role=3D"package"> again.
 
 Hope this helps.
 
 --=20
 Simon L. Nielsen
 
 --BXVAT5kNtrzKuDFl
 Content-Type: application/pgp-signature
 Content-Disposition: inline
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.4.2 (FreeBSD)
 
 iD8DBQFDamTBh9pcDSc1mlERAmDgAJ0dzhdRLO7RaTmOM0JHqnS+QVULHwCaAxm7
 hcOxO6euHV9sSL4gZqnygss=
 =uDRv
 -----END PGP SIGNATURE-----
 
 --BXVAT5kNtrzKuDFl--
State-Changed-From-To: open->closed 
State-Changed-By: vs 
State-Changed-When: Fri Nov 4 09:20:18 GMT 2005 
State-Changed-Why:  
Committed with modifications as suggested. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=88454 
>Unformatted:
