doc/en/gnome/docs/gnome_porting.sgml
2006-04-30 05:59:33 +00:00

137 lines
4 KiB
Text

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" [
<!ENTITY base CDATA "../..">
<!ENTITY date "$FreeBSD: www/en/gnome/docs/gnome_porting.sgml,v 1.17 2005/12/29 06:42:28 adamw Exp $">
<!ENTITY title "FreeBSD GNOME Project: GNOME Desktop-Independent Components">
<!ENTITY % navincludes SYSTEM "../includes.navgnome.sgml"> %navincludes;
<!ENTITY % gnomeincludes SYSTEM "../includes.sgml"> %gnomeincludes;
<!ENTITY % includes SYSTEM "../../includes.sgml"> %includes;
]>
<html>
&header;
<p> To see how to utilize these components, please examine the
<a href="example-Makefile.html">example Makefile</a>.
</p>
<!-- Begin USE_GNOME components list -->
<table class="tblbasic" summary="GNOME desktop-independent components">
<tr>
<th>COMPONENT</th>
<th>ASSOCIATED PROGRAM</th>
<th>IMPLIED COMPONENTS</th>
</tr>
<tr>
<td><tt>esound</tt></td>
<td><tt>audio/esound</tt></td>
<td><tt>&nbsp;</tt></td>
</tr>
<tr>
<td><tt>gnomehack</tt></td>
<td colspan="2"><tt>gnomehack</tt> makes common GNOME
Makefile substitutions that nearly every GNOME port
requires to fit into the proper mtree structure.
</td>
</tr>
<tr>
<td><tt>gnomehier</tt></td>
<td colspan="2"><tt>gnomehier</tt> installs all the
directories needed for both the GNOME 1 and 2 desktops.
Only include this option if your port calls <tt>@dirrm</tt>
on one of the directories listed in the plist for
<tt>gnomehier</tt>.
</td>
</tr>
<tr>
<td><tt>gnomemimedata</tt></td>
<td><tt>misc/gnomemimedata</tt></td>
<td><tt>gnomehier pkgconfig</tt></td>
</tr>
<tr>
<td><tt>gnomeprefix</tt></td>
<td><tt>gnomeprefix</tt> sets some CONFIGURE_ARGS
to ensure data is placed properly within the GNOME hierarchy.
</td>
<td><tt>gnomehier</tt></td>
</tr>
<tr>
<td><tt>gnometarget</tt></td>
<td><tt>gnometarget</tt> sets
<tt>${CONFIGURE_TARGET}</tt> for ports whose
<tt>configure</tt> script does not figure it out automatically.
</td>
<td><tt>&nbsp;</tt></td>
</tr>
<tr>
<td><tt>intlhack</tt></td>
<td><tt>intlhack</tt> registers a dependency upon
<tt>textproc/intltool</tt> and patches broken
<tt>intltool-merge.in</tt> implementations.
</td>
<td><tt>intltool</tt></td>
</tr>
<tr>
<td><tt>intltool</tt></td>
<td><tt>intltool</tt> registers a
BUILD_DEPENDS on
<tt>textproc/intltool</tt>.
</td>
<td><tt>&nbsp;</tt></td>
</tr>
<tr>
<td><tt>lthack</tt></td>
<td><tt>lthack</tt> prevents the installation of .la
files and ensures that <tt>${PTHREAD_LIBS}</tt>
will be passed to the linker.
<b>NOTE:</b> lthack is <b>DEPRECATED</b>,
and <tt>USE_AUTOTOOLS=libtool:15</tt> should be
used instead. See the <a
href="porting.html#libtool">libtool
section</a> of the porting guide for more
details.
</td>
<td><tt>&nbsp;</tt></td>
</tr>
<tr>
<td><tt>ltverhack</tt></td>
<td><tt>ltverhack</tt> noralizes shared
object versions so that they do not change
needlessly. Using <tt>ltverhack</tt>
keeps shared object versions in line with
what they should be and what they end up
being on other operating systems. In
order to use <tt>ltverhack</tt> the port
must define
<tt>USE_AUTOTOOLS=libtool:15</tt>.
</td>
<td><tt>&nbsp;</tt></td>
</tr>
<tr>
<td><tt>pkgconfig</tt></td>
<td><tt>pkgconfig</tt> registers a dependency upon
<tt>devel/pkgconfig</tt> to make sure it is installed.
</td>
<td><tt>&nbsp;</tt></td>
</tr>
</table>
<!-- End GNOME-related Makefile macros -->
<p>If you still need help with your port, have a look at some of
the <a href="/ports/gnome.html">existing ports</a> for examples.
The <a href="mailto:&email;@FreeBSD.org">freebsd-gnome mailing
list</a> is also there for you.</p>
&footer;
</body>
</html>