a0e5443943
* Link to the "keeping GNOME up-to-date" question in the "problems building" question. * Remove as many contractions as readability allows. * Shorten the contact list to only active GNOME committers. * Add my FreeBSD AIM screen name. * Fix a grammar nit in the GNOME 2 FAQ. * Clarify that the search interface now searches the freebsd-gnome mailing list archives.
473 lines
15 KiB
Text
473 lines
15 KiB
Text
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" [
|
|
<!ENTITY base CDATA "../..">
|
|
<!ENTITY date "$FreeBSD: www/en/gnome/docs/faq.sgml,v 1.37 2002/12/02 03:11:58 marcus Exp $">
|
|
<!ENTITY title "FreeBSD GNOME Project: GNOME 1.4 FAQ">
|
|
<!ENTITY % gnomeincludes SYSTEM "../includes.sgml"> %gnomeincludes;
|
|
<!ENTITY % includes SYSTEM "../../includes.sgml"> %includes;
|
|
]>
|
|
<html>
|
|
&header;
|
|
|
|
<table border="0">
|
|
<tr>
|
|
<td>
|
|
<h2>Contents</h2>
|
|
<ol>
|
|
<li> <a href="#q1">How do I get GNOME for FreeBSD?</a>
|
|
<li> <a href="#q2">GNOME is failing to build from ports. What do
|
|
I do?</a>
|
|
<li> <a href="#q3">I installed GNOME, but I am missing application
|
|
foo. What gives?</a>
|
|
<li> <a href="#q4">How do I keep my GNOME components and
|
|
applications up-to-date?</a>
|
|
<li> <a href="#q5">What is the difference between GNOME and KDE?
|
|
Which one is better?</a>
|
|
<li> <a href="#q6">Where can I get more themes for GNOME?</a>
|
|
<li> <a href="#q7">What window managers work well with GNOME?</a>
|
|
<li> <a href="#q8">Why can't I launch Linux apps from the GNOME
|
|
panel?</a>
|
|
<li> <a href="#q9">Why is GNOME so huge, slow and basically
|
|
useless?</a>
|
|
<li> <a href="#q10">Does GNOME support anti-aliased fonts?</a>
|
|
<li> <a href="#q11">How do I enable Java support in the Mozilla
|
|
or Galeon web browser?</a>
|
|
</ol>
|
|
<h2>Full Text </h2>
|
|
<table border="0" cellspacing="0" cellpadding="2">
|
|
|
|
<!-- Q1 -->
|
|
<tr>
|
|
<td width="10">
|
|
<b><a name="q1"> 1.</a></b>
|
|
</td>
|
|
<td align="left" valign="top" colspan="3">
|
|
<b>How do I get GNOME for FreeBSD?</b>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<!-- A1 -->
|
|
<td width="10"> <br> </td>
|
|
<td align="left" valign="top" colspan="3">
|
|
<p>There are two ways to install GNOME on FreeBSD. One way is to use
|
|
<a href="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/packages-using.html">
|
|
packages</a>, and the other way is to use
|
|
<a href="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/ports-using.html">
|
|
ports</a>.</p>
|
|
|
|
<p>To install GNOME from packages, use the command:</p>
|
|
|
|
<tt># pkg_add -r gnome</tt>
|
|
|
|
<p>This will download the latest GNOME packages from the FreeBSD FTP
|
|
site, and proceed to install them on your system.
|
|
|
|
<p>To build and install GNOME from ports, you should first
|
|
<a href="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/cvsup.html">
|
|
cvsup</a> the latest ports tree. Then:</p>
|
|
|
|
<pre>
|
|
# cd /usr/ports/x11/gnome
|
|
# make clean
|
|
# make install clean
|
|
</pre>
|
|
|
|
<p>After installing GNOME, you might consider adding the following
|
|
to <tt>/etc/make.conf</tt>:</p>
|
|
|
|
<pre>
|
|
WITH_GTK=yes
|
|
</pre>
|
|
|
|
<p>This is an optional step, but will allow certain ports, such as
|
|
Vim, to take advantage of the Gtk+ widget set.</p>
|
|
|
|
<p>Building from ports is the preferred method for
|
|
installing GNOME on FreeBSD.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td><br></td></tr>
|
|
|
|
<!-- Q2 -->
|
|
<tr>
|
|
<td width="10">
|
|
<b><a name="q2"> 2.</a></b></td>
|
|
<td align="left" valign="top" colspan="3">
|
|
<b>GNOME is failing to build from ports. What do I do?</b>
|
|
</td>
|
|
</tr>
|
|
<!-- A2 -->
|
|
<tr>
|
|
<td width="10"> <br> </td>
|
|
<td align="left" valign="top" colspan="3">
|
|
<p>The majority of GNOME compilation problems can be solved by
|
|
making sure all the necessary GNOME components are <a href="#q4">up-to-date</a>.
|
|
All GNOME applications require the following core components to
|
|
build:</p>
|
|
|
|
<pre>
|
|
pkg-config
|
|
glib
|
|
gettext
|
|
gtk+
|
|
ORBit
|
|
Imlib
|
|
esound
|
|
gnomelibs
|
|
gnomecore
|
|
</pre>
|
|
|
|
<p>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:</p>
|
|
|
|
<pre>
|
|
undefined reference to 'strerror_r'
|
|
</pre>
|
|
|
|
<p>To fix thread related errors, make sure you have the following
|
|
compiled into your kernel:</p>
|
|
|
|
<pre>
|
|
options _KPOSIX_PRIORITY_SCHEDULING
|
|
</pre>
|
|
|
|
<p>And make sure if you are tracking -stable or -current, that you
|
|
do <b>not</b> have <tt>NOLIBC_R</tt> set in <tt>/etc/make.conf</tt>.
|
|
If you do, remove it, then rebuild world.
|
|
</p>
|
|
|
|
<p>Ports such as <tt>devel/pth</tt> and <tt>devel/ngpt</tt> can
|
|
also cause pthread-related problems when compiling GNOME. If you
|
|
do not need these ports installed, it is recommended that you remove them.
|
|
</p>
|
|
|
|
<p>If you still have trouble,
|
|
please send email to <a href="mailto:&email;@FreeBSD.org">
|
|
&email;@FreeBSD.org</a> with the output of the failed compilation.
|
|
</p>
|
|
|
|
</td>
|
|
</tr>
|
|
<tr><td><br></td></tr>
|
|
|
|
<!-- Q3 -->
|
|
<tr>
|
|
<td width="10">
|
|
<b><a name="q3"> 3.</a></b></td>
|
|
<td align="left" valign="top" colspan="3">
|
|
<b>I installed GNOME, but I am missing application foo. What gives?
|
|
</b>
|
|
</td>
|
|
</tr>
|
|
<!-- A3 -->
|
|
<tr>
|
|
<td width="10"> <br> </td>
|
|
<td align="left" valign="top" colspan="3">
|
|
<p>Only the core components, and a few extras, are included in the
|
|
<tt>gnome</tt> package. There is another meta-port called
|
|
<tt>gnome-fifth-toe</tt> that includes some more popular (and
|
|
bigger) GNOME applications. <tt>gnome-fifth-toe</tt> includes
|
|
Galeon, Pan, Gnumeric, AbiWord, GNUCash, Evolution, Gimp, Dia, and
|
|
more.</p>
|
|
|
|
<p>To install <tt>gnome-fifth-toe</tt> from packages.
|
|
|
|
<pre>
|
|
# pkg_add -r gnome-fifth-toe
|
|
</pre>
|
|
|
|
<p>To build <tt>gnome-fifth-toe</tt> from ports:</p>
|
|
|
|
<pre>
|
|
# cd /usr/ports/x11/gnome-fifth-toe
|
|
# make clean
|
|
# make install clean
|
|
</pre>
|
|
|
|
<p>A full list of GNOME applications that have been ported to
|
|
FreeBSD can be found <a href="../../ports/gnome.html">here</a>.
|
|
</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td><br></td></tr>
|
|
|
|
<!-- Q4 -->
|
|
<tr>
|
|
<td width="10">
|
|
<b><a name="q4"> 4.</a></b></td>
|
|
<td align="left" valign="top" colspan="3">
|
|
<b>How do I keep my GNOME components and applications
|
|
up-to-date?</b>
|
|
</td>
|
|
</tr>
|
|
<!-- A4 -->
|
|
<tr>
|
|
<td width="10"> <br> </td>
|
|
<td align="left" valign="top" colspan="3">
|
|
<p>I find that <tt>/usr/ports/sysutils/portupgrade</tt> works really
|
|
well. For example:</p>
|
|
|
|
<tt># portupgrade -r pkgconfig</tt>
|
|
|
|
<p>This will upgrade pkgconfig and every other port that depends
|
|
on it (that needs updating).</p>
|
|
|
|
<p>However, sometimes so much changes that it becomes
|
|
necessary to do a little housekeeping first. In that case, this
|
|
usually works:</p>
|
|
|
|
<pre>
|
|
# pkg_delete -rf pkgconfig\*
|
|
# cd /usr/ports/x11/gnome
|
|
# make clean
|
|
# make install clean
|
|
</pre>
|
|
|
|
<p>These steps will remove <b>all</b> 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.
|
|
</p>
|
|
|
|
</td>
|
|
</tr>
|
|
<tr><td><br></td></tr>
|
|
|
|
<!-- Q5 -->
|
|
<tr>
|
|
<td width="10">
|
|
<b><a name="q5"> 5.</a></b></td>
|
|
<td align="left" valign="top" colspan="3">
|
|
<b>What is the difference between GNOME and KDE? Which one is
|
|
better?</b>
|
|
</td>
|
|
</tr>
|
|
<!-- A5 -->
|
|
<tr>
|
|
<td width="10"> <br> </td>
|
|
<td align="left" valign="top" colspan="3">
|
|
<p>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++.</p>
|
|
|
|
<p>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
|
|
<b>you</b> like better.
|
|
</p>
|
|
|
|
<p>You can read more about KDE on FreeBSD at
|
|
<a href="http://freebsd.kde.org">http://freebsd.kde.org</a>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td><br></td></tr>
|
|
|
|
<!-- Q6 -->
|
|
<tr>
|
|
<td width="10">
|
|
<b><a name="q6"> 6.</a></b></td>
|
|
<td align="left" valign="top" colspan="3">
|
|
<b>Where can I get more themes for GNOME?</b>
|
|
</td>
|
|
</tr>
|
|
<!-- A6 -->
|
|
<tr>
|
|
<td width="10"> <br> </td>
|
|
<td align="left" valign="top" colspan="3">
|
|
<p>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:</p>
|
|
|
|
<tt># pkg_add -r gtk-engines-collection</tt>
|
|
|
|
<p>To install the themes from ports, do:</p>
|
|
|
|
<pre>
|
|
# cd /usr/ports/x11-toolkits/gtk-engines-collection
|
|
# make clean
|
|
# make install clean
|
|
</pre>
|
|
|
|
<p>If you want even more themes, checkout
|
|
<a href="http://art.gnome.org/">http://art.gnome.org/</a>. Note,
|
|
you will probably need to install the
|
|
<tt>gtk-engines-collection</tt> before using any of the pixmap
|
|
themes.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td><br></td></tr>
|
|
|
|
<!-- Q7 -->
|
|
<tr>
|
|
<td width="10">
|
|
<b><a name="q7"> 7.</a></b></td>
|
|
<td align="left" valign="top" colspan="3">
|
|
<b>What window managers work well with GNOME?</b>
|
|
</td>
|
|
</tr>
|
|
<!-- A7 -->
|
|
<tr>
|
|
<td width="10"> <br> </td>
|
|
<td align="left" valign="top" colspan="3">
|
|
<p>The <tt>gnome</tt> meta-port installs the
|
|
<a href="http://sawmill.sourceforge.net/">Sawfish</a> window
|
|
manager by default. However, there are other window managers
|
|
you can use with GNOME. These include:</p>
|
|
|
|
<ul>
|
|
<li><a href="http://www.enlightenment.org/pages/main.html">
|
|
Enlightenment</a></li>
|
|
<li><a href="http://www.fvwm.org/">FVWM2</a></li>
|
|
<li><a href="http://www.windowmaker.org/">WindowMaker</a></li>
|
|
<li><a href="http://www.afterstep.org/">Afterstep</a></li>
|
|
<li><a href="http://www.icewm.org/">IceWM</a></li>
|
|
<li><a href="http://www.xfce.org/">XFce</a></li>
|
|
</ul>
|
|
</td>
|
|
</tr>
|
|
<tr><td><br></td></tr>
|
|
|
|
<!-- Q8 -->
|
|
<tr>
|
|
<td width="10">
|
|
<b><a name="q8"> 8.</a></b></td>
|
|
<td align="left" valign="top" colspan="3">
|
|
<b>Why can't I launch Linux apps from the GNOME panel?</b>
|
|
</td>
|
|
</tr>
|
|
<!-- A8 -->
|
|
<tr>
|
|
<td width="10"><br></td>
|
|
<td align="left" valign="top" colspan="3">
|
|
<p>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
|
|
<tt>~/.gnomerc-errors</tt> or on stdout:</p>
|
|
|
|
<pre>
|
|
/usr/local/Acrobat4/Reader/intellinux/bin/acroread: error in loading shared
|
|
libraries: /usr/X11R6/lib/libxalflaunch.so.0: ELF file OS ABI invalid.
|
|
</pre>
|
|
|
|
<p>To fix this problem you need to install the
|
|
<tt>linux-xalf</tt> port. This port (or package) installs
|
|
the Linux version of <tt>libxalflaunch.so.0</tt> in
|
|
<tt>/compat/linux/usr/X11R6/lib</tt>, and will be used
|
|
instead of the FreeBSD binary when launching Linux
|
|
applications. You may see the following error after
|
|
installing <tt>linux-xalf</tt>:</p>
|
|
|
|
<pre>
|
|
/usr/libexec/ld-elf.so.1: Shared object "libkrb.so.3" not found
|
|
</pre>
|
|
|
|
<p>This can be safely ignored.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td><br></td></tr>
|
|
|
|
<!-- Q9 -->
|
|
<tr>
|
|
<td width="10">
|
|
<b><a name="q9"> 9.</a></b></td>
|
|
<td align="left" valign="top" colspan="3">
|
|
<b>Why is GNOME so huge, slow and basically useless?</b>
|
|
</td>
|
|
</tr>
|
|
<!-- A9 -->
|
|
<tr>
|
|
<td width="10"><br></td>
|
|
<td align="left" valign="top" colspan="3">
|
|
<p>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?).</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td><br></td></tr>
|
|
<!-- Q10 -->
|
|
<tr>
|
|
<td width="10">
|
|
<b><a name="q10"> 10.</a></b></td>
|
|
<td align="left" valign="top" colspan="3">
|
|
<b>Does GNOME support anti-aliased fonts?</b>
|
|
</td>
|
|
</tr>
|
|
<!-- A10 -->
|
|
<tr>
|
|
<td width="10"><br></td>
|
|
<td align="left" valign="top" colspan="3">
|
|
<p>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 <tt>x11/gdkxft</tt> port. That's it! You do not need
|
|
to recompile any of your GNOME applications.</p>
|
|
|
|
<p>If you run into problems, have a look at the
|
|
<a href="http://gdkxft.sourceforge.net/">gdkxft website</a>
|
|
or send email to <a href="mailto:&email;@FreeBSD.org">
|
|
&email;@FreeBSD.org</a>.</p>
|
|
|
|
<p>If you have any questions, please send them to
|
|
<a href="mailto:&email;@FreeBSD.org">&email;@FreeBSD.org</a>.
|
|
</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td><br></td></tr>
|
|
<!-- Q11 -->
|
|
<tr>
|
|
<td width="10">
|
|
<b><a name="q11"> 11.</a></b></td>
|
|
<td align="left" valign="top" colspan="3">
|
|
<b>How do I enable Java support in the Mozilla or Galeon web
|
|
browser?</b>
|
|
</td>
|
|
</tr>
|
|
<!-- A11 -->
|
|
<tr>
|
|
<td width="10"><br></td>
|
|
<td align="left" valign="top" colspan="3">
|
|
<p>To enable Java support in the Mozilla web browser you need to
|
|
install the Java Development Kit available from the <tt>java/jdk13
|
|
</tt>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:</p>
|
|
<pre>
|
|
# ln -sf /usr/local/jdk1.3.1/jre/plugin/i386/ns600/libjavaplugin_oji.so \
|
|
/usr/X11R6/lib/mozilla/plugins/libjavaplugin_oji.so
|
|
</pre>
|
|
|
|
<p>You can verify that the Mozilla has picked the Java plugin by
|
|
selecting <i>About Plug-ins</i> from the <i>Help</i> 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.</p>
|
|
|
|
<p>If you built Galeon against the full version of Mozilla, then
|
|
the Java plugin will also work for it. Just make sure that
|
|
<i>Allow Java</i> in the <i>Settings</i> menu is checked.</p>
|
|
</td>
|
|
</tr>
|
|
<tr><td><br></td></tr>
|
|
|
|
</table>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
&footer;
|
|
</body>
|
|
</html>
|