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

Change all embedded HTML lags to lowercase. Also, fix a few typos.

Browse source
This commit is contained in:
Maxim Sobolev 2002-01-09 02:49:58 +00:00
parent 3a6cf9af28
commit d6ffaf7aa5
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/www/; revision=11635
2 changed files with 161 additions and 161 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

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

@ -24,74 +24,74 @@
<h2>Full Text </h2>
<table border="0" cellspacing="0" cellpadding="2">
<tr>
<TD WIDTH="10">
<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>
</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>
<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>
<p>To install GNOME from packages, use the command:</p>
<TT># pkg_add -r gnome</TT>
<tt># pkg_add -r gnome</tt>
<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
<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>
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>
<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>
<pre>
# cd /usr/ports/x11/gnome
# make clean
# make install clean
</PRE>
</pre>
<P>Currently, building from ports is the preferred method for installing
<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>
situation with pre-buit packages.</p>
<P>After GNOME is installed, you should edit <tt>/etc/make.conf</tt>,
<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>
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>
<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>
<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>
<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
<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>
applications require the following core components to build:</p>
<PRE>
<pre>
pkg-config
glib
gettext
@ -101,180 +101,180 @@ Imlib
esound
gnomelibs
gnomecore
</PRE>
</pre>
<P>Verify all those components are up-to-date, then try building
<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>
the output of the failed compilation.</p>
</td>
</tr>
<tr>
<TD WIDTH="10"><br></td>
<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>
<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
<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>
more.</p>
<P>To install <tt>gnome-fifth-toe</tt> from packages. <B>Note</B>:
<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>
4.4-RELEASE.</p>
<TT># pkg_add -r gnome-fifth-toe</TT>
<tt># pkg_add -r gnome-fifth-toe</tt>
<P>To build <tt>gnome-fifth-toe</tt> from ports:
<p>To build <tt>gnome-fifth-toe</tt> from ports:</p>
<PRE>
<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>
<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>
<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>
<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>
<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>
<tt># portupgrade -r ORBit</tt>
<P>This will upgrade ORBit and every other port that depends on it
(that needs updating).</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
<p>However, sometimes so much changes that it becomes
necessary to do a little housekeeping first. In that case, this
usually works:</P>
usually works:</p>
<PRE>
<pre>
# pkg_delete -r ORBit
# cd /usr/ports/x11/gnome
# make clean
# make install clean
</PRE>
</TD>
</pre>
</td>
</tr>
<tr>
<TD WIDTH="10"><br></td>
<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>
<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
<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>
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-blow office suites. Both are actively developed and
<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>
own, try them both, and see which one you 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>
<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>
<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>
<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
<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>
from packages, run:</p>
<TT># pkg_add -r gtk-engines-collection</TT>
<tt># pkg_add -r gtk-engines-collection</tt>
<P>To install the themes from ports, do:</P>
<p>To install the themes from ports, do:</p>
<PRE>
<pre>
# cd /usr/ports/x11-toolkits/gtk-engines-collection
# make all install clean
</PRE>
</pre>
<P>If you want even more themes, checkout
<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>
before using any of the themes from themes.org.</p>
</td>
</tr>
<tr>
<TD WIDTH="10"><br></td>
<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>
<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
<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>
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>
</UL>
</TD>
<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>
<td width="10"><br></td>
</tr>
</table>
@ -282,5 +282,5 @@ gnomecore
</tr>
</table>
&footer;
</BODY>
</HTML>
</body>
</html>

56
en/gnome/docs/porting.sgml
View file

@ -11,56 +11,56 @@
<table border="0">
<tr>
<td>
<P>General instructions can be found in the <A HREF="http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/index.html">FreeBSD Porter's Handbook</A>.
<P>For ports that <I>require</I> GNOME, you should define the following in your
port's Makefile:</P>
<p>General instructions can be found in the <a href="http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/index.html">FreeBSD Porter's Handbook</a>.
<p>For ports that <i>require</i> GNOME, you should define the following in your
port's Makefile:</p>
<PRE>
<pre>
USE_GNOME= yes
USE_X_PREFIX= yes
</PRE>
</pre>
<P>These will take care of the install prefix and requiring all the core GNOME
<p>These will take care of the install prefix and requiring all the core GNOME
dependencies. If your port can use GNOME, but it isn't required, you can
define the following in your Makefile:</P>
define the following in your Makefile:</p>
<PRE>
<pre>
WANT_GNOME= yes
</PRE>
</pre>
<P>If the user has defined <tt>WITH_GNOME</tt> in their <tt>/etc/make.conf</tt>
<p>If the user has defined <tt>WITH_GNOME</tt> in their <tt>/etc/make.conf</tt>
then GNOME components will be built. Other useful GNOME-related macros
that can be define in your port's Makefile include:</P>
that can be define in your port's Makefile include:</p>
<UL>
<LI><p><tt>USE_GLIB (WANT_GLIB)</tt> : The application requires (can use) Glib.
<ul>
<li><p><tt>USE_GLIB (WANT_GLIB)</tt> : The application requires (can use) Glib.
Defining <tt>USE_GNOME</tt> or <tt>USE_GTK</tt> takes care of this option
automatically.</p></LI>
<LI><p><tt>USE_GTK (WANT_GTK)</tt> : The application may not be GNOME-compliant, but
automatically.</p></li>
<li><p><tt>USE_GTK (WANT_GTK)</tt> : The application may not be GNOME-compliant, but
requires GTK+ widgets. This will take care of those dependencies. Note, this
option should <B>not</B> be defined if <tt>USE_GNOME</tt> is defined.</p></LI>
<LI><p><tt>USE_ESOUND (WANT_ESOUND)</tt> : The application requires (can use)
option should <b>not</b> be defined if <tt>USE_GNOME</tt> is defined.</p></li>
<li><p><tt>USE_ESOUND (WANT_ESOUND)</tt> : The application requires (can use)
Esound. Normally, Esound support is added by specifying <tt>USE_GNOME</tt>.
</p></LI>
<LI><p><tt>USE_IMLIB (WANT_IMLIB)</tt> : The application requires (can use) the
</p></li>
<li><p><tt>USE_IMLIB (WANT_IMLIB)</tt> : The application requires (can use) the
Imlib image library. This is not needed if <tt>USE_GNOME</tt> is defined.
</p></LI>
<LI><p><tt>USE_GNOMELIBS (WANT_GNOMELIBS)</tt> : The application requires (can use)
</p></li>
<li><p><tt>USE_GNOMELIBS (WANT_GNOMELIBS)</tt> : The application requires (can use)
GNOME libraries. This does not import as many dependencies as
<tt>USE_GNOME</tt> and should be used for applications that use GNOME, but
do not need the GNOME Control Center, the GNOME capplet library, or
anything from the GNOME Core.</p></LI>
<LI><p><tt>USE_GNOMECTRL (WANT_GNOMECTRL)</tt> : The application requires
anything from the GNOME Core.</p></li>
<li><p><tt>USE_GNOMECTRL (WANT_GNOMECTRL)</tt> : The application requires
(can use) all the GNOME libraries and the GNOME Control Center, but does not
use anything from GNOME Core. This option is usually used for backend APIs.
</p></LI>
</UL>
</p></li>
</ul>
<P>The more ported applications we have, the better.
<p>The more ported applications we have, the better.
</td>
</tr>
</table>
&footer;
</BODY>
</HTML>
</body>
</html>