doc/en/gnome/docs/faq.sgml
Maxim Sobolev 36614bb08c - Override contactus link at the bottom of each page with our own one;
- move KDE into its own section: Related Projects;
- add dummy (so far) entry for a link to a GNOME on GNU/Darwin page.
2002-01-23 21:56:27 +00:00

372 lines
12 KiB
Text

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" [
<!ENTITY base CDATA "../..">
<!ENTITY date "$FreeBSD$">
<!ENTITY title "FreeBSD GNOME Project: 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'm missing application
foo. What gives?</a>
<li> <a href="#q4">What's the best way to upgrade GNOME?</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>
</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. <b>Note:</b> As
of 4.4-RELEASE, installing GNOME from packages contained on a
release CDROM is broken. You should instead use the ports
method below.</p>
<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>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.</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 up-to-date. 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 P1003_1B
options _KPOSIX_PRIORITY_SCHEDULING
</pre>
<p>And make sure if you're 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. 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'm 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. <b>Note</b>:
Installing <tt>gnome-fifth-toe</tt> from packages is currently
broken on 4.4-RELEASE.</p>
<tt># pkg_add -r gnome-fifth-toe</tt>
<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>What's the best way to upgrade GNOME?</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 ORBit</tt>
<p>This will upgrade ORBit 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 -r ORBit
# cd /usr/ports/x11/gnome
# make clean
# make install clean
</pre>
</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're 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'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:</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://gtk.themes.org">http://gtk.themes.org</a>. Note,
you will probably need to install the <tt>gtk-engines-collection</tt>
before using any of the pixmap themes from themes.org.</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
hardly could be compared to commercial offerings in terms of
user-friendlily, but at the same time it is a huge step in the
right direction. It also should be noted, that both GNOME and
KDE are still very young and situation is likely to improve as
they will mature (does anybody remember what sort of crap
Windows 3.11 was?).</p>
</td>
</tr>
<tr><td><br></td></tr>
</table>
</td>
</tr>
</table>
&footer;
</body>
</html>