Add a section warning not to include default USE_GNOME components after

the .include <bsd.port.pre.mk> line.

Reported by:	netchild
This commit is contained in:
Joe Marcus Clarke 2002-09-19 21:45:36 +00:00
parent 6a917afbb9
commit 060b657921
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/www/; revision=14328

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.22 2002/08/25 05:56:54 marcus Exp $">
<!ENTITY date "$FreeBSD: www/en/gnome/docs/porting.sgml,v 1.23 2002/09/12 03:15:13 marcus Exp $">
<!ENTITY title "FreeBSD GNOME Project: How To Make a Port">
<!ENTITY % gnomeincludes SYSTEM "../includes.sgml"> %gnomeincludes;
<!ENTITY % includes SYSTEM "../../includes.sgml"> %includes;
@ -188,7 +188,7 @@ USE_GNOME= &lt;list of GNOME components&gt;
<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
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.<br>
<i>Implies</i>: <tt>gnomelibs</tt></p></li>
@ -263,6 +263,28 @@ PLIST_SUB= DATADIR="share"
component.
</p>
<p><b>Note:</b> You cannot add extra default <tt>USE_GNOME</tt>
components after the <tt>.include &lt;bsd.port.pre.mk&gt;</tt>.
That is, the following is <font color="#FF0000"><b>wrong</b>
</font>:</p>
<pre>
.include &lt;bsd.port.pre.mk&gt;
.if ${HAVE_GNOME:Mgnomelibs}!=""
USE_GNOME+= gnomelibs
.else
USE_GNOME+= gtk12 # WRONG!
.endif
</pre>
<p>This will make GNOMENG think that GNOME <em>is</em> desired, and
mark the <tt>pkg-plist</tt> accordingly thus breaking package
builds. If you need to add default <tt>USE_GNOME</tt>
components, do so <b>above</b> the <tt>
.include &lt;bsd.port.pre.mk&gt;</tt> line.
</p>
<p>To enforce use of optional GNOME dependencies no matter what,
you can add <tt>WITH_GNOME= yes</tt> to <tt>/etc/make.conf</tt>
or on the make command line. This makes GNOMENG always return