aboutsummaryrefslogtreecommitdiff
path: root/en_US.ISO8859-1/htdocs/gnome/docs/faq216.xml
blob: f9ffaa1f6891712d14121748d94b591a8f06ac6d (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//FreeBSD//DTD XHTML 1.0 Transitional-Based Extension//EN"
"http://www.FreeBSD.org/XML/doc/share/sgml/xhtml10-freebsd.dtd" [
<!ENTITY title "FreeBSD GNOME Project: GNOME &gnomever; Upgrading FAQ">
]>
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
      <title>&title;</title>

      <cvs:keyword xmlns:cvs="http://www.FreeBSD.org/XML/CVS">$FreeBSD$</cvs:keyword>
    </head>

    <body class="navinclude.gnome">

  <h2>Contents</h2>
    <ol>
    <li> <a href="#q1">What is new in GNOME &gnomever;?</a></li>
    <li> <a href="#q2">How do I upgrade to GNOME &gnomever;?</a></li>
    <li> <a href="#q3">The upgrade failed; what do I do?</a></li>
    <li> <a href="#q4">List of known GNOME &gnomever; 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>
<!-- 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.16/notes/en/">http://www.gnome.org/start/2.16/notes/en/</a>,
	some of the most exciting new features of GNOME &gnomever; are:</p>

      <ul>
        <li>HAL support for FreeBSD!</li>
	<li>MUCH better performance in large applications like
	  Evolution</li>
	<li>Better power management and media/volume integration</li>
	<li>Solid menu editing support</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 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>.  Simply obtain the latest ports tree, and you are
	    ready to go.  Then do the following:</p>
	  <pre>
# pkgdb -Ff
# portupgrade -rf pkg-config\*
	  </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>

	  <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 -r pkg-config\*
	  </pre>

	  <p>Then run portmaster normally.</p></li>
	</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><tt>hald-addon-storage</tt> consumes file descriptors
	  until it crashes.  This is a known bug in FreeBSD, and only
	  affects 6.0 and earlier and 5.5 and earlier.  Users on those
	  releases are encouraged to upgrade to FreeBSD 6.1 or
	  later.</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>

</body>
</html>