os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Actually add the GNOME 2.0 FAQ.

Browse source 
Reported by:	kermida, blackend
Big pointy hat to:	me (for breaking the web build)
This commit is contained in:
Joe Marcus Clarke 2002-07-06 02:48:02 +00:00
parent 8915aa9dd6
commit 9ddf90e331
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/www/; revision=13567
1 changed files with 335 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

335
en/gnome/docs/faq2.sgml Normal file
View file

@ -0,0 +1,335 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" [
<!ENTITY base CDATA "../..">
<!ENTITY date "$FreeBSD$">
<!ENTITY title "FreeBSD GNOME Project: GNOME 2.0 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 2.0 for FreeBSD?</a>
<li> <a href="#q2">GNOME 2.0 is failing to build from ports. What
do I do?</a>
<li> <a href="#q3">I installed GNOME 2.0, but I'm missing
application foo. What gives?</a>
<li> <a href="#q4">What's the best way to upgrade from GNOME
1.4.1 to GNOME 2.0?</a>
<li> <a href="#q5">Can I install GNOME 1.4.1 applications under
GNOME 2.0 and vice versa?</a>
<li> <a href="#q6">Where can I get more themes for GNOME 2.0?</a>
<li> <a href="#q7">What window managers work well with GNOME 2.0?
</a>
<li> <a href="#q8">Does GNOME 2.0 support anti-aliased fonts?</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 2.0 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 2.0 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 2.0 from packages, use the command:</p>
<tt># pkg_add -r gnome2</tt>
<p>This will download the latest GNOME 2.0 packages from the
FreeBSD FTP site, and proceed to install them on your system.
<b>Note:</b> 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.</p>
<p>To build and install GNOME 2.0 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/gnome2
# make clean
# make install clean
</pre>
<p>After installing GNOME 2.0, you might consider adding the
following to <tt>/etc/make.conf</tt>:</p>
<pre>
WITHOUT_GNOME=yes
</pre>
<p>This prevents applications that WANT_GNOME from installing
GNOME 1.4.1 components that conflict with GNOME 2.0. The GNOME
1.4.1 and GNOME 2.0 desktops do not coexist. Work is being done
on the ports system to allow for GNOME 2.0 specific make macros,
but it has not been committed yet. For more on GNOME 1.4.1 and
GNOME 2.0 coexistence, please see the related
<a href="#q5">question</a> below.</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 2.0 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 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:</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.
It is also helpful to include the config.log from the port's
work directory.</p>
<p>Ports such as <tt>devel/pth</tt> and <tt>devel/ngpt</tt> 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.
</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 2.0, 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>gnome2</tt> 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
<a href="#q5">GNOME 1.4.1 applications</a> under GNOME 2.0.</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 from GNOME 1.4.1 to GNOME 2.0?</b>
</td>
</tr>
<!-- A4 -->
<tr>
<td width="10"> <br> </td>
<td align="left" valign="top" colspan="3">
<p>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 <a href="http://www.gnome.org/start/2.0/installation.html#upgrading">official</a> 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:</p>
<pre>
gnomecore
sawfish
gnomeapplets
gnomemedia
gtop
libgtop
nautilus
glade
gedit
xalf
bugbuddy
gnomegames
gnomeutils
</pre>
<p>After those packages are removed, you can build GNOME 2.0 per the
instructions listed above.</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>Can I install GNOME 1.4.1 applications under GNOME 2.0 and vice
versa?</b>
</td>
</tr>
<!-- A5 -->
<tr>
<td width="10"> <br> </td>
<td align="left" valign="top" colspan="3">
<p>Sure! To run GNOME 1.4.1 applications within the GNOME 2.0 desktop
you will need to have <a href="#q4">upgraded</a>
from GNOME 1.4.1 to GNOME 2.0. Then, simply run the GNOME 1.4.1
application. Any GNOME 1.4.1 application that directly depends on
gnomecore (e.g. any panel applet) will <b>not</b> work in
GNOME 2.0 (e.g. gaim-gnome).</p>
<p>Upgrading GNOME 1.4.1 applications under GNOME 2.0 is currently
broken unfortunately. If gnomecore is installed, all bets are
off. This will result in GNOME 1.4.1 overwriting GNOME 2.0.
Fortunately, work is being done to correct this problem. As
soon as something is in place, this document will be updated.
</p>
<p>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 <tt>gnome2-devel</tt> port. To install this port
do the following:</p>
<pre>
# cd /usr/ports/devel/gnome2-devel
# make clean
# make install
</pre>
<p>After installing the <tt>gnome2-devel</tt> port, you will
be able to install <b>non-desktop</b> GNOME 2.0 applications
(e.g. <tt>math/gcalctool</tt>).</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 2.0?</b>
</td>
</tr>
<!-- A6 -->
<tr>
<td width="10"> <br> </td>
<td align="left" valign="top" colspan="3">
<p>The website <a href="http://www.sunshineinabag.co.uk/">
Sunshine in a Bag</a> 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.</p>
<p>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 ;-).</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 2.0?</b>
</td>
</tr>
<!-- A7 -->
<tr>
<td width="10"> <br> </td>
<td align="left" valign="top" colspan="3">
<p>The <tt>gnome2</tt> meta-port installs the
<a href="http://sawmill.sourceforge.net/">sawfish</a> 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.</p>
</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>Does GNOME 2.0 support anti-aliased fonts?</b>
</td>
</tr>
<!-- A8 -->
<tr>
<td width="10"><br></td>
<td align="left" valign="top" colspan="3">
<p>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:</p>
<pre>
Load "freetype"
Load "type1"
</pre>
<p>Then, simply set the environment variable
<tt>USE_GDK_XFT</tt> to 1 before starting GNOME.
If you use gdm, you can add it to your <tt>~/.gnomerc</tt>
file (make sure this file is executable!). If you use startx,
then add it to your <tt>~/.xinitrc</tt> file.</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>
</table>
</td>
</tr>
</table>
&footer;
</body>
</html>