From: "Theo Chatzimichos (tampakrap)" <tampakrap@gentoo.org>
To: gentoo-commits@lists.gentoo.org
Subject: [gentoo-commits] gentoo commit in xml/htdocs/proj/en/desktop/kde: index.xml kde4-guide.xml
Date: Sun, 10 Jan 2010 23:39:48 +0000 [thread overview]
Message-ID: <E1NU7Ns-0000O7-99@stork.gentoo.org> (raw)
tampakrap 10/01/10 23:39:48
Modified: index.xml kde4-guide.xml
Log:
some fixes to kde4 guide, and to main page mostly about kde-sunset
Revision Changes Path
1.100 xml/htdocs/proj/en/desktop/kde/index.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/desktop/kde/index.xml?rev=1.100&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/desktop/kde/index.xml?rev=1.100&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/desktop/kde/index.xml?r1=1.99&r2=1.100
Index: index.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/desktop/kde/index.xml,v
retrieving revision 1.99
retrieving revision 1.100
diff -u -r1.99 -r1.100
--- index.xml 8 Jan 2010 02:30:54 -0000 1.99
+++ index.xml 10 Jan 2010 23:39:47 -0000 1.100
@@ -52,7 +52,7 @@
<longdescription>
-<note>For support and installation instructions please refer to <uri
+<note>For support and installation instructions please refer to <uri
link="#doc_chap4">Support and assistance Section</uri></note>
<p>
@@ -120,7 +120,7 @@
</body>
</section>
<section>
-<title>KDE-3.5</title>
+<title>KDE 3.5</title>
<body>
<p>
@@ -130,7 +130,11 @@
been moved there. Keep in mind that this overlay is user-maintained only, and current
KDE team members have no responsibility about its status. If you are interested
in co-maintaining it, you can send an email to <mail link="scarabeus" /> asking for
-commit access.
+commit access. If you want to report a bug about this overlay, please don't file a
+bug in bugzilla. Instead, use the <uri
+link="http://archives.gentoo.org/gentoo-desktop/">gentoo-desktop</uri> mailing list.
+Instructions on how to subscribe can be found <uri
+link="http://www.gentoo.org/main/en/lists.xml">here</uri>.
</p>
<p>
@@ -254,30 +258,36 @@
<body>
<p>
-There are several ways to get support with KDE related issues. You can:
+There are several ways to get support with KDE related issues:
</p>
<ul>
<li>
- Join <uri link="irc://irc.freenode.net/gentoo-kde">#gentoo-kde</uri> on the
- Freenode IRC network. You'll find some of the team members there most of
- the time.
+ To install KDE on Gentoo, use the <uri link="kde4-guide.xml">Gentoo KDE
+ Guide</uri>. This guide covers the installation of KDE 3.5, KDE 4, and the
+ various KDE 3/4 applications, plus some FAQ, hints, and troubleshooting
+ sections.
</li>
<li>
- Address your concerns in the Gentoo Forums. Not all of us are avid forums
- users but many experienced users and some developers are likely to be able
- to help you.
+ You can join <uri link="irc://irc.freenode.net/gentoo-kde">#gentoo-kde</uri>
+ on the Freenode IRC network. You'll find some of the team members there most
+ of the time.
</li>
<li>
- Of course, you can also file a bug report at Gentoo's Bugzilla (do not
- forget to add your <c>emerge --info</c> and the output of <c>emerge -pv
- <package></c>).
+ You can address your concerns in the Gentoo Forums. Not all of us are avid
+ forums users but many experienced users and some developers are likely to be
+ able to help you.
</li>
<li>
- To install KDE on Gentoo, use the <uri link="kde4-guide.xml">Gentoo KDE
- Guide</uri>. This guide covers the installation of KDE 3.5, KDE 4, and the
- various KDE 3/4 applications, and also provides some FAQ, hints, and
- troubleshooting sections.
+ The KDE team uses the <uri link="http://archives.gentoo.org/gentoo-desktop/">gentoo-desktop</uri>
+ mailing list very often, to discuss about problems, announce various things
+ (like meetings or important changes) or even get in touch with users and solve
+ problems. Instructions on how to subscribe can be found <uri
+ link="http://www.gentoo.org/main/en/lists.xml">here</uri>.
+ </li>
+ <li>
+ Of course, you can also file a bug report. Please read the chapter
+ <uri link="#doc_chap6">How to report bugs</uri> before.
</li>
</ul>
@@ -343,4 +353,44 @@
</section>
</extrachapter>
+<extrachapter position="goals">
+<title>How to report bugs</title>
+<section>
+<body>
+
+<p>
+When you encounter a bug, this should always be reported. The best thing you
+could do is to check if it is already reported, and if not, report to the right
+people. When in doubt about the bug being a gentoo's fault or an upstream bug,
+this is the pattern that is usually used:
+</p>
+
+<ul>
+ <li>
+ If the bug is a runtime issue (crash or wrong package behaviour), it should
+ be reported upstream. You can report a bug to us as well if you want, so we can
+ track it and backport the patch. If you don't have kdebase-runtime-meta installed,
+ then please install it first, and if you are able to reproduce, then go ahead
+ and file the upstream bug. If you are not able to reproduce, then please report
+ the bug only to Gentoo, with all that information.
+ </li>
+ <li>
+ If the bug is a build failure, a depedency error or a general ebuild bug, it
+ should reported to us.
+ </li>
+ <li>
+ If you are still in doubt, we'd prefer a bug to us, so we can guide you then.
+ </li>
+</ul>
+
+<note>
+Before reporting the bug, make sure you have searched for similar bugs and
+that you haven't found your solution to the <uri
+link="kde4-guide.xml#doc_chap4">Hints and Troubleshooting</uri> section of the guide
+</note>
+
+</body>
+</section>
+</extrachapter>
+
</project>
1.44 xml/htdocs/proj/en/desktop/kde/kde4-guide.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml?rev=1.44&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml?rev=1.44&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml?r1=1.43&r2=1.44
Index: kde4-guide.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml,v
retrieving revision 1.43
retrieving revision 1.44
diff -u -r1.43 -r1.44
--- kde4-guide.xml 2 Dec 2009 11:44:31 -0000 1.43
+++ kde4-guide.xml 10 Jan 2010 23:39:47 -0000 1.44
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml,v 1.43 2009/12/02 11:44:31 wired Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/desktop/kde/kde4-guide.xml,v 1.44 2010/01/10 23:39:47 tampakrap Exp $ -->
<guide link="/proj/en/desktop/kde/kde4-guide.xml" lang="en">
<title>Gentoo KDE Guide</title>
@@ -26,7 +26,7 @@
<abstract>
This guide demonstrates how to setup KDE using the ebuilds in the tree. Some
-tools from the KDE team's git overlay (kde) will be used.
+tools from the KDE team's git overlay (kde) may be used.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
@@ -39,57 +39,29 @@
<chapter>
<title>KDE 3</title>
<section>
-<title>Introduction</title>
+<title>Quick Information</title>
<body>
<p>
KDE 3 is no longer maintained by upstream, with 3.5.10 being their last release.
Also, most KDE 3 applications aren't maintained any more, as they already have
-been or are currently being ported to KDE 4. The Gentoo KDE Team, provides both
-KDE 3 and KDE 4 ebuilds for the base KDE and for various applications, and
-supports a side by side full desktop installation of KDE 3 and 4, including misc
-KDE applications. Our advice is for you to install and use by default a full
-KDE 4 desktop, and use only the KDE 3 applications that you feel have yet to be
-propperly ported to KDE 4 (due to missing features, random crashes etc).
+been or are currently being ported to KDE 4.
</p>
-<warn>
-Keep in mind that since KDE 3 isn't maintained by upstream any more, it is
-possible and likely that bug reports concerning KDE 3 applications may not be
-fixed, but rather closed as WONTFIX / CANTFIX / UPSTREAM, or instead kept open
-for a long time until a fix (patch) is provided.
-</warn>
-
-</body>
-</section>
-<section>
-<title>KDE 3 Removal</title>
-<body>
-
<p>
-Currently KDE 3.5.10 is masked for all architectures, as it is being removed
-from Portage.
+In Gentoo, KDE 3 ebuilds have been removed from the portage tree, and they have
+been moved to the user-maintained overlay called <uri
+link="http://git.overlays.gentoo.org/gitweb/?p=proj/kde-sunset.git;a=summary">kde-sunset</uri>
+(available in layman). Keep in mind that this overlay is user-maintained only, and current KDE
+team members have no responsibility about its status. If you are interested in co-maintaining
+it, you can send an email to <mail link="scarabeus" /> asking for
+commit access. If you want to report a bug about this overlay, please don't file a bug in
+bugzilla. Instead, use the <uri
+link="http://archives.gentoo.org/gentoo-desktop/">gentoo-desktop</uri> mailing list.
+Instructions on how to subscribe can be found <uri
+link="http://www.gentoo.org/main/en/lists.xml">here</uri>.
</p>
-<p>
-The KDE team has been cleaning up the various KDE 3 applications by removing
-them from the tree, as they are too old, broken and unmaintained, and by
-dropping arts support (with major help from Media/Video teams). When this task
-is finished, we are going to drop arts from base KDE 3 as well.
-</p>
-
-<p>
-While using KDE 3 is not recommended due to security and bug concerns, if you
-<e>must</e> install it, you can find it in the <uri
-link="http://git.overlays.gentoo.org/gitweb/?p=proj/kde-sunset.git;a=summary">kde-sunset
-overlay</uri>.
-</p>
-
-<note>
-This overlay is completely unsupported by Gentoo. It's not maintained by the KDE
-team, so do <b>not</b> report any issues to Gentoo developers, bugzilla, etc.
-</note>
-
</body>
</section>
</chapter>
@@ -101,9 +73,11 @@
<body>
<p>
-KDE 4 is the current KDE version supported by upstream. The current KDE 4
-version available through Portage is 4.3.1 (this version is considered stable by
-upstream). In addition, KDE upstream provides weekly <uri
+KDE 4 is the current KDE version supported by upstream. In portage there is
+a stable version, and there might be one (or more) non-stable version.Under normal
+conditions it gets in stabilized after a month. The current KDE 4 versions available
+through Portage are 4.3.3 and 4.3.4 (also considered stable by upstream). In addition,
+KDE upstream provides weekly <uri
link="ftp://ftp.kde.org/pub/kde/unstable"> snapshots</uri>, and a <uri
link="http://websvn.kde.org">live SVN tree</uri>. The Gentoo KDE team provides
the snapshots, trunk and latest branch live ebuilds, through the
@@ -116,10 +90,10 @@
</p>
<table>
<tr>
- <ti><uri link="#kde_portage">KDE from Portage (currently 4.3.1)</uri></ti>
+ <ti><uri link="#kde_portage">KDE from Portage (currently 4.3.X)</uri></ti>
</tr>
<tr>
- <ti><uri link="#snapshots">KDE snapshots (currently 4.3.X)</uri></ti>
+ <ti><uri link="#snapshots">KDE snapshots (currently 4.3.XX)</uri></ti>
</tr>
<tr>
<ti><uri link="#live">KDE live ebuilds</uri></ti>
@@ -198,10 +172,9 @@
</body>
</section>
<section id="kde_portage">
-<title>Installing KDE 4.3.1 (from Portage)</title>
+<title>Installing KDE 4.3.X (from Portage)</title>
<body>
-
<note>
In order to minimize issues it is recommended to start with a clean environment.
Read more in <uri link="#cleanup">Cleaning Up KDE</uri> section.
@@ -222,10 +195,18 @@
section.
</p>
+<note>
+If you are running the stable branch and want to use the latest non-stable version
+in tree, you can use <uri
+link="http://git.overlays.gentoo.org/gitweb/?p=proj/kde.git;a=blob_plain;f=Documentation/package.keywords/kde-4.3.keywords;h=da0ba2026e09617535da6b50f4ff817de3814412;hb=HEAD">
+this</uri> keyword file and put it in your /etc/portage/package.keywords/
+folder.
+</note>
+
</body>
</section>
<section id="snapshots">
-<title>Installing KDE 4.3.X snapshots (from kde overlay)</title>
+<title>Installing KDE 4.3.XX snapshots (from kde overlay)</title>
<body>
<warn>
@@ -235,7 +216,7 @@
<p>
KDE upstream provides <uri link="ftp://ftp.kde.org/pub/kde/unstable">weekly
snapshots</uri> taken from the <uri link="http://websvn.kde.org/trunk/">SVN
-trunk tree</uri>. KDE now provides 4.3.X snapshot series, and after the 4.4
+trunk tree</uri>. KDE now provides 4.3.XX snapshot series, and after the 4.4
release they are going to start with 4.4.60. Beta and Release Candidate KDE
releases are following the snapshot model below:
</p>
@@ -246,16 +227,20 @@
<th>KDE Version</th>
</tr>
<tr>
- <ti>4.X.85</ti>
+ <ti>4.X.80</ti>
<ti>KDE 4.X Beta 1</ti>
</tr>
<tr>
- <ti>4.X.90</ti>
+ <ti>4.X.85</ti>
<ti>KDE 4.X Beta 2</ti>
</tr>
<tr>
+ <ti>4.X.90</ti>
+ <ti>KDE 4.X Release Candidate 1</ti>
+</tr>
+<tr>
<ti>4.X.95</ti>
- <ti>KDE 4.X Release Candidate</ti>
+ <ti>KDE 4.X Release Candidate 2</ti>
</tr>
</table>
@@ -297,12 +282,21 @@
have to symlink to our package.keywords directory:
</p>
-<pre caption="Creating symlink of the kde-4.3.keywords file">
+<pre caption="Creating symlink of the kde-4.4.keywords file">
# <i>cd /etc/portage/package.keywords</i>
# <i>ln -s /path/to/overlay/kde/Documentation/package.keywords/kde-4.4.keywords .</i>
</pre>
<p>
+All users also need to unmask the packages, which will be done the same way:
+</p>
+
+<pre caption="Creating symlink of the kde-4.4 unmask file">
+# <i>cd /etc/portage/package.unmask</i>
+# <i>ln -s /path/to/overlay/kde/Documentation/package.unmask/kde-4.4 .</i>
+</pre>
+
+<p>
The installation can be done either by using the meta packages or by using sets.
</p>
@@ -312,8 +306,8 @@
</pre>
<pre caption="Installation of KDE snapshots using sets">
-# <i>emerge -av @kde-4.3</i> <comment>(contains all of KDE modules)</comment>
-# <i>emerge -av @kdebase-4.3 @kdegames-4.3</i> <comment>(installation of chosen modules only)</comment>
+# <i>emerge -av @kde-4.4</i> <comment>(contains all of KDE modules)</comment>
+# <i>emerge -av @kdebase-4.4 @kdegames-4.4</i> <comment>(installation of chosen modules only)</comment>
<comment>See the <uri link="#sets">Using Sets</uri> section for more information.</comment>
</pre>
@@ -328,12 +322,12 @@
</warn>
<p>
-KDE is Open Source, with its code being available for browsing through<uri
+KDE is Open Source, with its code being available for browsing through <uri
link="http://websvn.kde.org">KDE Websvn</uri>, and for public checkout
through an anonymous (anonsvn) account. Gentoo, as a source based distro,
has the ability to provide live ebuilds that checkout the code either from
-the latest branch or from trunk. Currently, we provide 4.3.9999 ebuilds from
-4.3 branch.
+the latest branch or from trunk. Currently, we provide 4.4.9999 ebuilds from
+4.4 branch.
</p>
<table>
@@ -342,12 +336,12 @@
<th>KDE Version</th>
</tr>
<tr>
- <ti>4.3.9999</ti>
- <ti>KDE 4.3.Branch</ti>
+ <ti>4.4.9999</ti>
+ <ti>KDE 4.4.Branch</ti>
</tr>
<tr>
<ti>9999</ti>
- <ti>KDE 4 Trunk (currently 4.4)</ti>
+ <ti>KDE 4 Trunk</ti>
</tr>
</table>
@@ -380,8 +374,8 @@
<pre caption="Creating symlink of the kde-4.X.9999.keywords or kde-live file">
# <i>cd /etc/portage/package.keywords</i>
-# <i>ln -s /path/to/overlay/kde/Documentation/package.keywords/kde-4.3.9999.keywords .</i><comment>(for 4.3 Branch)</comment>
-# <i>ln -s /path/to/overlay/kde/Documentation/package.keywords/kde-live.keywords .</i><comment>(for KDE 4.4 Trunk)</comment>
+# <i>ln -s /path/to/overlay/kde/Documentation/package.keywords/kde-4.4.9999.keywords .</i><comment>(for 4.4 Branch)</comment>
+# <i>ln -s /path/to/overlay/kde/Documentation/package.keywords/kde-live.keywords .</i><comment>(for KDE Trunk)</comment>
</pre>
<p>
@@ -390,19 +384,19 @@
</p>
<pre caption="Installation of KDE live ebuilds using meta packages">
-<comment>(For KDE 4.3 Branch)</comment>
-# <i>emerge -av kde-meta:4.3</i> <comment>(contains all of KDE modules)</comment>
-# <i>emerge -av kdebase-meta:4.3 kdegames-meta:4.3</i> <comment>(installation of chosen modules only)</comment>
-<comment>(For KDE 4.4 Trunk)</comment>
+<comment>(For KDE 4.4 Branch)</comment>
+# <i>emerge -av kde-meta:4.4</i> <comment>(contains all of KDE modules)</comment>
+# <i>emerge -av kdebase-meta:4.4 kdegames-meta:4.4</i> <comment>(installation of chosen modules only)</comment>
+<comment>(For KDE Trunk)</comment>
# <i>emerge -av kde-meta:live</i> <comment>(contains all of KDE modules)</comment>
# <i>emerge -av kdebase-meta:live kdegames-meta:live</i> <comment>(installation of chosen modules only)</comment>
</pre>
<pre caption="Installation of KDE live ebuilds using sets">
-<comment>(For KDE 4.3 Branch)</comment>
-# <i>emerge -av @kde-4.3</i> <comment>(contains all of KDE modules)</comment>
-# <i>emerge -av @kdebase-4.3 @kdegames-4.3</i> <comment>(installation of chosen modules only)</comment>
-<comment>(For KDE 4.4 Trunk)</comment>
+<comment>(For KDE 4.4 Branch)</comment>
+# <i>emerge -av @kde-4.4</i> <comment>(contains all of KDE modules)</comment>
+# <i>emerge -av @kdebase-4.4 @kdegames-4.4</i> <comment>(installation of chosen modules only)</comment>
+<comment>(For KDE Trunk)</comment>
# <i>emerge -av @kde-live</i> <comment>(contains all of KDE modules)</comment>
# <i>emerge -av @kdebase-live @kdegames-live</i> <comment>(installation of chosen modules only)</comment>
<comment>See the <uri link="#sets">Using Sets</uri> section for more information.</comment>
@@ -422,9 +416,9 @@
</p>
<note>
-There is also a set with live KDE 4 applications, @kde-extras-live, in
-kde and a set with Qt live applications, @qt-extras-live, in qting-edge
-overlay.
+There is also a set with live KDE 4 applications, @kde-extras-live and a
+set with live KOffice @koffice-live, in kde overlay, and a set with Qt
+live applications, @qt-extras-live, in qting-edge overlay.
</note>
</body>
next reply other threads:[~2010-01-10 23:39 UTC|newest]
Thread overview: 7+ messages / expand[flat|nested] mbox.gz Atom feed top
2010-01-10 23:39 Theo Chatzimichos (tampakrap) [this message]
-- strict thread matches above, loose matches on Subject: below --
2010-09-08 17:12 [gentoo-commits] gentoo commit in xml/htdocs/proj/en/desktop/kde: index.xml kde4-guide.xml Theo Chatzimichos (tampakrap)
2010-03-31 14:24 Theo Chatzimichos (tampakrap)
2009-12-02 11:44 Alex Alexander (wired)
2009-11-16 19:33 Joshua Saddler (nightmorph)
2009-01-30 3:51 Jorge Manuel B. S. Vicetto (jmbsvicetto)
2008-09-29 1:00 Jorge Manuel B. S. Vicetto (jmbsvicetto)
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=E1NU7Ns-0000O7-99@stork.gentoo.org \
--to=tampakrap@gentoo.org \
--cc=gentoo-commits@lists.gentoo.org \
--cc=gentoo-dev@lists.gentoo.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox