Clear up the keeping-up-to-date section a bit... simplify explanations

and make examples a little more fool-tolerant.
This commit is contained in:
Adam Weinberger 2004-01-08 06:42:12 +00:00
parent 263c23904d
commit ac8c623ba2
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/www/; revision=19534

View file

@ -1,6 +1,6 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" [
<!ENTITY base CDATA "../..">
<!ENTITY date "$FreeBSD: www/en/gnome/docs/faq2.sgml,v 1.56 2003/12/28 00:48:28 adamw Exp $">
<!ENTITY date "$FreeBSD: www/en/gnome/docs/faq2.sgml,v 1.57 2004/01/08 03:29:36 marcus Exp $">
<!ENTITY title "FreeBSD GNOME Project: GNOME &gnomever; FAQ">
<!ENTITY % gnomeincludes SYSTEM "../includes.sgml"> %gnomeincludes;
<!ENTITY % includes SYSTEM "../../includes.sgml"> %includes;
@ -306,32 +306,40 @@ to run the above command after each step below)
<p><b>How do I keep my GNOME &gnomever; components and applications
up-to-date?</b></p>
<!-- A6 -->
<p>I find that <tt>/usr/ports/sysutils/portupgrade</tt> works really
well. For example:</p>
<p>You are emphatically encouraged to use <tt>portupgrade</tt> --
and <em>only</em> <tt>portupgrade</tt> -- to keep your GNOME
&gnomever; components and applications up-to-date.</p>
<tt># portupgrade -r pkgconfig</tt>
<p>Once you have updated your ports tree (presumably with
<tt>cvsup</tt>), the following two simple commands will update
what needs to be updated, and will prevent inconsistencies:</p>
<p>This will upgrade pkgconfig and every other port that depends
on it (that needs updating).</p>
<pre>
# pkgdb -F
# portupgrade -a
</pre>
<p>However, sometimes so much changes that it becomes
necessary to do a little housekeeping first. In that case, this
usually works:</p>
<p>Despite consistent utilization of <tt>portupgrade</tt>, if
it seems like everything is refusing to build with everything
else, you might save yourself a headache or three by removing
all your GNOME apps and reinstalling them (your data files will
remain untouched). To do this, follow these commands:</p>
<pre>
# pkgdb -F
# pkg_delete -rf pkgconfig\*
# cd /usr/ports/x11/gnome2
# 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 2 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>
<p>After running the above commands, you will have to reinstall all
the GNOME applications you desire. This process sounds painful,
but it is actually a great way to clear cruft off of your system.
Just install applications as you need them, and you'll be surprised
how much disk space you have reclaimed. A full rebuild does take
a significant amount of time; fortunately, this measure is only
rarely needed.</p>
</li>
<!-- Q7 -->