os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Remove instructions for differentiating between the GNOME 1 and GNOME 2

Browse source 
desktops.
This commit is contained in:
Adam Weinberger 2003-09-20 18:51:15 +00:00
parent 3f14adb3bc
commit 5e8d8f18cc
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/www/; revision=18194
1 changed files with 20 additions and 34 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

54
en/gnome/docs/porting.sgml
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.30 2003/06/03 17:55:11 marcus Exp $">
<!ENTITY date "$FreeBSD: www/en/gnome/docs/porting.sgml,v 1.31 2003/08/26 07:47:30 marcus Exp $">
<!ENTITY title "FreeBSD GNOME Project: How To Make a Port">
<!ENTITY % gnomeincludes SYSTEM "../includes.sgml"> %gnomeincludes;
<!ENTITY % includes SYSTEM "../../includes.sgml"> %includes;
@ -92,40 +92,26 @@ USE_GNOME= gnomehack gnomeprefix libgnomeui atspi libwnck
</pre>
<h2>GNOME 1 Desktop vs. GNOME 2 Desktop</h2>
<p>Certain aspects of the <tt>GNOME 1</tt> desktop environment are
incompatible with certain aspects of the <tt>GNOME 2</tt> desktop
environment. To ensure that a user does not compile a <tt>GNOME 2</tt>
component against their <tt>GNOME 1</tt> environment (or vice versa),
the user may set <b>GNOME_DESKTOP_VERSION</b> in their
<tt>/etc/make.conf</tt>. Even if a user has not explicitly set
<b>GNOME_DESKTOP_VERSION</b>, the FreeBSD GNOME architecture will
attempt to automatically deduce the desktop currently installed by
examining which components are already installed.</p>
<p>If compilation of a <tt>GNOME 2</tt> port is attempted on a
<tt>GNOME_DESKTOP_VERSION=1</tt> system, the compilation will
immediately abort and the user will be informed of the incompatability.</p>
<p>In the beginning, there was only <tt>GNOME 1</tt>. When the
<tt>GNOME 2</tt> desktop came around, maximum backwards compatability
was ensured, within reason. <tt>GNOME 1</tt> applications can run
fine under the <tt>GNOME 2</tt> desktop, provided that the applications
do not utilize functionality specific to the <tt>GNOME 1</tt> desktop
environment.</p>
<p>The <tt>GNOME 1</tt> desktop, and all applications that will not run
under the <tt>GNOME 2</tt> desktop, have been removed from the ports
tree.</p>
<p>What this means for you, as an application porter, is simply that
you should not add <tt>GNOME 1</tt>-specific applications to the
ports tree.</p>
<p>If your application can handle both <tt>GNOME 1</tt> and <tt>GNOME 2</tt>
compilation, you may check the value of <b>GNOME_DESKTOP_VERSION</b> to
determine for which desktop your port is compiling. For example:</p>
<pre>
USE_X_PREFIX= yes
USE_GNOME= gnomeprefix gnomehack
.if (${GNOME_DESKTOP_VERSION} == "1")
CONFIGURE_ARGS+= --with-gnome
USE_GNOME+= gtk12 libpanel
.else
CONFIGURE_ARGS+= --with-gnome2
USE_GNOME+= gtk20 gnomepanel
.endif
</pre>
<p>In this example, specific <tt>CONFIGURE_ARGS</tt> and <b>USE_GNOME</b>
components are set depending upon which <b>GNOME_DESKTOP_VERSION</b> is
installed or preferred by the user.</p>
<p>If you wish to determine which version of the GNOME desktop
environment is present on a user's machine, you can check the value
of <b>GNOME_DESKTOP_VERSION</b>. This variable is set to either
<tt>"1"</tt> or <tt>"2"</tt> depending upon whether the
<tt>GNOME 1</tt> or <tt>GNOME 2</tt> desktop is installed.</p>
<h2>Optional GNOME Dependencies</h2>
<p>If your port can optionally use GNOME, you must set