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

Update the upgrade FAQ for GNOME 2.14.

Browse source
This commit is contained in:
Joe Marcus Clarke 2006-04-30 05:20:38 +00:00
parent ed22fd69af
commit 3b5a1db618
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/www/; revision=27669
2 changed files with 125 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

3
en/gnome/docs/Makefile
View file

@ -1,4 +1,4 @@
# $FreeBSD: www/en/gnome/docs/Makefile,v 1.18 2005/11/05 07:22:29 marcus Exp $
# $FreeBSD: www/en/gnome/docs/Makefile,v 1.19 2006/01/01 20:32:17 adamw Exp $
.if exists(../Makefile.conf)
.include "../Makefile.conf"
@ -11,6 +11,7 @@ DOCS= faq2.sgml
DOCS+= faq28.sgml
DOCS+= faq210.sgml
DOCS+= faq212.sgml
DOCS+= faq214.sgml
DOCS+= gnome_porting.sgml
DOCS+= gnome1_porting.sgml
DOCS+= gnome2_porting.sgml

123
en/gnome/docs/faq214.sgml Normal file
View file

@ -0,0 +1,123 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" [
<!ENTITY base CDATA "../../">
<!ENTITY date "$FreeBSD: www/en/gnome/docs/faq214.sgml,v 1.4 2005/12/29 06:42:28 adamw Exp $">
<!ENTITY title "FreeBSD GNOME Project: GNOME &gnomever; Upgrading FAQ">
<!ENTITY % navincludes SYSTEM "../includes.navgnome.sgml"> %navincludes;
<!ENTITY % gnomeincludes SYSTEM "../includes.sgml"> %gnomeincludes;
<!ENTITY % includes SYSTEM "../../includes.sgml"> %includes;
]>
<html>
&header;
<h2>Contents</h2>
<ol>
<li> <a href="#q1">What is new in GNOME &gnomever;?</a>
<li> <a href="#q2">How do I upgrade to GNOME &gnomever;?</a>
<li> <a href="#q3">The upgrade failed; what do I do?</a>
<li> <a href="#q4">List of known GNOME &gnomever; problems and their solutions</a>
<li> <a href="#q5">I have found a bug; whom should I alert?</a>
<li> <a href="#q6">I want the fame and glory of the FreeBSD GNOME team! What
can I do to participate?</a>
</ol>
<h2>Full Text</h2>
<ol>
<!-- Q1 -->
<li style="padding-bottom: 0.5em"><a name="q1"></a>
<p><b>What is new in GNOME &gnomever;?</b></p>
<!-- A1 -->
<p>Although the canonical summary of new features can be found at
<a
href="http://www.gnome.org/start/2.14/notes/en/">http://www.gnome.org/start/2.12/notes/en/</a>,
some of the most exciting new features of GNOME &gnomever; are:</p>
<ul>
<li>Sexy new default theme, Clearlooks
<li>More usable and powerful Nautilus file manager
<li>Desktop-wide clipboard that can save your paste buffer
even after you have closed the application from which you
copied
<li>Enhanced multimedia support
<li>Extensive list of stability and speed increases
</ul>
</li>
<!-- Q2 -->
<li style="padding-bottom: 0.5em"><a name="q2"></a>
<p><b>How do I upgrade to GNOME &gnomever;?</b></p>
<!-- A2 -->
<p>The answer is much simpler than it has been in the past:</p>
<ol>
<li>
<p>To build GNOME &gnomever;, you need to obtain the latest
ports tree skeleton. This is most easily accomplished with
<tt>portsnap(8)</tt> or <a
href="http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/cvsup.html">cvsup</a>CVSup. Simply obtain the latest ports tree, and you are
ready to go. Then do the following:</p>
<pre>
# pkgdb -Ff
# portupgrade -o net/avahi -f howl
# portupgrade -o x11/gnome-screensaver -f xscreensaver-gnome
</pre>
<p>Then you can run <tt>portupgrade(8)</tt> as you normally
would. <b>NOTE:</b> it is recommended to run <b>portupgrade
-a</b> to make sure you get all the necessary ports.</p>
</ol>
<p>More detailed instructions are as follows:</p>
<!-- Q3 -->
<li style="padding-bottom: 0.5em"><a name="q3"></a>
<p><b>The upgrade failed; what do I do?</b></p>
<!-- A3 -->
<p>Unfortunately, this is not only possible, it is highly probable. There are many possible
valid GNOME configurations, and even more invalid starting points. If the script fails,
follow the instructions in the error message to let the FreeBSD GNOME team know about the
failure.</p>
<p>The majority of build failures will be dependency-related issues. One simple way to resolve
the problem is to remove the offending port, re-run <tt>gnome_upgrade.sh</tt>, and then
reinstall the port when the upgrade process is complete. In
order to avoid having to build everything again, you can pass
the <tt>-restart</tt> flag to <tt>gnome_upgrade.sh</tt> to
resume a failed build.</p>
</li>
<!-- Q4 -->
<li style="padding-bottom: 0.5em"><a name="q4"></a>
<p><b>List of GNOME &gnomever; problems and their solutions</b></p>
<!-- A4 -->
<p>Although GNOME &gnomever; is certainly the best release to date (of course), there are
a couple regressions that slipped in, both in the GNOME code and in its implementation
within FreeBSD. Some of the more visible issues are:</p>
<p>There are currently no known issues with GNOME on
FreeBSD.</p>
</li>
<!-- Q5 -->
<li style="padding-bottom: 0.5em"><a name="q5"></a>
<p><b>I have found a bug; whom should I alert?</b></p>
<!-- A5 -->
<p>Please read the FreeBSD GNOME Project's
<a href="http://www.FreeBSD.org/gnome/docs/bugging.html">documentation on reporting bugs</a>.
</p>
</li>
<!-- Q6 -->
<li style="padding-bottom: 0.5em"><a name="q6"></a>
<p><b>I want the fame and glory of being part of the FreeBSD GNOME team!
What can I do to participate?</b></p>
<!-- A6 -->
<p>Please read our list of <a href="http://www.FreeBSD.org/gnome/docs/volunteer.html">ways
to get involved</a>!
</p>
</li>
</ol>
&footer;
</body>
</html>