docs/88454: [patch] Porter's Handbook: Update sec. on Shared Libraries

[vs]

>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:          open
>Quarter:        
>Keywords:      
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Thu Nov 03 14:30:12 GMT 2005
>Closed-Date:
>Last-Modified:
>Originator:     Volker Stolz
>Release:        FreeBSD 4.11-STABLE i386
>Organization:

Lehrstuhl f?r Informatik II; RWTH Aachen Universit?t
>Environment:
System: FreeBSD menelaos.informatik.rwth-aachen.de 4.11-STABLE FreeBSD 4.11-STABLE #23: Fri Jan 14 09:26:11 CET 2005 [hidden email]:/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:
>Unformatted:
_______________________________________________
[hidden email] mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "[hidden email]"

[Simon L. B. Nielsen-4]

The following reply was made to PR docs/88454; it has been noted by GNATS.

From: "Simon L. Nielsen" <[hidden email]>
To: Volker Stolz <[hidden email]>
Cc: [hidden email]
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--
_______________________________________________
[hidden email] mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "[hidden email]"

[vs]

Synopsis: [patch] Porter's Handbook: Update sec. on Shared Libraries

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
_______________________________________________
[hidden email] mailing list
http://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "[hidden email]"