Document the new ltasneededhack component.

This commit is contained in:
Joe Marcus Clarke 2008-03-24 21:15:04 +00:00
parent 6d51730ab7
commit c43cba0c8f
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/www/; revision=31733

View file

@ -1,6 +1,6 @@
<!DOCTYPE HTML PUBLIC "-//FreeBSD//DTD HTML 4.01 Transitional-Based Extension//EN" [
<!ENTITY base CDATA "../..">
<!ENTITY date "$FreeBSD: www/en/gnome/docs/gnome_porting.sgml,v 1.21 2006/08/19 21:20:35 hrs Exp $">
<!ENTITY date "$FreeBSD: www/en/gnome/docs/gnome_porting.sgml,v 1.22 2007/06/21 06:55:20 marcus Exp $">
<!ENTITY title "FreeBSD GNOME Project: GNOME Desktop-Independent Components">
<!ENTITY email "freebsd-gnome">
<!ENTITY % navinclude.gnome "INCLUDE">
@ -100,9 +100,28 @@
<td><tt>&nbsp;</tt></td>
</tr>
<tr>
<td><tt>ltasneededhack</tt></td>
<td><tt>ltasneededhack</tt> hacks the port's
libtool so that the <tt>-Wl,--as-needed</tt>
flag is passed to the linker. This will result
in shared objects with smaller ELF NEEDED
sections which can improve the startup time
and module load time of some applications.
In order to use <tt>ltasneededhack</tt>
the port must define
<tt>USE_AUTOTOOLS=libtool:15</tt>.
<b>NOTE:</b> be sure to thoroughly test
the resulting application to make sure
there are no undefined symbol errors after
adding this hack.
</td>
<td><tt>&nbsp;</tt></td>
</tr>
<tr>
<td><tt>ltverhack</tt></td>
<td><tt>ltverhack</tt> noralizes shared
<td><tt>ltverhack</tt> normalizes shared
object versions so that they do not change
needlessly. Using <tt>ltverhack</tt>
keeps shared object versions in line with