Grammar nitpicks: For the last two overlays it should probably say: "This overlay is being developed and maintained by the community." Also, for the Paludis overlay you might want to make it say "not compatible with Gentoo's Portage package" Last but not least you could start with: "This is the official guide."

Feel free to disregard these suggestions, and I'm sorry to post after you asked people not to; and thank you for you effort to clarify the situation in regards to KDE 4._________________"We have/need art, so that we don't die of the truth." -- Friedrich Nietzsche

- section of "Official KDE team overlay [kde-testing]" could be enhanced with something like:

Quote:

If you want to use this overlay visit this guide.
You can get support for this overlay in #gentoo-kde and help Gentoo KDE team testing it before it is moved into the official Portage tree.

The following should be removed:

Quote:

Support thread for official KDE team overlay is here:
[url]TODO[/url]

So far there is no feedback to my mail from moderators, Maybe they just can't get the things done and they're not discussing giving me rights to editing the guide either.
Thanks go to desultory for your effort._________________Maciek

And a bit of news - Gentoo KDE herd and kdesvn-portage guys are making some steps to unify eclasses between kde-testing and kdesvn-portage overlay which may (or may not) result in merging those overlays._________________Maciek

Last edited by reavertm on Mon Sep 29, 2008 1:30 am; edited 1 time in total

Estimating progress for KDE 4.1 inclusion in Portage can be found here.

Reason:
this comparison no longer makes sense as kde 4.1.2 ebuilds are already in portage (masked by package.mask until KDE 4.1.2 is officialy released) - so now we'll have Gentoo KDE4 nearly since the day 0._________________Maciek

* add the following to kde-testing section, just below "You can get support ...":

Quote:

Please visit this thread before asking developers - you may find your answer here as well.

reason:
thread kdesvn-portage has been renamed "kde-testing and kdesvn-portage overlays thread" and it now holds support for both overlays

* add the following FAQ just under those 4 sections (before "Stuck by NeddySeagoon " ;) )

Quote:

KDE 4.1 in Portage - FAQ

Q: When KDE 4.1 will be in Portage?

A: KDE-4.1.2 is already in Portage now but it's masked due to conflicts with existing KDE3 installations. The team is already working to solve that issue. If your are brave enough, you can unmask placing this file in your /etc/portage/package.unmask. Remember that you are unmasking KDE-4.1.2 at your own risk.

Q: Why there are no sets for KDE 4.1?

A: KDE-4.1.2 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 here (click 'raw' to download file and place in /etc/portage/sets/). Remember that you are using them at your own risk.

Q: When I start KDE 3, Plasma is being executed and my KDE 3 applications are either crashing or just not working, what's going on?

A: This is the conflict mentioned earlier. There is a fix - test it please and report any further issues with KDE 3 applications here or directly on IRC channel.

If you have any suggestions for improvements regarding this guide, feel free to post them here.

reason:
- so far I'm the only person suggesting anything, maybe nobody knows where to add suggestions - on the other hand there should be some discussion (maybe internal but with some feedback here) among admins/mods before adding any change - so that we have the most politically correct guide as a result etc

so far I'm the only person suggesting anything, maybe nobody knows where to add suggestions - on the other hand there should be some discussion (maybe internal but with some feedback here) among admins/mods before adding any change - so that we have the most politically correct guide as a result etc

Changes of ambiguous merit would certainly be discussed prior to inclusion, those of unambiguous merit are likely to be handled accordingly and with little discussion.

well.. suggestion has not been applied 100% correctly - link is missing:

there is:

Quote:

If you have any suggestions for improvements regarding this guide, feel free to post them here.

should be (see 'edit/quote' to see the code) :

Quote:

If you have any suggestions for improvements regarding this guide, feel free to post them here.

And question - is there any hope for adding spoilers feature? (like in vBulletin)
Changelog could be spoiled in guide as it's constantly growing and soon it will be longer than the contents itself._________________Maciek

I'm just dropping a note regarding the way you ship the kde-4.1 sets. I found the gitweb interface painful to use, using hashed names preventing mass downloading. Perhaps preparing a little tarball with all the sets would be easier to setup for users that are just interested by using "emerge @kdebase".

Well - KDE4 sets are going to enter portage in near future (what does it mean 'near', it's question for developers).
Regarding gitweb interface being painfull - users who want to install KDE4 gentoo way are adviced (no matter what is mentioned in FAQ we're discussing here) to visit KDE 4 guide - that being said - KDE4 in portage is not that intended for "everyone" (out of the box) as it needs unkeywording at least.
One can grab whole sets directory from gitweb as well - on top of the page there is "snapshot" and links on the right - with archives you propose - being prepared on the fly.

Anyway, some updates won't hurt:

Requested updates:

- in FAQ section, change

Quote:

prepared some sets for you here (click 'raw' to download file and place in /etc/portage/sets/). Remember that you are using them at your own risk.

to

Quote:

prepared some sets for you here (click 'raw' to download file and place in /etc/portage/sets/). An archive with all sets can be downloaded from here. Remember that you are using them at your own risk.

- in kdesvn-portage section replace: (whole section)

Quote:

This overlay is being developed and maintained by the community. It contains tagged packages as well as SVN ebuilds, it follows the 4.2 development branch. If you want to use this overlay - consult this Wiki.
Support thread for unofficial Portage-compatible overlay is here:
https://forums.gentoo.org/viewtopic-t-709364.html

with

Quote:

This overlay is being removed and Live KDE ebuilds from this overlay are being merged to kde-testing overlay.
If you are using KDE 4 from this overlay, you are advised to switch to KDE 4 from Portage repository.

edit: this one is applied already_________________Maciek

Last edited by reavertm on Tue Oct 28, 2008 6:51 pm; edited 2 times in total

Portage repository
The only officially supported. If you haven't used any overlay nor compiled KDE 4 from source manually - this is probably what you're looking for. KDE 4 portage guide can be found here.
Support thread for official KDE 4 support is here:
https://forums.gentoo.org/viewtopic-t-707986.html

with

Quote:

Portage repository
The only officially supported and recommended way to get KDE4 (4.1.2 recently). If you haven't used any overlay nor compiled KDE 4 from source manually - this is probably what you're looking for.
KDE 4 portage guide can be found here - read it please to avoid problem in a future, it's is advised that you checked FAQ below as well.
You've found a bug? Visit this page - it may have been reported already.
Support thread for KDE 4 in Portage can be found here:
https://forums.gentoo.org/viewtopic-t-707986.html

reason:
more info

* replace in [kde-testing] - whole section:

Quote:

Official Gentoo KDE team overlay [kde-testing]
This is overlay used by KDE team, it's official but unsupported. When mature enough and tested, packages from this overlay are being transferred to Portage repository.
You can get support for this overlay in #gentoo-kde and help Gentoo KDE team testing it before it is moved into the official
Portage tree.
Please visit this thread before asking developers - you may find your answer here as well.

with

Quote:

Official Gentoo KDE team testing overlay [kde-testing]
This is overlay used by Gentoo KDE team, it's official but unsupported. It contains only KDE4 applications that are compatible with KDE4 from Portage repository but they are not there for some reasons. Some of those packages may appear in Portage repository in a future. Note that no KDE releases will be available in this overlay.
You can get support for this overlay in #gentoo-kde and help Gentoo KDE team testing it.
Support thread for official KDE4 testing overlay is here:
https://forums.gentoo.org/viewtopic-t-709364.html

reason: more info, overlay purpose changed

* replace [kdesvn-portage] - whole section:

Quote:

Unofficial Portage-compatible overlay [kdesvn-portage]
This overlay is being removed and Live KDE ebuilds from this overlay are being merged to kde-testing overlay.
If you are using KDE 4 from this overlay, you are advised to switch to KDE 4 from Portage repository.
Support thread for unofficial Portage-compatible overlay is here:
https://forums.gentoo.org/viewtopic-t-709364.html

with

Quote:

Official Gentoo KDE team (highly) experimental overlay [kde-crazy]
This overlay is playground for Gentoo KDE team. that being said it's known to eat puppies and kill kittens. It contains unstable KDE4 releases as well as live (Subversion) ebuilds. Please DON'T report any bugs regarding this overlay.
If you have some suggestions or you would like to contribute, contact Gentoo KDE team on #gentoo-kde.
Support thread for official KDE4 experimental overlay is here:
https://forums.gentoo.org/viewtopic-t-709364.html

reason: more info, kdesvn-portage overlay is no more, long live kde-crazy

* add in FAQ section - just under existing question - to maintain spacing like here

Quote:

Q: 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?

A: This is the conflict related to mixed KDE3/KDE4 sessions. To fix this issue you need to upgrade your existing KDE 3.5.x installations to 3.5.10 or newer.

Q: I installed KDE4, I can start my desktop using startx but KDM is not working. Please help.

If it's not found, then probably your environment is not up to date. To update it, run:

Code:

env-update && source /etc/profile

When kdm is found, set DISPLAYMANAGER="kdm" variable in /etc/conf.d/xdm. From now on, KDM should be working.

Q: I just found this neat KDE4 application, can you make an ebuild for it?

A: In short, no. To be more precise, it is possible but it would be better if you created ebuild 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 bug with ebuild proposal (if it's not there already) and inform the developers on #gentoo-kde 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?