diff --git a/en/gnome/docs/faq.sgml b/en/gnome/docs/faq.sgml index cfe5cf05ec..925a23a24d 100644 --- a/en/gnome/docs/faq.sgml +++ b/en/gnome/docs/faq.sgml @@ -1,118 +1,156 @@ %includes; ]> &header;

Contents

  1. How do I get GNOME for FreeBSD?
  2. GNOME is failing to build from ports. What do I do?
  3. I installed GNOME, but I'm missing application foo. What gives?
  4. What's the best way to upgrade GNOME?

Full Text

+ + + + + + + + + + + +
1. How do I get GNOME for FreeBSD?

There are two ways to install GNOME on FreeBSD. One way is to use packages, and the other way is to use ports.

To install GNOME from packages, use the command:

# pkg_add -r gnome

This will download the latest GNOME packages from the FreeBSD FTP site, and proceed to intall them on your system. Note: As of 4.4-STABLE, installing GNOME from packages is broken. You should instead use the ports method below.

To build and install GNOME from ports, you should first cvsup the latest ports tree. Then:

 # cd /usr/ports/x11/gnome
 # make all install clean

Building from ports is the preferred method for installing GNOME on FreeBSD.

After GNOME is installed, you should edit /etc/make.conf, and add the following lines. If /etc/make.conf does not exist, create the file, then add the following lines:

 WITH_GTK=yes
 WITH_ESOUND=yes
 WITH_GNOME=yes

This last step is optional, but these lines enable other ports, such as XMMS, to take advantage of the GNOME installation.


2. GNOME is failing to build from ports. What do I do?

The majority of GNOME compilation problems can be solved by making sure all the necessary GNOME components are up-to-date. All GNOME applications require the following core components to build:

 pkg-config
 Glib
 gettext
 Gtk+
 ORBit
 Imlib
 esound
 gnomelibs
 gnomecore

Verify all those components are up-to-date, then try building GNOME or your GNOME application again. If you're trying to build one of those core components, and it is failing, or if, after updating all your components, you still have trouble; please send email to &email;@FreeBSD.ORG with the output of the failed compilation.


+ 3. + I installed GNOME, but I'm missing application foo. What gives? +

+

Only the core components, and a few extras, are included in the + gnome package. There is another meta-port called + gnome-fifth-toe that includes some more popular (and + bigger) GNOME applications. gnome-fifth-toe includes + Galeon, Pan, Gnumeric, AbiWord, GNUCash, Evolution, Gimp, Dia, and + more.

+ +

To install gnome-fifth-toe from packages. Note: + Installing gnome-fifth-toe from packages is currently broken on + 4.4-STABLE.

+ + # pkg_add -r gnome-fifth-toe + +

To build gnome-fifth-toe from ports: + + 

+# cd /usr/ports/x11/gnome-fifth-toe
+# make all install clean
+
+ +

A full list of GNOME applications that have been ported to FreeBSD can + be found here.

+

&footer;