diff --git a/en/gnome/docs/faq.sgml b/en/gnome/docs/faq.sgml index faef70a155..027cd32f58 100644 --- a/en/gnome/docs/faq.sgml +++ b/en/gnome/docs/faq.sgml @@ -1,467 +1,475 @@ - - + + %gnomeincludes; %includes; ]> &header;

How do I get GNOME for FreeBSD?
GNOME is failing to build from ports. What do I do?
I installed GNOME, but I'm missing application foo. What gives?
How do I keep my GNOME components and applications up-to-date?
What is the difference between GNOME and KDE? Which one is better?
Where can I get more themes for GNOME?
What window managers work well with GNOME?
Why can't I launch Linux apps from the GNOME panel?
Why is GNOME so huge, slow and basically useless?
Does GNOME support anti-aliased fonts?
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 + site, and proceed to install them on your system. Note: + Installing GNOME from packages contained in the 4.4-RELEASE + release CDROM was 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. + installing GNOME on FreeBSD; however, the FreeBSD GNOME team is + working on improving the installation of 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: + 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: + 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. + do not need these ports installed, it is recommended that you remove them.

3.	- I installed GNOME, but I'm missing application foo. What gives? + 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` + +# 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. + 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 -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. + 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. + 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: + Sawfish window + manager by default. However, there are other window managers + you can use with GNOME. These include: - Enlightenment + + Enlightenment FVWM2 WindowMaker Afterstep IceWM XFce

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`: + 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 + 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? + 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: + 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 2e7e99bbad..7e02222775 100644 --- a/en/gnome/docs/faq2.sgml +++ b/en/gnome/docs/faq2.sgml @@ -1,472 +1,494 @@ - + %gnomeincludes; %includes; ]> &header;

How do I get GNOME 2.0 for FreeBSD?
GNOME 2.0 is failing to build from ports. What do I do?
I installed GNOME 2.0, but I am missing application foo. What gives?
What is the best way to upgrade from GNOME - 1.4.1 to GNOME 2.0? + 1.4 to GNOME 2.0?
How do I keep my GNOME 2.0 components and applications up-to-date? -
Can I install GNOME 1.4.1 applications under +
Can I install GNOME 1.4 applications under GNOME 2.0 and vice versa?
Where can I get more themes for GNOME 2.0?
What window managers work well with GNOME 2.0?
Does GNOME 2.0 support anti-aliased fonts?
How do I edit my GNOME 2 menus?
How do I use GTK+ 2 resource settings for GTK+ 2 applications when not in a GNOME environment?

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 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. 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 + If you do not need these ports installed, it is recommended that you remove them.

3.	I installed GNOME 2.0, but I am 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 have not 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 applications under GNOME 2.0. + + Many applications that have already been ported are included + in the `gnome2-fifth-toe` meta-port. + `gnome2-fifth-toe` includes GNOME 2.0 versions + of some GNOME 1.4 applications. Note, many of these + applications are still in the early development stages, + and may not be very stable. + + To install `gnome2-fifth-toe` from packages: + + +# pkg_add -r gnome2-fifth-toe + + + To install `gnome2-fifth-toe` from ports: + + +# cd /usr/ports/x11/gnome2-fifth-toe +# make clean +# make install clean + +

4.	- What is the best way to upgrade from GNOME 1.4.1 to GNOME 2.0? + What is the best way to upgrade from GNOME 1.4 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 + GNOME 1.4, 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 GNOME site. Next, make sure your GNOME 1.4 ports are + up-to-date, then remove the following GNOME 1.4 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. + After those packages are removed, you can build GNOME 2.0 as 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 + Can I install GNOME 1.4 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. + Sure! Right now, the FreeBSD GNOME team is in the process of + migrating all GNOME 1.4 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 + GNOME 2 users to install GNOME 1.4 ports without overwriting their GNOME 2 desktop. - Before building a GNOME 1.4.1 port under GNOME 2, take a + Before building a GNOME 1.4 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 + mentioning 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 + To run GNOME 2.0 applications under GNOME 1.4, you will need + to make sure your GNOME 1.4 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 art.gnome.org 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. A new theme site called The Theme Depot has just been launched. This site contains themes for GNOME 2 as well as KDE and quite a few window managers. A good site for some cool GNOME icons (some stock, some new) is jimmac's Icons site. 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 will 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.

10.	How do I edit my GNOME 2 menus?
	You need to use Nautilus to edit your GNOME 2 menus. If you want to edit any menu other than Favorites, you must be root. This feature requires GNOME 2.0.2 or later. To edit the menus, launch Nautilus, and enter the URL applications:///. From there you should be able to edit your entire application menu.

11.	How do I use GTK+ 2 resource settings for GTK+ 2 applications when not in a GNOME environment?
	GNOME 2 applications get their GTK+ 2 resources from themes and the corresponding theme engine. If you would rather run your GTK+ 2 applications in a non-GNOME environment then you will need to create a file named `~/.gtkrc-2.0`. For the most part, you can transfer your settings from your `~/.gtkrc` (used for GTK+ 1.2) file with a couple of caveats. If you have any theme engine references, you will have - to make sure there is a corresponding GTK+ 2 theme engine, - otherwise remove the engine entries. + to make sure there is a corresponding GTK+ 2 theme engine. + Otherwise, remove the engine entries. The default font specification should be outside of any `style` blocks and should be specified with the `gtk-font-name` keyword. For example: gtk-font-name = "Verdana 11"

&footer; diff --git a/en/gnome/index.xsl b/en/gnome/index.xsl index 35c7464327..e87c4530c1 100644 --- a/en/gnome/index.xsl +++ b/en/gnome/index.xsl @@ -1,213 +1,213 @@ - + - +

GNOME on FreeBSD
· GNOME on FreeBSD Home
- · Installation Instructions for GNOME 1.4.1
+ · Installation Instructions for GNOME 1.4
· Installation Instructions for GNOME 2.0
· Available Applications
· How to Help
· Reporting a Bug
· Screenshots
· Contact Us

Documentation
- · GNOME 1.4.1 FAQ
+ · GNOME 1.4 FAQ
· GNOME 2.0 FAQ
· Creating Ports

Resources
· GNOME Project
· GNOME Office
· GNOME on GNU/Darwin

Related Projects
· KDE Project
· KDE on FreeBSD
· CDE (commercial)

What is GNOME?

The GNOME project was born as an effort to create an entirely free desktop environment for free systems. From the start, the main - objective of GNOME has been to provide a user friendly suite of + objective of GNOME has been to provide a user-friendly suite of applications and an easy-to-use desktop. The FreeBSD GNOME Project strives to bring GNOME to the FreeBSD user.

As with most GNU programs, GNOME has been designed to run on all modern Unix-like operating systems. Through the efforts of the FreeBSD GNOME Project and countless volunteers, those operating systems include FreeBSD.

The GNOME project has expanded its objectives over the past few months to include addressing a number of problems in the existing Unix infrastructure.

The GNOME project acts as an umbrella, the major components of +

The GNOME project acts as an umbrella. The major components of GNOME are:

The GNOME desktop: An easy - to use windows-based environment for users.
The GNOME development platform: A rich collection of tools, libraries, and components to develop powerful applications on Unix.
The GNOME Office: A set of office productivity applications.

State of the port

We currently support 4.x and 5-CURRENT FreeBSD systems - for GNOME 1.4.1 and 2.0.2. Anything prior to FreeBSD 4.5 is + for GNOME 1.4 and 2.0. Anything prior to FreeBSD 4.5 is not supported. Most of GNOME has been ported to FreeBSD; however, there is plenty left to do!

FreeBSD GNOME News
Latest update: ,
· newsflash.html#

More...

GNOME Project News
·
More...

Contents

Full Text

Contents

Full Text

What is GNOME?

State of the port