Add the correct file to CVS.

This commit is contained in:
Joe Marcus Clarke 2009-04-11 08:20:24 +00:00
parent 082d8f146a
commit b11d46a663
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/www/; revision=34076
2 changed files with 135 additions and 281 deletions

View file

@ -1,281 +0,0 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta name="generator" content="HTML Tidy, see www.w3.org" />
<title>FreeBSD GNOME Project: GNOME 2.24 Upgrading FAQ</title>
<meta http-equiv="CONTENT-TYPE" content="text/html; charset=iso-8859-1" />
<meta name="MSSMARTTAGSPREVENTPARSING" content="TRUE" />
<link href="../..//favicon.ico" type="image/x-icon" rel="shortcut icon" />
<link href="../..//favicon.ico" type="image/x-icon" rel="icon" />
<link title="Normal Text" href="../..//layout/css/fixed.css?20060509" type="text/css"
rel="stylesheet" media="screen" />
<link title="Large Text" href="../..//layout/css/fixed_large.css" type="text/css"
rel="alternate stylesheet" media="screen" />
<script type="text/javascript" src="../..//layout/js/styleswitcher.js">
</script>
</head>
<body>
<div id="CONTAINERWRAP">
<div id="CONTAINER"><span class="txtoffscreen"><a title="Skip site navigation"
href="#CONTENT" accesskey="1">Skip site navigation</a> (1) <a
title="Skip section navigation" href="#CONTENTWRAP" accesskey="2">Skip section
navigation</a> (2)</span>
<div id="HEADERCONTAINER">
<div id="HEADER">
<h2 class="blockhide">Header And Logo</h2>
<div id="HEADERLOGOLEFT"><a title="FreeBSD" href="../../"><img
src="../..//layout/images/logo-red.png" alt="FreeBSD" height="75" width="457" />
</a></div>
<div id="HEADERLOGORIGHT">
<h2 class="blockhide">Peripheral Links</h2>
<div id="SEARCHNAV">
<ul id="SEARCHNAVLIST">
<li>Text Size: <a title="Normal Text Size"
onclick="setActiveStyleSheet('Normal Text'); return false;" onkeypress="return false;"
href="#">Normal</a> / <a title="Large Text Size"
onclick="setActiveStyleSheet('Large Text'); return false;" onkeypress="return false;"
href="#">Large</a></li>
<li><a title="Donate" href="../..//donations/">Donate</a></li>
<li class="last-child"><a title="Contact" href="../..//mailto.html">Contact</a></li>
</ul>
</div>
<div id="SEARCH">
<form action="http://www.FreeBSD.org/cgi/search.cgi" method="GET">
<div>
<h2 class="blockhide"><label for="WORDS">Search</label></h2>
<div><input type="HIDDEN" name="max" value="25" /> <input type="HIDDEN" name="source"
value="www" /> <input id="WORDS" type="TEXT" name="words" value="Search" size="20"
maxlength="255" onfocus="if( this.value==this.defaultValue ) this.value='';" /> <input
id="SUBMIT" type="SUBMIT" name="submit" value="Search" /></div>
</div>
</form>
</div>
</div>
</div>
<h2 class="blockhide">Site Navigation</h2>
<div id="TOPNAV">
<ul id="TOPNAVLIST">
<li><a title="Home" href="../..//">Home</a></li>
<li><a title="About" href="../..//about.html">About</a></li>
<li><a title="Get FreeBSD" href="../..//where.html">Get FreeBSD</a></li>
<li><a title="Documentation" href="../..//docs.html">Documentation</a></li>
<li><a title="Community" href="../..//community.html">Community</a></li>
<li><a title="Developers" href="../..//projects/index.html">Developers</a></li>
<li><a title="Support" href="../..//support.html">Support</a></li>
<li><a title="The FreeBSD Foundation"
href="http://www.freebsdfoundation.org/">Foundation</a></li>
</ul>
</div>
</div>
<div id="CONTENT">
<div id="SIDEWRAP">
<div id="SIDENAV">
<h2 class="blockhide">Section Navigation</h2>
<ul>
<li><a href="../..//gnome/index.html">FreeBSD/GNOME</a>
<ul>
<li><a href="../..//gnome/docs/faq2.html#q1">Installation Instructions</a></li>
<li><a href="../..//gnome/docs/faq224.html#q2">Upgrade Instructions</a></li>
<li><a href="../..//gnome/../ports/gnome.html">Available Applications</a></li>
<li><a href="../..//gnome/docs/volunteer.html">How to Help</a></li>
<li><a href="../..//gnome/docs/bugging.html">Reporting a Bug</a></li>
<li><a href="../..//gnome/screenshots.html">Screenshots</a></li>
<li><a href="../..//gnome/contact.html">Contact Us</a></li>
</ul>
</li>
<li><a href="../..//gnome/index.html">Documentation</a>
<ul>
<li><a href="../..//gnome/docs/faq2.html">FAQ</a></li>
<li><a href="../..//gnome/docs/halfaq.html">HAL FAQ</a></li>
<li><a href="../..//gnome/docs/faq224.html">2.22 to 2.24 Upgrade FAQ</a></li>
<li><a href="../..//gnome/docs/develfaq.html">Development Branch FAQ</a></li>
<li><a href="../..//gnome/docs/porting.html">Creating Ports</a></li>
<li><a href="../..//gnome/docs/faq224.html#q4">Known Issues</a></li>
</ul>
</li>
</ul>
</div>
</div>
<div id="CONTENTWRAP">
<h1>FreeBSD GNOME Project: GNOME 2.24 Upgrading FAQ</h1>
<h2>Contents</h2>
<ol>
<li><a href="#q1">What is new in GNOME 2.24?</a></li>
<li><a href="#q2">How do I upgrade to GNOME 2.24?</a></li>
<li><a href="#q3">The upgrade failed; what do I do?</a></li>
<li><a href="#q4">List of known GNOME 2.24 problems and their solutions</a></li>
<li><a href="#q5">I have found a bug; whom should I alert?</a></li>
<li><a href="#q6">I want the fame and glory of the FreeBSD GNOME team! What can I do to
participate?</a></li>
</ol>
<h2>Full Text</h2>
<ol>
<li style="padding-bottom: 0.5em"><a id="q1" name="q1"></a>
<p><b>What is new in GNOME 2.24?</b></p>
<p>Although the canonical summary of new features can be found at <a
href="http://library.gnome.org/misc/release-notes/2.24/">http://library.gnome.org/misc/release-notes/2.24/</a>,
some of the most exciting new features of GNOME 2.24 are:</p>
<ul>
<li>A FreeBSD port of libxul-1.9 has been added as an alternative Gecko provider to
Firefox 2. This can be used by setting <tt>WITH_GECKO=libxul</tt> in
<tt>/etc/make.conf</tt>.</li>
<li>The Brasero disc burning application has been added to the Desktop to replace
nautilus-cd-burner.</li>
<li>The pulseaudio sound system has been made part of the Desktop to replace ESounD. This
provides more comprehensive sound support.</li>
<li>Personal file sharing (WebDAV) has been added.</li>
</ul>
</li>
<li style="padding-bottom: 0.5em"><a id="q2" name="q2"></a>
<p><b>How do I upgrade to GNOME 2.24?</b></p>
<p>The answer is relatively simple:</p>
<ol>
<li>
<p>To build GNOME 2.24, 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>.
Simply obtain the latest ports tree, and you are ready to go. Then do the following:</p>
<pre>
# pkgdb -Ff
(Remove gnome-volume-manager.)
# portupgrade -aOW
# portupgrade -f gnome-media gnome-settings-daemon gnome-control-center
</pre>
<p><b>NOTE:</b> it is recommended to run <b>portupgrade -a</b> to make sure you get all
the necessary ports.</p>
<p>If you are a <tt>portmaster(8)</tt> user, make sure you have least 1.9 version. Then
do the following:</p>
<pre>
# portmaster -a
# portmaster gnome-media gnome-settings-daemon gnome-control-center
</pre>
</li>
</ol>
</li>
<li style="padding-bottom: 0.5em"><a id="q3" name="q3"></a>
<p><b>The upgrade failed; what do I do?</b></p>
<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>portupgrade</tt> or
<tt>portmaster</tt>, and then reinstall the port when the upgrade process is
complete.</p>
</li>
<li style="padding-bottom: 0.5em"><a id="q4" name="q4"></a>
<p><b>List of GNOME 2.24 problems and their solutions</b></p>
<p>Although GNOME 2.24 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>
<ul>
<li><b>HAL</b> can not unmount and reset the da[0-9] devices associated with USB disks
when you manually detach them from the system. Manually removing a USB umass device while
it is mounted can result in a panic. This is a known bug in FreeBSD. See <a
href="http://www.freebsd.org/cgi/query-pr.cgi?pr=kern/103258">kern/103258</a> and <a
href="http://www.freebsd.org/cgi/query-pr.cgi?pr=kern/89102">kern/89102</a> for more
details.</li>
</ul>
</li>
<li style="padding-bottom: 0.5em"><a id="q5" name="q5"></a>
<p><b>I have found a bug; whom should I alert?</b></p>
<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>
<li style="padding-bottom: 0.5em"><a id="q6" 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>
<p>Please read our list of <a
href="http://www.FreeBSD.org/gnome/docs/volunteer.html">ways to get involved</a>!</p>
</li>
</ol>
</div>
<br class="clearboth" />
</div>
<div id="FOOTER"><a href="../..//search/index-site.html">Site Map</a> | <a
href="../..//copyright/">Legal Notices</a> | &copy; 1995-2009 The FreeBSD Project. All
rights reserved.<br />
$FreeBSD: www/en/gnome/docs/faq226.html,v 1.1 2009/04/11 03:10:05 marcus Exp $</div>
</div>
</div>
</body>
</html>

135
en/gnome/docs/faq226.sgml Normal file
View file

@ -0,0 +1,135 @@
<!DOCTYPE HTML PUBLIC "-//FreeBSD//DTD HTML 4.01 Transitional-Based Extension//EN" [
<!ENTITY base CDATA "../../">
<!ENTITY date "$FreeBSD$">
<!ENTITY title "FreeBSD GNOME Project: GNOME &gnomever; Upgrading FAQ">
<!ENTITY % navinclude.gnome "INCLUDE">
]>
<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://library.gnome.org/misc/release-notes/&gnomever;/">http://library.gnome.org/misc/release-notes/&gnomever;/</a>,
some of the most exciting new features of GNOME &gnomever; are:</p>
<ul>
<li>A FreeBSD port of libxul-1.9 has been added as an
alternative Gecko provider to Firefox 2. This can be used
by setting <tt>WITH_GECKO=libxul</tt> in
<tt>/etc/make.conf</tt>.</li>
<li>The Brasero disc burning application has been added to
the Desktop to replace nautilus-cd-buner.</li>
<li>The pulseaudio sound system has been made part of the
Desktop to replace ESounD. This provides more comprehensive
sound support.</li>
<li>Personal file sharing (WebDAV) has been added.</li>
</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 relatively simple:</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>. Simply obtain the latest ports tree, and you are
ready to go. Then do the following:</p>
<pre>
# pkgdb -Ff
(Remove gnome-volume-manager.)
# portupgrade -aOW
# portupgrade -f gnome-media gnome-settings-daemon gnome-control-center
</pre>
<p><b>NOTE:</b> it is recommended to run <b>portupgrade
-a</b> to make sure you get all the necessary ports.</p>
<p>If you are a <tt>portmaster(8)</tt> user, make sure you have
least 1.9 version. Then do the following:</p>
<pre>
# portmaster -a
# portmaster gnome-media gnome-settings-daemon gnome-control-center
</pre>
</ol>
</li>
<!-- 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>portupgrade</tt> or <tt>portmaster</tt>, and then
reinstall the port when the upgrade process is complete.</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>
<ul>
<li><b>HAL</b> can not unmount and reset the da[0-9] devices
associated with USB disks when you manually detach them from
the system. Manually removing a USB umass device while it
is mounted can result in a panic. This is a known bug in FreeBSD.
See <a href="http://www.freebsd.org/cgi/query-pr.cgi?pr=kern/103258">kern/103258</a> and <a href="http://www.freebsd.org/cgi/query-pr.cgi?pr=kern/89102">kern/89102</a> for more details.</li>
</ul>
</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>