[gentoo-commits] proj/kde:master commit in: Documentation/maintainers/

[Andreas Hüttel]

commit:     393cd4f7f9310a30a90d536c6b66351dff1ac46d
Author:     Andreas K. Huettel (dilfridge) <mail <AT> akhuettel <DOT> de>
AuthorDate: Sat Jun  2 22:11:04 2012 +0000
Commit:     Andreas Hüttel <dilfridge <AT> gentoo <DOT> org>
CommitDate: Sat Jun  2 22:11:04 2012 +0000
URL:        http://git.overlays.gentoo.org/gitweb/?p=proj/kde.git;a=commit;h=393cd4f7

[doc] Line breaks

---
 Documentation/maintainers/forum-post.txt |  119 ++++++++++++++++++++++-------
 1 files changed, 90 insertions(+), 29 deletions(-)

diff --git a/Documentation/maintainers/forum-post.txt b/Documentation/maintainers/forum-post.txt
index 9fd3889..66f5297 100644
--- a/Documentation/maintainers/forum-post.txt
+++ b/Documentation/maintainers/forum-post.txt
@@ -3,15 +3,22 @@ This is the official guide for KDE 4 related threads.
 KDE 4 for Gentoo is delivered in several ways:
 [list]
 [*][b][url=http://en.gentoo-wiki.com/wiki/Portage]Portage repository[/url][/b]
-The only officially supported and recommended way to get [url=http://www.kde.org/announcements/announce-4.4.4.php]KDE4 (4.4.4 recently)[/url].
-If you haven't used any [url=http://en.gentoo-wiki.com/wiki/Portage_Overlay]overlay[/url] nor compiled KDE 4 from source manually - this is probably what you're looking for.
-KDE 4 portage guide can be found [url=http://www.gentoo.org/proj/en/desktop/kde/kde4-guide.xml]here[/url] - read it please to avoid problems in a future, it's is advised that you checked FAQ below as well.
-You've found a bug? Visit this [url=http://tinyurl.com/3bpdlv]page[/url] - it may have been reported already.
+The only officially supported and recommended way to get
+[url=http://www.kde.org/announcements/announce-4.4.4.php]KDE4 (4.4.4 recently)[/url].
+If you haven't used any [url=http://en.gentoo-wiki.com/wiki/Portage_Overlay]overlay[/url]
+nor compiled KDE 4 from source manually - this is probably what you're looking for.
+KDE 4 portage guide can be found
+[url=http://www.gentoo.org/proj/en/desktop/kde/kde4-guide.xml]here[/url] - read it please
+to avoid problems in a future, it's is advised that you checked FAQ below as well.
+You've found a bug? Visit this [url=http://tinyurl.com/3bpdlv]page[/url] - it may have
+been reported already.
 Support thread for KDE 4 in Portage can be found here: 
 [topic=707986]http://forums.gentoo.org/viewtopic-t-707986.html[/topic]
 
-[*][b]Official Gentoo KDE team testing overlay [[url=http://git.overlays.gentoo.org/gitweb/?p=proj/kde.git]kde[/url]][/b]
-This is overlay used by [url=http://www.gentoo.org/proj/en/desktop/kde/]Gentoo KDE team[/url], it's official but unsupported.
+[*][b]Official Gentoo KDE team testing overlay
+[[url=http://git.overlays.gentoo.org/gitweb/?p=proj/kde.git]kde[/url]][/b]
+This is overlay used by [url=http://www.gentoo.org/proj/en/desktop/kde/]Gentoo KDE
+team[/url], it's official but unsupported.
 It contains:[list]
 [*]KDE releases that will later appear in the Portage repository (-4.4.x)
 [*]live KDE ebuilds tracking main development tree (-9999)
@@ -19,69 +26,123 @@ It contains:[list]
 [*]live KDE ebuilds tracking 4.4.x development branch (-4.4.9999)
 [*]live KDE ebuilds tracking 4.5.x development branch (-4.5.9999)
 [*]3rd party KDE packages that are not in Portage repository for various reasons[/list]
-If you have some suggestions or you would like to contribute, contact Gentoo KDE team on [url=irc://irc.freenode.net/gentoo-kde]#gentoo-kde.[/url]
-Please DON'T report any [url=https://bugs.gentoo.org/]bugs[/url] regarding live packages in this overlay. For bugs related KDE release candidates you should add [kde-testing] to description, but it's [b]always[/b] better to ask on forum or IRC channel first.
+If you have some suggestions or you would like to contribute, contact Gentoo KDE team on
+[url=irc://irc.freenode.net/gentoo-kde]#gentoo-kde.[/url]
+Please DON'T report any [url=https://bugs.gentoo.org/]bugs[/url] regarding live packages
+in this overlay. For bugs related KDE release candidates you should add [kde-testing] to
+description, but it's [b]always[/b] better to ask on forum or IRC channel first.
 Support thread for official KDE4 testing overlay is here: 
 [url]http://forums.gentoo.org/viewtopic-t-722264.html[/url]
 
 Qt4 live ebuilds can be found in Qt-exclusive experimental overlay now.
-To make use of them, choose the [url=http://gitorious.org/gentoo-qt/qting-edge]qting-edge[/url] overlay in [i]layman[/i].
+To make use of them, choose the
+[url=http://gitorious.org/gentoo-qt/qting-edge]qting-edge[/url] overlay in [i]layman[/i].
 
-[*][b]Official Gentoo user-maintained Qt3/KDE3 overlay [[url=http://git.overlays.gentoo.org/gitweb/?p=proj/kde-sunset.git]kde-sunset[/url]][/b]
-This overlay contains Qt3 and KDE3 packages removed from main repository. It is maintaned by community. If you're interested in contributing, please let us know.
+[*][b]Official Gentoo user-maintained Qt3/KDE3 overlay
+[[url=http://git.overlays.gentoo.org/gitweb/?p=proj/kde-sunset.git]kde-sunset[/url]][/b]
+This overlay contains Qt3 and KDE3 packages removed from main repository. It is maintaned
+by community. If you're interested in contributing, please let us know.
 Gentoo KDE team can be found on [url=irc://irc.freenode.net/gentoo-kde]#gentoo-kde[/url].
 [/list]
 
 [size=18]KDE in Portage - FAQ[/size]
 
-[color=orange]Q:[/color] What's the deal with [b]kdeprefix[/b] USE flag and why is it masked?
+[color=orange]Q:[/color] What's the deal with [b]kdeprefix[/b] USE flag and why is it
+masked?
 
-[b]A:[/b] [b]kdeprefix[/b] USE flag allows installing KDE4 in alternate location, thus making it possible to have multiple KDE4 releases side by side. Note that this is not needed to have KDE3 installed as well. Because having multiple KDE4 installations has known issues like bugs [bug=258027]258027[/bug] or [bug=267793]267793[/bug], it's not ready for public consumption hence it's been disabled by default.
+[b]A:[/b] [b]kdeprefix[/b] USE flag allows installing KDE4 in alternate location, thus
+making it possible to have multiple KDE4 releases side by side. Note that this is not
+needed to have KDE3 installed as well. Because having multiple KDE4 installations has
+known issues like bugs [bug=258027]258027[/bug] or [bug=267793]267793[/bug], it's not
+ready for public consumption hence it's been disabled by default.
 
 
-[color=orange]Q:[/color] I want to run amarok, but all I get is "symbol lookup error: /usr/kde/live/lib64/kde4/plugins/styles/oxygen.so: undefined symbol". What should I do?
+[color=orange]Q:[/color] I want to run amarok, but all I get is "symbol lookup error:
+/usr/kde/live/lib64/kde4/plugins/styles/oxygen.so: undefined symbol". What should I do?
 
-[b]A:[/b] It's a Qt bug that appears when using [b]kdeprefix[/b] USE flag. Qt plugin loader appends "qtplugins" path from currently running KDE4 session, causing oxygen.so from wrong KDE prefix to be dlopen'ed. Unfortunately it as well cashes plugin locations in [color=blue]~/.config/Trolltech.conf[/color], making it permanently broken unless the file is removed. It usually happens with amarok or any other KDE4 applications installed in no prefix ([color=blue]/usr[/color]), that are built against existing KDE4 in one prefix (for example [color=blue]/usr/kde/4.2[/color]), but run from the other (for example in Gnome, KDE3 or [color=blue]/usr/kde/live[/color]). For now there's no known solution.
+[b]A:[/b] It's a Qt bug that appears when using [b]kdeprefix[/b] USE flag. Qt plugin
+loader appends "qtplugins" path from currently running KDE4 session, causing oxygen.so
+from wrong KDE prefix to be dlopen'ed. Unfortunately it as well cashes plugin locations in
+[color=blue]~/.config/Trolltech.conf[/color], making it permanently broken unless the file
+is removed. It usually happens with amarok or any other KDE4 applications installed in no
+prefix ([color=blue]/usr[/color]), that are built against existing KDE4 in one prefix (for
+example [color=blue]/usr/kde/4.2[/color]), but run from the other (for example in Gnome,
+KDE3 or [color=blue]/usr/kde/live[/color]). For now there's no known solution.
 
 
 [color=orange]Q:[/color] Why there are no sets for KDE4?
 
-[b]A:[/b] KDE4 so far is NOT making use of sets but sets are expected to arrive in near future - the reason is - the naming convention for sets is not yet established. Although KDE4 Gentoo team prepared some sets for you [url=http://git.overlays.gentoo.org/gitweb/?p=proj/kde.git;a=tree;f=sets;h=829bc933b1e43e13133dcd6f9c2c2c5566569315;hb=master]here[/url] (click 'raw' to download file and place in [color=blue]/etc/portage/sets/[/color]). An archive with all sets can be downloaded from [url=http://git.overlays.gentoo.org/gitweb/?p=proj/kde.git;a=snapshot;h=829bc933b1e43e13133dcd6f9c2c2c5566569315;sf=tgz]here[/url]. Remember that you are using them at your own risk.
+[b]A:[/b] KDE4 so far is NOT making use of sets but sets are expected to arrive in near
+future - the reason is - the naming convention for sets is not yet established. Although
+KDE4 Gentoo team prepared some sets for you
+[url=http://git.overlays.gentoo.org/gitweb/?p=proj/kde.git;a=tree;f=sets;h=
+829bc933b1e43e13133dcd6f9c2c2c5566569315;hb=master]here[/url] (click 'raw' to download
+file and place in [color=blue]/etc/portage/sets/[/color]). An archive with all sets can be
+downloaded from
+[url=http://git.overlays.gentoo.org/gitweb/?p=proj/kde.git;a=snapshot;h=
+829bc933b1e43e13133dcd6f9c2c2c5566569315;sf=tgz]here[/url]. Remember that you are using
+them at your own risk.
 
 
-[color=orange]Q:[/color] When I start KDE 3, Plasma is being executed and my KDE 3 applications are either crashing or just not working. Konqueror refuses to start, complaining about default stylesheet version mismatch. What's going on?
+[color=orange]Q:[/color] When I start KDE 3, Plasma is being executed and my KDE 3
+applications are either crashing or just not working. Konqueror refuses to start,
+complaining about default stylesheet version mismatch. What's going on?
 
-[b]A:[/b] This is the conflict related to mixed KDE3/KDE4 sessions. To fix this issue you need to [url=http://www.gentoo.org/proj/en/desktop/kde/kde-split-ebuilds.xml]upgrade[/url] your existing KDE 3.5.x installations to 3.5.10 or newer. Note that the 3.5.10 series has not been given stable keywords yet and that the monolithic packages have been discontinued.
+[b]A:[/b] This is the conflict related to mixed KDE3/KDE4 sessions. To fix this issue you
+need to [url=http://www.gentoo.org/proj/en/desktop/kde/kde-split-ebuilds.xml]upgrade[/url]
+your existing KDE 3.5.x installations to 3.5.10 or newer. Note that the 3.5.10 series has
+not been given stable keywords yet and that the monolithic packages have been
+discontinued.
 
 
-[color=orange]Q:[/color] I installed KDE4, I can start my desktop using startx but KDM is not working. Please help.
+[color=orange]Q:[/color] I installed KDE4, I can start my desktop using startx but KDM is
+not working. Please help.
 
-[b]A:[/b] First, ensure that [color=blue]kdm[/color] executable is in your [i]PATH[/i]. To check that, run:
+[b]A:[/b] First, ensure that [color=blue]kdm[/color] executable is in your [i]PATH[/i]. To
+check that, run:
 [code]which kdm[/code]
 If it's not found, then probably your environment is not up to date. To update it, run:
 [code]env-update && source /etc/profile[/code]
-When [color=blue]kdm[/color] is found, set [i]DISPLAYMANAGER="kdm"[/i] variable in [color=blue]/etc/conf.d/xdm[/color]. From now on, KDM should be working.
+When [color=blue]kdm[/color] is found, set [i]DISPLAYMANAGER="kdm"[/i] variable in
+[color=blue]/etc/conf.d/xdm[/color]. From now on, KDM should be working.
 
 
-[color=orange]Q:[/color] I just found this neat KDE4 application, can you make an ebuild for it?
+[color=orange]Q:[/color] I just found this neat KDE4 application, can you make an ebuild
+for it?
 
-[b]A:[/b] In short, no. To be more precise, it is possible but it would be better if you [url=http://devmanual.gentoo.org/ebuild-writing]created ebuild[/url] for it and send it Gentoo KDE team for review - it's more likely it will be added to overlay. The best procedure would be to create [url=https://bugs.gentoo.org]bug[/url] with ebuild proposal (if it's not there already) and inform the developers on [url=irc://irc.freenode.net/gentoo-kde]#gentoo-kde[/url] about it:
-[quote]Hi, i found this nice app blablu v 14.2 i opened bug 234556 for it. Please could you consider adding it to kde-testing?[/quote]
+[b]A:[/b] In short, no. To be more precise, it is possible but it would be better if you
+[url=http://devmanual.gentoo.org/ebuild-writing]created ebuild[/url] for it and send it
+Gentoo KDE team for review - it's more likely it will be added to overlay. The best
+procedure would be to create [url=https://bugs.gentoo.org]bug[/url] with ebuild proposal
+(if it's not there already) and inform the developers on
+[url=irc://irc.freenode.net/gentoo-kde]#gentoo-kde[/url] about it:
+[quote]Hi, i found this nice app blablu v 14.2 i opened bug 234556 for it. Please could
+you consider adding it to kde-testing?[/quote]
 
-If you have any suggestions for improvements regarding this guide, feel free to post them [topic=708322]here[/topic]. Please refrain from general discussion and do not post ebuild/installation questions there.
+If you have any suggestions for improvements regarding this guide, feel free to post them
+[topic=708322]here[/topic]. Please refrain from general discussion and do not post
+ebuild/installation questions there.
 
 [i]Stuck by NeddySeagoon[/i]
 
-[i]Locked and split off the other posts as a feedback [topic=708322]topic[/topic]. -- desultory[/i]
+[i]Locked and split off the other posts as a feedback [topic=708322]topic[/topic]. --
+desultory[/i]
 [i]Made some minor grammatical corrections at the request of reavertm. -- desultory[/i]
 [i]Continued updates. -- desultory[/i]
 [i]Updated link -- Jorge (jmbsvicetto)[/i]
 [i]Update kde-guide link -- Jorge (jmbsvicetto)[/i]
 [i]Removed arrival progress estimation link. -- desultory[/i]
-[i]Applied changes asked [url=https://forums.gentoo.org/viewtopic-p-5237336.html#5237336]here[/url] -- Jorge (jmbsvicetto)[/i]
+[i]Applied changes asked
+[url=https://forums.gentoo.org/viewtopic-p-5237336.html#5237336]here[/url] -- Jorge
+(jmbsvicetto)[/i]
 [i]Applied more [post=5245444]updates[/post]. -- desultory[/i]
 [i]Applied even more [post=5255329]updates[/post] -- Jorge (jmbsvicetto).[/i]
-[i]Applied [post=5262576]updates[/post], [post=5276245]updates[/post] and more updates. Updated links. [post=5368691]A[/post][post=5401451]p[/post][post=5423969]p[/post][post=5552930]l[/post][post=5669087]i[/post][post=5734682]e[/post][post=5786336]d[/post] [post=5811962]updates[/post]. -- desultory[/i]
+[i]Applied [post=5262576]updates[/post], [post=5276245]updates[/post] and more updates.
+Updated links.
+[post=5368691]A[/post][post=5401451]p[/post][post=5423969]p[/post][post=5552930]l[/post][
+post=5669087]i[/post][post=5734682]e[/post][post=5786336]d[/post]
+[post=5811962]updates[/post]. -- desultory[/i]
 [i]Applied [post=5847443]update[/post].  --kallamej[/i]
 [i]Applied [post=5956057]updates[/post]. -- desultory[/i]
-[i]Updates, removed info about genkdesvn (offline) and replaced kde-crazy with kde-sunset. -- reavertm[/i]
+[i]Updates, removed info about genkdesvn (offline) and replaced kde-crazy with kde-sunset.
+-- reavertm[/i]