diff --git a/en/gnome/docs/faq.sgml b/en/gnome/docs/faq.sgml index 5b3dd9b124..3dcbf29ab0 100644 --- a/en/gnome/docs/faq.sgml +++ b/en/gnome/docs/faq.sgml @@ -1,282 +1,286 @@ %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?
  5. What is the difference between GNOME and KDE?
  6. Where can I get more themes for GNOME?
  7. What window managers work well with 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.

+ 4.4-RELEASE, installing GNOME from packages contained on a release + CDROM 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
+# make clean
+# make install clean
-

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

+

Currently, building from ports is the preferred method for installing + GNOME on FreeBSD, however FreeBSD GNOME team is working on improving + situation with pre-buit packages.

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
+glib
 gettext
-Gtk+
+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.

+ 4.4-RELEASE.

# pkg_add -r gnome-fifth-toe

To build gnome-fifth-toe from ports: 

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

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

+ be found here.


4. What's the best way to upgrade GNOME?

I find that /usr/ports/sysutils/portupgrade works really well. For example:

- # portupgrade -r bonobo + # portupgrade -r ORBit -

This will upgrade bonobo and every other port that depends on it +

This will upgrade ORBit and every other port that depends on it (that needs updating).

However, sometimes so much changes that it becomes necessary to do a little housekeeping first. In that case, this usually works:

 # pkg_delete -r ORBit
 # cd /usr/ports/x11/gnome
-# make all install clean
+# make clean
+# make install clean


5. What is the difference between GNOME and KDE?

GNOME and KDE are both desktop environments. GNOME is based on the GTK+ widget set, and is primarily written in C. KDE on the other hand is based on the QT widget set, and is primarily written in C++.

Both environments offer a wide range of applications from toys and games to full-blow office suites. Both are actively developed and ported to FreeBSD. If you're trying to decide which one to call your own, try them both, and see which one you like better.

You can read more about KDE on FreeBSD at http://freebsd.kde.org.


6. Where can I get more themes for GNOME?

If you're tired of the default themes that come with GNOME, you do have options. First, FreeBSD's ports collection comes with a rather large collection of GTK themes for GNOME. To install these from packages, run:

# pkg_add -r gtk-engines-collection

To install the themes from ports, do:

 # cd /usr/ports/x11-toolkits/gtk-engines-collection
 # make all install clean

If you want even more themes, checkout http://gtk.themes.org. Note, you will probably need to install the gtk-engines-collection before using any of the themes from themes.org.


7. What window managers work well with GNOME?

The gnome meta-port installs the Sawfish window manager by default. However, there are other window managers you can use with GNOME. These include:

&footer;