diff --git a/en/gnome/docs/Makefile b/en/gnome/docs/Makefile index e60aafc531..f0bb4dc495 100644 --- a/en/gnome/docs/Makefile +++ b/en/gnome/docs/Makefile @@ -1,19 +1,18 @@ -# $FreeBSD: www/en/gnome/docs/Makefile,v 1.7 2003/02/07 17:53:24 marcus Exp $ +# $FreeBSD: www/en/gnome/docs/Makefile,v 1.8 2003/04/20 22:58:11 adamw Exp $ .if exists(../Makefile.conf) .include "../Makefile.conf" .endif .if exists(../Makefile.inc) .include "../Makefile.inc" .endif -DOCS= faq.sgml -DOCS+= faq2.sgml +DOCS= faq2.sgml DOCS+= gnome_porting.sgml DOCS+= gnome2_porting.sgml DOCS+= porting.sgml DOCS+= bugging.sgml DOCS+= volunteer.sgml DOCS+= 22knownissues.sgml .include "${WEB_PREFIX}/share/mk/web.site.mk" diff --git a/en/gnome/docs/faq.sgml b/en/gnome/docs/faq.sgml deleted file mode 100644 index 878c838b1d..0000000000 --- a/en/gnome/docs/faq.sgml +++ /dev/null @@ -1,473 +0,0 @@ - - - - %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 am missing application - foo. What gives? -
  4. How do I keep my GNOME components and - applications up-to-date? -
  5. What is the difference between GNOME and KDE? - Which one is better? -
  6. Where can I get more themes for GNOME? -
  7. What window managers work well with GNOME? -
  8. Why can't I launch Linux apps from the GNOME - panel? -
  9. Why is GNOME so huge, slow and basically - useless? -
  10. Does GNOME support anti-aliased fonts? -
  11. 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. - -

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.

- -

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

-

- 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     _KPOSIX_PRIORITY_SCHEDULING
-
- -

And make sure if you are tracking -stable or -current, that you - do not have NOLIBC_R set in /etc/make.conf. - If you do, remove it, then rebuild world. -

- -

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 that you remove them. -

- -

If you still have trouble, - please send email to - &email;@FreeBSD.org with the output of the failed compilation. -

- -

- 3. - I installed GNOME, but I am 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. - - 

-# 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. - 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 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 -rf 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 are 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 are 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://art.gnome.org/. Note, - you will probably need to install the - gtk-engines-collection before using any of the pixmap - themes.

-

- 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 will need to accomplish this, - however. First, you will need to be running XFree86 4.0 or - higher (4.1 or higher is recommended). Then, you will need - the x11/gdkxft port. That's it! You do not 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; - -