diff --git a/en/gnome/docs/Makefile b/en/gnome/docs/Makefile new file mode 100644 index 0000000000..1001a46ebf --- /dev/null +++ b/en/gnome/docs/Makefile @@ -0,0 +1,12 @@ +# $FreeBSD: www/en/java/docs/Makefile,v 1.4 2000/11/07 04:05:17 kuriyama Exp $ + +.if exists(../Makefile.conf) +.include "../Makefile.conf" +.endif +.if exists(../Makefile.inc) +.include "../Makefile.inc" +.endif + +DOCS = faq.sgml + +.include "${WEB_PREFIX}/share/mk/web.site.mk" diff --git a/en/gnome/docs/faq.sgml b/en/gnome/docs/faq.sgml new file mode 100644 index 0000000000..cfe5cf05ec --- /dev/null +++ b/en/gnome/docs/faq.sgml @@ -0,0 +1,118 @@ + + + + + %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.

+

+
+&footer; + +