* Mention that USE_GNOMENG is temporary until all ports have been migrated

to the new infrastructure
* Add information on what implicit components each explicit component imports
This commit is contained in:
Joe Marcus Clarke 2002-08-25 05:56:54 +00:00
parent 2f559cc0c7
commit 1edd933e3b
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/www/; revision=14007

View file

@ -1,6 +1,6 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" [
<!ENTITY base CDATA "../..">
<!ENTITY date "$FreeBSD: www/en/gnome/docs/porting.sgml,v 1.20 2002/08/21 18:50:38 marcus Exp $">
<!ENTITY date "$FreeBSD: www/en/gnome/docs/porting.sgml,v 1.21 2002/08/22 01:07:53 marcus Exp $">
<!ENTITY title "FreeBSD GNOME Project: How To Make a Port">
<!ENTITY % gnomeincludes SYSTEM "../includes.sgml"> %gnomeincludes;
<!ENTITY % includes SYSTEM "../../includes.sgml"> %includes;
@ -31,7 +31,7 @@
DEPENDS is sufficient for the time being.</p>
<p>The old infrastructure used the following Makefile macros
for building GNOME or GTK ports:</p>
for building GNOME or GTK+ ports:</p>
<pre>
USE_ESOUND
@ -101,73 +101,97 @@ USE_GNOME= &lt;list of GNOME components&gt;
<tt>devel/glib12</tt> (replaces <tt>USE_GLIB</tt>).</p></li>
<li><p><tt>gtk12</tt> : This adds a dependency on
<tt>x11-toolkits/gtk12</tt> (replaces <tt>USE_GTK</tt>).</p></li>
<tt>x11-toolkits/gtk12</tt> (replaces <tt>USE_GTK</tt>).<br>
<i>Implies</i>: <tt>glib12</tt></p></li>
<li><p><tt>libxml</tt> : This adds a dependency on
<tt>textproc/libxml</tt>.</p></li>
<tt>textproc/libxml</tt>.<br>
<i>Implies</i>: <tt>glib12</tt></p></li>
<li><p><tt>gdkpixbuf</tt> : This adds a dependency on
<tt>graphics/gdk-pixbuf</tt>.</p></li>
<tt>graphics/gdk-pixbuf</tt>.<br>
<i>Implies</i>: <tt>gtk12</tt></p></li>
<li><p><tt>imlib</tt> : This adds a dependency on
<tt>graphics/imlib</tt> (replaces <tt>USE_IMLIB</tt>).</p></li>
<tt>graphics/imlib</tt> (replaces <tt>USE_IMLIB</tt>).<br>
<i>Implies</i>: <tt>gtk12</tt></p></li>
<li><p><tt>orbit</tt> : This adds a dependency on
<tt>devel/ORBit</tt>.</p></li>
<tt>devel/ORBit</tt>.<br>
<i>Implies</i>: <tt>glib12</tt></p></li>
<li><p><tt>gnomelibs</tt> : This adds a dependency on
<tt>x11/gnomelibs</tt> (replaces <tt>USE_GNOMELIBS</tt>).</p></li>
<tt>x11/gnomelibs</tt> (replaces <tt>USE_GNOMELIBS</tt>).<br>
<i>Implies</i>: <tt>esound</tt> <tt>imlib</tt> <tt>libxml</tt>
<tt>orbit</tt></p></li>
<li><p><tt>gnomecanvas</tt> : This adds a dependency on
<tt>graphics/gnomecanvas</tt>.</p></li>
<tt>graphics/gnomecanvas</tt>.<br>
<i>Implies</i>: <tt>gnomelibs</tt> <tt>gdkpixbuf</tt></p></li>
<li><p><tt>oaf</tt> : This adds a dependency on
<tt>devel/oaf</tt>.</p></li>
<tt>devel/oaf</tt>.<br>
<i>Implies</i>: <tt>orbit</tt> <tt>libxml</tt></p></li>
<li><p><tt>gnomemimedata</tt> : This adds a dependency on
<tt>misc/gnomemimedata</tt>.</p></li>
<tt>misc/gnomemimedata</tt>.<br>
<i>Implies</i>: <tt>gnomehier</tt></p></li>
<li><p><tt>gconf</tt> : This adds a dependency on
<tt>devel/gconf</tt>.</p></li>
<tt>devel/gconf</tt>.<br>
<i>Implies</i>: <tt>oaf</tt></p></li>
<li><p><tt>gnomevfs</tt> : This adds a dependency on
<tt>devel/gnomevfs</tt>.</p></li>
<tt>devel/gnomevfs</tt>.<br>
<i>Implies</i>: <tt>gnomemimedata</tt> <tt>gconf</tt>
<tt>gnomelibs</tt></p></li>
<li><p><tt>libcapplet</tt> : This adds a dependency on
<tt>x11/libcapplet</tt> (replaces <tt>USE_GNOMECTRL</tt>).
If your port installs a configuration applet (or capplet),
you must include this option.</p></li>
you must include this option.<br>
<i>Implies</i>: <tt>gnomelibs</tt></p></li>
<li><p><tt>gnomeprint</tt> : This adds a dependency on
<tt>print/gnomeprint</tt>.</p></li>
<tt>print/gnomeprint</tt>.<br>
<i>Implies</i>: <tt>gnomelibs</tt> <tt>gnomecanvas</tt></p></li>
<li><p><tt>bonobo</tt> : This adds a dependency on
<tt>devel/bonobo</tt>.</p></li>
<tt>devel/bonobo</tt>.<br>
<i>Implies</i>: <tt>oaf</tt> <tt>gnomeprint</tt></p></li>
<li><p><tt>libgda</tt> : This adds a dependency on
<tt>databases/libgda</tt>.</p></li>
<tt>databases/libgda</tt>.<br>
<i>Implies</i>: <tt>gconf</tt> <tt>bonobo</tt></p></li>
<li><p><tt>gnomedb</tt> : This adds a dependency on
<tt>databases/gnomedb</tt>.</p></li>
<tt>databases/gnomedb</tt>.<br>
<i>Implies</i>: <tt>libgda</tt></p></li>
<li><p><tt>libglade</tt> : This adds a dependency on
<tt>devel/libglade</tt>.</p></li>
<tt>devel/libglade</tt>.<br>
<i>Implies</i>: <tt>gnomedb</tt></p></li>
<li><p><tt>gal</tt> : This adds a dependency on
<tt>x11-toolkits/gal</tt>.</p></li>
<tt>x11-toolkits/gal</tt>.<br>
<i>Implies</i>: <tt>libglade</tt></p></li>
<li><p><tt>glibwww</tt> : This adds a dependency on
<tt>www/glibwww</tt>.</p></li>
<tt>www/glibwww</tt>.<br>
<i>Implies</i>: <tt>gnomelibs</tt></p></li>
<li><p><tt>gtkhtml</tt> : This adds a dependency on
<tt>www/gtkhtml</tt>.</p></li>
<tt>www/gtkhtml</tt>.<br>
<i>Implies</i>: <tt>glibwww</tt> <tt>gal</tt> <tt>libghttp</tt>
<tt>libcapplet</tt></p></li>
<li><p><tt>libpanel</tt> : This adds a dependency on
<tt>x11/libpanel</tt>. Use this if your port installs
an applet that can be placed in the GNOME 1 panel. <b>Note:</b>
that even though you can have GNOME 1 applets in a
GNOME 2 desktop environment, they will <b>not</b> work
with the GNOME 2 panel.</p></li>
with the GNOME 2 panel.<br>
<i>Implies</i>: <tt>gnomelibs</tt></p></li>
</ul>
<p>Let us take an example:</p>
@ -249,6 +273,13 @@ CONFIGURE_ARGS+= --without-gnome
<p>More information on GNOMENG can be found by looking at the source
and comments of <tt>${PORTSDIR}/Mk/bsd.gnomeng.mk</tt>.</p>
<p><b>Note:</b> GNOMENG is temporary. That is, it was put
in place so that ports could be gradually migrated from the old
infrastructure to the new one. Once all ports have been
migrated, the old porting infrastructure as well as the
<tt>USE_GNOMENG</tt> macro will be removed.</p>
<!-- End GNOME-related Makefile macros -->
<!-- Begin GNOME libtool -->
@ -269,7 +300,8 @@ $ac_aux_dir/ltconfig $LIBTOOL_DEPS
</pre>
<p>This prevents the installation of .la files and
ensures that ${PTHREAD_LIBS} will be passed to the linker.</p>
ensures that <tt>${PTHREAD_LIBS}</tt> will be passed to the
linker.</p>
<!-- End GNOME libtool -->
<!-- Begin GNOME distfiles -->