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

Update documentation for GNOME 2.24.

Browse source
This commit is contained in:
Joe Marcus Clarke 2009-01-11 22:11:15 +00:00
parent 9084f78e29
commit 1a36ed19ba
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/www/; revision=33689
4 changed files with 158 additions and 11 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.25 2008/03/24 05:14:07 marcus Exp $
# $FreeBSD: www/en/gnome/docs/Makefile,v 1.26 2008/03/30 18:35:28 marcus Exp $
.if exists(../Makefile.conf)
.include "../Makefile.conf"
@ -16,6 +16,7 @@ DOCS+= faq216.sgml
DOCS+= faq218.sgml
DOCS+= faq220.sgml
DOCS+= faq222.sgml
DOCS+= faq224.sgml
DOCS+= gnome_porting.sgml
DOCS+= gnome1_porting.sgml
DOCS+= gnome2_porting.sgml

10
en/gnome/docs/develfaq.sgml
View file

@ -1,6 +1,6 @@
<!DOCTYPE HTML PUBLIC "-//FreeBSD//DTD HTML 4.01 Transitional-Based Extension//EN" [
<!ENTITY base CDATA "../..">
<!ENTITY date "$FreeBSD: www/en/gnome/docs/develfaq.sgml,v 1.54 2008/03/29 22:58:52 marcus Exp $">
<!ENTITY date "$FreeBSD: www/en/gnome/docs/develfaq.sgml,v 1.55 2008/07/04 06:24:47 marcus Exp $">
<!ENTITY title "FreeBSD GNOME Project: GNOME Development Branch FAQ">
<!ENTITY email "freebsd-gnome">
<!ENTITY % navinclude.gnome "INCLUDE">
@ -158,11 +158,9 @@ WITH_DEBUG=yes
<li style="padding-bottom: 0.5em"><a name="q7"></a>
<p><b>What is the current state of development GNOME on FreeBSD?</b></p>
<!-- A7 -->
<p>GNOME 2.23.4 is the latest development release, and it is
relatively stable. The only obvious known issue is that
some icons are missing. This is part of an initiative to
clean up the deprecated icons. As the &gnomedevelver;
releases continue, this will gradually be fixed.</p>
<p>Because of the long ports tree freeze, we have not yet
started work on GNOME &gnomedevelver;. Stay tuned for more
updates.</p>
</li>
</ol>
&footer;

148
en/gnome/docs/faq224.sgml Normal file
View file

@ -0,0 +1,148 @@
<!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 new updated hal port has been included which provides
Fuse support (e.g. for ntfs-3g mounts).</li>
<li>A new IM client, empathy, has been added to the
Desktop.</li>
<li>A time-tracking applet, Hamster, has been added to the
Desktop.</li>
<li>Sound theme support 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
(Answer "yes" to unregister gail while keeping gtk20.)
(Answer "yes" to unregister fast-user-switch-applet while keeping
gdm.)
# pkg_deinstall -fO gtkmm-2.12\*
# portupgrade -aOW
# portupgrade -f gnome-session
</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>
# pkg_delete -f gtkmm-2.12\*
# portmaster -a
# portmaster gnome-session
</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> does not work with the new usb2 stack in
-CURRENT. If you try to use hal with usb2, the hald daemon
will take up 100% of the CPU. Work is underway to fix
this.</li>
<li>Session management is broken in GNOME &gnomever;. See
<a href="http://np237.livejournal.com/22014.html">
http://np237.livejournal.com/22014.html</a> for more details. A
good workaround can be found at
<a href="http://blogs.sun.com/mattman/entry/gnome_2_24_session_save1">
http://blogs.sun.com/mattman/entry/gnome_2_24_session_save1</a>.</li>
<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>

8
en/gnome/index.xsl
View file

@ -4,7 +4,7 @@
<!ENTITY title "The FreeBSD GNOME Project">
<!ENTITY % navinclude.gnome "INCLUDE">
]>
<!-- $FreeBSD: www/en/gnome/index.xsl,v 1.100 2008/05/22 18:26:21 mezz Exp $ -->
<!-- $FreeBSD: www/en/gnome/index.xsl,v 1.101 2008/07/04 17:40:25 marcus Exp $ -->
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
@ -125,16 +125,16 @@
<li>devel/gnome2-hacker-tools (development tools)</li>
</ul>
<h2>Upgrading to GNOME 2.22?</h2>
<h2>Upgrading to GNOME 2.24?</h2>
<p>If you are upgrading from GNOME 2.20 to GNOME 2.22, read the
<p>If you are upgrading from GNOME 2.22 to GNOME 2.24, read the
<a href="docs/faq222.html">Upgrade FAQ</a> for upgrade
instructions.</p>
<h2>State of the port</h2>
<p>GNOME for FreeBSD is currently supported on
6.3, 6-STABLE, 7.0, 7-STABLE, and 8-CURRENT.
6.4, 6-STABLE, 7.0, 7.1, 7-STABLE, and 8-CURRENT.
Most of GNOME has been ported to FreeBSD, but there is still
<a href="docs/volunteer.html">plenty left to be done</a>!</p>