Gentoo Archives: gentoo-commits

From: "Jorge Manuel B. S. Vicetto (jmbsvicetto)" <jmbsvicetto@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] gentoo commit in xml/htdocs/proj/en/desktop/kde: index.xml kde4-guide.xml
Date: Fri, 30 Jan 2009 03:51:36
Message-Id: E1LSkPm-0001w7-EW@stork.gentoo.org
1 jmbsvicetto 09/01/30 03:51:34
2
3 Modified: index.xml kde4-guide.xml
4 Log:
5 Updated index.xml to reflect last changes and rewrote a few sections in the kde4-guide
6 to have it apply to both 4.2 and 4.1.
7
8 Revision Changes Path
9 1.57 xml/htdocs/proj/en/desktop/kde/index.xml
10
11 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/desktop/kde/index.xml?rev=1.57&view=markup
12 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/desktop/kde/index.xml?rev=1.57&content-type=text/plain
13 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/desktop/kde/index.xml?r1=1.56&r2=1.57
14
15 Index: index.xml
16 ===================================================================
17 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/desktop/kde/index.xml,v
18 retrieving revision 1.56
19 retrieving revision 1.57
20 diff -u -r1.56 -r1.57
21 --- index.xml 29 Jan 2009 03:10:17 -0000 1.56
22 +++ index.xml 30 Jan 2009 03:51:34 -0000 1.57
23 @@ -7,7 +7,7 @@
24 <name>KDE</name>
25 <longname>Gentoo KDE Project</longname>
26
27 -<date>2008-11-22</date>
28 +<date>2009-01-30</date>
29
30 <author title="Author">
31 <mail link="caleb@g.o">Caleb Tennis</mail>
32
33
34
35 1.13 xml/htdocs/proj/en/desktop/kde/kde4-guide.xml
36
37 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml?rev=1.13&view=markup
38 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml?rev=1.13&content-type=text/plain
39 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml?r1=1.12&r2=1.13
40
41 Index: kde4-guide.xml
42 ===================================================================
43 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml,v
44 retrieving revision 1.12
45 retrieving revision 1.13
46 diff -u -r1.12 -r1.13
47 --- kde4-guide.xml 16 Nov 2008 19:25:48 -0000 1.12
48 +++ kde4-guide.xml 30 Jan 2009 03:51:34 -0000 1.13
49 @@ -1,9 +1,9 @@
50 <?xml version="1.0" encoding="UTF-8"?>
51 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
52 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml,v 1.12 2008/11/16 19:25:48 scarabeus Exp $ -->
53 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml,v 1.13 2009/01/30 03:51:34 jmbsvicetto Exp $ -->
54
55 <guide link="/proj/en/desktop/kde/kde4-guide.xml" lang="en">
56 -<title>Gentoo KDE 4.1 Guide</title>
57 +<title>Gentoo KDE 4.X Guide</title>
58
59 <author title="Author">
60 <mail link="scarabeus" />
61 @@ -19,7 +19,7 @@
62 </author>
63
64 <abstract>
65 -This guide demonstrates how to setup KDE 4.1 using the ebuilds in the tree. Some
66 +This guide demonstrates how to setup KDE 4.X using the ebuilds in the tree. Some
67 tools from the KDE team's git overlay (kde-testing) will be used.
68 </abstract>
69
70 @@ -27,8 +27,8 @@
71 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
72 <license/>
73
74 -<version>0.3</version>
75 -<date>2008-10-23</date>
76 +<version>0.4</version>
77 +<date>2009-01-30</date>
78
79 <chapter>
80 <title>Cleaning up</title>
81 @@ -72,10 +72,12 @@
82 <body>
83
84 <p>
85 +The KDE 4.2 ebuilds are masked for now until we get everything ready. So if you want
86 +to test it before we unmask it, you'll need to use the package.unmask file from <uri
87 +link="http://git.overlays.gentoo.org/gitweb/?p=proj/kde.git;a=blob_plain;f=Documentation/package.unmask/kde-4.2.0;hb=master">
88 +Documentation/package.unmask/kde-4.2.0</uri>.
89 The KDE 4.1 ebuilds are no longer masked so you won't need to use the package.unmask
90 -file to be able to install them. If you're running ~arch and don't want to update to 4.1,
91 -you can use the package.mask file from <uri
92 -link="http://git.overlays.gentoo.org/gitweb/?p=proj/kde.git;a=blob_plain;f=Documentation/package.mask/kde;hb=master">Documentation/package.mask/kde</uri>.
93 +file to be able to install them.
94 If you are running the stable tree you will need to keyword the ebuilds,
95 otherwise skip this step. For those running the stable tree in Gentoo:
96 </p>
97 @@ -144,7 +146,12 @@
98 <section>
99 <title>Using sets</title>
100 <body>
101 - <warn>Portage 2.2_rcX is currently masked to allow 2.1.6 getting stable asap. So if you want to use sets please unmask <c>~sys-apps/portage-2.2</c>. Also all users of kde-crazy should unmask this portage version.</warn>
102 +
103 +<warn>
104 +Portage 2.2_rcX is currently masked to allow 2.1.6 getting stable asap. So if
105 +you want to use sets please unmask <c>~sys-apps/portage-2.2</c>.
106 +</warn>
107 +
108 <p>
109 One of the new features provided by Portage 2.2 is sets.
110 </p>
111 @@ -156,12 +163,12 @@
112 before we can put sets in the Portage tree. Thus, grab the sets from the
113 <c>kde-testing</c> overlay <uri
114 link="http://git.overlays.gentoo.org/gitweb/?p=proj/kde.git;a=tree;f=sets;h=e44f270a37083da16da6f1b70c226169e44c4237;hb=master">sets
115 -directory</uri> or as <uri
116 -link="http://dev.gentoo.org/~scarabeus/sets-4.1.tar.bz2">sets tarball</uri>
117 -and put the ones you like in <e>/etc/portage/sets</e> -- you
118 -can browse the list of sets provided by the KDE team in the overlay.
119 +directory</uri> or grab them as a <uri
120 +link="http://git.overlays.gentoo.org/gitweb/?p=proj/kde.git;a=snapshot;h=5b2fc54fa5d1c8aeddaeb05f044bf28754bb18be;sf=tbz2">
121 +tar.bz2 archive</uri> and put the ones you like in <e>/etc/portage/sets</e> --
122 +you can browse the list of sets provided by the KDE team in the overlay
123 +by using the first link.
124 </p>
125 -<note>If you experience any problems with tarball use sets from overlay. (Tarball last updated 20081027)</note>
126 <p>
127 Amongst others, there are sets for each KDE tarball - @kdeaccessibility,
128 @kdeadmin, @kdeartwork, @kdebase, @kdeedu, @kdegames, @kdegraphics,
129 @@ -203,9 +210,9 @@
130 </note>
131
132 <note>
133 -All KDE 4.1 ebuilds require <c>sys-apps/portage-2.2_rc11</c> or greater, which
134 -has implemented everything in the new EAPI 2 specification used in these
135 -ebuilds (<c>sys-apps/portage-2.1.6</c> will backport this feature).
136 +All >= KDE 4.1 ebuilds require <c>sys-apps/portage-2.1.6</c> or greater,
137 +which has implemented everything in the new EAPI 2 specification used in
138 +these ebuilds (<c>>=sys-apps/portage-2.2_rc12</c> is required to use sets).
139 </note>
140
141 </body>
142 @@ -215,12 +222,14 @@
143 <body>
144
145 <note>
146 -This method is provided to ease the transition to the new sets. There will be no
147 -meta ebuilds for KDE 4.2.
148 +This method is provided to ease the transition to the new sets. We had planned
149 +not to have meta ebuilds for KDE 4.2, but as sets support isn't finalized yet,
150 +that portage-2.2 is still hard masked and that we can't have sets in the tree,
151 +we opted to offer metas for 4.2.
152 </note>
153
154 <pre caption="emerge meta packages">
155 -# <i>emerge kde-meta:4.1</i>
156 +# <i>emerge kde-meta:4.X</i>
157 </pre>
158
159 </body>
160 @@ -252,19 +261,20 @@
161
162 <p>
163 KDE stores its configuration files in the <e>~/.kde</e> directory by default. In
164 -the Gentoo ebuilds this has been changed in KDE 4.1 to allow for better
165 -integration of KDE 3.5 and 4.1 when using the same user account. If you export
166 +the Gentoo ebuilds this has been changed in KDE 4.1 and later to allow for better
167 +integration of KDE 3.5 and 4.X when using the same user account. If you export
168 $KDEHOME this behaviour will be overridden. It is strongly recommended that you
169 -do not do this. $KDEHOME will make KDE 3.5 and 4.1 use the same configuration
170 +do not do this. $KDEHOME will make KDE 3.5 and 4.X use the same configuration
171 directory which is usually not desired.
172 </p>
173
174 <p>
175 -KDE 3.5 uses <e>~/.kde</e> and the default FHS (-kdeprefix) KDE 4.1 uses
176 +KDE 3.5 uses <e>~/.kde</e> and the default FHS (-kdeprefix) KDE 4.X uses
177 <e>~/.kde4</e>. If you install KDE 4.1 using the kdeprefix USE flag then the
178 -configuration directory will default to <e>~/.kde4.1</e>, <e>~/.kde4.2</e> etc.
179 -The advantage of this is that KDE 3.5 and 4.1 can be run from the same user
180 -account without clobbering settings. Moving backwards in version, i.e. 4.1 to
181 +configuration directory will default to <e>~/.kde4.1</e>, for KDE 4.2 it will
182 +be <e>~/.kde4.2</e> and so on.
183 +The advantage of this is that KDE 3.5 and 4.X can be run from the same user
184 +account without clobbering settings. Moving backwards in version, i.e. 4.X to
185 3.5, is not supported.
186 </p>
187
188 @@ -331,10 +341,10 @@
189 cookies.
190 </note>
191
192 -<pre caption="Running change_slot to update the slot from 4 to 4.1">
193 -# <i>change_slot kde 4 4.1</i>
194 -# <comment>(After you confirm that it works as expected (you should see SLOTS as 4.1 and not 4))</comment>
195 -# <i>change_slot kde 4 4.1 Y</i>
196 +<pre caption="Running change_slot to update the slot from 4 to 4.2">
197 +# <i>change_slot kde 4 4.2</i>
198 +# <comment>(After you confirm that it works as expected (you should see SLOTS as 4.2 and not 4))</comment>
199 +# <i>change_slot kde 4 4.2 Y</i>
200 </pre>
201
202 </body>
203 @@ -471,7 +481,7 @@
204 </section>
205 </chapter>
206 <chapter>
207 -<title>Uninstalling KDE 4.x</title>
208 +<title>Uninstalling KDE 4.X</title>
209 <section>
210 <title>Removing all KDE packages</title>
211 <body>