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

Re-indentate.

Browse source
This commit is contained in:
Maxim Sobolev 2002-01-09 09:07:08 +00:00
parent e0748ee6f2
commit a221be3ac7
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/www/; revision=11638
1 changed files with 255 additions and 225 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

480
en/gnome/docs/faq.sgml
View file

@ -6,92 +6,105 @@
<!ENTITY % includes SYSTEM "../../includes.sgml"> %includes;
]>
<html>
&header;
&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?</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>
</ol>
<h2>Full Text </h2>
<table border="0" cellspacing="0" cellpadding="2">
<tr>
<td width="10">
<font><a name="q1"> 1.</a></font>
</td>
<td align="LEFT" valign="TOP" colspan="3">
<b>How do I get GNOME for FreeBSD?</b>
</td>
</tr>
<tr>
<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>
<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?</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>
</ol>
<h2>Full Text </h2>
<table border="0" cellspacing="0" cellpadding="2">
<p>To install GNOME from packages, use the command:</p>
<!-- Q1 -->
<tr>
<td width="10">
<font><a name="q1"> 1.</a></font>
</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>
<tt># pkg_add -r gnome</tt>
<p>To install GNOME from packages, use the command:</p>
<p>This will download the latest GNOME packages from the FreeBSD FTP
site, and proceed to intall 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>
<tt># pkg_add -r gnome</tt>
<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>
<p>This will download the latest GNOME packages from the FreeBSD FTP
site, and proceed to intall 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>
<pre>
<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>
</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-buit packages.</p>
<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-buit packages.</p>
<p>After GNOME is installed, you should edit <tt>/etc/make.conf</tt>,
and add the following lines. If <tt>/etc/make.conf</tt> does not
exist, create the file, then add the following lines:</p>
<p>After GNOME is installed, you should edit <tt>/etc/make.conf</tt>,
and add the following lines. If <tt>/etc/make.conf</tt> does not
exist, create the file, then add the following lines:</p>
<pre>
<pre>
WITH_GTK=yes
WITH_ESOUND=yes
WITH_GNOME=yes
</pre>
</pre>
<p>This last step is optional, but these lines enable other ports,
such as XMMS, to take advantage of the GNOME installation.</p>
</td>
</tr>
<tr>
<td width="10"><br></td>
</tr>
<tr><td colspan="4"><br></td></tr>
<tr>
<td width="10">
<font><a name="q2"> 2.</a></font></td>
<td align="LEFT" valign="TOP" colspan="3">
<b>GNOME is failing to build from ports. What do I do?</b>
</td>
</tr>
<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>
<p>This last step is optional, but these lines enable other ports,
such as XMMS, to take advantage of the GNOME installation.</p>
</td>
</tr>
<tr>
<td width="10"><br></td>
</tr>
<tr><td colspan="4"><br></td></tr>
<pre>
<!-- Q2 -->
<tr>
<td width="10">
<font><a name="q2"> 2.</a></font></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
@ -101,186 +114,203 @@ Imlib
esound
gnomelibs
gnomecore
</pre>
</pre>
<p>Verify all those components are up-to-date, then try building
GNOME or your GNOME application again. If you're trying to build
one of those core components, and it is failing, or if, after updating
all your components, 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 width="10"><br></td>
</tr>
<tr><td colspan="4"><br></td></tr>
<tr>
<td width="10">
<font><a name="q3"> 3.</a></font></td>
<td align="LEFT" valign="TOP" colspan="3">
<b>I installed GNOME, but I'm missing application foo. What gives?</b>
</td>
</tr>
<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>Verify all those components are up-to-date, then try building
GNOME or your GNOME application again. If you're trying to build
one of those core components, and it is failing, or if, after
updating all your components, 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 width="10"><br></td>
</tr>
<tr><td colspan="4"><br></td></tr>
<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>
<!-- Q3 -->
<tr>
<td width="10">
<font><a name="q3"> 3.</a></font></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>
<tt># pkg_add -r gnome-fifth-toe</tt>
<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>
<p>To build <tt>gnome-fifth-toe</tt> from ports:</p>
<tt># pkg_add -r gnome-fifth-toe</tt>
<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>
</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 width="10"><br></td>
</tr>
<tr><td colspan="4"><br></td></tr>
<tr>
<td width="10">
<font><a name="q4"> 4.</a></font></td>
<td align="LEFT" valign="TOP" colspan="3">
<b>What's the best way to upgrade GNOME?</b>
</td>
</tr>
<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>
<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 width="10"><br></td>
</tr>
<tr><td colspan="4"><br></td></tr>
<tt># portupgrade -r ORBit</tt>
<!-- Q4 -->
<tr>
<td width="10">
<font><a name="q4"> 4.</a></font></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>
<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>
<tt># portupgrade -r ORBit</tt>
<pre>
<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 width="10"><br></td>
</tr>
<tr><td colspan="4"><br></td></tr>
<tr>
<td width="10">
<font><a name="q5"> 5.</a></font></td>
<td align="LEFT" valign="TOP" colspan="3">
<b>What is the difference between GNOME and KDE?</b>
</td>
</tr>
<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>
</pre>
</td>
</tr>
<tr>
<td width="10"><br></td>
</tr>
<tr><td colspan="4"><br></td></tr>
<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 you like better.</p>
<!-- Q5 -->
<tr>
<td width="10">
<font><a name="q5"> 5.</a></font></td>
<td align="left" valign="top" colspan="3">
<b>What is the difference between GNOME and KDE?</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>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 width="10"><br></td>
</tr>
<tr><td colspan="4"><br></td></tr>
<tr>
<td width="10">
<font><a name="q6"> 6.</a></font></td>
<td align="LEFT" valign="TOP" colspan="3">
<b>Where can I get more themes for GNOME?</b>
</td>
</tr>
<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>
<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 you like better.</p>
<tt># pkg_add -r gtk-engines-collection</tt>
<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 width="10"><br></td>
</tr>
<tr><td colspan="4"><br></td></tr>
<p>To install the themes from ports, do:</p>
<!-- Q6 -->
<tr>
<td width="10">
<font><a name="q6"> 6.</a></font></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>
<pre>
<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 all install clean
</pre>
# 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 themes from themes.org.</p>
</td>
</tr>
<tr>
<td width="10"><br></td>
</tr>
<tr><td colspan="4"><br></td></tr>
<tr>
<td width="10">
<font><a name="q7"> 7.</a></font></td>
<td align="LEFT" valign="TOP" colspan="3">
<b>What window managers work well with GNOME?</b>
</td>
</tr>
<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>
<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 themes from themes.org.</p>
</td>
</tr>
<tr>
<td width="10"><br></td>
</tr>
<tr><td colspan="4"><br></td></tr>
<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>
</ul>
</td>
</tr>
<tr>
<td width="10"><br></td>
</tr>
<!-- Q7 -->
<tr>
<td width="10">
<font><a name="q7"> 7.</a></font></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>
</table>
</td>
</tr>
</table>
&footer;
<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>
</ul>
</td>
</tr>
<tr>
<td width="10"><br></td>
</tr>
</table>
</td>
</tr>
</table>
&footer;
</body>
</html>