* Update porting guide with respect to autotools changes

* Mention the new GNOME PREFIX
This commit is contained in:
Joe Marcus Clarke 2006-10-14 17:13:19 +00:00
parent aa796a7351
commit f89c4e909d
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/www/; revision=28860
2 changed files with 25 additions and 10 deletions

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/example-Makefile.sgml,v 1.10 2006/05/29 18:12:05 mezz Exp $">
<!ENTITY date "$FreeBSD: www/en/gnome/docs/example-Makefile.sgml,v 1.11 2006/08/19 21:20:35 hrs Exp $">
<!ENTITY title "FreeBSD GNOME Project: Example GNOME Makefile">
<!ENTITY % navinclude.gnome "INCLUDE">
]>
@ -15,7 +15,7 @@
# Date created: 27 December 2003
# Whom: Some GNOME User &lt;&email;@FreeBSD.org&gt;
#
# $FreeBSD: www/en/gnome/docs/example-Makefile.sgml,v 1.10 2006/05/29 18:12:05 mezz Exp $
# $FreeBSD: www/en/gnome/docs/example-Makefile.sgml,v 1.11 2006/08/19 21:20:35 hrs Exp $
#
# For this example, assume there was already a gnomeapp in the tree, and that this
@ -31,7 +31,7 @@ MAINTAINER= gnome@FreeBSD.org
COMMENT= A GNOME app that does some stuff
USE_BZIP2= yes
USE_X_PREFIX= yes
USE_XLIB= yes
GNU_CONFIGURE= yes # NOTE: if the port needs ltverhack, this must be
USE_AUTOTOOLS=libtool:15
USE_GMAKE= yes # same with GNU make

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/porting.sgml,v 1.51 2006/05/29 18:12:05 mezz Exp $">
<!ENTITY date "$FreeBSD: www/en/gnome/docs/porting.sgml,v 1.52 2006/08/19 21:20:35 hrs Exp $">
<!ENTITY title "FreeBSD GNOME Project: How To Make a Port">
<!ENTITY % navinclude.gnome "INCLUDE">
]>
@ -25,7 +25,7 @@
all as a space-separated list. For example:</p>
<pre>
USE_X_PREFIX= yes
USE_XLIB= yes
USE_GNOME= gnomeprefix gnomehack libgnomeui
</pre>
@ -44,7 +44,7 @@ USE_GNOME= gnomeprefix gnomehack libgnomeui
the shortest way to define this:</p>
<pre>
USE_X_PREFIX= yes
USE_XLIB= yes
USE_GNOME= gtk20
</pre>
@ -52,7 +52,7 @@ USE_GNOME= gtk20
the shortest way to define this:</p>
<pre>
USE_X_PREFIX= yes
USE_XLIB= yes
USE_GNOME= gtk12
</pre>
@ -207,6 +207,21 @@ WANT_GNOME= yes
<!-- End GNOME-related Makefile macros -->
<!-- Begin GNOME PREFIX -->
<a name="prefix"></a>
<h2>GNOME PREFIX</h2>
<p>Since the release of 2.16, GNOME now lives in
<tt>LOCALBASE</tt> instead of <tt>X11BASE</tt>. To make
it easier for GNOME ports that must also be installed into
the same PREFIX as GNOME, a hack has been added to
<tt>bsd.gnome.mk</tt> to force the PREFIX to
<tt>LOCALBASE</tt> whenever the <tt>gnomeprefix</tt>
component is used. This can be overridden by manually
specifying <tt>PREFIX</tt> in your port's
<tt>Makefile</tt> or on the command line.</p>
<!-- End GNOME PREFIX -->
<!-- Begin GNOME OMF -->
<a name="omf"></a>
<h2>OMF Installation</h2>
@ -315,10 +330,10 @@ GCONF_SCHEMAS= CDDB-Slave2.schemas gnome-audio-profiles.schemas \
They also use the GNU configure system. If your port installs
shared libraries, and includes an <tt>ltmain.sh</tt> script
in its <tt>${WRKSRC}</tt> directory, you should add
<tt>USE_LIBTOOL_VER=15</tt> to your port's Makefile.
<tt>USE_AUTOTOOLS=libtool:15</tt> to your port's Makefile.
However, if your port uses custom <tt>LIBTOOLFLAGS</tt>, you
must use <tt>USE_INC_LIBTOOL_VER=13</tt> instead. If you have
to use <tt>USE_INC_LIBTOOL_VER</tt>, you must also add
must use <tt>USE_AUTOTOOLS=libtool:13:inc</tt> instead. If you have
to use <tt>libtool:X:inc</tt>, you must also add
<tt>lthack</tt> to <tt>USE_GNOME</tt>. In general, though,
<tt>lthack</tt> is deprecated, and should only be used if
absolutely necessary.</p>