diff --git a/en/gnome/docs/faq.sgml b/en/gnome/docs/faq.sgml index 897a843e81..b61d274441 100644 --- a/en/gnome/docs/faq.sgml +++ b/en/gnome/docs/faq.sgml @@ -1,286 +1,316 @@ %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-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:

- - 
+  &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-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 clean
 # make install clean
-	  

+	    
 
-	  
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.

+	    
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:

+	    
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:

-
-	   
+            

+
+	    
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-RELEASE.

-
-	   # pkg_add -r gnome-fifth-toe
-
-	   
To build gnome-fifth-toe from ports:

-
-	   
+            

+
+	    
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-RELEASE.

+
+	    # pkg_add -r gnome-fifth-toe
+
+	    
To build gnome-fifth-toe from ports:

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

-
-	   
A full list of GNOME applications that have been ported to FreeBSD can
-	   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 ORBit
-
-		
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:

-
-		
+	    

+
+	    
A full list of GNOME applications that have been ported to
+	      FreeBSD can 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 ORBit
+
+	    
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 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-blown 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:

-
-		
+	    

+	  



+	     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-blown 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;	
+# make clean
+# make 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;