diff --git a/en/gnome/docs/faq.sgml b/en/gnome/docs/faq.sgml index 62190e7b21..faef70a155 100644 --- a/en/gnome/docs/faq.sgml +++ b/en/gnome/docs/faq.sgml @@ -1,456 +1,467 @@ - + %gnomeincludes; %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. How do I keep my GNOME components and + applications up-to-date?
  6. What is the difference between GNOME and KDE? Which one is better?
  7. Where can I get more themes for GNOME?
  8. What window managers work well with GNOME?
  9. Why can't I launch Linux apps from the GNOME panel?
  10. Why is GNOME so huge, slow and basically useless?
  11. Does GNOME support anti-aliased fonts?
  12. How do I enable Java support in the Mozilla or Galeon web browser?

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 install 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. The problem was fixed in the 4.5-RELEASE.

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

After installing GNOME, you might consider adding the following to /etc/make.conf:

 WITH_GTK=yes

This is an optional step, but will allow certain ports, such as Vim, to take advantage of the Gtk+ widget set.

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

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. You may see compiler errors relating to pthreads (POSIX threads), such as:

 undefined reference to 'strerror_r'

To fix thread related errors, make sure you have the following compiled into your kernel:

 options     P1003_1B
 options     _KPOSIX_PRIORITY_SCHEDULING

And make sure if you're tracking -stable or -current, that you do not have NOLIBC_R set in /etc/make.conf. If you do, remove it, then rebuild world. If you still have trouble, please send email to &email;@FreeBSD.org with the output of the failed compilation.

Ports such as devel/pth and devel/ngpt can also cause pthread-related problems when compiling GNOME. If you do not need these ports installed, it is recommended you remove them.


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 was broken broken on 4.4-RELEASE (fixed in 4.5-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? + How do I keep my GNOME components and applications + up-to-date?

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

- # portupgrade -r ORBit + # portupgrade -r pkgconfig -

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

+

This will upgrade pkgconfig 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\*
+# pkg_delete -r pkgconfig\*
 # cd /usr/ports/x11/gnome
 # make clean
 # make install clean
+ +

These steps will remove all the GNOME 1 and 2 components + and applications from your machine, but only reinstalls the + GNOME 1 desktop. You should be aware, that if it comes to + this, you will need to reinstall your applications after + reinstalling the desktop. Fortunately, this extreme measure + is only rarely needed. +

+

5. What is the difference between GNOME and KDE? Which one is better?

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

8. Why can't I launch Linux apps from the GNOME panel?

Short answer is you can. The problem is most likely that you have Launch Feedback (xalf) enabled. xalf is a FreeBSD shared object, and as such cannot be loaded by Linux applications. When you try to load a Linux application, nothing will happen, and something like the following will show up in ~/.gnomerc-errors or on stdout:

 /usr/local/Acrobat4/Reader/intellinux/bin/acroread: error in loading shared 
 libraries: /usr/X11R6/lib/libxalflaunch.so.0: ELF file OS ABI invalid.

To fix this problem you need to install the linux-xalf port. This port (or package) installs the Linux version of libxalflaunch.so.0 in /compat/linux/usr/X11R6/lib, and will be used instead of the FreeBSD binary when launching Linux applications. You may see the following error after installing linux-xalf:

 /usr/libexec/ld-elf.so.1: Shared object "libkrb.so.3" not found

This can be safely ignored.

9. Why is GNOME so huge, slow and basically useless?

Well, it depends on the point of view. Of course both GNOME and KDE are still far from perfection or even completeness and could hardly be compared to commercial offerings in terms of user-friendliness. But at the same time it is a huge step in the right direction. It should also be noted, that both GNOME and KDE are still very young and the situation is likely to improve as they mature (does anybody remember what sort of crap Windows 3.11 was?).

10. Does GNOME support anti-aliased fonts?

Yes! There are two things you'll need to accomplish this, however. First, you'll need to be running XFree86 4.0 or higher (4.1 or higher is recommended). Then, you'll need the x11/gdkxft port. That's it! You don't need to recompile any of your GNOME applications.

If you run into problems, have a look at the gdkxft website or send email to &email;@FreeBSD.org.

If you have any questions, please send them to &email;@FreeBSD.org.


11. How do I enable Java support in the Mozilla or Galeon web browser?

To enable Java support in the Mozilla web browser you need to install the Java Development Kit available from the java/jdk13 port (version 1.3.1p6 or later is required) and restart the browser. Please note that if the version of the Mozilla package installed on your computer is less than 0.9.8_2,1 then you also need to use the following command to create the symbolic link required for the Java plugin to work:

 # ln -sf /usr/local/jdk1.3.1/jre/plugin/i386/ns600/libjavaplugin_oji.so \
 	/usr/X11R6/lib/mozilla/plugins/libjavaplugin_oji.so

You can verify that the Mozilla has picked the Java plugin by selecting About Plug-ins from the Help menu after restarting Mozilla. You should see /usr/local/jdk1.3.1/jre/plugin/i386/ns600/libjavaplugin_oji.so in the list of available plugins, indicating that Java support is enabled.

If you built Galeon against the full version of Mozilla, then the Java plugin will also work for it. Just make sure that Allow Java in the Settings menu is checked.

&footer; diff --git a/en/gnome/docs/faq2.sgml b/en/gnome/docs/faq2.sgml index 77b7ff3133..df3331c275 100644 --- a/en/gnome/docs/faq2.sgml +++ b/en/gnome/docs/faq2.sgml @@ -1,394 +1,402 @@ - + %gnomeincludes; %includes; ]> &header;

Contents

  1. How do I get GNOME 2.0 for FreeBSD?
  2. GNOME 2.0 is failing to build from ports. What do I do?
  3. I installed GNOME 2.0, but I'm missing application foo. What gives?
  4. What's the best way to upgrade from GNOME 1.4.1 to GNOME 2.0?
  5. How do I keep my GNOME 2.0 components and applications up-to-date?
  6. Can I install GNOME 1.4.1 applications under GNOME 2.0 and vice versa?
  7. Where can I get more themes for GNOME 2.0?
  8. What window managers work well with GNOME 2.0?
  9. Does GNOME 2.0 support anti-aliased fonts?

Full Text

1. How do I get GNOME 2.0 for FreeBSD?

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

To install GNOME 2.0 from packages, use the command:

# pkg_add -r gnome2

This will download the latest GNOME 2.0 packages from the FreeBSD FTP site, and proceed to install them on your system. Note: Currently, building GNOME 2.0 from packages is broken. GNOME 2.0 is still new, and work is being done to improve the package installation process. You should instead use the ports method below.

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

 # cd /usr/ports/x11/gnome2
 # make clean
 # make install clean

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

The majority of GNOME 2.0 compilation problems can be solved by making sure all the necessary GNOME 2.0 components are up-to-date. You may see compiler errors relating to pthreads (POSIX threads), such as:

 undefined reference to 'strerror_r'

To fix thread related errors, make sure you have the following compiled into your kernel:

 options     P1003_1B
 options     _KPOSIX_PRIORITY_SCHEDULING

And make sure if you're tracking -stable or -current, that you do not have NOLIBC_R set in /etc/make.conf. If you do, remove it, then rebuild world. If you still have trouble, please send email to &email;@FreeBSD.org with the output of the failed compilation. It is also helpful to include the config.log from the port's work directory.

Ports such as devel/pth and devel/ngpt can also cause pthread-related problems when compiling GNOME 2.0. If you do not need these ports installed, it is recommended you remove them.


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

Only the core components, and a few extras, are included in the gnome2 package. Since GNOME 2.0 is so new, there haven't been a great deal of applications ported over to it. As more applications become available, they will be ported over. In the meantime, you can, however, run - GNOME 1.4.1 applications under GNOME 2.0.

+ GNOME 1.4.1 applications under GNOME 2.0.

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

Right now, the GNOME project is still very much in flux. Work still must be done to the GNOME ports infrastructure in order to get things working cleanly. However, if you have GNOME 1.4.1, and you want to upgrade to GNOME 2.0, first familiarize yourself with the official upgrade instructions from the GNOME site. Next, make sure your GNOME 1.4.1 ports are up-to-date, then remove the following GNOME 1.4.1 packages from the system:

 gnomecore
 sawfish
 gnomeapplets 
 gnomemedia
 gtop
 libgtop
 nautilus
 glade
 gedit
 xalf
 bugbuddy
 gnomegames
 gnomeutils
 gdm
 eog

After those packages are removed, you can build GNOME 2.0 per the instructions listed above.

5. How do I keep my GNOME 2.0 components and applications up-to-date?

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

# portupgrade -r pkgconfig

This will upgrade pkgconfig 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 pkgconfig\*
 # cd /usr/ports/x11/gnome2
 # make clean
 # make install clean
+ +

These steps will remove all the GNOME 1 and 2 components + and applications from your machine, but only reinstalls the + GNOME 2 desktop. You should be aware, that if it comes to + this, you will need to reinstall your applications after + reinstalling the desktop. Fortunately, this extreme measure + is only rarely needed. +


6. Can I install GNOME 1.4.1 applications under GNOME 2.0 and vice versa?

Sure! Right now, the FreeBSD GNOME team is in the process or migrating all GNOME 1.4.1 ports to a new build infrastructure. This new infrastructure, called GNOMENG, will allow GNOME 2 users to install GNOME 1.4.1 ports without overwriting their GNOME 2 desktop.

Before building a GNOME 1.4.1 port under GNOME 2, take a look at the port's Makefile, and check that it contains:

 USE_GNOMENG=	yes

If it does, you can safely build this port under GNOME 2. If the Makefile contains the following, do not build it as it will overwrite your GNOME 2 desktop:

 USE_GNOME=	yes

In that case, send email to &email;@FreeBSD.org mention the name of the port, and we will convert it to the new layout. Alternatively, you are free to convert the port yourself, and submit a PR.

NOTE! You must have a current /usr/ports/Mk directory in order to make use of the new GNOMENG framework. If you do not have a current Mk directory, you will still overwrite your GNOME 2 desktop even when USE_GNOMENG is defined. To update your Mk directory, make sure your ports supfile is set to retrieve the ports-base tag. This is done automatically if your supfile contains the ports-all tag.

To run GNOME 2.0 applications under GNOME 1.4.1, you will need to make sure your GNOME 1.4.1 components are up-to-date, then install the gnome2-devel port. To install this port do the following:

 # cd /usr/ports/devel/gnome2-devel
 # make clean
 # make install

After installing the gnome2-devel port, you will be able to install non-desktop GNOME 2.0 applications (e.g. math/gcalctool).

7. Where can I get more themes for GNOME 2.0?

The website Sunshine in a Bag has been setup as a general GNOME theme repository. They offer some gtk+-2.0, metacity, sawfish, nautilus, and gdm themes, as well as some backgrounds.

See the instructions on the website for installing the themes. If you feel inclined to port a few of them, you will not be turned away ;-).

8. What window managers work well with GNOME 2.0?

The gnome2 meta-port installs the sawfish and metacity window managers by default. Both work quite well in GNOME 2.0. A lot of people prefer metacity since it is lighter weight. However, sawfish will be used as the default Window manager.

To switch between sawfish and metacity in GNOME 2, you'll need to do the following:

 killall sawfish; sleep 5; metacity &

To switch back, simply reverse sawfish and metacity. In an upcoming release of gnomecontrolcenter2, there will be a more user-friendly way of doing this.

9. Does GNOME 2.0 support anti-aliased fonts?

Yes! Anti-aliasing requires XFree86 4.x with freetype2 support. To add freetype2 support to X, make sure you have the following modules loaded in your XF86Config file under the Modules section:

 Load	"freetype"
 Load	"type1"

Then, simply set the environment variable GDK_USE_XFT to 1 before starting GNOME. If you use gdm, you can add it to your ~/.gnomerc file (make sure this file is executable!). If you use startx, then add it to your ~/.xinitrc file.

If you have any questions, please send them to &email;@FreeBSD.org.


&footer;