KDE TechBase - User contributions [en]

Projects/Nepomuk

2011-12-01T23:49:11Z

Skierpage: add Subpages section, seems useful

{{Template:I18n/Language Navigation Bar|Projects/Nepomuk}}

[[Image:Nepomuk_logo_big.png|center|300px]]

== About Nepomuk ==

This page is dedicated to Nepomuk development ideas, progress, experiments, and is a general starting point for new developers.

For general information about the Nepomuk project see the [http://nepomuk.kde.org/ dedicated Nepomuk homepage].

== Contact ==

The Nepomuk project is maintained by [mailto:trueg@kde.org Sebastian Trueg] of Mandriva.

The "official" IRC channel is '''#nepomuk-kde''' on freenode.

All development questions should be discussed on the [https://mail.kde.org/mailman/listinfo/nepomuk Nepomuk mailing list].

== Documentation ==
The [http://userbase.kde.org/Nepomuk Nepomuk page on UserBase] has information and troubleshooting for users.

The following links provide good reads for getting used to the Nepomuk system and its APIs.
* [[Development/Tutorials/Metadata/Nepomuk|Development Tutorials]]
*'''[[Development/Tutorials/Metadata/Nepomuk/TipsAndTricks|Nepomuk Tips and Tricks]]'''
* [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk/html/index.html Nepomuk API Documentation]
* [http://soprano.sourceforge.net/apidox/trunk/index.html Soprano (RDF storage) API]
* [http://trueg.wordpress.com/2009/06/02/nepomuk-and-some-cmake-magic/ Using the Nepomuk Resource Code generator and the Soprano Ontology class generator in cmake]

As Nepomuk is highly dependent on its data in the RDF store and the used ontologies, one might consider to read up on RDF and the Nepomuk ontogies:
* [http://www.w3.org/TR/REC-rdf-syntax/ RDF Primer]
* [http://www.semanticdesktop.org/ontologies Nepomuk Ontologies]
* [http://dev.nepomuk.semanticdesktop.org/wiki/OntologyMaintenance Experimental Nepomuk Ontologies and Ideas for new ones]

== Events ==

[[Projects/Nepomuk/CodingSprint2009|June 19-21, 2009 - Coding Sprint 2009 Freiburg, Germany]]

[[Projects/Nepomuk/OpenSocialSemanticDesktopWorkshop2009|Open Social Semantic Desktop Workshop 2009 Freiburg, Germany]]

== ToDo ==

Nepomuk is a rather young project with a notorious shortage in developers. There are many tasks and subprojects to get ones hands dirty on. Unlike other projects like Plasma, however, developing for Nepomuk is not easy. One has to read up on a lot of things and fight some day-to-day annoyances. But: helping with the development will improve the situation in any case.

If you are interested in working on a task in this list, please contact [mailto:trueg@kde.org Sebastian Trueg].

=== Junior Jobs ===
If you want to get into Nepomuk development quickly by taking over a small task have a look at our [[Projects/Nepomuk/JuniorJobs|Junior Job page]].

=== Low level Nepomuk Development Tasks ===

The low-level development tasks are those that are not directly reflected in the GUI or even in the API used by most developers. However, they are important in terms of performance, scalability, and compatibility.

==== Add Inference Configuration to the Virtuoso Soprano Backend ====

Virtuoso 5 provides inference on rdfs:subClassOf and rdfs:subPropertyOf. These are the most important ones and for now all we need in Nepomuk.

The current implementation of the Virtuoso Soprano backend does not enable inference. We need a configuration option to do exactly that. It could happen along the lines of the [http://soprano.sourceforge.net/apidox/trunk/soprano_backend_virtuoso.html existing config options] or with the introduction of dedicated inference configuration options on the Soprano::Backend level.

==== Soprano Transaction Support ====

[http://soprano.sf.net/ Soprano] is the RDF database framework used in Nepomuk. Currently Soprano does not support transactions, i.e. sets of commands that can be rolled back. An [http://websvn.kde.org/branches/soprano/experimental experimental development] branch exists which already contains new API for transaction support (while keeping BC).

It still misses an implementation of the transaction support in Soprano backends (Sesame2 and Virtuoso) and in the client/server architecture.

Another idea is to create a new API based on the design that Sesame2 follows: Repository and RepositoryConnection classes. The former creates instances of the latter which then has all the actual data handling methods and acts as one transaction object.

=== General Nepomuk ===

==== Handling of external storage ====

'''We already have the removablestorage service in kdebase which handles USB keys and such to a degree.'''

A typical problem with the way Nepomuk handles files and file metadata are removable storage devices. They can be mounted at different paths on different systems. But still one wants to keep the metadata stored in Nepomuk. If possible one would even want to be able to search for files saved on an USB stick even if it is not plugged in.

The [http://trueg.wordpress.com/2009/04/15/portable-meta-information-yet-again-only-this-time-there-is-code/ blog entry about removable storage in Nepomuk] already discusses this problem and shows some existing code in KDE's [http://websvn.kde.org/trunk/playground/base/removablestorageservice/ playground] which tries to tackle this problem.

However, one actually needs more. The system would have to be embedded into KIO to make sure the metadata cache on the removable storage device is always up-to-date. Also it is directly related to the problem of relative vs. absolute file URLs.

==== Nepomuk Backup Service ====

Implementation details are discussed in [[Projects/Nepomuk/MetadataSharing]]

We need a backup solution. The idea is the typical one: have a Nepomuk service that allows to specify update intervals and manual updates.

The service should ignore all data extracted by Strigi, i.e. data that can be recreated deterministically. This can easy be determined by checking the context/named graph the data statements are stored in. Strigi stores all extracted data in one context which is marked as the ''http://www.strigi.org/fields#indexGraphFor'' for the file in question. Thus, a query along the lines of the following would work:
<pre>select ?s ?p ?o ?g where {
graph ?g { ?s ?p ?o . } .
OPTIONAL { ?g strigi:indexGraphFor ?x . } .
FILTER(!BOUND(?x)) .
}</pre>

Other features could include replacement of the home directory like it is done in KConfig. This way the data could be re-imported in another user account.

==== Nepomuk Toolbox ====
Provide a GUI that allows to call methods such as ''optimize'' and ''rebuildIndex'' on the storage service. The latter method is not commited yet due to the KDE 4.3 feature freeze but will be afterwards.

It would also be useful to have Nepomuk register such operations (including the data conversion when changing backends) via the notification system.

== Development status ==

See [[Projects/Nepomuk/DevelopmentStatus]].

== Ideas ==

There are many ideas on how to improve the Nepomuk system or on how to use it. This is the place to list them all.

Feel free to add your own ideas. Please leave your name in case someone wants to contact you for details or a discussion of the idea.

=== Use Nepomuk in the KDE Menu ===
One could think of using nepomuk search in the KMenu to look for applications or even files or persons.

=== Remember Usage of movie/sound files ===
Media players such as Dragonplayer or Amarok could remember when movie/sound files have been watched/listened to. The last time is interesting but maybe also a history.

In any case, it allows to quickly access unwatched episodes.

=== Tool to gather annotation statistics about selected files ===
Quoting [http://trueg.wordpress.com/2009/05/21/your-our-nepomuk-ideas/#comment-303 blog comment] as an example: ''"I am using Nepomuk to tag/rate schoolwork from my students. For every paper/file I tag it with seen/unseen and rate it with the actual grade I want to give (0-5). When I have seen them all, I collect the results into a spreadsheet. It would make my life (even) easier if, by selecting a bunch of file I could have a summary (one I could save in some text form) of all ratings/tags for each file in the selection."''

One could think of an action in Dolphin (for a first prototype this is always a good idea) which triggers a collection of all metadata which is then layed out according to the user's wishes: html, plain text, odt, whatever.

=== Add support for qualified links/relations ===

This is a somewhat low-level idea with no visible results as long as applications don't use it, but I think that having it implemented would allow for some nice possibilities.

Basically, the goal is to have some generic way of attaching a "quality" to any “thing -- property” assignment, in order to cope with the varying credibility/certainty of different meta-data collection methods such as user input, heuristic algorithms, circumstantial guesses, etc. in a transparent and unified way.

This would among other things allow implementing many automatic-data-collection ideas like NLP-support in a more user-friendly (that is: non-intrusive) fashion.

For more details & discussion see [[Projects/Nepomuk/Qualified Relations Idea]].

=== Folder Cloud in Dolphin/KDirOperator ===
Using information from the Nepomuk DB about usage frequency of folders (or the files within) it would be nice to have the folders be presented in a cloud. More often used or more important folders would appear bigger.

This is a nice idea originally posted on [http://www.kde-look.org/content/show.php/Folder+Cloud?content=101521 kde-look.org].

=== Nepomuk based backup system ===
Nepomuk has a huge potential for an intelligent backup system. The point here is that Nepomuk could "know" that a certain file on a certain device is the backup of a local file. Then, when the device is available it would trigger an automatic update of the backup.

The user could, for example, just tag a folder with "Backup" (better use a dedicated ontology) and the system would ask where to back it up and perform all the necessary tasks. Backup history and recovery could then be done inside the Nepomuk resource. The key point here is really the fact that the system would "know" what a backup is, recognize one when it sees it and know what to do with it.

=== Nepomuk based versioning system ===
This is partly related to the backup system. User should be able to tag a version of a file, a bit like in svn. When opening a file, there could be a list of saved versions, in case user wants to revert changes or something like that.

This could even be combined with automatic detection. For example in email: somebody sends you the second version of a paper which is then saved. It would be great to remember that the new file is the second version of the first one. Then the system could warn if one opens the older version.

=== File Boxes ===
There is a nice idea about file boxes which allow to temporarily group files to perform some actions on them here: http://bugs.kde.org/show_bug.cgi?id=200461

This could be done using Nepomuk. I am not sure, however, if Nepomuk is really the correct choice here. Maybe a simple kded service and a KIO slave nicely integrated into Dolphin and the file dialog would be sufficient.

=== Categorize new files ===
'''We already have the fileannotation service in [http://websvn.kde.org/trunk/playground/base/nepomuk-kde/fileannotationservice/ playground]. This is the basis for the idea below as it already implements parts of it.''

Let Strigi emit a D-Bus signal on new files (only after the initial indexing so we do not get signals for all files) that appear in typical document folders (so we do not get signals on temp and log files and the like).

When a new file appears propose to relate it to the current Nepomuk context (the context service is in playground: a very simple one only maintaining one URI which is the current context and can be any resource. Typically, however, it would be a project or task or event).

Also use the information extracted by Strigi (mostly nie:plainTextContent and nie:description and nie:name) to generate annotation suggestions through Scribo and propose them to the user, too. This could be done via notifications (in a first version) and later in a nicer plasma GUI.

Here rating of the suggestions is important. Nepomuk::Annotation already provides a relevance() method but most plugins' relevance generation code is rather simple and could use improvement.

'''''Hints:'''''
* If the above "''Add support for qualified links/relations''" idea were implemented, the user would not have to be bothered to confirm the relation of the new file to the current context. You could just add it as a weak relation ('found by circumstancial evidence'). The user could always confirm it at a later point (e.g. in dolphin) to turn it into a strong relation.

=== FIXME: add your own ideas ===

==== Linking between documents ====
I usually deal with lots of scientific papers in the form of searchable pdf's.
My idea is twofold:
1) Have a 'Google scholar' type search that allows me to see the relations between papers and retrace an idea to its original author.
2) Each paper refers to a few other that I might have already on disk. My idea is to have okular integration such that when I click on a reference it opens the respective file based on author, date, journal, etc.

==== Push tag clouds on the web ====

I'd like to save my tag cloud on the web so that when I change computers, I still have my tags. There should also be serveral projects which wikify tag cloud creation and which would serve updates via some kind of RSS feeds. Think of it as some sort of Digg for both online and offline desktop items.

=== Augment menu toolbars with semantic search ===
Ideally, eliminate the use of menu toolbars, rather have a powerful semantic search to query for a given functionality/action etc.

=== Pure semantic desktop environment ===
A minimalistic desktop environment solely based on semantic search. Ideal for small screens (e.g. netbooks/smartbooks), all functionality is accessed via semantic search, rather than the usual assortment of menus or application icon panels. A rather intuitive UI. The user 'talks' to the computer. In essence this takes the idea of beagle/krunner/gnome-go like idea to the next level. Combined with the replacement of toolbar menus, it makes for an efficient use of screen space with an uncluttered UI, plus shifting the input method more to the keyboard side, which can be beneficial to netbooks/laptops on the move (when you don't want to rely on a mouse)

=== Link Pictures to Persons ===

Apple already did it the really fancy way: face recognition + linking of faces to people.

We do not have face recognition yet but we can link pictures to persons. Akonadi pushes the contacts in the address book to Nepomuk as nco:PersonContact instances. We can simply use those to allow linking to images.

In playground we already have peopletag which allows to define a region. It would make more sense to integrate it with Gwenview.

The ontology to use it still an issue. After all we want to easily handle

* The direct link between the image and the person
* The region in the image

Dolphin should be able to display the information, too, i.e. the name of the person, maybe even with a link to the address book.

=== Automatically annotate system files ===

The example is wallpapers. Installed wallpapers could automatically be marked as begin of type "Wallpaper". This would also require an ontology which includes the term Wallpaper based on PIMO.

== Subpages of {{FULLPAGENAME}}==
{{Special:PrefixIndex/{{FULLPAGENAME}}/}}

Projects/Nepomuk

2011-12-01T23:47:39Z

Skierpage: /* Documentation */ add link to http://userbase.kde.org/Nepomuk

User:Skierpage

2011-11-15T01:29:14Z

Skierpage: /* Nepomuk indexing mystery */ more

I first used [[Projects/KDE_on_Windows]] but now run Kubuntu as my main operating system.
I wrote an occasional journal of my adventures in getting Kubuntu working at [http://userbase.kde.org/User:Skierpage userbase.kde.org user page]

I mostly do documentation and support for Semantic MediaWiki, an extension to MediaWiki.

== Techbase problems and what I'm going to do about them ==
2011-11-14: I'm frustrated as hell trying to figure out a problem with KDE (Strigi not indexing my stuff), and TechBase is ''not'' helping.

Some wiki woes also apply to userbase.

=== Service page problems ===
The Nepomuk blog's [http://nepomuk.kde.org/node/2 Documentation] page has a Strigi Service link that goes to [[Development/Tutorials/Metadata/Nepomuk/StrigiService]]
unfortunately this suffers from the same problems as the blog's Documentation page

* BUG: doesn't say where the source is
* BUG: doesn't say where the API is
* BUG: doesn't say what the service looks like. Is it a process I can look at? What's the process name?

* TODO: techbase needs to have {{tl|source}}, {{tl|api}}, {{tl|processname}} templates for creating links to these, and should have a series of form template that presents this sort of information about a project in an infobox:
<nowiki>{{</nowiki>service| source= | api= | processname= | bugtracker= | kdemodule= | blog= }}

=== Too many wikis! ===
TODO: the split between userbase and techbase is dubious. I'm a user, but I want to go beyond the user documentation. You're just going to duplicate information like the processname, the blog, the bug tracker and the kdemodule in two wikis.

And it turns out there's a third wiki, http://community.kde.org. <nowiki><rant>That is completely f***ing ridiculous.</rant></nowiki> ''Three times the infrastructure'' to maintain (Help pages, templates, interwiki links, common images, vandal patrolling), three copies of all these bugs, and for what? Users are three times more likely to look in the wrong wiki.

=== Techbase minor bugs ===
BUG: [[Template:Info]] is undocumented! Use <nowiki><noinclude> </noinclude></nowiki> to document what templates do!

BUG: [[Help:Contents]] says to use
<nowiki>{{bug|123456}}</nowiki>
surely this HTML formatting junk should be part of a template, i.e. {{formatted_bug|xxx}}

BUG: Template:Template has a silly confusing warning
"If this page is not already in the "Template" namespace, it should probably be migrated to that location."

Instead, someone should just periodically look at [[Special:WhatLinksHere/Template:Template]] and see if pages outside Category:Template are using it.

=== techbase interwiki issues ===
[http://www.mediawiki.org/wiki/Manual:Interwiki interwiki prefixes]] let you link between wikis. But the [http://techbase.kde.org/api.php?action=query&meta=siteinfo&siprop=interwikimap interwiki prefixes on techbase] have some problems:

* It should be easy to link from one wiki to another, using [userbase:http://userbase.kde.org/Special:MyLanguage/Quick Start], but it isn't set up.

* There is a bug prefix, e.g. [[bug:1234|1234]], but why is it <tt>language="ᨅᨔ ᨕᨘᨁᨗ"</tt> attribute? Maybe that's why on userbase this doesn't do anything?
* Why is there an empty bugs prefix, e.g.[[bugs:1234|1234]] ?
* techbase and userbase have different interwiki maps, e.g. techbase has no wikipedia prefix, but userbase does e.g. [[wikipedia:Git]]; userbase has <nowiki>[[mediawikiwiki:</nowiki>, etc.!

=== Stylistic issues ===
* Don't capitalize each word in titles and section headings. It Makes the Wiki Look Imperious and Official, it conflicts with the default heading style (See the Toolbox links) and it makes linking to pages in the flow text flow unnatural to read. Compare
** If you're interested in contributing translations, your first step is to [[Special:MyLanguage/Translator Account|Get a Translator Account]]
** If you're interested in contributing translations, your first step is to [[Special:MyLanguage/Translator Account|get a translator account]]

=== Layout issues ===
I think all these bugs are in the Chihuahua skin, and they all apply to userbase.kde.org as well.

BUG: In three-column listings like [[:Category:Template]] , the techbase wiki skin makes the listing overlap the right-hand "Share your Knowledge" column.

BUG: In revision history the
:Revision as of 21:55, 20 May 2009 by JRT (Talk | contribs) (diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
crashes into the light header with [View the content page] [Discussion about the content page] icons.

BUG: justified text looks bad in a narrow window. Allow ragged right column

BUG: when you select, the highlight color makes highlighted text look ''identical'' to a link. Try it, select this text and link [[Schedules]] and this text. You can't tell!

MAYBE: pre text just goes on and on off the right side. Consider using the wrap attribute of pre so that stuff wraps.

=== TechBase problems fixed! ===
* I fixed [[Template:Template]] to explain what it does.
* I pulled in [[Template:Tl]] from Wikipedia, so that instead of fiddling with <nowiki>{{</nowiki> you can use e.g. {{tl|bug}} to generate a nicely-formatted <nowiki>{{</nowiki>[[Template:bug|bug]]}} which is also a link to a template.
* I revived a "Browsing the code" section in [[Getting_Started#Browsing_the_code|Getting Started]], it's critical! Someone deleted the old "Getting the source" section.

== Searching and browsing source ==
I brought back [[Getting Started#Browsing the code]] but the situation is confusing.
There are three systems that let you browse and search source code:
; http://projects.kde.org
: The git repositories, most KDE source code is in Git these days.
; http://api.kde.org
: API docs generated from the source code, but you can also scroll down and click to view the source code
; http://lxr.kde.org
: Cross-reference to files and names in the KDE source code.

But they give different results. Try searching for the class StrigiIndexWriter in 4.x ("the trunk"?) in each, or equivalently the file nepomukindexwriter.cpp

* [http://api.kde.org/mapsearcher.php?class=StrigiIndexWriter&module=ALL&version=4.x api.kde.org] finds the class in nepomukindexwriter.cpp in three different places!
*: [http://api.kde.org/4.x-api/kde-runtime-apidocs/nepomuk/html/classNepomuk_1_1StrigiIndexWriter.html StrigiIndexWriter] in module kde-runtime-4.x, project nepomuk [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk_1_1StrigiIndexWriter.html StrigiIndexWriter] in module kdelibs-4.x, project nepomuk-core [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/libnepomukcore/html/classNepomuk_1_1StrigiIndexWriter.html StrigiIndexWriter] in module kdelibs-4.x, project nepomuk-core(/libnepomukcore)

* [http://lxr.kde.org/search?string=StrigiIndexWriter lxr.kde.org] finds the class in two different places, but with a completely different path:
*: [http://lxr.kde.org/source/kde/kdelibs/nepomuk-core/services/fileindexer/indexer/nepomukindexwriter.cpp in kdelibs/nepomuk-core in the directory services/fileindexer/indexer/] [http://lxr.kde.org/source/kde/kde-runtime/nepomuk/services/fileindexer/indexer/nepomukindexwriter.cpp in kde-runtime/nepomuk in the same directory subtree] 

* Can't search for either in https://projects.kde.org/projects/kde/ or its subdirectories kdelibs and kdelibs/nepomuk-core. You can eventually browse to [https://projects.kde.org/projects/kde/kdelibs/nepomuk-core/repository/revisions/master/entry/services/fileindexer/indexer/nepomukindexwriter.cpp services / fileindexer / indexer / nepomukindexwriter.cpp] . This path in Git bears no relation to the path in api but matches the path in lxr. And projects and lxr agree on the file contents.

BUG: Ideally api.kde.org would generate a link to the actual file in Git.

== Nepomuk indexing mystery ==
I'm slogging through all this crap to try to figure out why Nepomuk isn't indexing my NTFS volumes. It could be something to do with "System Settings > Nepomuk/Strigi config > File indexing > Removable media handling > Ignore all removable media", but I can't find the glue that links this KCM with the actual indexing. I know this is in nepomuk/kcm/nepomukserverkcm.cpp (No thanks to the three search engines, I found it in Google), but searching for "RemovableMedia" doesn't find anything.

The result is <code>.kde/share/config/nepomukstrigirc</code> gets:
[RemovableMedia]
ask user=false
index newly mounted=false

but I can't find these terms in KDE source.

User:Skierpage

2011-11-15T01:28:02Z

Skierpage: markup typo

User:Skierpage

2011-11-15T01:22:53Z

Skierpage: new section on Nepomuk indexing mystery

I first used [[Projects/KDE_on_Windows]] but now run Kubuntu as my main operating system.
I wrote an occasional journal of my adventures in getting Kubuntu working at [http://userbase.kde.org/User:Skierpage userbase.kde.org user page]

I mostly do documentation and support for Semantic MediaWiki, an extension to MediaWiki.

== Techbase problems and what I'm going to do about them ==
2011-11-14: I'm frustrated as hell trying to figure out a problem with KDE (Strigi not indexing my stuff), and TechBase is ''not'' helping.

Some wiki woes also apply to userbase.

=== Service page problems ===
The Nepomuk blog's [http://nepomuk.kde.org/node/2 Documentation] page has a Strigi Service link that goes to [[Development/Tutorials/Metadata/Nepomuk/StrigiService]]
unfortunately this suffers from the same problems as the blog's Documentation page

* BUG: doesn't say where the source is
* BUG: doesn't say where the API is
* BUG: doesn't say what the service looks like. Is it a process I can look at? What's the process name?

* TODO: techbase needs to have {{tl|source}}, {{tl|api}}, {{tl|processname}} templates for creating links to these, and should have a series of form template that presents this sort of information about a project in an infobox:
<nowiki>{{</nowiki>service| source= | api= | processname= | bugtracker= | kdemodule= | blog= }}

=== Too many wikis! ===
TODO: the split between userbase and techbase is dubious. I'm a user, but I want to go beyond the user documentation. You're just going to duplicate information like the processname, the blog, the bug tracker and the kdemodule in two wikis.

And it turns out there's a third wiki, http://community.kde.org. <nowiki><rant>That is completely f***ing ridiculous.</rant></nowiki> ''Three times the infrastructure'' to maintain (Help pages, templates, interwiki links, common images, vandal patrolling), three copies of all these bugs, and for what? Users are three times more likely to look in the wrong wiki.

=== Techbase minor bugs ===
BUG: [[Template:Info]] is undocumented! Use <nowiki><noinclude> </noinclude></nowiki> to document what templates do!

BUG: [[Help:Contents]] says to use
<nowiki>{{bug|123456}}</nowiki>
surely this HTML formatting junk should be part of a template, i.e. {{formatted_bug|xxx}}

BUG: Template:Template has a silly confusing warning
"If this page is not already in the "Template" namespace, it should probably be migrated to that location."

Instead, someone should just periodically look at [[Special:WhatLinksHere/Template:Template]] and see if pages outside Category:Template are using it.

=== techbase interwiki issues ===
[http://www.mediawiki.org/wiki/Manual:Interwiki interwiki prefixes]] let you link between wikis. But the [http://techbase.kde.org/api.php?action=query&meta=siteinfo&siprop=interwikimap interwiki prefixes on techbase] have some problems:

* It should be easy to link from one wiki to another, using [userbase:http://userbase.kde.org/Special:MyLanguage/Quick Start], but it isn't set up.

* There is a bug prefix, e.g. [[bug:1234|1234]], but why is it <tt>language="ᨅᨔ ᨕᨘᨁᨗ"</tt> attribute? Maybe that's why on userbase this doesn't do anything?
* Why is there an empty bugs prefix, e.g.[[bugs:1234|1234]] ?
* techbase and userbase have different interwiki maps, e.g. techbase has no wikipedia prefix, but userbase does e.g. [[wikipedia:Git]]; userbase has <nowiki>[[mediawikiwiki:</nowiki>, etc.!

=== Stylistic issues ===
* Don't capitalize each word in titles and section headings. It Makes the Wiki Look Imperious and Official, it conflicts with the default heading style (See the Toolbox links) and it makes linking to pages in the flow text flow unnatural to read. Compare
** If you're interested in contributing translations, your first step is to [[Special:MyLanguage/Translator Account|Get a Translator Account]]
** If you're interested in contributing translations, your first step is to [[Special:MyLanguage/Translator Account|get a translator account]]

=== Layout issues ===
I think all these bugs are in the Chihuahua skin, and they all apply to userbase.kde.org as well.

BUG: In three-column listings like [[Category:Template]] , the techbase wiki skin makes the listing overlap the right-hand "Share your Knowledge" column.

BUG: In revision history the
:Revision as of 21:55, 20 May 2009 by JRT (Talk | contribs) (diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
crashes into the light header with [View the content page] [Discussion about the content page] icons.

BUG: justified text looks bad in a narrow window. Allow ragged right column

BUG: when you select, the highlight color makes highlighted text look ''identical'' to a link. Try it, select this text and link [[Schedules]] and this text. You can't tell!

MAYBE: pre text just goes on and on off the right side. Consider using the wrap attribute of pre so that stuff wraps.

=== TechBase problems fixed! ===
* I fixed [[Template:Template]] to explain what it does.
* I pulled in [[Template:Tl]] from Wikipedia, so that instead of fiddling with <nowiki>{{</nowiki> you can use e.g. {{tl|bug}} to generate a nicely-formatted <nowiki>{{</nowiki>[[Template:bug|bug]]}} which is also a link to a template.
* I revived a "Browsing the code" section in [[Getting_Started#Browsing_the_code|Getting Started]], it's critical! Someone deleted the old "Getting the source" section.

== Searching and browsing source ==
I brought back [[Getting Started#Browsing the code]] but the situation is confusing.
There are three systems that let you browse and search source code:
; http://projects.kde.org
: The git repositories, most KDE source code is in Git these days.
; http://api.kde.org
: API docs generated from the source code, but you can also scroll down and click to view the source code
; http://lxr.kde.org
: Cross-reference to files and names in the KDE source code.

But they give different results. Try searching for the class StrigiIndexWriter in 4.x ("the trunk"?) in each, or equivalently the file nepomukindexwriter.cpp

* [http://api.kde.org/mapsearcher.php?class=StrigiIndexWriter&module=ALL&version=4.x api.kde.org] finds the class in nepomukindexwriter.cpp in three different places!
*: [http://api.kde.org/4.x-api/kde-runtime-apidocs/nepomuk/html/classNepomuk_1_1StrigiIndexWriter.html StrigiIndexWriter] in module kde-runtime-4.x, project nepomuk [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk_1_1StrigiIndexWriter.html StrigiIndexWriter] in module kdelibs-4.x, project nepomuk-core [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/libnepomukcore/html/classNepomuk_1_1StrigiIndexWriter.html StrigiIndexWriter] in module kdelibs-4.x, project nepomuk-core(/libnepomukcore)

* [http://lxr.kde.org/search?string=StrigiIndexWriter lxr.kde.org] finds the class in two different places, but with a completely different path:
*: [http://lxr.kde.org/source/kde/kdelibs/nepomuk-core/services/fileindexer/indexer/nepomukindexwriter.cpp in kdelibs/nepomuk-core in the directory services/fileindexer/indexer/] [http://lxr.kde.org/source/kde/kde-runtime/nepomuk/services/fileindexer/indexer/nepomukindexwriter.cpp in kde-runtime/nepomuk in the same directory subtree] 

* Can't search for either in https://projects.kde.org/projects/kde/ or its subdirectories kdelibs and kdelibs/nepomuk-core. You can eventually browse to [https://projects.kde.org/projects/kde/kdelibs/nepomuk-core/repository/revisions/master/entry/services/fileindexer/indexer/nepomukindexwriter.cpp services / fileindexer / indexer / nepomukindexwriter.cpp] . This path in Git bears no relation to the path in api but matches the path in lxr. And projects and lxr agree on the file contents.

BUG: Ideally api.kde.org would generate a link to the actual file in Git.

== Nepomuk indexing mystery ==
I'm slogging through all this crap to try to figure out why Nepomuk isn't indexing my NTFS volumes. It could be something to do with "System Settings > Nepomuk/Strigi config > File indexing > Removable media handling > Ignore all removable media", but I can't find the glue that links this KCM with the actual indexing. I know this is in nepomuk/kcm/nepomukserverkcm.cpp (No thanks to the three search engines, I found it in Google), but searching for "RemovableMedia" doesn't find anything.

User:Skierpage

2011-11-15T00:57:10Z

Skierpage: new section about source browsing confusion

I first used [[Projects/KDE_on_Windows]] but now run Kubuntu as my main operating system.
I wrote an occasional journal of my adventures in getting Kubuntu working at [http://userbase.kde.org/User:Skierpage userbase.kde.org user page]

I mostly do documentation and support for Semantic MediaWiki, an extension to MediaWiki.

== Techbase problems and what I'm going to do about them ==
2011-11-14: I'm frustrated as hell trying to figure out a problem with KDE (Strigi not indexing my stuff), and TechBase is ''not'' helping.

Some wiki woes also apply to userbase.

=== Service page problems ===
The Nepomuk blog's [http://nepomuk.kde.org/node/2 Documentation] page has a Strigi Service link that goes to [[Development/Tutorials/Metadata/Nepomuk/StrigiService]]
unfortunately this suffers from the same problems as the blog's Documentation page

* BUG: doesn't say where the source is
* BUG: doesn't say where the API is
* BUG: doesn't say what the service looks like. Is it a process I can look at? What's the process name?

* TODO: techbase needs to have {{tl|source}}, {{tl|api}}, {{tl|processname}} templates for creating links to these, and should have a series of form template that presents this sort of information about a project in an infobox:
<nowiki>{{</nowiki>service| source= | api= | processname= | bugtracker= | kdemodule= | blog= }}

=== Too many wikis! ===
TODO: the split between userbase and techbase is dubious. I'm a user, but I want to go beyond the user documentation. You're just going to duplicate information like the processname, the blog, the bug tracker and the kdemodule in two wikis.

And it turns out there's a third wiki, http://community.kde.org. <nowiki><rant>That is completely f***ing ridiculous.</rant></nowiki> ''Three times the infrastructure'' to maintain (Help pages, templates, interwiki links, common images, vandal patrolling), three copies of all these bugs, and for what? Users are three times more likely to look in the wrong wiki.

=== Techbase minor bugs ===
BUG: [[Template:Info]] is undocumented! Use <nowiki><noinclude> </noinclude></nowiki> to document what templates do!

BUG: [[Help:Contents]] says to use
<nowiki>{{bug|123456}}</nowiki>
surely this HTML formatting junk should be part of a template, i.e. {{formatted_bug|xxx}}

BUG: Template:Template has a silly confusing warning
"If this page is not already in the "Template" namespace, it should probably be migrated to that location."

Instead, someone should just periodically look at [[Special:WhatLinksHere/Template:Template]] and see if pages outside Category:Template are using it.

=== techbase interwiki issues ===
[http://www.mediawiki.org/wiki/Manual:Interwiki interwiki prefixes]] let you link between wikis. But the [http://techbase.kde.org/api.php?action=query&meta=siteinfo&siprop=interwikimap interwiki prefixes on techbase] have some problems:

* It should be easy to link from one wiki to another, using [userbase:http://userbase.kde.org/Special:MyLanguage/Quick Start], but it isn't set up.

* There is a bug prefix, e.g. [[bug:1234|1234]], but why is it <tt>language="ᨅᨔ ᨕᨘᨁᨗ"</tt> attribute? Maybe that's why on userbase this doesn't do anything?
* Why is there an empty bugs prefix, e.g.[[bugs:1234|1234]] ?
* techbase and userbase have different interwiki maps, e.g. techbase has no wikipedia prefix, but userbase does e.g. [[wikipedia:Git]]; userbase has <nowiki>[[mediawikiwiki:</nowiki>, etc.!

=== Stylistic issues ===
* Don't capitalize each word in titles and section headings. It Makes the Wiki Look Imperious and Official, it conflicts with the default heading style (See the Toolbox links) and it makes linking to pages in the flow text flow unnatural to read. Compare
** If you're interested in contributing translations, your first step is to [[Special:MyLanguage/Translator Account|Get a Translator Account]]
** If you're interested in contributing translations, your first step is to [[Special:MyLanguage/Translator Account|get a translator account]]

=== Layout issues ===
I think all these bugs are in the Chihuahua skin, and they all apply to userbase.kde.org as well.

BUG: In three-column listings like [[Category:Template]] , the techbase wiki skin makes the listing overlap the right-hand "Share your Knowledge" column.

BUG: In revision history the
:Revision as of 21:55, 20 May 2009 by JRT (Talk | contribs) (diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
crashes into the light header with [View the content page] [Discussion about the content page] icons.

BUG: justified text looks bad in a narrow window. Allow ragged right column

BUG: when you select, the highlight color makes highlighted text look ''identical'' to a link. Try it, select this text and link [[Schedules]] and this text. You can't tell!

MAYBE: pre text just goes on and on off the right side. Consider using the wrap attribute of pre so that stuff wraps.

=== TechBase problems fixed! ===
* I fixed [[Template:Template]] to explain what it does.
* I pulled in [[Template:Tl]] from Wikipedia, so that instead of fiddling with <nowiki>{{</nowiki> you can use e.g. {{tl|bug}} to generate a nicely-formatted <nowiki>{{</nowiki>[[Template:bug|bug]]}} which is also a link to a template.
* I revived a "Browsing the code" section in [[Getting_Started#Browsing_the_code|Getting Started]], it's critical! Someone deleted the old "Getting the source" section.

== Searching and browsing source ==
I brought back [[Getting Started#Browsing the code]] but the situation is confusing.
There are three systems that let you browse and search source code:
; http://projects.kde.org
: The git repositories, most KDE source code is in Git these days.
; http://api.kde.org
: API docs generated from the source code, but you can also scroll down and click to view the source code
; http://lxr.kde.org
: Cross-reference to files and names in the KDE source code.

But they give different results. Try searching for the class StrigiIndexWriter in 4.x ("the trunk"?) in each, or equivalently the file nepomukindexwriter.cpp

* [http://api.kde.org/mapsearcher.php?class=StrigiIndexWriter&module=ALL&version=4.x api.kde.org] finds the class in nepomukindexwriter.cpp in three different places!
*: [http://api.kde.org/4.x-api/kde-runtime-apidocs/nepomuk/html/classNepomuk_1_1StrigiIndexWriter.html StrigiIndexWriter] in module kde-runtime-4.x, project nepomuk [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/html/classNepomuk_1_1StrigiIndexWriter.html StrigiIndexWriter] in module kdelibs-4.x, project nepomuk-core [http://api.kde.org/4.x-api/kdelibs-apidocs/nepomuk-core/libnepomukcore/html/classNepomuk_1_1StrigiIndexWriter.html StrigiIndexWriter] in module kdelibs-4.x, project nepomuk-core(/libnepomukcore)

* [http://lxr.kde.org/search?string=StrigiIndexWriter lxr.kde.org] finds the class in two different places, but with a completely different path:
*: [http://lxr.kde.org/source/kde/kdelibs/nepomuk-core/services/fileindexer/indexer/nepomukindexwriter.cpp in kdelibs/nepomuk-core in the directory services/fileindexer/indexer/] [http://lxr.kde.org/source/kde/kde-runtime/nepomuk/services/fileindexer/indexer/nepomukindexwriter.cpp in kde-runtime/nepomuk in the same directory subtree] 

* Can't search for either in https://projects.kde.org/projects/kde/ or its subdirectories kdelibs and kdelibs/nepomuk-core. You can eventually browse to [https://projects.kde.org/projects/kde/kdelibs/nepomuk-core/repository/revisions/master/entry/services/fileindexer/indexer/nepomukindexwriter.cpp services / fileindexer / indexer / nepomukindexwriter.cpp] . This path in Git bears no relation to the path in api but matches the path in lxr. And projects and lxr agree on the file contents.

BUG: Ideally api.kde.org would generate a link to the actual file in Git.

User:Skierpage

2011-11-15T00:22:07Z

Skierpage: /* techbase interwiki issues */ more details

KDE TechBase:Migrate content

2011-11-15T00:19:09Z

Skierpage: /* How to fill this wiki with life */ developer.kde.org is obsolete, markup {{movepage}}

{{Template:I18n/Language Navigation Bar|KDE_TechBase:Migrate_content}}

Information about syntax and templates can be found [[Help:Contents|here]].

== How to fill this wiki with life ==

# Step: Identify all developer-related content
# <del>Step: check [http://developer.kde.org developer.kde.org] pages for similar content</del> Apart from some developers' home directories, all URLs on http://developer.org redirect to techbase.kde.org
# Step: put the material on this wiki
# If content is missing, use the template {{[[Template:movepage|movepage]]|''from-url''}} to add a todo-box.

== Rules ==

# Page names aren't in CamelCase (CamelCase proper nouns - like ''DocBook'' - are okay)
# Make use of subpages, for example [[Policies/SVN Commit Policy]]
# Make use of [http://meta.wikimedia.org/wiki/Help:Template templates] to mark Pages as relevant for KDE 3 or 4
# Use categories inside those templates.
# In case of doubt, read the [http://meta.wikimedia.org/wiki/Help:Contents#For_editors Media Wiki Users Guide]
# If you do have a KDE Subversion account, please use the ''same username'' in the wiki, because we might introduce unified login

== Roadmap ==

See also: [[Projects/Partners]]

Things to be done:
# dynamic content like feature plan
#* TODO: enable our mediawiki extension for our xml based feature plans
# validate our tutorials (i.e. proof-read everything and really try it)
# finish half-started pages (fill todo's in the e.g. KDE Architecture pages)
# <insert todo's here>

== Keep in mind ==

It's a wiki, you can change things easily later on. Note that this is not an invitation to just dump stuff here, but it may be relieving to know that not everything has to be perfect at first approach.

Thread:User talk:Odysseus/I added Getting Started Browsing the code, lxr vs. api vs. projects.kde.org

2011-11-14T23:45:38Z

Skierpage: New thread: I added Getting_Started#Browsing_the_code, lxr vs. api vs. projects.kde.org

I was frustrated that the old [http://techbase.kde.org/index.php?title=Getting_Started&oldid=41850|Getting Started "Getting the Source"] section was removed, so I added something. I'm sorry if this messes up your plans to translate it.

I'm not sure whether http://lxr.kde.org is up-to-date. It presents a different module organization than api.kde.org or projects.kde.org. All of these have a [Search] button but they work do different ghins and produce different results, it's quite confusing.

While trying to find the source (for Strigi's Removable media handling, I'm still looking :-( ) I enumerated a lot of problems with the wiki(s) and fixed a few of them. The former probably isn't helpful, maybe the latter will be. Cheers.

User:Skierpage

2011-11-14T23:37:01Z

Skierpage: /* Stylistic issues */ example

User:Skierpage

2011-11-14T23:30:07Z

Skierpage: /* Techbase minor bugs */ markup

Getting Started/Using Project Neon to contribute to KDE

2011-11-14T23:25:33Z

Skierpage: rephrase some obsolete mentions of SVN

[https://launchpad.net/project-neon Project Neon] is a nightly build of the latest KDE trunk. It is an easy way for new contributors to KDE to get started without having to download and build the entire KDE source code tree. Additionally, dependencies are automatically handled and updated. This is suitable for new developers, translators, usability designers, documenters, promoters, bug triagers etc. This process makes the steps detailed on [[Getting_Started/Build|this page]].

However, for developers, it may at some point become necessary to build more components from source code as you become more involved in the project. The [[Getting_Started/Build/kdesrc-build|kdesrc-build]] script is an easy way to build all or parts of KDE from its source code repositories.

== Requirements ==

Project neon always requires the latest stable Kubuntu release or development release. Previous versions of Kubuntu are not supported.

== Installing Project Neon ==

To use Project Neon, add the following PPA (Personal Package Archive) to your <tt>sources.list</tt> using your preferred method:

<syntaxhighlight lang="bash">
sudo add-apt-repository ppa:neon/ppa
</syntaxhighlight>
or
<pre>
# Project neon nightly KDE4 build
deb http://ppa.launchpad.net/neon/ppa/ubuntu maverick main

#above repository is PGP signed, refer to below link for getting PGP key
https://launchpad.net/~neon/+archive/ppa
</pre>

After that, you can simply install the nightly package of whichever modules you want to work on. The Packages are named project-neon-<git/svn module name>. The packages are installed in /opt/project-neon/ and won't affect your stable KDE install.

You can install all of the packages or just the ones you are interested in, depending on what you want to use them for. For example if you want to install the KDE Workspace with the extra plasmoids, you would install the <tt>project-neon-kdeplasma-addons</tt> and <tt>project-neon-session</tt> so you get KDM support for Project Neon.

<syntaxhighlight lang="bash">
sudo apt-get install project-neon-kdeplasma-addons project-neon-session
</syntaxhighlight>

If you are only interested in application development in another module, you can install just the module package.

<syntaxhighlight lang="bash">
sudo apt-get install project-neon-kdepim project-neon-common
</syntaxhighlight>

That command will also install the <tt>kdelibs</tt>, <tt>kdepimlibs</tt> and other dependencies too. In your regular (stable) KDE session you can then run the nightly version of your chosen application after setting up the environment.

<syntaxhighlight lang="bash">
. /opt/project-neon/share/project-neon/environment.rc
kmail
</syntaxhighlight>

Instead of sourcing the settings by hand every time, you could add this to your .bashrc:

<syntaxhighlight lang="bash">
switchtonightly ()
{
. /opt/project-neon/share/project-neon/environment.rc
}
</syntaxhighlight>

or use <tt>neon-env</tt> (see below).

You'll need to close the terminal session for the settings to be undone.

This will correctly use the nightly version of libraries instead of using the stable versions, so no other changes are necessary to your library path etc.

Note that settings for applications that you run from project neon do not conflict with your regular application settings and data. <tt>.project-neon-kde/</tt> is used instead of <tt>.kde/</tt>

== Using Project Neon for development ==

If you are joining one of the development teams in KDE, you will need a real SVN/GIT checkout in order to contribute your code back to the project and create patches easily. If you only code for KDE every now and then, Project Neon provides some extra tools for this purpose in the package <tt>project-neon-utils</tt>:

NOTE: both neon-cmake and neonmake require neon-env to be run first!

<tt>neon-env</tt> -
sets up the necessary environment settings for project neon builds and opens a subshell.

<tt>neon-cmake</tt> -
cmake wrapper with neon environment settings for cmake, same synopsis as cmake and passes arguments to cmake

<tt>neonmake</tt> -
convenience script which will create a build folder, configure the source, build it and install it in /opt/project-neon/ so you can test your changes.

<tt>neon-clean</tt> -
This script will reset all changes you did to /opt/project-neon after installing the packages. Since this script reinstalls the packages it might require a working internet connection.

<tt>neonbuild</tt> -
pbuilder/pdebuild wrapper to rebuild a neon package in a chroot. Takes the same options as pbuilder. If no pbuidler action is given pdebuild is run instead.

You can change the cmake and make options used by setting these variables in ~/.neonrc:

<tt>NEON_CMAKE_OPTS=""</tt> Here you can add additional cmake options that should be used together with the default neon options.

<tt>NEON_CMAKE_OVERRIDE=""</tt> If you set this variable cmake will ignore the default neon options and only use the ones in NEON_CMAKE_OVERRIDE.

<tt>NEON_MAKE_OVERRIDE=""</tt> If you set this variable make in neonmake will only use your options. By default make uses '-j CPUs+1'

Debugging Symbols:
The debugging symbols for every package are in it's corresponding -dbg package, so to install the debugging symbols for kdelibs you can use
<syntaxhighlight lang="bash">
sudo apt-get install project-neon-kdelibs-dbg
</syntaxhighlight>

If you are already using a nightly package of the module you want to develop for, you should remove that, and checkout the development version. For example:

<pre>
# Remove the packaged nightly version
sudo apt-get purge project-neon-kdepim

# Add below Project Neon source code repository to sources.list if you didn't use add-apt-repository
deb-src http://ppa.launchpad.net/neon/ppa/ubuntu maverick main

# Get the dependencies for building kdepim
sudo apt-get build-dep project-neon-kdepim
cd ~
# You may choose to do your development in a different folder.
cd Development
# Gets the latest version of the kdepim module.
git clone git://anongit.kde.org/kdepim
cd kdepim
# Set up neon environment
neon-env
# Shortcut provided by Project Neon to make the module
# and install it to the prefix /opt/project-neon/
neonmake
</pre>

Note that you should usually checkout a module from KDE, not an application. Most modules contain libraries shared within the module and which are necessary to build the applications in the module.

Also note that when using apt-get build-dep it will always get all build-depends, so watch out that it doesn't install a component you want to build yourself as that would overwrite your changes should you install the packages after installing your build.

== Using Project Neon for translation ==

The Project Neon nightly packages include English language strings only. Translated packages are not available. However, if you are translating KDE applications, you can install the translations from KDE SVN in your normal workflow.

<syntaxhighlight lang="bash">
cd ~
cd Translations
# The -N switch checks out only the top level directory from svn.
svn co -N svn://anonsvn.kde.org/home/kde/trunk/l10n-kde4
cd l10n-kde4
# scripts necessary to build translations.
svn up scripts
# Get the German translations
svn up de
# Generate the build files for the German language pack - if you get a message
# that revpath couldn't be found you need to install the xutils-dev package
./scripts/autogen.sh de
cd de
neon-env
neonmake
</syntaxhighlight>

After building the translations it is possible to either change the language in system settings, or run applications in another language using the environment variable <tt>KDE_LANG</tt>.

<syntaxhighlight lang="bash">
switchtonightly # or neon-env
KDE_LANG=de kmail
</syntaxhighlight>

exit the shell to reset the settings.

== Using Project Neon for documentation ==

The Project Neon nightly source packages include the official KDE User Documentation in English.

TODO: How to build user docs from SVN.

== Using Project Neon for promotion ==

If you are creating screenshots or screencasts of the latest version of KDE, project Neon is a simple and fast way of getting a default KDE4 session.

The KDE Promotion team recommends using the default background, theme, icons etc when preparing official promotional materials (unless the feature you are showing is related to configuring KDE artwork). Project Neon uses the default artwork that comes with KDE4, so it is useful for creating promo materials.

Here is a shortcut to get all available modules from the PPA:

<syntaxhighlight lang="bash">
sudo apt-get install project-neon-all
</syntaxhighlight>

The application [http://ariya.blogspot.com/2008/06/creating-fancy-screenshots-with.html screenie] is provided since Kubuntu 8.10 as <tt>screenie-qt</tt>.

<syntaxhighlight lang="bash">
sudo apt-get install screenie-qt
</syntaxhighlight>

== Contact the Team ==

You can reach the Project Neon team on IRC in
<syntaxhighlight lang="text">#project-neon on irc.freenode.net</syntaxhighlight>
by mail at <syntaxhighlight lang="text">neon@lists.launchpad.net</syntaxhighlight>
or you can ask a question on [https://answers.launchpad.net/project-neon launchpad]

If you think there is a bug in our packaging of the provided software you can file a bug on [https://bugs.launchpad.net/project-neon launchpad]

[https://wiki.kubuntu.org/Kubuntu/ProjectNeon Team page in the Kubuntu Wiki]

User:Skierpage

2011-11-14T23:16:32Z

Skierpage: /* Too many wikis! */ edits

User:Skierpage

2011-11-14T23:15:51Z

Skierpage: /* Techbase problems and what I'm going to do about them */ I brought back Getting_Started#Browsing_the_code

Getting Started

2011-11-14T23:11:43Z

Skierpage: revive the Browsing the code section from 2010, that's how people "Get started"!

<languages />
<translate>


{{Warning|These pages are currently being completely re-written to reflect the new KDE infrastructure and may not be in a consistent state. Information and commands on some page may no longer be valid and should be used with care.}}


{{Template:I18n/Language Navigation Bar|Getting_Started}}

== Introduction == 


There are many different ways to become involved in the KDE Community, ranging all the way from a simply using our software through to being a core platform developer.


You can find more general information on getting involved in KDE at the following links:
* [http://kde.org/community/getinvolved/ Getting Involved in KDE]
* [[Special:myLanguage/Contribute|Contribute to KDE]]


This section of KDE TechBase is designed to help get you started in participating in the technical side of the KDE community. It will explain to you how KDE Software is structured and built, and how you can participate by building KDE for yourself.


{{Note|'''Quickstart:''' If you are impatient to get started without understanding what you are doing then you can skip straight to using a [[Special:myLanguage/Getting_Started/Build#Scripted_Builds|Build Script]], but it is strongly recommended you read this documentation first.}}

== Using KDE Software == 


If you just want to use stable KDE software for your everyday computing needs, then you do not need to build KDE Software for yourself. You should instead use the software installer provided by your Linux distribution to install KDE package.


The best place to learn how to do this is through your distributions normal support channels, although you may find some useful information on the following pages:
* [http://www.kde.org/download/distributions.php Distributions shipping KDE]
* [[Special:myLanguage/Getting_Started/Build/Distributions|Install KDE Software on Linux and BSD Distributions]]
* [[Special:myLanguage/Projects/KDE_on_Windows/Installation|Install KDE Software on Windows]]
* Mac OS X does not currently have an installer available for KDE Software, but you can simplify building it by using [http://mac.kde.org/?id=build MacPorts or Fink]

== Getting Help == 


If you are looking for help in using the KDE Workspace or KDE Applications then please visit the [http://userbase.kde.org/ KDE UserBase].


If you have any questions or problems with building or developing KDE Software please feel free to [[Special:myLanguage/Development/Getting_Help|ask for help]]. However, be patient while waiting for a response, and try to work through the problem yourself, we aren't going to do it ''all'' for you. Working your way through and understanding why something doesn't work is a good way to learn how to do things the right way.

== Browsing the code ==
The KDE project is all free and open source. You can view its source code and make changes.

http://projects.kde.org hosts the source for many KDE-related initiatives, including [https://projects.kde.org/projects/kde KDE itself]. Choose a piece of KDE such as KDE Libraries, then click Repository to browse its source. [[Getting_Started/Sources]] explains the organization of KDE source code.

There are other utilities to browse the source code:

* http://lxr.kde.org/search lets you search the code ''(may be out of date?)''
* http://api.kde.org lets you browse API documentation generated from the code. You can search for class names, but not filenames.

== Building and Running KDE Software From Source == 


There are several possible ways to build and install KDE software and the method you choose depends on what you want to do with the software. In particular if you are only wanting to build and develop a single application you may not need to build the entire KDE Development Platform to do so. You can read more about this on the [[Special:myLanguage/Getting_Started/Build/Methods|Build Methods page]].




The following sections explain the steps you need to understand and give the instructions you need to follow to successfully build KDE Software from source:


* [[Special:myLanguage/Getting_Started/Sources|How the KDE Source Code is structured]]
* [[Special:myLanguage/Getting_Started/Build|How to Build and Install the software]]

== Development Model == 


TODO: General introduction to the dev model, release cycles, etc.


* [[Special:myLanguage/Schedules/Release_Schedules_Guide|The KDE Release Schedule]]
* [[Special:myLanguage/Development/Software_Engineering_Framework|The KDE Software Engineering Framwork]]
* [[Special:myLanguage/Policies|KDE Development Policies and Procedures to follow]]
* [[Special:myLanguage/Policies/Application_Lifecycle|The development lifecycle for a new application]]

== Development Tools == 


There are a number of [[Special:myLanguage/Development/Tools|Development Tools]] that are either required or helpful when building KDE Software. For these you will usually want to use the stable packages provided by your distribution.


You may want to use a graphical IDE for your development work:
* [[Special:myLanguage/Development/Tutorials/Using_Qt_Creator|Qt Creator]]
* [http://www.kdevelop.org/ KDevelop 4]
* [[Special:myLanguage/Development/Tools/Eclipse|Eclipse]]
* [[Special:myLanguage/Getting_Started/Using_an_IDE_with_KDE4|Using an IDE with KDE4]]

== Contributing To KDE == 


Once you have a copy of KDE built you can then start contributing back to KDE. The pages below will help you find out how you can help make KDE even better.


[[Image:Action_tool.svg|right|32px]]
* [[Special:myLanguage/Contribute|Contribute]]
* [[Special:myLanguage/Contribute/Send_Patches|Send Patches]]
* [[Special:myLanguage/Contribute/Bugsquad|Bugsquad]]


[[Category:Build_KDE]]
</translate>

User:Skierpage

2011-11-14T22:42:09Z

Skierpage: /* Techbase problems and what I'm going to do about them */ three wikis, are you f***ing kidding me?

Template:Template

2011-11-14T22:28:26Z

Skierpage: suggest only using this on templates lacking better documentation

<noinclude>
This template inserts generic information about a template, and adds the page to [[:Category:Template]]. Use it on template pages that don't have better documentation.

The content that it inserts is:
----
</noinclude>
This page is a template, editing it will affect all the pages that make use of it, so users should be especially careful when editing it. If this page is not already in the "Template" namespace, it should probably be migrated to that location.

You can include this content in another page by using the wiki markup <nowiki>{{</nowiki>{{PAGENAME}}<nowiki>}}</nowiki> (or <nowiki>{{</nowiki>{{FULLPAGENAME}}<nowiki>}}</nowiki>, if this page is not in the "Template" namespace). For more details on how to use templates see [http://en.wikipedia.org/wiki/Help:A_quick_guide_to_templates "A Quick Guide to Templates"].
<noinclude>
----
[End of content that it inserts]
</noinclude>
<includeonly>[[Category:Template]]</includeonly>

User:Skierpage

2011-11-14T22:26:14Z

Skierpage: /* TechBase problems done */ Template:Tl

User:Skierpage

2011-11-14T22:25:31Z

Skierpage: /* Techbase problems and what I'm going to do about them */ Tl: done

Template:Tl

2011-11-14T22:22:30Z

Skierpage: useful template lifted from Wikipedia

{{[[Template:{{{1}}}|{{{1}}}]]}}<noinclude>

(This is a template lifted from [http://en.wikipedia.org/wiki/Template:Tl Wikipedia].)

The '''template link''' template is a simple [[w:Macro (computer science)|macro]] [[metawikipedia:Help:template|template]] used to display a template name as a link surrounded by braces, thus showing how the template name would be used in code. Its primary use is in instruction and documentation. A short example is that the code:
::<code><nowiki>{{Tl|Example}}</nowiki></code>
:generates
::{{Tl|Example}}

[[Category:Template]]
</noinclude>

User:Skierpage

2011-11-14T22:16:14Z

Skierpage: interwiki bugs, layout bugs

User:Skierpage

2011-11-14T21:42:29Z

Skierpage: frustrated with TechBase, list of problems

Template:Template

2011-11-14T21:18:47Z

Skierpage: Actually explain what this does

<noinclude>
This template inserts boilerplate information about a template, and adds the page to [[:Category:Template]]. Use it on template pages.

The content that it inserts is:
----
</noinclude>
This page is a template, editing it will affect all the pages that make use of it, so users should be especially careful when editing it. If this page is not already in the "Template" namespace, it should probably be migrated to that location.

You can include this content in another page by using the wiki markup <nowiki>{{</nowiki>{{PAGENAME}}<nowiki>}}</nowiki> (or <nowiki>{{</nowiki>{{FULLPAGENAME}}<nowiki>}}</nowiki>, if this page is not in the "Template" namespace). For more details on how to use templates see [http://en.wikipedia.org/wiki/Help:A_quick_guide_to_templates "A Quick Guide to Templates"].
<noinclude>
----
[End of content that it inserts]
</noinclude>
<includeonly>[[Category:Template]]</includeonly>

User:Skierpage

2011-08-16T20:18:31Z

Skierpage: fix link

User:Skierpage

2011-08-16T20:11:26Z

Skierpage: mention my techbase page

I first used [[Projects/KDE_on_Windows]] but now run Kubuntu as my main operating system.
I wrote an occasional journal of my adventures in getting Kubuntu working at [http://techbase.kde.org/User:Skierpage techbase user page]

I mostly do documentation and support for Semantic MediaWiki, an extension to MediaWiki.

User:Skierpage

2011-08-16T20:08:32Z

Skierpage: I'm running Kubuntu

I first used [[Projects/KDE_on_Windows]] but now run Kubuntu as my main operating system.

I mostly do documentation and support for Semantic MediaWiki, an extension to MediaWiki.

Development/Tutorials/Metadata/Nepomuk/RDFIntroduction

2009-07-14T23:39:25Z

Skierpage: /* Other/Custom Ontologies */ mention and motivate http://www.semanticdesktop.org/ontologies/

{{Template:I18n/Language Navigation Bar|Development/Tutorials/Metadata/Nepomuk/RDFIntroduction}}

{{TutorialBrowser|
series=[[../|Nepomuk]]|
name=RDF and Ontologies in Nepomuk|
pre=|
next=[[../ResourceGenerator|Using the Nepomuk Resource Class Generator]]|
reading=[[../Resources|Resource Handling with Nepomuk]],
[[../AdvancedQueries|Advanced Queries with SPARQL]],
[http://www.kdedevelopers.org/blog/2904 Sebastian Trueg's Nepomuk Blog]|
}}

==RDF and Ontologies in Nepomuk==

This tutorial is based on the blog entry [http://www.kdedevelopers.org/node/3276 Nepomuk Appendix A - RDF for Dummies in a Nutshell] by Sebastian Trueg.

All ontologies discussed here are installed with the kdelibs. Thus, they are always in the Nepomuk store. In addition their resource URIs can easily be accessed through the [http://api.kde.org/kdesupport-api/kdesupport-apidocs/soprano/html/namespaceSoprano_1_1Vocabulary.html Soprano::Vocabulary namespace].

===[http://www.w3.org/TR/rdf-primer/ RDF - The Resource Description Framework]===

RDF describes a way of storing data. While "classical" databases are based on tables RDF data consists on triples and only triples. Each triple, called statement consists of
<pre>subject - predicate - object</pre>
The subject is a resource, the predicate is a relation, and the object is either another resource or a literal value.
A literal can be a string, integer, double, or any other type defined by [http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/datatypes.html XML Schema], and it is even possible to define custom literal types.
Thus RDF can represent statements such as "Mary - is mother of - Carl", or "Mary - was born on - 1970-02-23". These are statements about things, hence RDF is a good technology for ''metadata''.

To reduce ambiguity, resources and relations need to be uniquely identified; for example, in statement above, to identify a particular "Mary", and also to distinguish the maternal relationship from "Baghdad - is mother of - all battles".
Since RDF was born as a web technology all resources and relations are identified by a ''URI'', [http://en.wikipedia.org/wiki/Uniform_Resource_Identifier Uniform Resource Identifier]. (Hence they have a namespace often ending in a # and a name. Typically abbreviation such as foo:bar are used.) Thus, a dataset in RDF is basically a graph where resources are the nodes, predicates the links, and literals act as leaves.

RDF defines one important default property: rdf:type which allows to assign a type to a resource.

===[http://www.w3.org/TR/rdf-schema/ RDFS - The RDF Schema]===

RDFS defines a set of resources and properties extending RDF. This extension basically allows to define ontologies. RDFS defines the two important classes rdfs:Resource and rdfs:Class which introduces the distinction between instances and types, as well as properties to define type hierarchies: rdfs:subClassOf and rdfs:subPropertyOf, and rdfs:domain and rdfs:range to specify details when defining properties.

This allows to create new classes and properties much like in object oriented programming. For example:

<pre>
@PREFIX foo: <http://foo.bar/types#>

foo:Human rdf:type rdfs:Class .
foo:Woman rdf:type rdfs:Class .
foo:Woman rdfs:subClassOf foo:Human .

foo:isMotherOf rdf:type rdf:Property .
foo:isMotherOf rdfs:domain foo:Woman .
foo:isMotherOf rdfs:range foo:Human .

foo:Mary rdf:type foo:Woman .
foo:Mary foo:isMotherOf foo:Carl .
</pre>

A simple example of how to define an ontology in RDFS (using the [http://www.dajobe.org/2004/01/turtle/ Turtle] language). The last two important predicates in RDFS are rdfs:label and rdfs:comment which define human readable names and comments for any resource.

===[http://www.semanticdesktop.org/ontologies/nrl/ NRL - The Nepomuk Representation Language]===

NRL was developed in Nepomuk to further extend on RDFS. I will not go into detail and explain everything about NRL but keep to what is important with respect to KDE at the moment.

Most importantly NRL changes triples to quadruples where the fourth "parameter" is another resource defining the graph in which the statement is stored (may be empty which means to store in the "default graph"). This graph (or context as it is called in [http://soprano.sf.net/ Soprano]) is just another resource which groups a set of statements and allows to "attach" information to this set. NRL defines a set of graph types of which two are important here: nrl:InstanceBase and nrl:Ontology. The first one defines graphs that contain instances and the second one, well you guessed it, defines graphs that contain types and predicates.

To make this clearer let's extend our example with NRL stuff:

<pre>
@PREFIX foo: <http://foo.bar/types#>

foo:graph1 rdf:type nrl:Ontology .
foo:graph2 rdf:type nrl:InstanceBase .

foo:Human rdf:type rdfs:Class foo:graph1.
foo:Woman rdf:type rdfs:Class foo:graph1.
foo:Woman rdfs:subClassOf foo:Human foo:graph1 .

foo:isMotherOf rdf:type rdf:Property foo:graph1 .
foo:isMotherOf rdfs:domain foo:Woman foo:graph1 .
foo:isMotherOf rdfs:range foo:Human foo:graph1 .

foo:Mary rdf:type foo:Woman foo:graph2 .
foo:Mary foo:isMotherOf foo:Carl foo:graph2 .
</pre>

But making a distinction between ontology and instance resources is not all we gain from contexts.

===[http://www.semanticdesktop.org/ontologies/nao/ NAO - The Nepomuk Annotation Ontology]===

NAO already defines resource types and properties you already encountered in KDE: nao:Tag or nao:rating. But it also defines nao:created which is a property that assigns an [http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/datatypes.html#dateTime xls:dateTime] literal to a resource, in our case a graph. This way we store information about when a piece of information was inserted into the Nepomuk repository.

<pre>
foo:graph1 nao:created "2008-02-12T14:43.022Z"^^<http://www.w3.org/2001/XMLSchema#dateTime> .
</pre>

===[http://xesam.org/main/XesamOntology90 Xesam - The Desktop File Metadata Ontology]===

Xesam is an ontology that has been developed in regards to desktop file indexing tools such as Strigi. It tries to define classes/types and properties for most of the metadata that occurs in files on the desktop. Simple examples include id3 tags or image size or even email data such as sender or recipient.
File Metadata indexed by Strigi on the KDE desktop is stored in the Nepomuk repository using Xesam classes and properties.

===[http://www.w3.org/TR/rdf-sparql-query/ SPARQL - The Query Language for RDF]===

SPARQL is what we use to query the RDF repository. Its syntax has been designed close to SQL but since it is quite young it is by far not as powerful yet.

Anyway, this is how a simple query that retrieves the mother of Carl looks like:

<pre>
prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>
prefix foo: <http://foo.bar/types#>

select ?r where { ?r foo:isMotherOf foo:Carl . }
</pre>

Or if we take NRL into account:

<pre>
prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>
prefix foo: <http://foo.bar/types#>
prefix nrl: <http://semanticdesktop.org/ontologies/2007/08/15/nrl#>

select ?r where { graph ?g { ?r foo:isMotherOf foo:Carl . } . ?g rdf:type nrl:InstanceBase . }
</pre>

A very valuable piece of documentation is the [http://www.dajobe.org/2005/04-sparql/SPARQLreference-1.8.pdf SPARQL quick reference].

===Other/Custom Ontologies===

The ontologies mentioned here form the basis of the data in Nepomuk bu they cannot describe every aspect necessary. If you want to store your own data in Nepomuk and link it with other information it is recommended to follow the following process:

* Check if existing standard ontologies provide the classes and properties you need (or some of them). Many, including NRL and NAO, reside at http://www.semanticdesktop.org/ontologies/.
* If not, check [http://dev.nepomuk.semanticdesktop.org/wiki/OntologyMaintenance Nepomuk Ontology Drafts and Proposals] for what you need and help with the discussions and development
* If that does not help either, start your own ontology and if possible propose it as a standard.

Development/Tutorials/Metadata/Nepomuk/RDFIntroduction

2009-07-14T21:17:47Z

Skierpage: /* RDF - The Resource Description Framework */ better English

{{Template:I18n/Language Navigation Bar|Development/Tutorials/Metadata/Nepomuk/RDFIntroduction}}

{{TutorialBrowser|
series=[[../|Nepomuk]]|
name=RDF and Ontologies in Nepomuk|
pre=|
next=[[../ResourceGenerator|Using the Nepomuk Resource Class Generator]]|
reading=[[../Resources|Resource Handling with Nepomuk]],
[[../AdvancedQueries|Advanced Queries with SPARQL]],
[http://www.kdedevelopers.org/blog/2904 Sebastian Trueg's Nepomuk Blog]|
}}

==RDF and Ontologies in Nepomuk==

This tutorial is based on the blog entry [http://www.kdedevelopers.org/node/3276 Nepomuk Appendix A - RDF for Dummies in a Nutshell] by Sebastian Trueg.

All ontologies discussed here are installed with the kdelibs. Thus, they are always in the Nepomuk store. In addition their resource URIs can easily be accessed through the [http://api.kde.org/kdesupport-api/kdesupport-apidocs/soprano/html/namespaceSoprano_1_1Vocabulary.html Soprano::Vocabulary namespace].

===[http://www.w3.org/TR/rdf-primer/ RDF - The Resource Description Framework]===

RDF describes a way of storing data. While "classical" databases are based on tables RDF data consists on triples and only triples. Each triple, called statement consists of
<pre>subject - predicate - object</pre>
The subject is a resource, the predicate is a relation, and the object is either another resource or a literal value.
A literal can be a string, integer, double, or any other type defined by [http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/datatypes.html XML Schema], and it is even possible to define custom literal types.
Thus RDF can represent statements such as "Mary - is mother of - Carl", or "Mary - was born on - 1970-02-23". These are statements about things, hence RDF is a good technology for ''metadata''.

To reduce ambiguity, resources and relations need to be uniquely identified; for example, in statement above, to identify a particular "Mary", and also to distinguish the maternal relationship from "Baghdad - is mother of - all battles".
Since RDF was born as a web technology all resources and relations are identified by a ''URI'', [http://en.wikipedia.org/wiki/Uniform_Resource_Identifier Uniform Resource Identifier]. (Hence they have a namespace often ending in a # and a name. Typically abbreviation such as foo:bar are used.) Thus, a dataset in RDF is basically a graph where resources are the nodes, predicates the links, and literals act as leaves.

RDF defines one important default property: rdf:type which allows to assign a type to a resource.

===[http://www.w3.org/TR/rdf-schema/ RDFS - The RDF Schema]===

RDFS defines a set of resources and properties extending RDF. This extension basically allows to define ontologies. RDFS defines the two important classes rdfs:Resource and rdfs:Class which introduces the distinction between instances and types, as well as properties to define type hierarchies: rdfs:subClassOf and rdfs:subPropertyOf, and rdfs:domain and rdfs:range to specify details when defining properties.

This allows to create new classes and properties much like in object oriented programming. For example:

<pre>
@PREFIX foo: <http://foo.bar/types#>

foo:Human rdf:type rdfs:Class .
foo:Woman rdf:type rdfs:Class .
foo:Woman rdfs:subClassOf foo:Human .

foo:isMotherOf rdf:type rdf:Property .
foo:isMotherOf rdfs:domain foo:Woman .
foo:isMotherOf rdfs:range foo:Human .

foo:Mary rdf:type foo:Woman .
foo:Mary foo:isMotherOf foo:Carl .
</pre>

A simple example of how to define an ontology in RDFS (using the [http://www.dajobe.org/2004/01/turtle/ Turtle] language). The last two important predicates in RDFS are rdfs:label and rdfs:comment which define human readable names and comments for any resource.

===[http://www.semanticdesktop.org/ontologies/nrl/ NRL - The Nepomuk Representation Language]===

NRL was developed in Nepomuk to further extend on RDFS. I will not go into detail and explain everything about NRL but keep to what is important with respect to KDE at the moment.

Most importantly NRL changes triples to quadruples where the fourth "parameter" is another resource defining the graph in which the statement is stored (may be empty which means to store in the "default graph"). This graph (or context as it is called in [http://soprano.sf.net/ Soprano]) is just another resource which groups a set of statements and allows to "attach" information to this set. NRL defines a set of graph types of which two are important here: nrl:InstanceBase and nrl:Ontology. The first one defines graphs that contain instances and the second one, well you guessed it, defines graphs that contain types and predicates.

To make this clearer let's extend our example with NRL stuff:

<pre>
@PREFIX foo: <http://foo.bar/types#>

foo:graph1 rdf:type nrl:Ontology .
foo:graph2 rdf:type nrl:InstanceBase .

foo:Human rdf:type rdfs:Class foo:graph1.
foo:Woman rdf:type rdfs:Class foo:graph1.
foo:Woman rdfs:subClassOf foo:Human foo:graph1 .

foo:isMotherOf rdf:type rdf:Property foo:graph1 .
foo:isMotherOf rdfs:domain foo:Woman foo:graph1 .
foo:isMotherOf rdfs:range foo:Human foo:graph1 .

foo:Mary rdf:type foo:Woman foo:graph2 .
foo:Mary foo:isMotherOf foo:Carl foo:graph2 .
</pre>

But making a distinction between ontology and instance resources is not all we gain from contexts.

===[http://www.semanticdesktop.org/ontologies/nao/ NAO - The Nepomuk Annotation Ontology]===

NAO already defines resource types and properties you already encountered in KDE: nao:Tag or nao:rating. But it also defines nao:created which is a property that assigns an [http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/datatypes.html#dateTime xls:dateTime] literal to a resource, in our case a graph. This way we store information about when a piece of information was inserted into the Nepomuk repository.

<pre>
foo:graph1 nao:created "2008-02-12T14:43.022Z"^^<http://www.w3.org/2001/XMLSchema#dateTime> .
</pre>

===[http://xesam.org/main/XesamOntology90 Xesam - The Desktop File Metadata Ontology]===

Xesam is an ontology that has been developed in regards to desktop file indexing tools such as Strigi. It tries to define classes/types and properties for most of the metadata that occurs in files on the desktop. Simple examples include id3 tags or image size or even email data such as sender or recipient.
File Metadata indexed by Strigi on the KDE desktop is stored in the Nepomuk repository using Xesam classes and properties.

===[http://www.w3.org/TR/rdf-sparql-query/ SPARQL - The Query Language for RDF]===

SPARQL is what we use to query the RDF repository. Its syntax has been designed close to SQL but since it is quite young it is by far not as powerful yet.

Anyway, this is how a simple query that retrieves the mother of Carl looks like:

<pre>
prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>
prefix foo: <http://foo.bar/types#>

select ?r where { ?r foo:isMotherOf foo:Carl . }
</pre>

Or if we take NRL into account:

<pre>
prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>
prefix foo: <http://foo.bar/types#>
prefix nrl: <http://semanticdesktop.org/ontologies/2007/08/15/nrl#>

select ?r where { graph ?g { ?r foo:isMotherOf foo:Carl . } . ?g rdf:type nrl:InstanceBase . }
</pre>

A very valuable piece of documentation is the [http://www.dajobe.org/2005/04-sparql/SPARQLreference-1.8.pdf SPARQL quick reference].

===Other/Custom Ontologies===

The ontologies mentioned here form the basis of the data in Nepomuk bu they cannot describe every aspect necessary. If you want to store your own data in Nepomuk and link it with other information it is recommended to follow the following process:

* Check if the standard ontologies provide the classes and properties you need (or some of them)
* If not, check [http://dev.nepomuk.semanticdesktop.org/wiki/OntologyMaintenance Nepomuk Ontology Drafts and Proposals] for what you need and help with the discussions and development
* If that does not help either, start your own ontology and if possible propose it as a standard.

Development/Tutorials/Metadata/Nepomuk/RDFIntroduction

2009-07-14T21:12:48Z

Skierpage: /* RDF - The Resource Description Framework */ motivate uniqueness, link URI

{{Template:I18n/Language Navigation Bar|Development/Tutorials/Metadata/Nepomuk/RDFIntroduction}}

{{TutorialBrowser|
series=[[../|Nepomuk]]|
name=RDF and Ontologies in Nepomuk|
pre=|
next=[[../ResourceGenerator|Using the Nepomuk Resource Class Generator]]|
reading=[[../Resources|Resource Handling with Nepomuk]],
[[../AdvancedQueries|Advanced Queries with SPARQL]],
[http://www.kdedevelopers.org/blog/2904 Sebastian Trueg's Nepomuk Blog]|
}}

==RDF and Ontologies in Nepomuk==

This tutorial is based on the blog entry [http://www.kdedevelopers.org/node/3276 Nepomuk Appendix A - RDF for Dummies in a Nutshell] by Sebastian Trueg.

All ontologies discussed here are installed with the kdelibs. Thus, they are always in the Nepomuk store. In addition their resource URIs can easily be accessed through the [http://api.kde.org/kdesupport-api/kdesupport-apidocs/soprano/html/namespaceSoprano_1_1Vocabulary.html Soprano::Vocabulary namespace].

===[http://www.w3.org/TR/rdf-primer/ RDF - The Resource Description Framework]===

RDF describes a way of storing data. While "classical" databases are based on tables RDF data consists on triples and only triples. Each triple, called statement consists of
<pre>subject - predicate - object</pre>
The subject is a resource, the predicate is a relation, and the object is either another resource or a literal value.
A literal can be a string or an integer or a double or any other type defined by [http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/datatypes.html XML Schema] (actually it is even possible to define custom literal types).
Thus RDF can represent statements such as "Mary - is mother of - Carl", or "Mary - was born on - 1970-02-23". These are statements about things, hence RDF is a good technology for ''metadata''.

To reduce ambiguity, resources and relations need to be uniquely identified; in the example statement above, to identify a particular "Mary", and also to distinguish the family relationship from "Baghdad - is mother of - all battles".
Since RDF was born as a web technology all resources and relations are identified by a ''URI'', [http://en.wikipedia.org/wiki/Uniform_Resource_Identifier Uniform Resource Identifier]. (Hence they have a namespace often ending in a # and a name. Typically abbreviation such as foo:bar are used.) Thus, a dataset in RDF is basically a graph where resources are the nodes, predicates the links, and literals act as leaves.

RDF defines one important default property: rdf:type which allows to assign a type to a resource.

===[http://www.w3.org/TR/rdf-schema/ RDFS - The RDF Schema]===

RDFS defines a set of resources and properties extending RDF. This extension basically allows to define ontologies. RDFS defines the two important classes rdfs:Resource and rdfs:Class which introduces the distinction between instances and types, as well as properties to define type hierarchies: rdfs:subClassOf and rdfs:subPropertyOf, and rdfs:domain and rdfs:range to specify details when defining properties.

This allows to create new classes and properties much like in object oriented programming. For example:

<pre>
@PREFIX foo: <http://foo.bar/types#>

foo:Human rdf:type rdfs:Class .
foo:Woman rdf:type rdfs:Class .
foo:Woman rdfs:subClassOf foo:Human .

foo:isMotherOf rdf:type rdf:Property .
foo:isMotherOf rdfs:domain foo:Woman .
foo:isMotherOf rdfs:range foo:Human .

foo:Mary rdf:type foo:Woman .
foo:Mary foo:isMotherOf foo:Carl .
</pre>

A simple example of how to define an ontology in RDFS (using the [http://www.dajobe.org/2004/01/turtle/ Turtle] language). The last two important predicates in RDFS are rdfs:label and rdfs:comment which define human readable names and comments for any resource.

===[http://www.semanticdesktop.org/ontologies/nrl/ NRL - The Nepomuk Representation Language]===

NRL was developed in Nepomuk to further extend on RDFS. I will not go into detail and explain everything about NRL but keep to what is important with respect to KDE at the moment.

Most importantly NRL changes triples to quadruples where the fourth "parameter" is another resource defining the graph in which the statement is stored (may be empty which means to store in the "default graph"). This graph (or context as it is called in [http://soprano.sf.net/ Soprano]) is just another resource which groups a set of statements and allows to "attach" information to this set. NRL defines a set of graph types of which two are important here: nrl:InstanceBase and nrl:Ontology. The first one defines graphs that contain instances and the second one, well you guessed it, defines graphs that contain types and predicates.

To make this clearer let's extend our example with NRL stuff:

<pre>
@PREFIX foo: <http://foo.bar/types#>

foo:graph1 rdf:type nrl:Ontology .
foo:graph2 rdf:type nrl:InstanceBase .

foo:Human rdf:type rdfs:Class foo:graph1.
foo:Woman rdf:type rdfs:Class foo:graph1.
foo:Woman rdfs:subClassOf foo:Human foo:graph1 .

foo:isMotherOf rdf:type rdf:Property foo:graph1 .
foo:isMotherOf rdfs:domain foo:Woman foo:graph1 .
foo:isMotherOf rdfs:range foo:Human foo:graph1 .

foo:Mary rdf:type foo:Woman foo:graph2 .
foo:Mary foo:isMotherOf foo:Carl foo:graph2 .
</pre>

But making a distinction between ontology and instance resources is not all we gain from contexts.

===[http://www.semanticdesktop.org/ontologies/nao/ NAO - The Nepomuk Annotation Ontology]===

NAO already defines resource types and properties you already encountered in KDE: nao:Tag or nao:rating. But it also defines nao:created which is a property that assigns an [http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/datatypes.html#dateTime xls:dateTime] literal to a resource, in our case a graph. This way we store information about when a piece of information was inserted into the Nepomuk repository.

<pre>
foo:graph1 nao:created "2008-02-12T14:43.022Z"^^<http://www.w3.org/2001/XMLSchema#dateTime> .
</pre>

===[http://xesam.org/main/XesamOntology90 Xesam - The Desktop File Metadata Ontology]===

Xesam is an ontology that has been developed in regards to desktop file indexing tools such as Strigi. It tries to define classes/types and properties for most of the metadata that occurs in files on the desktop. Simple examples include id3 tags or image size or even email data such as sender or recipient.
File Metadata indexed by Strigi on the KDE desktop is stored in the Nepomuk repository using Xesam classes and properties.

===[http://www.w3.org/TR/rdf-sparql-query/ SPARQL - The Query Language for RDF]===

SPARQL is what we use to query the RDF repository. Its syntax has been designed close to SQL but since it is quite young it is by far not as powerful yet.

Anyway, this is how a simple query that retrieves the mother of Carl looks like:

<pre>
prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>
prefix foo: <http://foo.bar/types#>

select ?r where { ?r foo:isMotherOf foo:Carl . }
</pre>

Or if we take NRL into account:

<pre>
prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>
prefix foo: <http://foo.bar/types#>
prefix nrl: <http://semanticdesktop.org/ontologies/2007/08/15/nrl#>

select ?r where { graph ?g { ?r foo:isMotherOf foo:Carl . } . ?g rdf:type nrl:InstanceBase . }
</pre>

A very valuable piece of documentation is the [http://www.dajobe.org/2005/04-sparql/SPARQLreference-1.8.pdf SPARQL quick reference].

===Other/Custom Ontologies===

The ontologies mentioned here form the basis of the data in Nepomuk bu they cannot describe every aspect necessary. If you want to store your own data in Nepomuk and link it with other information it is recommended to follow the following process:

* Check if the standard ontologies provide the classes and properties you need (or some of them)
* If not, check [http://dev.nepomuk.semanticdesktop.org/wiki/OntologyMaintenance Nepomuk Ontology Drafts and Proposals] for what you need and help with the discussions and development
* If that does not help either, start your own ontology and if possible propose it as a standard.

Development/Tutorials/Metadata/Nepomuk/RDFIntroduction

2009-07-14T20:59:00Z

Skierpage: /* RDF - The Resource Description Framework */ give examples, hope that's OK

{{Template:I18n/Language Navigation Bar|Development/Tutorials/Metadata/Nepomuk/RDFIntroduction}}

{{TutorialBrowser|
series=[[../|Nepomuk]]|
name=RDF and Ontologies in Nepomuk|
pre=|
next=[[../ResourceGenerator|Using the Nepomuk Resource Class Generator]]|
reading=[[../Resources|Resource Handling with Nepomuk]],
[[../AdvancedQueries|Advanced Queries with SPARQL]],
[http://www.kdedevelopers.org/blog/2904 Sebastian Trueg's Nepomuk Blog]|
}}

==RDF and Ontologies in Nepomuk==

This tutorial is based on the blog entry [http://www.kdedevelopers.org/node/3276 Nepomuk Appendix A - RDF for Dummies in a Nutshell] by Sebastian Trueg.

All ontologies discussed here are installed with the kdelibs. Thus, they are always in the Nepomuk store. In addition their resource URIs can easily be accessed through the [http://api.kde.org/kdesupport-api/kdesupport-apidocs/soprano/html/namespaceSoprano_1_1Vocabulary.html Soprano::Vocabulary namespace].

===[http://www.w3.org/TR/rdf-primer/ RDF - The Resource Description Framework]===

RDF describes a way of storing data. While "classical" databases are based on tables RDF data consists on triples and only triples. Each triple, called statement consists of
<pre>subject - predicate - object</pre>
The subject is a resource, the predicate is a relation, and the object is either another resource or a literal value.
A literal can be a string or an integer or a double or any other type defined by [http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/datatypes.html XML Schema] (actually it is even possible to define custom literal types).
Thus RDF can represent statements such as "Mary - is mother of - Carl", or "Mary - was born on - 1970-02-23". These are statements about things, hence RDF is a good technology for ''metadata''.

Since RDF was born as a web technology all resources and relations are identified by their unique URI. (Meaning they have a namespace often ending in a # and a name. Typically abbreviation such as foo:bar are used.) Thus, a dataset in RDF is basically a graph where resources are the nodes, predicates the links, and literals act as leaves.

RDF defines one important default property: rdf:type which allows to assign a type to a resource.

===[http://www.w3.org/TR/rdf-schema/ RDFS - The RDF Schema]===

RDFS defines a set of resources and properties extending RDF. This extension basically allows to define ontologies. RDFS defines the two important classes rdfs:Resource and rdfs:Class which introduces the distinction between instances and types, as well as properties to define type hierarchies: rdfs:subClassOf and rdfs:subPropertyOf, and rdfs:domain and rdfs:range to specify details when defining properties.

This allows to create new classes and properties much like in object oriented programming. For example:

<pre>
@PREFIX foo: <http://foo.bar/types#>

foo:Human rdf:type rdfs:Class .
foo:Woman rdf:type rdfs:Class .
foo:Woman rdfs:subClassOf foo:Human .

foo:isMotherOf rdf:type rdf:Property .
foo:isMotherOf rdfs:domain foo:Woman .
foo:isMotherOf rdfs:range foo:Human .

foo:Mary rdf:type foo:Woman .
foo:Mary foo:isMotherOf foo:Carl .
</pre>

A simple example of how to define an ontology in RDFS (using the [http://www.dajobe.org/2004/01/turtle/ Turtle] language). The last two important predicates in RDFS are rdfs:label and rdfs:comment which define human readable names and comments for any resource.

===[http://www.semanticdesktop.org/ontologies/nrl/ NRL - The Nepomuk Representation Language]===

NRL was developed in Nepomuk to further extend on RDFS. I will not go into detail and explain everything about NRL but keep to what is important with respect to KDE at the moment.

Most importantly NRL changes triples to quadruples where the fourth "parameter" is another resource defining the graph in which the statement is stored (may be empty which means to store in the "default graph"). This graph (or context as it is called in [http://soprano.sf.net/ Soprano]) is just another resource which groups a set of statements and allows to "attach" information to this set. NRL defines a set of graph types of which two are important here: nrl:InstanceBase and nrl:Ontology. The first one defines graphs that contain instances and the second one, well you guessed it, defines graphs that contain types and predicates.

To make this clearer let's extend our example with NRL stuff:

<pre>
@PREFIX foo: <http://foo.bar/types#>

foo:graph1 rdf:type nrl:Ontology .
foo:graph2 rdf:type nrl:InstanceBase .

foo:Human rdf:type rdfs:Class foo:graph1.
foo:Woman rdf:type rdfs:Class foo:graph1.
foo:Woman rdfs:subClassOf foo:Human foo:graph1 .

foo:isMotherOf rdf:type rdf:Property foo:graph1 .
foo:isMotherOf rdfs:domain foo:Woman foo:graph1 .
foo:isMotherOf rdfs:range foo:Human foo:graph1 .

foo:Mary rdf:type foo:Woman foo:graph2 .
foo:Mary foo:isMotherOf foo:Carl foo:graph2 .
</pre>

But making a distinction between ontology and instance resources is not all we gain from contexts.

===[http://www.semanticdesktop.org/ontologies/nao/ NAO - The Nepomuk Annotation Ontology]===

NAO already defines resource types and properties you already encountered in KDE: nao:Tag or nao:rating. But it also defines nao:created which is a property that assigns an [http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/datatypes.html#dateTime xls:dateTime] literal to a resource, in our case a graph. This way we store information about when a piece of information was inserted into the Nepomuk repository.

<pre>
foo:graph1 nao:created "2008-02-12T14:43.022Z"^^<http://www.w3.org/2001/XMLSchema#dateTime> .
</pre>

===[http://xesam.org/main/XesamOntology90 Xesam - The Desktop File Metadata Ontology]===

Xesam is an ontology that has been developed in regards to desktop file indexing tools such as Strigi. It tries to define classes/types and properties for most of the metadata that occurs in files on the desktop. Simple examples include id3 tags or image size or even email data such as sender or recipient.
File Metadata indexed by Strigi on the KDE desktop is stored in the Nepomuk repository using Xesam classes and properties.

===[http://www.w3.org/TR/rdf-sparql-query/ SPARQL - The Query Language for RDF]===

SPARQL is what we use to query the RDF repository. Its syntax has been designed close to SQL but since it is quite young it is by far not as powerful yet.

Anyway, this is how a simple query that retrieves the mother of Carl looks like:

<pre>
prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>
prefix foo: <http://foo.bar/types#>

select ?r where { ?r foo:isMotherOf foo:Carl . }
</pre>

Or if we take NRL into account:

<pre>
prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#>
prefix foo: <http://foo.bar/types#>
prefix nrl: <http://semanticdesktop.org/ontologies/2007/08/15/nrl#>

select ?r where { graph ?g { ?r foo:isMotherOf foo:Carl . } . ?g rdf:type nrl:InstanceBase . }
</pre>

A very valuable piece of documentation is the [http://www.dajobe.org/2005/04-sparql/SPARQLreference-1.8.pdf SPARQL quick reference].

===Other/Custom Ontologies===

The ontologies mentioned here form the basis of the data in Nepomuk bu they cannot describe every aspect necessary. If you want to store your own data in Nepomuk and link it with other information it is recommended to follow the following process:

* Check if the standard ontologies provide the classes and properties you need (or some of them)
* If not, check [http://dev.nepomuk.semanticdesktop.org/wiki/OntologyMaintenance Nepomuk Ontology Drafts and Proposals] for what you need and help with the discussions and development
* If that does not help either, start your own ontology and if possible propose it as a standard.

Getting Started

2009-05-18T00:07:14Z

Skierpage: links to search source code and view API docs (from Development/FAQs/General FAQ#Can I access KDE source code online?

{{Template:I18n/Language Navigation Bar|Getting_Started}}
{{Box|Getting the Source|
[[Image:Action_down.svg|right|32px]]
* [[Getting_Started/Using Project Neon to contribute to KDE|Using Project Neon to contribute to KDE]]
* [[Getting_Started/Sources/Anonymous SVN|Anonymous SVN Quickstart Guide]]
* [[Getting_Started/Sources/Using Subversion with KDE|Using Subversion with KDE]] ''A more in depth look at accessing KDE source code with subversion, including the repository layout and working with revisions and patches.''
* [[Getting_Started/Sources/Snapshots|Daily Snapshots]]
* [http://websvn.kde.org/ Browse code online], or [http://lxr.kde.org/search search the code] or [http://www.englishbreakfastnetwork.org/ browse API docs]
|100%}}

{{Box|Building KDE|
[[Image:Action_tool.svg|right|32px]]
There are different KDE branches. For production use, we recommend using a stable version of KDE.
* [[Getting_Started/Build/KDE4|KDE 4 (Development version, TRUNK)]]
* [[Getting_Started/Build/KDE4.x|KDE 4.x (Current 4.x Release or 4.x SVN BRANCH)]]
* [[Getting_Started/Build/Stable Version|KDE 3.5 (Stable version)]]
* [[Getting_Started/Build|Other versions and FAQ]] ''Including information for building on non-linux systems''
|100%}}

{{Box|Setting up the Environment|
[[Image:Action_pen.svg|right|32px]]
After KDE has been built, you'll want a good way to launch apps and perform your regular development tasks:
* [[Getting_Started/Increased Productivity in KDE4 with Scripts|Increased Productivity in KDE4 with Scripts]]
* [[Getting_Started/Set up KDE 4 for development|Set up KDE 4 for development]]
|100%}}
[[Category:Build KDE]]

Development/FAQs/General FAQ

2009-04-30T00:26:57Z

Skierpage: /* Can I access KDE source code online? */ rephrase lxr link

====I want to start this new application. What do you advise?====
We all agree that there are plenty of KDE applications that need to be written. But there are also a lot of existing kde applications that need your help.

To see the areas where help is needed, check this page.

Before starting a new application, it's always a good idea to check www.kde-apps.org for existing applications and to ask on the kde-devel@kde.org mailing-list whether someone is already working on a similar project.

====I am a developer, how can I contribute to KDE?====
Check the open jobs from the job list, there is certainly one that you can take. KOffice and KDevelop, despite being very praised, have very few developers, so you might check there. There is no need to be a KDE core-developer to help. KDE is very modular so you can perfectely improve one area without knowing how the whole system works.

You can also ask on kde-devel if someone needs help on an application.
Use the latest version of KDE and spot things that are needed. A theme generator? A konsole schema editor? Improve a game? There is always a small feature missing. Go and implement it!

Are you familiar or attracted with a specific field? See if there is a related application that could use your help. Or write one. KDE needs more non-geek oriented applications.

====I am not a developer, how can I help?====
There are plenty of tasks that don't require development skills. Write reviews of applications for the promoting of KDE (see the kde-promo mailing-list), help the documentation team (see i18n.kde.org/doc), help the translations (see i18n.kde.org), help to filter the incoming bugs (see bugs.kde.org).

====Where can I find images of Konqi the dragon?====
The Konqi for some people SDK is at [ftp://ftp.kde.org/pub/kde/devel/konqi_sdk.tar.bz2 ftp.kde.org/pub/kde/devel/konqi_sdk.tar.bz2] 
It was posted to artist.kde.org before that site ceased to be updated.

Further images are on [http://kde.org/stuff/clipart.php KDE merchandise].

====What is the level required to contribute to KDE? What should I learn? What should I read?====
You need to know C++. Read the Qt tutorials and browse the Qt docs to get familiar with what's available with Qt. Then read the KDE tutorials and browse architecture and documentation. You can also read the KDE Book, it can not harm. But you don't have to be familiar with the whole KDE architecture to become a kde developer. Using kde's technologies is quite easy, so concentrate on what you really need, you can learn the other bits later on.
http://techbase.kde.org and doc.trolltech.com (also in your {{path|$QTDIR/doc/html}}) are invaluable resources, take advantage of them.
Then, browse the source, look for the examples directories, see how the other did code their applications. Reading and writing code is the best way to learn.

====What is SVN? How do I get KDE from SVN?====
See the [[Getting_Started/Sources/Anonymous SVN|Anonymous SVN page]].

====Can I access KDE source code online?====
Yes
* Browse http://websvn.kde.org/
* Search the source code at http://lxr.kde.org/search
* Browse API docs generated from the source code at http://www.englishbreakfastnetwork.org/

====What should I put in my .subversion/config?====
<code>[miscellany]
global-ignores = *.moc *.moc.cc *.moc.cpp config.log config.status \
config.cache *.gmo .deps .libs SunWS_cache *.lo *.la *.rpo *.la.closure \
*_la_closure.cpp *_la_closure.cc *_la_closure.cxx *.all_cc.cc *.all_cpp.cpp \
*.all_C.C *.all_cxx.cxx *_meta_unload.cc *_meta_unload.h *_meta_unload.cpp \
*_meta_unload.C *_meta_unload.cxx index.cache.bz2 .memdump Makefile.rules.in \
Makefile.calls.in Makefile.rules Makefile.calls autom4te.cache *.kidl \
*.o *.lo *.la #*# .*.rej *.rej *.pyc</code>
And to make svn diff ignore whitespace, and print function names:
<code>[helpers]
diff-cmd = /usr/local/bin/_svndiff</code>

with the following in {{path|/usr/local/bin/_svndiff}}:
<code>#!/bin/sh
exec /usr/bin/diff -b -u -p "$@"</code>

Don't forget to make {{path|/usr/local/bin/_svndiff}} executable.

====I want to put my app in KDE====
There are three requirements:
* your app must compile with the latest version of KDE (SVN trunk).
* your app must be stable.
* your app must be maintained. You will probably get a good deal of bug reports and wishes. People expect you to fix the bugs and implement the wishes that make sense.
See also the next question.

====Is it better to develop inside or outside KDE?====
As core developer Waldo Bastian explains in a copyrighted mail:
----
:Being part of KDE means that you have to work together with others. Such cooperation brings along advantages but it also brings along responsibilities.
: 
:Some of those advantages are: your code ends up on all distro's, people might fix your bugs, you get free translations and documentation, you get tons of bugreports.
: 
:On the other side there are disadvantages and responsibilities: you will have to communicate with other developers about your work, other people might make changes to your code, you will have to respect release freezes, you get tons of bugreports and people actually expect that you fix them as well (what are they smoking?), people expect you to maintain your code.
: 
:You can't chose for the advantages and ignore the responsibilities that come with it, it's a complete package, it's both or nothing.
: 
:In general it should be the author of a piece of software that chooses to put his application in SVN. We usualy don't put software in KDE SVN unless the author wishes to do so. The other way around, if the author prefers to work on his application outside SVN then that's his right as well. Unless there is a split in the actual group of people working on the application it makes no sense to fork the development of an application because of that.
: 
:BUT... by putting your code under and open source license and putting it in KDE SVN you give the world at large, as well as KDE in particular, the irrevocable right to use your code. And KDE will use that right at its discretion to protect the interests of KDE, even if that goes against the wishes of the author at that point in time.
----
It is important to know that but don't be afraid. Usually, things work very well. In 5 years, it has only happened once that a developer had his work put kept in KDE while he wanted to remove it.

====How do I get SVN access to kde?====
See full article at [[Contribute/Get_a_SVN_Account|Contribute > Get a SVN Account]].

Send a mail to sysadmin (at) kde (dot) org justify why you need SVN access. Make sure to specify your full name and e-mail address, if the From field in your mails doesn't specify them.

Please include the name of your bugs.kde.org account, if non-existent please create one so that it can be given usual developer rights. Closing bugs.kde.org reports with keywords in commit comments only works if the email address of your SVN and bugs.kde.org accounts match. You can change your bugs.kde.org address in the Bugzilla user settings.

You can currently choose between the standard SVN protocol (https using a password) and the svn+ssh using an ssh key. If you choose https, send also an encrypted password (for instance using useradd dummy ; passwd dummy ; grep dummy /etc/passwd /etc/shadow) and see also the tutorial. If you choose svn+ssh, send a public ssh key instead (e.g. {{path|~/.ssh/id_dsa.pub}})

See also [[#How do I create a SSH key?]]

If you are contributing to an application that is not yours, it is a good idea to first submitting your coding as patches to the author and let him apply them. If the author is not maintaining his application, you might become the new maintainer...

Although there is no restrictions on SVN rights, we expect you not to mess up other developers' code without their consent.
You must also respect the feature freezes of the release schedule (published on developer.kde.org)

A detailed list of rules you should follow when committing to the KDE SVN repository are listed in the KDE SVN Commit Policy.

====My app is not stable but I would like to have it in KDE====
As a first step, we can put it in playground (=kde-alpha). Develop it there and when it is ready, ask your app to be moved to the appropriate KDE package or the extragear module.

====I don't want to lose my SVN history.====
This is no longer possible with Subversion. Maybe in the future, if the server is upgraded and allows that.

====What is kdebindings?====
It contains Qt/KDE bindings for Java to use Qt/KDE classes with Java, DCOP bindings for C, Java, Perl, Python to use DCOP in those langages and XParts to embed non-KDE apps as a KPart. There are also other bindings for kde which are not maintained by KDE. Check the binding page of developer.kde.org.

====Does the feature freeze apply to playground?====
No, playground are not a released packages. The same is true for kdereview and extragear: they are not frozen and released. But if you want your app to move to a package, ask for it before the beta-release.

====Can I have a stable and an unstable KDE on the same computer?====
Yes, check the Building 2 Versions documentation.

====How do I know which version of Qt/KDE I am using?====
Launch the KDE Control Center. The splash screen includes Kde version information.

<tt>kde-config</tt> and all kde programs accept <tt>--version</tt> as argument.

====Qt-copy or Qt from trolltech.com : if one were doing a clean build of trunk, which would be preferable?====
You can use either. They are binary compatible (forward and backward). There can be, however, a few bugfixes in qt-copy over the most recent Qt release. Especially if building from qt-copy, pay attention to the apply-patches script.

====How can I checkout a single directory from a SVN module?====
Checkout the top-level dir with 'svn co -N /modulename', 'cd modulename', 'svn up admin' to get the admin/ dir and then finally checkout the dir you want with 'svn up subdir'

For instance, to get only reaktivate from playground/utils:
svn co -N /playground/utils; svn up reaktivate
Then compile as usual.

The same answer applies to the question "How do I get a single language out of kde-i18n?".

If you don't know the name of the directory you want to check out, you can browse websvn.kde.org to find it.

====How can I get one of the KDE application as a standalone tarball?====
kdesdk/scripts/svn2dist is a script to extract an application from the KDE source tree and package it as a standalone application.

====How do I close my own bug reports?====
If you reported a bug that is fixed in a new release of KDE but is still reported as open, you can close it. It might happens because your bug is the same as another one, or simply because the developer fixed something without noticing that it would correct your bug.

You can do that from your Subversion commit. To do so, append to your commit message a line like this:

<tt>BUG: XXXXX</tt> 
Where <tt>XXXXX</tt> is the bug report you want to close. If the report you're closing is adding a new feature, you can use FEATURE instead of BUG. 
Managing a bug list is a huge task for the developers and they usually have a lot of bugs listed, some being fixed already without their knowledge, some being unreproducable, some without enough information to be corrected, etc. If you can help managing and updating the list of outstanding bug, you will be gladly welcome. And you will receive an even happier welcome if you provide a patch.

====How do I create a SSH key?====
SSH makes use of two keys: a private key and a public key. You should keep the private key secret at all times and only place it on machines over which you have direct control. Public, shared, and community machines are not suitable environments to store SSH private keys. Take action to help prevent theft of your SSH private key data. Setting a password on your SSH private key will help reduce the risks involved with private key theft.

Generate a key pair for each major location you work from. This helps to reduce the impact when your key gets stolen.
When someone obtains access to your private key, your key can be abused in attempts to compromise KDE servers. Well known open source projects have been compromised this way in the past, YOU must help us to make sure that this doesn't happen with KDE servers as well. For that reason it is important to notify sysadmin (at) kde (dot) org immediately when you notice that someone may have had access to your private key for example when a computer on which it was stored has been hacked or infected with a virus, worm or trojan.

If you choose to make a backup of your SSH private key data, please ensure that any such backup is stored in a secure manner as well.

For the practical part, the following command can be used to generate a SSH private/public key pair with
ssh-keygen -t dsa
This will create a private key as {{path|~/.ssh/id_dsa}} and a public key as {{path|~/.ssh/id_dsa.pub}}.

There are times when you may want to use a key of a different name to the default, perhaps to use seperate keys for different projects. To let SSH know which key you want to use for KDE.org, you can keep a list of servers and their corresponding keys in ~/.ssh/config. For example,
Host svn.kde.org
IdentityFile ~/.ssh/id_dsa_kde
In order to use SSH to access KDE servers you need to send your public key to sysadmin (at) kde (dot) org.

====How can I monitor changes made by others?====
The kde-commits mailinglist carries automatic notifications for all changes made in the KDE SVN repository. The KDE-Commits mailinglist is very high traffic. An alternative is CommitFilter which allows you to get notification for only those areas that interest you.
[[Category:FAQs]]

Development/FAQs/General FAQ

2009-04-30T00:25:02Z

Skierpage: /* What is SVN? How do I get KDE from SVN? */

====I want to start this new application. What do you advise?====
We all agree that there are plenty of KDE applications that need to be written. But there are also a lot of existing kde applications that need your help.

To see the areas where help is needed, check this page.

Before starting a new application, it's always a good idea to check www.kde-apps.org for existing applications and to ask on the kde-devel@kde.org mailing-list whether someone is already working on a similar project.

====I am a developer, how can I contribute to KDE?====
Check the open jobs from the job list, there is certainly one that you can take. KOffice and KDevelop, despite being very praised, have very few developers, so you might check there. There is no need to be a KDE core-developer to help. KDE is very modular so you can perfectely improve one area without knowing how the whole system works.

You can also ask on kde-devel if someone needs help on an application.
Use the latest version of KDE and spot things that are needed. A theme generator? A konsole schema editor? Improve a game? There is always a small feature missing. Go and implement it!

Are you familiar or attracted with a specific field? See if there is a related application that could use your help. Or write one. KDE needs more non-geek oriented applications.

====I am not a developer, how can I help?====
There are plenty of tasks that don't require development skills. Write reviews of applications for the promoting of KDE (see the kde-promo mailing-list), help the documentation team (see i18n.kde.org/doc), help the translations (see i18n.kde.org), help to filter the incoming bugs (see bugs.kde.org).

====Where can I find images of Konqi the dragon?====
The Konqi for some people SDK is at [ftp://ftp.kde.org/pub/kde/devel/konqi_sdk.tar.bz2 ftp.kde.org/pub/kde/devel/konqi_sdk.tar.bz2] 
It was posted to artist.kde.org before that site ceased to be updated.

Further images are on [http://kde.org/stuff/clipart.php KDE merchandise].

====What is the level required to contribute to KDE? What should I learn? What should I read?====
You need to know C++. Read the Qt tutorials and browse the Qt docs to get familiar with what's available with Qt. Then read the KDE tutorials and browse architecture and documentation. You can also read the KDE Book, it can not harm. But you don't have to be familiar with the whole KDE architecture to become a kde developer. Using kde's technologies is quite easy, so concentrate on what you really need, you can learn the other bits later on.
http://techbase.kde.org and doc.trolltech.com (also in your {{path|$QTDIR/doc/html}}) are invaluable resources, take advantage of them.
Then, browse the source, look for the examples directories, see how the other did code their applications. Reading and writing code is the best way to learn.

====What is SVN? How do I get KDE from SVN?====
See the [[Getting_Started/Sources/Anonymous SVN|Anonymous SVN page]].

====Can I access KDE source code online?====
Yes
* Browse http://websvn.kde.org/
* Search the source code for identifiers at http://lxr.kde.org/ to
* Browse API docs generated from the source code at http://www.englishbreakfastnetwork.org/

====What should I put in my .subversion/config?====
<code>[miscellany]
global-ignores = *.moc *.moc.cc *.moc.cpp config.log config.status \
config.cache *.gmo .deps .libs SunWS_cache *.lo *.la *.rpo *.la.closure \
*_la_closure.cpp *_la_closure.cc *_la_closure.cxx *.all_cc.cc *.all_cpp.cpp \
*.all_C.C *.all_cxx.cxx *_meta_unload.cc *_meta_unload.h *_meta_unload.cpp \
*_meta_unload.C *_meta_unload.cxx index.cache.bz2 .memdump Makefile.rules.in \
Makefile.calls.in Makefile.rules Makefile.calls autom4te.cache *.kidl \
*.o *.lo *.la #*# .*.rej *.rej *.pyc</code>
And to make svn diff ignore whitespace, and print function names:
<code>[helpers]
diff-cmd = /usr/local/bin/_svndiff</code>

with the following in {{path|/usr/local/bin/_svndiff}}:
<code>#!/bin/sh
exec /usr/bin/diff -b -u -p "$@"</code>

Don't forget to make {{path|/usr/local/bin/_svndiff}} executable.

====I want to put my app in KDE====
There are three requirements:
* your app must compile with the latest version of KDE (SVN trunk).
* your app must be stable.
* your app must be maintained. You will probably get a good deal of bug reports and wishes. People expect you to fix the bugs and implement the wishes that make sense.
See also the next question.

====Is it better to develop inside or outside KDE?====
As core developer Waldo Bastian explains in a copyrighted mail:
----
:Being part of KDE means that you have to work together with others. Such cooperation brings along advantages but it also brings along responsibilities.
: 
:Some of those advantages are: your code ends up on all distro's, people might fix your bugs, you get free translations and documentation, you get tons of bugreports.
: 
:On the other side there are disadvantages and responsibilities: you will have to communicate with other developers about your work, other people might make changes to your code, you will have to respect release freezes, you get tons of bugreports and people actually expect that you fix them as well (what are they smoking?), people expect you to maintain your code.
: 
:You can't chose for the advantages and ignore the responsibilities that come with it, it's a complete package, it's both or nothing.
: 
:In general it should be the author of a piece of software that chooses to put his application in SVN. We usualy don't put software in KDE SVN unless the author wishes to do so. The other way around, if the author prefers to work on his application outside SVN then that's his right as well. Unless there is a split in the actual group of people working on the application it makes no sense to fork the development of an application because of that.
: 
:BUT... by putting your code under and open source license and putting it in KDE SVN you give the world at large, as well as KDE in particular, the irrevocable right to use your code. And KDE will use that right at its discretion to protect the interests of KDE, even if that goes against the wishes of the author at that point in time.
----
It is important to know that but don't be afraid. Usually, things work very well. In 5 years, it has only happened once that a developer had his work put kept in KDE while he wanted to remove it.

====How do I get SVN access to kde?====
See full article at [[Contribute/Get_a_SVN_Account|Contribute > Get a SVN Account]].

Send a mail to sysadmin (at) kde (dot) org justify why you need SVN access. Make sure to specify your full name and e-mail address, if the From field in your mails doesn't specify them.

Please include the name of your bugs.kde.org account, if non-existent please create one so that it can be given usual developer rights. Closing bugs.kde.org reports with keywords in commit comments only works if the email address of your SVN and bugs.kde.org accounts match. You can change your bugs.kde.org address in the Bugzilla user settings.

You can currently choose between the standard SVN protocol (https using a password) and the svn+ssh using an ssh key. If you choose https, send also an encrypted password (for instance using useradd dummy ; passwd dummy ; grep dummy /etc/passwd /etc/shadow) and see also the tutorial. If you choose svn+ssh, send a public ssh key instead (e.g. {{path|~/.ssh/id_dsa.pub}})

See also [[#How do I create a SSH key?]]

If you are contributing to an application that is not yours, it is a good idea to first submitting your coding as patches to the author and let him apply them. If the author is not maintaining his application, you might become the new maintainer...

Although there is no restrictions on SVN rights, we expect you not to mess up other developers' code without their consent.
You must also respect the feature freezes of the release schedule (published on developer.kde.org)

A detailed list of rules you should follow when committing to the KDE SVN repository are listed in the KDE SVN Commit Policy.

====My app is not stable but I would like to have it in KDE====
As a first step, we can put it in playground (=kde-alpha). Develop it there and when it is ready, ask your app to be moved to the appropriate KDE package or the extragear module.

====I don't want to lose my SVN history.====
This is no longer possible with Subversion. Maybe in the future, if the server is upgraded and allows that.

====What is kdebindings?====
It contains Qt/KDE bindings for Java to use Qt/KDE classes with Java, DCOP bindings for C, Java, Perl, Python to use DCOP in those langages and XParts to embed non-KDE apps as a KPart. There are also other bindings for kde which are not maintained by KDE. Check the binding page of developer.kde.org.

====Does the feature freeze apply to playground?====
No, playground are not a released packages. The same is true for kdereview and extragear: they are not frozen and released. But if you want your app to move to a package, ask for it before the beta-release.

====Can I have a stable and an unstable KDE on the same computer?====
Yes, check the Building 2 Versions documentation.

====How do I know which version of Qt/KDE I am using?====
Launch the KDE Control Center. The splash screen includes Kde version information.

<tt>kde-config</tt> and all kde programs accept <tt>--version</tt> as argument.

====Qt-copy or Qt from trolltech.com : if one were doing a clean build of trunk, which would be preferable?====
You can use either. They are binary compatible (forward and backward). There can be, however, a few bugfixes in qt-copy over the most recent Qt release. Especially if building from qt-copy, pay attention to the apply-patches script.

====How can I checkout a single directory from a SVN module?====
Checkout the top-level dir with 'svn co -N /modulename', 'cd modulename', 'svn up admin' to get the admin/ dir and then finally checkout the dir you want with 'svn up subdir'

For instance, to get only reaktivate from playground/utils:
svn co -N /playground/utils; svn up reaktivate
Then compile as usual.

The same answer applies to the question "How do I get a single language out of kde-i18n?".

If you don't know the name of the directory you want to check out, you can browse websvn.kde.org to find it.

====How can I get one of the KDE application as a standalone tarball?====
kdesdk/scripts/svn2dist is a script to extract an application from the KDE source tree and package it as a standalone application.

====How do I close my own bug reports?====
If you reported a bug that is fixed in a new release of KDE but is still reported as open, you can close it. It might happens because your bug is the same as another one, or simply because the developer fixed something without noticing that it would correct your bug.

You can do that from your Subversion commit. To do so, append to your commit message a line like this:

<tt>BUG: XXXXX</tt> 
Where <tt>XXXXX</tt> is the bug report you want to close. If the report you're closing is adding a new feature, you can use FEATURE instead of BUG. 
Managing a bug list is a huge task for the developers and they usually have a lot of bugs listed, some being fixed already without their knowledge, some being unreproducable, some without enough information to be corrected, etc. If you can help managing and updating the list of outstanding bug, you will be gladly welcome. And you will receive an even happier welcome if you provide a patch.

====How do I create a SSH key?====
SSH makes use of two keys: a private key and a public key. You should keep the private key secret at all times and only place it on machines over which you have direct control. Public, shared, and community machines are not suitable environments to store SSH private keys. Take action to help prevent theft of your SSH private key data. Setting a password on your SSH private key will help reduce the risks involved with private key theft.

Generate a key pair for each major location you work from. This helps to reduce the impact when your key gets stolen.
When someone obtains access to your private key, your key can be abused in attempts to compromise KDE servers. Well known open source projects have been compromised this way in the past, YOU must help us to make sure that this doesn't happen with KDE servers as well. For that reason it is important to notify sysadmin (at) kde (dot) org immediately when you notice that someone may have had access to your private key for example when a computer on which it was stored has been hacked or infected with a virus, worm or trojan.

If you choose to make a backup of your SSH private key data, please ensure that any such backup is stored in a secure manner as well.

For the practical part, the following command can be used to generate a SSH private/public key pair with
ssh-keygen -t dsa
This will create a private key as {{path|~/.ssh/id_dsa}} and a public key as {{path|~/.ssh/id_dsa.pub}}.

There are times when you may want to use a key of a different name to the default, perhaps to use seperate keys for different projects. To let SSH know which key you want to use for KDE.org, you can keep a list of servers and their corresponding keys in ~/.ssh/config. For example,
Host svn.kde.org
IdentityFile ~/.ssh/id_dsa_kde
In order to use SSH to access KDE servers you need to send your public key to sysadmin (at) kde (dot) org.

====How can I monitor changes made by others?====
The kde-commits mailinglist carries automatic notifications for all changes made in the KDE SVN repository. The KDE-Commits mailinglist is very high traffic. An alternative is CommitFilter which allows you to get notification for only those areas that interest you.
[[Category:FAQs]]

Development/FAQs/General FAQ

2009-04-30T00:20:52Z

Skierpage: /* How do I get SVN access to kde? */ link

====I want to start this new application. What do you advise?====
We all agree that there are plenty of KDE applications that need to be written. But there are also a lot of existing kde applications that need your help.

To see the areas where help is needed, check this page.

Before starting a new application, it's always a good idea to check www.kde-apps.org for existing applications and to ask on the kde-devel@kde.org mailing-list whether someone is already working on a similar project.

====I am a developer, how can I contribute to KDE?====
Check the open jobs from the job list, there is certainly one that you can take. KOffice and KDevelop, despite being very praised, have very few developers, so you might check there. There is no need to be a KDE core-developer to help. KDE is very modular so you can perfectely improve one area without knowing how the whole system works.

You can also ask on kde-devel if someone needs help on an application.
Use the latest version of KDE and spot things that are needed. A theme generator? A konsole schema editor? Improve a game? There is always a small feature missing. Go and implement it!

Are you familiar or attracted with a specific field? See if there is a related application that could use your help. Or write one. KDE needs more non-geek oriented applications.

====I am not a developer, how can I help?====
There are plenty of tasks that don't require development skills. Write reviews of applications for the promoting of KDE (see the kde-promo mailing-list), help the documentation team (see i18n.kde.org/doc), help the translations (see i18n.kde.org), help to filter the incoming bugs (see bugs.kde.org).

====Where can I find images of Konqi the dragon?====
The Konqi for some people SDK is at [ftp://ftp.kde.org/pub/kde/devel/konqi_sdk.tar.bz2 ftp.kde.org/pub/kde/devel/konqi_sdk.tar.bz2] 
It was posted to artist.kde.org before that site ceased to be updated.

Further images are on [http://kde.org/stuff/clipart.php KDE merchandise].

====What is the level required to contribute to KDE? What should I learn? What should I read?====
You need to know C++. Read the Qt tutorials and browse the Qt docs to get familiar with what's available with Qt. Then read the KDE tutorials and browse architecture and documentation. You can also read the KDE Book, it can not harm. But you don't have to be familiar with the whole KDE architecture to become a kde developer. Using kde's technologies is quite easy, so concentrate on what you really need, you can learn the other bits later on.
http://techbase.kde.org and doc.trolltech.com (also in your {{path|$QTDIR/doc/html}}) are invaluable resources, take advantage of them.
Then, browse the source, look for the examples directories, see how the other did code their applications. Reading and writing code is the best way to learn.

====What is SVN? How do I get KDE from SVN?====
See the [[Getting_Started/Sources/Anonymous SVN|Anonymous SVN page]].

====What should I put in my .subversion/config?====
<code>[miscellany]
global-ignores = *.moc *.moc.cc *.moc.cpp config.log config.status \
config.cache *.gmo .deps .libs SunWS_cache *.lo *.la *.rpo *.la.closure \
*_la_closure.cpp *_la_closure.cc *_la_closure.cxx *.all_cc.cc *.all_cpp.cpp \
*.all_C.C *.all_cxx.cxx *_meta_unload.cc *_meta_unload.h *_meta_unload.cpp \
*_meta_unload.C *_meta_unload.cxx index.cache.bz2 .memdump Makefile.rules.in \
Makefile.calls.in Makefile.rules Makefile.calls autom4te.cache *.kidl \
*.o *.lo *.la #*# .*.rej *.rej *.pyc</code>
And to make svn diff ignore whitespace, and print function names:
<code>[helpers]
diff-cmd = /usr/local/bin/_svndiff</code>

with the following in {{path|/usr/local/bin/_svndiff}}:
<code>#!/bin/sh
exec /usr/bin/diff -b -u -p "$@"</code>

Don't forget to make {{path|/usr/local/bin/_svndiff}} executable.

====I want to put my app in KDE====
There are three requirements:
* your app must compile with the latest version of KDE (SVN trunk).
* your app must be stable.
* your app must be maintained. You will probably get a good deal of bug reports and wishes. People expect you to fix the bugs and implement the wishes that make sense.
See also the next question.

====Is it better to develop inside or outside KDE?====
As core developer Waldo Bastian explains in a copyrighted mail:
----
:Being part of KDE means that you have to work together with others. Such cooperation brings along advantages but it also brings along responsibilities.
: 
:Some of those advantages are: your code ends up on all distro's, people might fix your bugs, you get free translations and documentation, you get tons of bugreports.
: 
:On the other side there are disadvantages and responsibilities: you will have to communicate with other developers about your work, other people might make changes to your code, you will have to respect release freezes, you get tons of bugreports and people actually expect that you fix them as well (what are they smoking?), people expect you to maintain your code.
: 
:You can't chose for the advantages and ignore the responsibilities that come with it, it's a complete package, it's both or nothing.
: 
:In general it should be the author of a piece of software that chooses to put his application in SVN. We usualy don't put software in KDE SVN unless the author wishes to do so. The other way around, if the author prefers to work on his application outside SVN then that's his right as well. Unless there is a split in the actual group of people working on the application it makes no sense to fork the development of an application because of that.
: 
:BUT... by putting your code under and open source license and putting it in KDE SVN you give the world at large, as well as KDE in particular, the irrevocable right to use your code. And KDE will use that right at its discretion to protect the interests of KDE, even if that goes against the wishes of the author at that point in time.
----
It is important to know that but don't be afraid. Usually, things work very well. In 5 years, it has only happened once that a developer had his work put kept in KDE while he wanted to remove it.

====How do I get SVN access to kde?====
See full article at [[Contribute/Get_a_SVN_Account|Contribute > Get a SVN Account]].

Send a mail to sysadmin (at) kde (dot) org justify why you need SVN access. Make sure to specify your full name and e-mail address, if the From field in your mails doesn't specify them.

Please include the name of your bugs.kde.org account, if non-existent please create one so that it can be given usual developer rights. Closing bugs.kde.org reports with keywords in commit comments only works if the email address of your SVN and bugs.kde.org accounts match. You can change your bugs.kde.org address in the Bugzilla user settings.

You can currently choose between the standard SVN protocol (https using a password) and the svn+ssh using an ssh key. If you choose https, send also an encrypted password (for instance using useradd dummy ; passwd dummy ; grep dummy /etc/passwd /etc/shadow) and see also the tutorial. If you choose svn+ssh, send a public ssh key instead (e.g. {{path|~/.ssh/id_dsa.pub}})

See also [[#How do I create a SSH key?]]

If you are contributing to an application that is not yours, it is a good idea to first submitting your coding as patches to the author and let him apply them. If the author is not maintaining his application, you might become the new maintainer...

Although there is no restrictions on SVN rights, we expect you not to mess up other developers' code without their consent.
You must also respect the feature freezes of the release schedule (published on developer.kde.org)

A detailed list of rules you should follow when committing to the KDE SVN repository are listed in the KDE SVN Commit Policy.

====My app is not stable but I would like to have it in KDE====
As a first step, we can put it in playground (=kde-alpha). Develop it there and when it is ready, ask your app to be moved to the appropriate KDE package or the extragear module.

====I don't want to lose my SVN history.====
This is no longer possible with Subversion. Maybe in the future, if the server is upgraded and allows that.

====What is kdebindings?====
It contains Qt/KDE bindings for Java to use Qt/KDE classes with Java, DCOP bindings for C, Java, Perl, Python to use DCOP in those langages and XParts to embed non-KDE apps as a KPart. There are also other bindings for kde which are not maintained by KDE. Check the binding page of developer.kde.org.

====Does the feature freeze apply to playground?====
No, playground are not a released packages. The same is true for kdereview and extragear: they are not frozen and released. But if you want your app to move to a package, ask for it before the beta-release.

====Can I have a stable and an unstable KDE on the same computer?====
Yes, check the Building 2 Versions documentation.

====How do I know which version of Qt/KDE I am using?====
Launch the KDE Control Center. The splash screen includes Kde version information.

<tt>kde-config</tt> and all kde programs accept <tt>--version</tt> as argument.

====Qt-copy or Qt from trolltech.com : if one were doing a clean build of trunk, which would be preferable?====
You can use either. They are binary compatible (forward and backward). There can be, however, a few bugfixes in qt-copy over the most recent Qt release. Especially if building from qt-copy, pay attention to the apply-patches script.

====How can I checkout a single directory from a SVN module?====
Checkout the top-level dir with 'svn co -N /modulename', 'cd modulename', 'svn up admin' to get the admin/ dir and then finally checkout the dir you want with 'svn up subdir'

For instance, to get only reaktivate from playground/utils:
svn co -N /playground/utils; svn up reaktivate
Then compile as usual.

The same answer applies to the question "How do I get a single language out of kde-i18n?".

If you don't know the name of the directory you want to check out, you can browse websvn.kde.org to find it.

====How can I get one of the KDE application as a standalone tarball?====
kdesdk/scripts/svn2dist is a script to extract an application from the KDE source tree and package it as a standalone application.

====How do I close my own bug reports?====
If you reported a bug that is fixed in a new release of KDE but is still reported as open, you can close it. It might happens because your bug is the same as another one, or simply because the developer fixed something without noticing that it would correct your bug.

You can do that from your Subversion commit. To do so, append to your commit message a line like this:

<tt>BUG: XXXXX</tt> 
Where <tt>XXXXX</tt> is the bug report you want to close. If the report you're closing is adding a new feature, you can use FEATURE instead of BUG. 
Managing a bug list is a huge task for the developers and they usually have a lot of bugs listed, some being fixed already without their knowledge, some being unreproducable, some without enough information to be corrected, etc. If you can help managing and updating the list of outstanding bug, you will be gladly welcome. And you will receive an even happier welcome if you provide a patch.

====How do I create a SSH key?====
SSH makes use of two keys: a private key and a public key. You should keep the private key secret at all times and only place it on machines over which you have direct control. Public, shared, and community machines are not suitable environments to store SSH private keys. Take action to help prevent theft of your SSH private key data. Setting a password on your SSH private key will help reduce the risks involved with private key theft.

Generate a key pair for each major location you work from. This helps to reduce the impact when your key gets stolen.
When someone obtains access to your private key, your key can be abused in attempts to compromise KDE servers. Well known open source projects have been compromised this way in the past, YOU must help us to make sure that this doesn't happen with KDE servers as well. For that reason it is important to notify sysadmin (at) kde (dot) org immediately when you notice that someone may have had access to your private key for example when a computer on which it was stored has been hacked or infected with a virus, worm or trojan.

If you choose to make a backup of your SSH private key data, please ensure that any such backup is stored in a secure manner as well.

For the practical part, the following command can be used to generate a SSH private/public key pair with
ssh-keygen -t dsa
This will create a private key as {{path|~/.ssh/id_dsa}} and a public key as {{path|~/.ssh/id_dsa.pub}}.

There are times when you may want to use a key of a different name to the default, perhaps to use seperate keys for different projects. To let SSH know which key you want to use for KDE.org, you can keep a list of servers and their corresponding keys in ~/.ssh/config. For example,
Host svn.kde.org
IdentityFile ~/.ssh/id_dsa_kde
In order to use SSH to access KDE servers you need to send your public key to sysadmin (at) kde (dot) org.

====How can I monitor changes made by others?====
The kde-commits mailinglist carries automatic notifications for all changes made in the KDE SVN repository. The KDE-Commits mailinglist is very high traffic. An alternative is CommitFilter which allows you to get notification for only those areas that interest you.
[[Category:FAQs]]

Getting Started/Sources/Anonymous SVN

2009-04-30T00:13:52Z

Skierpage: /* Also of interest */ mention http://websvn.kde.org/

{{Template:I18n/Language Navigation Bar|Getting Started/Sources/Anonymous SVN}}
{{TutorialBrowser|

series=Getting Started|

name=Getting KDE Sources Using Anonymous Subversion (SVN)|

next=[[../../Build/KDE4|Building KDE4]]|

reading=[http://svnbook.red-bean.com/ Version Control with Subversion]|
}}

== Abstract ==

For those of us that like to stay on the "bleeding edge" there's an easy way to keep a local copy of the KDE sources up-to-date — anonymous SVN.

Alternatively, install [[Getting_Started/Distribution_Packages|KDE SVN packages from your distribution]].

== Anonymous SVN ==

=== Setup Subversion ===

First, install the subversion (svn) binary if it isn't already on your computer. Your operating system should have a package for it. Alternatively you can download and compile it yourself via the [http://subversion.tigris.org/project_packages.html svn project download page]. Please read the [[Getting_Started/Sources/Using_Subversion_with_KDE|KDE Subversion tutorial]] if you are interested in how to use Subversion.

=== Checkout KDE ===

'''/trunk/''' is where the Qt4-based KDE 4 is being developed. The following is the minimal set of modules you will need to check out to build KDE and KDE software:

svn co svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs
svn co svn://anonsvn.kde.org/home/kde/trunk/KDE/kdebase

To get the oxygen icons you need to checkout:

svn co svn://anonsvn.kde.org/home/kde/trunk/kdesupport/oxygen-icons

{{tip|If your firewall doesn't allow access to arbitrary ports, substitute '''svn://anonsvn.kde.org/''' with '''svn://websvn.kde.org:443/''' above.}}

{{tip|The kdebase module has an external dependency, using svn:externals. The problem is, at this time, the externals property is set with an absolute path, pointing to anonsvn. For those using behind a firewall, this is a problem. You can change the property for your workspace, using two commands:
cs KDE
svn propset svn:externals "lib svn://websvn.kde.org:443/home/kde/trunk/KDE/kdebase/runtime/kstyles/oxygen/lib" kdebase/workspace/kwin/clients/oxygen
svn propset svn:externals "lib svn://websvn.kde.org:443/home/kde/trunk/KDE/kdebase/runtime/kstyles/oxygen/lib" kdebase/workspace/kwin/clients/ozone
This way the external property will look for the additional files in the websvn repository. There are also kdenetwork/kget/transfer-plugins/bittorrent and kdebase/workspace/kwin/clients/ozone that use svn:externals get the url with svn propget svn:externals PATH and replace anonsvn.kde.org with websvn.kde.org:443 here too.}}

'''qt-copy''' is a copy of the latest stable [http://www.trolltech.com Qt] release which works with KDE, put into SVN for convenience. It also contains patches by KDE developers that haven't found their way to Qt yet. They are recommended for those working with KDE from '''trunk'''. Instructions on how to get and configure it can be found [[Getting_Started/Build/KDE4/Prerequisites#Qt |here]].

If you wish to have a complete copy of the KDE distribution, you can simply check out the entire source tree with one command:

svn co svn://anonsvn.kde.org/home/kde/trunk/KDE

{{note|It is smarter to first use [http://websvn.kde.org/trunk/KDE The KDE Source Repository Web Viewer]. Use it to choose which modules to download. This way KDE will be quicker to install and try out.}}

If you want additional software packages you can check out the following modules within '''trunk/''' as well:

koffice
extragear
playground
kdereview

So, for example, if you want to check out koffice trunk, you can use:

svn co svn://anonsvn.kde.org/home/kde/trunk/koffice

=== Checking out trunk using snapshots ===

If you are checking out modules from '''trunk/''' you may be able to save time by using snapshots. Using Subversion trunk snapshots is described at [[../Snapshots|the Subversion snapshots tutorial page]].

=== Checking out KDE 3 instead ===

If you want to track KDE 3 rather than the bleeding edge, you may retrieve the KDE 3.5 sources using:

svn co svn://anonsvn.kde.org/home/kde/branches/arts/1.5/arts
svn co svn://anonsvn.kde.org/home/kde/branches/KDE/3.5/

And if you want the matching qt-copy:
svn co svn://anonsvn.kde.org/home/kde/branches/qt/3.3/qt-copy

=== Checking out specific releases ===

KDE modules are also tagged at each release so that it is possible to get a specific release of KDE. Most KDE modules have a tag name in the format '''tags/KDE/X.Y.Z''' (where X, Y and Z represent the exact version). The arts module (only needed for KDE 2 and KDE 3) has a different format of tag name, '''tags/arts/X.Y.Z'''. For instance to get kdelibs as it was shipped in KDE 3.5.0, do:

svn co svn://anonsvn.kde.org/home/kde/tags/KDE/3.5.0/kdelibs/

If you then want to update this checkout to KDE 3.5.5, use this command:

svn switch svn://anonsvn.kde.org/home/kde/tags/KDE/3.5.5/kdelibs

{{tip|If you used a '''/branch/''' or '''/trunk/''' path, then there is no need to switch, just run '''svn update'''.}}

=== Checking out translations ===
If you are looking for translations and other localizations, check out the appropriate language from the appropriate module: [http://websvn.kde.org/trunk/l10n-kde4 l10n-kde4] (KDE4) or [http://websvn.kde.org/trunk/l10n-kde3 l10n-kde3] (KDE3).

{{Warning|The l10n module is ''extremely'' large. Be sure you have lots of time and disk space on hand before checking out the entire l10n module. Most people only check out specific language subdirectories rather than the entire l10n module.}}

You are now ready to start building KDE! Visit [[Getting_Started/Build/KDE4|this page]] for instructions on building trunk or [[Getting_Started/Build/Stable_Version|this page]] for instruction on compiling the last stable release.

=== Checkout from behind a proxy ===

If the tip above didn't help you, and you've realized that the only way to go seems to be with http://anonsvn.kde.org/.. , then you will have to jump through a few hoops to get an svn checkout. Since http:// access is open only to developers, you will have to use svn://. Transconnect is a small piece of software that can tunnel all the traffic through your friendly neigbourhood proxy server. Get the transconnect sources from http://transconnect.sourceforge.net/ , compile it, and edit ~/.tconn/tconn.conf to point to your proxy server. Export the LD_PRELOAD variable as per the README from transconnect, and you're set to go.

== Also of interest ==
* Visit http://websvn.kde.org/ to browse the source code online.
* anonsvn.kde.org is a round robin DNS entry, which will resolve to one out of several anonsvn mirrors. The DNS setup is maintained by [mailto:sysadmin@kde.org the KDE sysadmins]. However, it might be desireable to choose a local mirror explicitely. Some mirrors are listed below, sorted by performance:
** kde.mneisen.org is located near Nuernberg, Germany, maintained by [mailto:martin.eisenhardt@mneisen.org Martin Eisenhardt]
** www.englishbreakfastnetwork.org also hosts an anonymous SVN mirror, at the University of Nijmegen, Netherlands. Maintained by [mailto:groot@kde.org Adriaan de Groot]

* There are also aliases anonsvn1.kde.org, anonsvn2.kde.org and anonsvn3.kde.org which point to the mirrors used in the DNS round robin (the above two plus another mneisen.org mirror). If you experience trouble because one mirror is broken, you can always select a specific mirror using either the fullnames above or simply anonsvn1, 2, or 3.

: Be careful when switching between mirrors. SVN remembers the server in the working copy, so to switch you have to run
svn switch --relocate svn://anonsvn.kde.org/ svn://kde.mneisen.org/
: in all your checkouts.
If you're interested in setting up a svn mirror, please contact [mailto:sysadmin@kde.org the KDE sysadmins].

[[Category:Build KDE]]

Projects/KDE on Windows/Installation

2009-01-14T04:51:39Z

Skierpage: /* Fine-tuning */ one instruction for the path to kdeglobals

{{Template:I18n/Language Navigation Bar|Projects/KDE_on_Windows/Installation}}

{{note|Perhaps actual developers should summarize status of KDE4 on Windows here, while we encourage users to describe their experiences on the [[Talk:{{PAGENAME}}|Talk page?]]}}

== KDE Installer for Windows ==
You can use this installer to download and install the
various binary packages that you need to run KDE applications on MS Windows.
KDE is free and open source so you can build all the applications "from scratch" from their source code;
but as a convenience for others,
volunteers create these precompiled packages and make them available on the Internet.

'''Disclaimer''' These are early days for KDE4 on Windows,
some programs work better than others and some fail to run altogether.

'''If you experience any problems please have a look into our [http://lists.kde.org/?l=kde-windows&r=1&w=2| mailing list].'''

You can also use the KDE Installer for Windows to install source code and the packages that you need to ''build'' KDE4 on Windows
(although if you are building KDE4 on Windows you may prefer to use the emerge system to build KDE and its requirements from latest source);
see [[Getting Started/Build/KDE4/Windows]].

=== Summary of Steps ===
* Visit http://www.winkde.org/pub/kde/ports/win32/installer/
* Download and save the latest version to a directory, e.g. <tt>C:\KDE4</tt>
* Run the installer, download what you need (see [[#Download needed packages|Download needed packages]] below).
* Add a KDEDIRS environment variable (Start > Control Panel > System > Advanced > Environment Variables, click [New] User variable and create Variable name <tt>KDEDIRS</tt> with Variable value the directory where you installed KDE4, e.g. <tt>C:\KDE4</tt>).
* Add your lib directory and your bin directory to your Windows %PATH%. (Start > Control Panel > System > Advanced > Environment Variables, double-click the Path System Variable and add "<tt>%KDEDIRS%\lib;%KDEDIRS%\bin</tt>" to your path separated by semicolon.)
* If you don't have Visual Studio 2005 installed, download and install the "Microsoft Visual C++ 2005 SP1 Redistributable Package (x86)" [http://www.microsoft.com/downloads/details.aspx?familyid=200B2FD9-AE1A-4A14-984D-389C36F85647&displaylang=en]
* Try running a Qt application in the <tt>bin</tt> directory, such as linguist.exe
* If that works, try running a KDE application such as <tt>kwrite.exe</tt>.

=== Download needed packages ===
When you run KDE-installer for the first time, you'll see the welcome screen. Since it's your first launch leave the checkbox below unchecked. Proceed to the next screen, where you choose the KDE4 installation directory. It can be anything you prefer, e.g. C:\KDE4. 
On the next screen, define who you are: End User or Developer. The End User installation installs only binary packages and libraries needed to run KDE application. Developer mode provides you with the source code for all packages needed to build KDE from scratch. If you have chosen to be a Developer, then you need to decide what compiler to use - MinGW or MSVC. In End User mode only MSVC packages are currently available. 
Proceed to the next screen and there choose the directory where all the downloaded packages will be stored. Let it be something like C:\KDE4-tmp or C:\KDE4-packages. 
The next screen will ask you to choose your internet connection type, particularly whether or not you're using a proxy. If you don't use a proxy server, just click 'Next'. If you are unsure of whether you're using proxy or if you have web browser configured to work with it properly, choose the second or the third option, according to your favourite web-browser. If you'd like to set all the settings manually - choose the last option and go ahead. 
When you click the 'Next' button the (currently, rather short) list of available servers will be loaded and you could choose the one closest to you. 
When you click 'Next' again, the list of all available pckages will be loaded and processed, providing you with the list of package groups you can select for further installation. The short description next to each group of packages should make your choice easier. Select the packages you need. Proceed to the next screen. 
Here you can see all the required dependencies, or software necessary to support the choices you've made. Click 'Next' to download them all. 
After all the packages are downloaded they'll be unpacked and processed by the installer. The final window will tell that your KDE installation for Windows is complete. 

=== Issues with KDE Installer for Windows ===
If something goes wrong during installation, for example a file can't be replaced because it is still in use, the installer may still report successful completion. If you see any alert or failure message from the installer, when it completes, quit and re-run it. 
If that didn't help and you think it's a bug, please report to [mailto:kde-windows@kde.org]

== Testing your installation ==
Navigate to the <tt>bin</tt> directory.

See if you can run the Qt program assistant.exe.
Qt programs have fewer dependencies than a full-blown KDE application.

If that works, try running a simple KDE application, such as lskat.exe from the kdegames package.

Look into your start menu: there will be a new entry KDE 4.XX.XX Release. Below that folder you can find all the apps you installed.

=== Startup, shutdown, and diagnosing problems ===
The first KDE program you run should automatically invoke <tt>kdeinit4.exe</tt>, the KDE initialisation app,
which starts background KDE applications and services like dbus-daemon, klauncher and kded4.

The first time you save or open, another background application, kioslave, will start.

These background KDE applications and services remain running after you close KDE applications. If you want you can shut them down by running <tt>kdeinit4 --terminate</tt> from a command prompt.

You can run <tt>kdeinit4 --list</tt> from a command prompt to see what processes are running. <tt>kdeinit4</tt> has other useful options documented elsewhere.

== Fine-tuning ==
=== Common step: editing the kdeglobals file ===
Unless otherwise stated you make all the setting changes below by editing the <tt>kdeglobals</tt> file in the directory <tt>%APPDATA%\.kde\share\config\</tt> with any text editor (such as kwrite).
(Note that for versions older than 4.0.85 the file is in <tt>%USERPROFILE%\.kde\share\config\kdeglobals</tt>.)
%APPDATA% (and %USERPROFILE%) is different for different Windows users/versions/locales; in a command prompt, entering the command <tt>cd %APPDATA%</tt> will switch to it, effectively telling you what it is.

===Set Oxygen style for widgets===
The default KDE widget style on Windows is the native one. The Oxygen style installs with basic KDE installation (as a plugin library %KDEROOT%\lib\kde4\plugins\styles\oxygen.dll), so it can be used as well. To set it for a single user:
# edit kdeglobals
#locate the General section (a line containing the text "[General]"). If there is no General section, create one.
#Within the General section ([General]), edit the line containing <tt>widgetStyle=....</tt> so that it reads <tt>widgetStyle=oxygen</tt>. If there is no such <tt>widgetStyle=...</tt> line, create it.
Newly started applications should be displayed with the Oxygen style now.

===Set Tahoma (Windows default font) for widgets===
To set it for a single user:
# edit kdeglobals
#locate the General section (a line containing the text "[General]"). If there is no General section, create one.
#Within the General section ([General]), add these two lines:
<tt>font=Tahoma 
menuFont=Tahoma</tt>

Newly started applications should use this font now.
Note: this works for any font you have installed.

===Change the mouse to Double Click===
To change the mouse to use double click:
#Add a new section with a line: 
<tt>[KDE] 
SingleClick=false</tt> 
Newly started applications (Dolphin and Konqueror) should use double click now.
===Change locale and country settings===
To change locale setting:
#Add a new section with the line: 
<tt>[Locale] 
Country=** 
Language=**</tt> 
Replace ** with your lowercase [http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 alpha-2 country code], e.g. pl for Poland; of course, you need to install your language localization package.
===Change native/KDE file dialogs===
To chose native or KDE file dialog:
#Add a new section with the lines: 
<tt> [KFileDialog Settings] 
Native=false</tt> 
Either set Native to true or false.

== Status ==
Using kdewin-installer-gui-0.9.3.exe to install 4.1.3 packages:
* starting a KDE program correctly starts dbus-daemon.exe
* many games run
* choosing File > Open correctly starts klauncher.exe, kioslave.exe and kded4.exe, and runs kbuildsycoca4.exe as needed.
* Full-text search in khelpcenter does not work because Perl scripts are disabled.
* Many applications have a generic icon in Windows Explorer.
* Multimedia support should work, although video support might be missing (from the backend)

General notes:
* There are many other KDE programs that are not part of KDE 4.0.0 and are not currently packaged for MS Windows.
* By design, KDE-windows does not provide the full-blown KDE desktop, a preview on the plasma shell replacement will be available in 4.1.2 - Nevertheless this does not rely on kwin/X11 which means that desktop effects are not available
* Some KDE programs use UNIX-specific features, such as konsole's use of pseudo-terminals, and thus are difficult (read: currently impossible) to port to MS Windows.

=== Package status and contents ===
{| border="0" cellpadding="2"
|-valign="top"
!package
!status
!contains applications
|-valign="top"
|amarok
|packaged
|Amarok music player
|-valign="top"
|Digikam
|packaged
|Photo management
|-valign="top"
|kdebase-apps
|packaged
|Konqueror, Dolphin, KWrite, folderview etc.
|-valign="top"
|kdebase-workspace
|packaged
|Plasma, Wallpapers, Solid, etc.
|-valign="top"
|kdeedu
|packaged
|Marble, Parley, KStars, KHangman, etc.
|-valign="top"
|kdegames
|packaged
|Kgoldrunner, Kpat, KMahjongg, etc.
|-valign="top"
|kdegraphics
|packaged
|Okular, kolourpaint, gwenview, etc.
|-valign="top"
|kdemultimedia
|packaged
|JuK, etc.
|-valign="top"
|kdenetwork
|packaged
|Kopete, KGet, etc.
|-valign="top"
|kdepim
|not packaged
|KMail, AKregator, etc.
|-valign="top"
|kdesdk
|packaged
|Kate, Umbrello, etc.
|-valign="top"
|kdetoys
|packaged
|KTeatime, etc.
|-valign="top"
|kdeutils
|packaged
|KGpg, KWallet, Okteta, etc.
|-valign="top"
|koffice
|packaged
|KWord, Krita, Karbon, etc. (Beta 3)
|-valign="top"
|ktorrent
|packaged
|the KTorrent utility
|}

[[Category: MS Windows]]

Projects/KDE on Windows/Installation

2008-11-12T06:20:29Z

Skierpage: /* Testing your installation */ add a section about startup, shutdown, and diagnosing problems

{{Template:I18n/Language Navigation Bar|Projects/KDE_on_Windows/Installation}}

{{note|Perhaps actual developers should summarize status of KDE4 on Windows here, while we encourage users to describe their experiences on the [[Talk:{{PAGENAME}}|Talk page?]]}}

== KDE Installer for Windows ==
You can use this installer to download and install the
various binary packages that you need to run KDE applications on MS Windows.
KDE is free and open source so you can build all the applications "from scratch" from their source code;
but as a convenience for others,
volunteers create these precompiled packages and make them available on the Internet.

'''Disclaimer''' These are early days for KDE4 on Windows,
some programs work better than others and some fail to run altogether.

'''If you experience any problems please have a look into our [http://lists.kde.org/?l=kde-windows&r=1&w=2| mailing list].'''

You can also use the KDE Installer for Windows to install source code and the packages that you need to ''build'' KDE4 on Windows
(although if you are building KDE4 on Windows you may prefer to use the emerge system to build KDE and its requirements from latest source);
see [[Getting Started/Build/KDE4/Windows]].

=== Summary of Steps ===
* Visit http://www.winkde.org/pub/kde/ports/win32/installer/
* Download and save the latest version to a directory, e.g. <tt>C:\KDE4</tt>
* Run the installer, download what you need (see [[#Download needed packages|Download needed packages]] below).
* Add a KDEDIRS environment variable (Start > Control Panel > System > Advanced > Environment Variables, click [New] User variable and create Variable name <tt>KDEDIRS</tt> with Variable value the directory where you installed KDE4, e.g. <tt>C:\KDE4</tt>).
* Add your lib directory and your bin directory to your Windows %PATH%. (Start > Control Panel > System > Advanced > Environment Variables, double-click the Path System Variable and add "<tt>%KDEDIRS%\lib;%KDEDIRS%\bin</tt>" to your path separated by semicolon.)
* If you don't have Visual Studio 2005 installed, download and install the "Microsoft Visual C++ 2005 SP1 Redistributable Package (x86)" [http://www.microsoft.com/downloads/details.aspx?familyid=200B2FD9-AE1A-4A14-984D-389C36F85647&displaylang=en]
* Try running a Qt application in the <tt>bin</tt> directory, such as linguist.exe
* If that works, try running a KDE application such as <tt>kwrite.exe</tt>.

=== Download needed packages ===
For the first time when you run KDE-installer you'll see the welcome screen. Since it's your first launch - leave the checkbox below unchecked. Proceed to the next screen, where you are to choose the KDE4 installation directory. It can be any of your favor, e.g. C:\KDE4. 
On the next screen you are to define who you are - End User ot a Developer. The End user installation installs only binary packages and libraries needed to run KDE application. Developer mode provides you with the source code for all packages needed to build KDE from scratch. If you have chosen to be a Developer, then you need to decide what compiler to use - MinGW or MSVC. In End User mode there're only MSVC packages currently available. 
Proceed to the next screen and there you're to choose the directory where all the downloaded packages will be stored. Let it be something like C:\KDE4-tmp or C:\KDE4-packages. 
The next screen will ask you to choose the type of your connection to the internet. It's usefull when you are using proxy. If you don't use proxy, then just click 'Next'. If you are unsure of whether you're using proxy or if you have web browser configured to work with it properly - choose the second or the third option, according to your favourite web-browser. If you'd like to set all the settings manually - choose the last option and go ahead. 
When you click the 'Next' button the list of available servers will be loaded and you could choose the one, which is closer to you. Currently the list isn't very long, though. 
If you click 'Next' again the list of all available pckages will be loaded and processed to provide you with the list of package groups that you're able to select for further installation. There short description next to each group of packages for you make your choice easier. Select the packages you need. Proceed to the next screen. 
Here you can see all the required dependencies. Just click 'Next' to download them all. 
After all the packages are downloaded they'll be unpacked and processed by the installer. The final window will tell that your KDE installation for windows is complete. 

=== Issues with KDE Installer for Windows ===
If something goes wrong during installation, for example a file can't be replaced because it is still in use, the installer may still report successful completion. If you see any alert or failure message from the installer, when it completes quit and re-run it. 
If that didn't help and you think it's a bug, please report to [mailto:kde-windows@kde.org]

== Testing your installation ==
Navigate to the <tt>bin</tt> directory.

See if you can run the Qt program assistant.exe.
Qt programs have fewer dependencies than a full-blown KDE application.

If that works, try running a simple KDE application, such as lskat.exe from the kdegames package.

Look into your start menu: there will be a new entry KDE 4.XX.XX Release. Below that folder you can find all the apps you installed.

=== Startup, shutdown, and diagnosing problems ===
The first KDE program you run should automatically invoke <tt>kdeinit4.exe</tt>, the KDE initialisation app,
which starts background KDE applications and services like dbus-daemon, klauncher and kded4.

The first time you save or open, another background application kioslave will start.

These background KDE applications and services remain running after you close KDE applications. If you want you can shut them down by running <tt>kdeinit4 --terminate</tt> from a command prompt.

You can run <tt>kdeinit4 --list</tt> from a command prompt to see what processes are running, and it has other useful options.

== Fine-tuning ==
===Set Oxygen style for widgets===
The default KDE widget style on Windows is the native one. You already have Oxygen style installed (which is a plugin library %KDEROOT%\lib\kde4\plugins\styles\oxygen.dll), so it can be used as well. To set it for a single user:
#edit <tt>%APPDATA%\.kde\share\config\kdeglobals</tt> (for versions older than 4.0.85 use <tt>%USERPROFILE%\.kde\share\config\kdeglobals</tt>) with any text editor (e.g. kwrite) Note: `cd %UserPROFILE%` will change to the right directory, effectively telling you what %UserPROFILE% expands to, such as "C:\Documents and Settings\mark"
#locate the General section (a line containing the text "[General]"). If there is no General section, create one.
#Within the General section ([General]), edit the line containing <tt>widgetStyle=....</tt> so that it reads <tt>widgetStyle=oxygen</tt>. If there is no such <tt>widgetStyle=...</tt> line, create it.
Newly started applications should be displayed with Oxygen style now.

===Set Tahoma (WIndows default font) for widgets===
To set it for a single user:
#edit <tt>%APPDATA%\.kde\share\config\kdeglobals</tt> (for versions older than 4.0.85 use <tt>%USERPROFILE%\.kde\share\config\kdeglobals</tt>) with any text editor (e.g. kwrite) Note: `cd %UserPROFILE%` will change to the right directory, effectively telling you what %UserPROFILE% expands to, such as "C:\Documents and Settings\mark"
#locate the General section (a line containing the text "[General]"). If there is no General section, create one.
#Within the General section ([General]), add these two lines:
<tt>font=Tahoma 
menuFont=Tahoma</tt>

Newly started applications should use this font now.
Note: this works for any font you have installed.

===Change the mouse to Double Click===
To change the mouse to use double click:
#Add a new section with a line: 
<tt>[KDE] 
SingleClick=false</tt> 
Newly started applications (Dolphin and Konqueror) should use double click now.
===Change locale and country settings===
To change locale setting:
#Add a new section with the line: 
<tt>[Locale] 
Country=** 
Language=**</tt> 
Replace ** with your lowercase [http://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 alpha-2 country code], e.g. pl for Poland, of course you need to install your language localization package.
===Change native/KDE file dialogs===
To chose native or KDE file dialog:
#Add a new section with the lines: 
<tt> [KFileDialog Settings] 
Native=false</tt> 
Either set Native to true or false.

== Status ==
Using kdewin-installer-gui-0.9.3.exe to install 4.1.00 packages:
* starting a KDE program correctly starts dbus-daemon.exe
* many games run
* choosing File > Open correctly starts klauncher.exe, kioslave.exe and kded4.exe, and runs kbuildsycoca4.exe as needed.
* Full-text search in khelpcenter does not work because Perl scripts are disabled.
* Many applications have a generic icon in Windows Explorer.
* Multimedia support should work, although video support might be missing(from the backend)

General notes:
* There are many other KDE programs that are not part of KDE 4.0.0 and are not currently packaged for MS Windows.
* By design, KDE-windows does not provide the full-blown KDE desktop, a preview on the plasma shell replacement will be available in 4.1.2 - Nevertheless this does not rely on kwin/X11 which means that desktop effects are not available
* Some KDE programs use UNIX-specific features, such as konsole's use of pseudo-terminals, and thus are difficult(read: currently impossible) to port to MS Windows.

=== Package status and contents ===
{| border="0" cellpadding="2"
|-valign="top"
!package
!status
!contains applications
|-valign="top"
|amarok
|packaged
|Amarok music player(Beta 1)
|-valign="top"
|Digikam
|packaged
|Photo management
|-valign="top"
|kdebase-apps
|packaged
|Konqueror, Dolphin, KWrite, folderview etc.
|-valign="top"
|kdebase-workspace
|packaged
|Plasma, Wallpapers, Solid, etc.
|-valign="top"
|kdeedu
|packaged
|Marble, Parley, KStars, KHangman, etc.
|-valign="top"
|kdegames
|packaged
|Kgoldrunner, Kpat, KMahjongg, etc.
|-valign="top"
|kdegraphics
|packaged
|Okular, kolourpaint, etc.
|-valign="top"
|kdemultimedia
|packaged
|JuK, etc.
|-valign="top"
|kdenetwork
|packaged
|Kopete, KGet, etc.
|-valign="top"
|kdepim
|packaged
|KMail, AKregator, etc.
|-valign="top"
|kdesdk
|packaged
|Kate, Umbrello, etc.
|-valign="top"
|kdetoys
|packaged
|KTeatime, etc.
|-valign="top"
|kdeutils
|packaged
|KGpg, KWallet, Okteta, etc.
|-valign="top"
|koffice
|packaged
|KWord, Krita, Karbon, etc. (Beta 1)
|-valign="top"
|ktorrent
|packaged
|the KTorrent utility
|}

[[Category: MS Windows]]

Projects/KDE on Windows/Installation

2008-05-19T20:22:10Z

Skierpage: /* Status */ mention Konsole

{{Template:I18n/Language Navigation Bar|Projects/KDE_on_Windows/Installation}}

{{note|Perhaps actual developers should summarize status of KDE4 on Windows here, while we encourage users to describe their experiences on the [[Talk:{{PAGENAME}}|Talk page?]]}}

== KDE Installer for Windows ==
You can use this installer to download and install the
various binary packages that you need to run KDE applications on MS Windows.
KDE is free and open source so you can build all the applications "from scratch" from their source code;
but as a convenience for others,
volunteers create these precompiled packages and make them available on the Internet.

'''Disclaimer''' These are early days for KDE4 on Windows,
some programs work better than others and some fail to run altogether.

'''If you experience any problems please have a look into our [http://lists.kde.org/?l=kde-windows&r=1&w=2| mailing list].'''

You can also use the KDE Installer for Windows to install source code and the packages that you need to ''build'' KDE4 on Windows
(although if you are building KDE4 on Windows you may prefer to use the emerge system to build KDE and its requirements from latest source);
see [[Getting Started/Build/KDE4/Windows]].

=== Summary of Steps ===
* Visit http://www.winkde.org/pub/kde/ports/win32/installer/
* Download and save the latest version to a directory, e.g. <tt>C:\KDE4</tt>
* Run the installer, download what you need (see [[#Download needed packages|Download needed packages]] below).
* Add a KDEDIRS environment variable (Start > Control Panel > System > Advanced > Environment Variables, click [New] User variable and create Variable name <tt>KDEDIRS</tt> with Variable value the directory where you installed KDE4, e.g. <tt>C:\KDE4</tt>).
* Add your lib directory, <tt>%KDEDIRS\lib</tt>, and your bin directory, <tt>%KDEDIRS\bin</tt>, to your Windows %PATH%. (Start > Control Panel > System > Advanced > Environment Variables, double-click the Path System Variable and add this to your path separated by semicolon.)
* If you don't have Visual Studio 2005 installed, download and install the "Microsoft Visual C++ 2005 SP1 Redistributable Package (x86)" [http://www.microsoft.com/downloads/details.aspx?familyid=200B2FD9-AE1A-4A14-984D-389C36F85647&displaylang=en]
* Try running a Qt application in the <tt>bin</tt> directory, such as linguist.exe
* If that works, try running a KDE application such as <tt>kwrite.exe</tt>.

=== Download needed packages ===
A single program in the The K Desktop Environment depends on many other libraries and packages; that is why each .exe is comparatively small.
The KDE Installer for Windows has some awareness of dependencies,
but not complete.
So, the first few times you try to run an application you may see alerts about missing DLLs.

If you do not intend to build from source, do not click "all" and do not click "src", as you do not need to download the source for each package. ''Unclear whether you need lib for each''.

There are two development systems for KDE on Windows,
Microsoft's Visual C and [http://en.wikipedia.org/wiki/MinGW MinGW].
Even if you are only running binaries and do not intend to build KDE4 yourself,
you need to choose between these because of the provided runtime environments.
You're free to decide which to take.

The KDE programs themselves are organized into several groups: kdeedu, kdegames, and kdegraphics.

Here are some of the minimal packages you need to run a KDE application:
: dbus-msvc, kdebase-msvc, kdewin32-msvc, qt-msvc, vcredist, ??

The Dependencies tab for a particular package lists some of the additional packages it needs.
However, the dependency checking currently only works for first-level dependencies
Other dependencies are not easy to determine in advance.
For example, if you install kdegames only with its dependencies,
you will not be able to start it because you also need libstreamanalyze
(for which you have to install the strigi package).
rhabacker: This is fixed in installer version > 0.8.4.

[[Getting_Started/Build/KDE4/Windows/3rd-party_libraries]] is a more complete list of libraries that a full installation needs.

=== Issues with KDE Installer for Windows ===
If you find an issue, please report to [mailto:kde-windows@kde.org].

==== Successful? completion ====
If something goes wrong during installation, for example a file can't be replaced because it is still in use, the installer may still report successful completion. If you see any alert or failure message from the installer, when it completes quit and re-run it.

== Testing your installation ==
Navigate to the <tt>bin</tt> directory.

See if you can run the Qt program assistant.exe.
Qt programs have fewer dependencies than a full-blown KDE application.

If that works, try running a simple KDE application, such as lskat.exe from the kdegames package.

The first KDE application you run will start a console window in order to run the [http://en.wikipedia.org/wiki/D-Bus D-Bus daemon].

== Fine-tuning ==
===Set Oxygen style for widgets===
The default KDE widget style on Windows is the native one. You already have Oxygen style installed (which is a plugin library %KDEROOT%\lib\kde4\plugins\styles\oxygen.dll), so it can be used as well. To set it for a single user:
#edit <tt>%UserPROFILE%\.kde\share\config\kdeglobals</tt> with any text editor (e.g. kwrite) Note: `cd %UserPROFILE%` will change to the right directory, effectively telling you what %UserPROFILE% expands to, such as "C:\Documents and Settings\mark"
#locate the General section (a line containing the text "[General]"). If there is no General section, create one.
#Within the General section ([General]), edit the line containing <tt>widgetStyle=....</tt> so that it reads <tt>widgetStyle=oxygen</tt>. If there is no such <tt>widgetStyle=...</tt> line, create it.
Newly started applications should be displayed with Oxygen style now.

== Status ==
Using kdewin-installer-gui-0.8.6.exe to install 4.00.60 packages:
* starting a KDE program correctly starts dbus-daemon.exe
* many games run
* choosing File > Open correctly starts klauncher.exe, kioslave.exe and kded4.exe, and runs kbuildsycoca4.exe as needed.
* Full-text search in khelpcenter does not work because Perl scripts are disabled.
* Many applications have a generic icon in Windows Explorer.
* Applications that try to play sounds might display an alert about "Multimedia Backend" problems. This requires the Windows backend for [http://phonon.kde.org/ Phonon]. The amarok package installs an experimental Windows phonon backend. Amarok plays music!!

General notes:
* There are many other KDE programs that are not part of KDE 4.0.0 and are not currently packaged for MS Windows, such as KOffice 2.
* By design, KDE-windows does not provide the full-blown KDE desktop, thus no KWin composite manager, KDE-specific "start" menus, Plasma desktop, etc.
* Some KDE programs use UNIX-specific features, such as konsole's use of pseudo-terminals, and thus are difficult to port to MS Windows.

=== Package status and contents ===
{| border="0" cellpadding="2"
|-valign="top"
!package
!status
!contains applications
|-valign="top"
|kdebase
|packaged
|Konqueror, Dolphin, KWrite, etc.
|-valign="top"
|kdegames
|packaged
|Kgoldrunner, Kpat, KMahjongg, etc.
|-valign="top"
|kdesdk
|packaged
|Kate, Umbrello, etc.
|-valign="top"
|kdetoys
|packaged
|KTeatime, etc.
|-valign="top"
|kdeedu
|packaged
|Marble, Parley, KStars, KHangman, etc.
|-valign="top"
|kdegraphics
|packaged
|Okular, kolourpaint, etc.
|-valign="top"
|amarok
|packaged
|Amarok music player
|-valign="top"
|koffice
|packaged
|KWord, Krita, Karbon, etc.
|-valign="top"
|kdepim
|not building
|KMail, AKregator, etc.
|-valign="top"
|kdenetwork
|not building
|Kopete, KGet, etc.
|-valign="top"
|kdeutils
|not packaged
|KGpg, KWallet, etc.
|-valign="top"
|ktorrent
|packaged
|the KTorrent utility
|}

== Deprecated: post-install steps ==
After manual installation of a package one has to run the included post-install.bat script (inside the manifest folder). This batch file includes at least the following steps.

===Run update-mime-database===
Be sure that you have no KDE-related applications running: run the Windows Task Manager (taskmgr.exe), switch to its Processes tab, and kill all occurences of dbus-daemon.exe, kded4.exe, kioslave.exe and klauncher.exe (and all other KDE apps).

Open a Windows command prompt (cmd.exe) and navigate to the directory where you installed KDE. Say you installed KDE to C:\KDE4, then run from the cmd.exe window:
C:\KDE4> '''bin\update-mime-database C:\KDE4\share\mime'''
This will give you a lot of warning message. Most of them you can easily ignore; even if you should set [[KDE_System_Administration/Environment_Variables#XDG_DATA_HOME|XDG_DATA_HOME]] or [[KDE_System_Administration/Environment_Variables#XDG_DATA_DIRS|XDG_DATA_DIRS]] it worked perfectly. If it says you should rerun update-mime-database as root then you're not within your installation directory.

===Run kbuildsyscoca4===
After finishing the previous step, run
C:\KDE4> '''bin\kbuildsycoca4 --noincremental'''
If this tells you that your disk is full (which is most probably not the case) you have still some executables from KDE running. Please close them and try again.

Excuse us for the inconvenience — we hope for a better solution in the next release.

[[Category: MS Windows]]

Projects/KDE on Windows/Installation

2008-05-19T19:37:29Z

Skierpage: /* Package status and contents */ KOffice now packaged, KTorrent available

{{Template:I18n/Language Navigation Bar|Projects/KDE_on_Windows/Installation}}

{{note|Perhaps actual developers should summarize status of KDE4 on Windows here, while we encourage users to describe their experiences on the [[Talk:{{PAGENAME}}|Talk page?]]}}

== KDE Installer for Windows ==
You can use this installer to download and install the
various binary packages that you need to run KDE applications on MS Windows.
KDE is free and open source so you can build all the applications "from scratch" from their source code;
but as a convenience for others,
volunteers create these precompiled packages and make them available on the Internet.

'''Disclaimer''' These are early days for KDE4 on Windows,
some programs work better than others and some fail to run altogether.

'''If you experience any problems please have a look into our [http://lists.kde.org/?l=kde-windows&r=1&w=2| mailing list].'''

You can also use the KDE Installer for Windows to install source code and the packages that you need to ''build'' KDE4 on Windows
(although if you are building KDE4 on Windows you may prefer to use the emerge system to build KDE and its requirements from latest source);
see [[Getting Started/Build/KDE4/Windows]].

=== Summary of Steps ===
* Visit http://www.winkde.org/pub/kde/ports/win32/installer/
* Download and save the latest version to a directory, e.g. <tt>C:\KDE4</tt>
* Run the installer, download what you need (see [[#Download needed packages|Download needed packages]] below).
* Add a KDEDIRS environment variable (Start > Control Panel > System > Advanced > Environment Variables, click [New] User variable and create Variable name <tt>KDEDIRS</tt> with Variable value the directory where you installed KDE4, e.g. <tt>C:\KDE4</tt>).
* Add your lib directory, <tt>%KDEDIRS\lib</tt>, and your bin directory, <tt>%KDEDIRS\bin</tt>, to your Windows %PATH%. (Start > Control Panel > System > Advanced > Environment Variables, double-click the Path System Variable and add this to your path separated by semicolon.)
* If you don't have Visual Studio 2005 installed, download and install the "Microsoft Visual C++ 2005 SP1 Redistributable Package (x86)" [http://www.microsoft.com/downloads/details.aspx?familyid=200B2FD9-AE1A-4A14-984D-389C36F85647&displaylang=en]
* Try running a Qt application in the <tt>bin</tt> directory, such as linguist.exe
* If that works, try running a KDE application such as <tt>kwrite.exe</tt>.

=== Download needed packages ===
A single program in the The K Desktop Environment depends on many other libraries and packages; that is why each .exe is comparatively small.
The KDE Installer for Windows has some awareness of dependencies,
but not complete.
So, the first few times you try to run an application you may see alerts about missing DLLs.

If you do not intend to build from source, do not click "all" and do not click "src", as you do not need to download the source for each package. ''Unclear whether you need lib for each''.

There are two development systems for KDE on Windows,
Microsoft's Visual C and [http://en.wikipedia.org/wiki/MinGW MinGW].
Even if you are only running binaries and do not intend to build KDE4 yourself,
you need to choose between these because of the provided runtime environments.
You're free to decide which to take.

The KDE programs themselves are organized into several groups: kdeedu, kdegames, and kdegraphics.

Here are some of the minimal packages you need to run a KDE application:
: dbus-msvc, kdebase-msvc, kdewin32-msvc, qt-msvc, vcredist, ??

The Dependencies tab for a particular package lists some of the additional packages it needs.
However, the dependency checking currently only works for first-level dependencies
Other dependencies are not easy to determine in advance.
For example, if you install kdegames only with its dependencies,
you will not be able to start it because you also need libstreamanalyze
(for which you have to install the strigi package).
rhabacker: This is fixed in installer version > 0.8.4.

[[Getting_Started/Build/KDE4/Windows/3rd-party_libraries]] is a more complete list of libraries that a full installation needs.

=== Issues with KDE Installer for Windows ===
If you find an issue, please report to [mailto:kde-windows@kde.org].

==== Successful? completion ====
If something goes wrong during installation, for example a file can't be replaced because it is still in use, the installer may still report successful completion. If you see any alert or failure message from the installer, when it completes quit and re-run it.

== Testing your installation ==
Navigate to the <tt>bin</tt> directory.

See if you can run the Qt program assistant.exe.
Qt programs have fewer dependencies than a full-blown KDE application.

If that works, try running a simple KDE application, such as lskat.exe from the kdegames package.

The first KDE application you run will start a console window in order to run the [http://en.wikipedia.org/wiki/D-Bus D-Bus daemon].

== Fine-tuning ==
===Set Oxygen style for widgets===
The default KDE widget style on Windows is the native one. You already have Oxygen style installed (which is a plugin library %KDEROOT%\lib\kde4\plugins\styles\oxygen.dll), so it can be used as well. To set it for a single user:
#edit <tt>%UserPROFILE%\.kde\share\config\kdeglobals</tt> with any text editor (e.g. kwrite) Note: `cd %UserPROFILE%` will change to the right directory, effectively telling you what %UserPROFILE% expands to, such as "C:\Documents and Settings\mark"
#locate the General section (a line containing the text "[General]"). If there is no General section, create one.
#Within the General section ([General]), edit the line containing <tt>widgetStyle=....</tt> so that it reads <tt>widgetStyle=oxygen</tt>. If there is no such <tt>widgetStyle=...</tt> line, create it.
Newly started applications should be displayed with Oxygen style now.

== Status ==
Using kdewin-installer-gui-0.8.6.exe to install 4.00.60 packages:
* starting a KDE program correctly starts dbus-daemon.exe
* many games run
* choosing File > Open correctly starts klauncher.exe, kioslave.exe and kded4.exe, and runs kbuildsycoca4.exe as needed.
* Full-text search in khelpcenter does not work because Perl scripts are disabled.
* Many applications have a generic icon in Windows Explorer.
* Applications that try to play sounds might display an alert about "Multimedia Backend" problems. This requires the Windows backend for [http://phonon.kde.org/ Phonon]. The amarok package installs an experimental Windows phonon backend. Amarok plays music!!

General notes:
* There are many other KDE programs that are not part of KDE 4.0.0 and are not currently packaged for Windows, such as KOffice 2.
* By design, KDE-windows does not provide the full-blown KDE desktop, thus no KWin composite manager, KDE-specific "start" menus, Plasma desktop, etc.

=== Package status and contents ===
{| border="0" cellpadding="2"
|-valign="top"
!package
!status
!contains applications
|-valign="top"
|kdebase
|packaged
|Konqueror, Dolphin, KWrite, etc.
|-valign="top"
|kdegames
|packaged
|Kgoldrunner, Kpat, KMahjongg, etc.
|-valign="top"
|kdesdk
|packaged
|Kate, Umbrello, etc.
|-valign="top"
|kdetoys
|packaged
|KTeatime, etc.
|-valign="top"
|kdeedu
|packaged
|Marble, Parley, KStars, KHangman, etc.
|-valign="top"
|kdegraphics
|packaged
|Okular, kolourpaint, etc.
|-valign="top"
|amarok
|packaged
|Amarok music player
|-valign="top"
|koffice
|packaged
|KWord, Krita, Karbon, etc.
|-valign="top"
|kdepim
|not building
|KMail, AKregator, etc.
|-valign="top"
|kdenetwork
|not building
|Kopete, KGet, etc.
|-valign="top"
|kdeutils
|not packaged
|KGpg, KWallet, etc.
|-valign="top"
|ktorrent
|packaged
|the KTorrent utility
|}

== Deprecated: post-install steps ==
After manual installation of a package one has to run the included post-install.bat script (inside the manifest folder). This batch file includes at least the following steps.

===Run update-mime-database===
Be sure that you have no KDE-related applications running: run the Windows Task Manager (taskmgr.exe), switch to its Processes tab, and kill all occurences of dbus-daemon.exe, kded4.exe, kioslave.exe and klauncher.exe (and all other KDE apps).

Open a Windows command prompt (cmd.exe) and navigate to the directory where you installed KDE. Say you installed KDE to C:\KDE4, then run from the cmd.exe window:
C:\KDE4> '''bin\update-mime-database C:\KDE4\share\mime'''
This will give you a lot of warning message. Most of them you can easily ignore; even if you should set [[KDE_System_Administration/Environment_Variables#XDG_DATA_HOME|XDG_DATA_HOME]] or [[KDE_System_Administration/Environment_Variables#XDG_DATA_DIRS|XDG_DATA_DIRS]] it worked perfectly. If it says you should rerun update-mime-database as root then you're not within your installation directory.

===Run kbuildsyscoca4===
After finishing the previous step, run
C:\KDE4> '''bin\kbuildsycoca4 --noincremental'''
If this tells you that your disk is full (which is most probably not the case) you have still some executables from KDE running. Please close them and try again.

Excuse us for the inconvenience — we hope for a better solution in the next release.

[[Category: MS Windows]]

Projects/PIM/Akonadi

2008-05-03T00:18:00Z

Skierpage: /* Do I need a running MySQL server? */ "it's" typo

== Akonadi TODO ==
The following list contains the things which need to be done for Akonadi.

Note: The person noted in the "Contact" column is not necessarily the one implementing that feature, but the one who can tell you what to do and how to help, i.e. you can also contribute to those tasks ;-)

=== Core ===

Urgent tasks that need to be finished for the KDE 4.1 release ('''May 19th'''):

{| class="sortable" border="1" cellpadding="5" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width: 100%;"
|- style="background: #ececec; white-space:nowrap;"
! Status !! Item !! Description !! Contact
{{FeatureInProgress|Item size|Needed by Mailody|thomas.mcguire@gmx.net}}
{{FeatureTodo|Payload serialization format versioning|see below|Volker}}
{{FeatureInProgress|Item streaming in ItemSync/ResourceBase|As discussed in Osnabrueck|Tom}}
{{FeatureDone|API for additional item parts|As discussed in Osnabruck|Volker/Tobias}}
{{FeatureDone|Infrastructure for showing additional dialogs from agents/resources|As discussed in Osnabrueck|Tom}}
{{FeatureInProgress|Allow to limit ItemFetchJob to current cache content|Prevents search index feeder agents from downloading all remote data|vkrause@kde.org|Volker}}
{{FeatureDone|Fix API for item/collection modifications|See Osnabrueck meeting notes for details|vkrause@kde.org|Volker}}
{{FeatureTodo|Error reporting|Akonadi::Job basically has only one error code: Unknown|Tobias}}
{{FeatureTodo|Plugin Versioning|For serializer plugins, also check using Qt plugin stuff instead of the libkdepim plugin framework|}}
|}

==== Less urgent tasks ====

{| class="sortable" border="1" cellpadding="5" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width: 100%;"
|- style="background: #ececec; white-space:nowrap;"
! Status !! Item !! Description !! Contact
{{FeatureDone|Tray app|small app to control the server and have a something that can report errors|tomalbers@kde.nl|Toma}}
{{FeatureInProgress|Akonadi Artwork|Icon for the tray app|tomalbers@kde.nl|Toma}}
{{FeatureInProgress|Finish collection model/view|see below|thomas.mcguire@gmx.net}}
{{FeatureDone|Backup support|Dump & Restore database contents, also useful when upgrading to a newer database version|tomalbers@kde.nl}}
{{FeatureInProgress|Collection statistics for sub-trees|Provide a CollectionStatus object covering the full sub-tree in the model, allowing accumulated unread counts etc.|Thomas}}
{{FeatureTodo|Nepomuk integration|Generic Item tag/rate/comment, etc.|Tom}}
{{FeatureTodo|Account creation wizard|as discussed in Berlin, see below|}}
{{FeatureTodo|Sync collection tree after creating setting up a resource|see AgentInstanceCreateJob|}}
{{FeatureTodo|Support standard commands for QUndo framework||}}
{{FeatureTodo|Conflict detection in resources|See Osnabrueck meeting notes for details|}}
{{FeatureInProgress|Action framework|see below|vkrause@kde.org|Volker}}
{{FeatureTodo|Solid integration|Switch online/offline state in ResourceBase automatically|}}
{{FeatureTodo|Make unittests work without destroying the production database||}}
{{FeatureTodo|Fix API docs|The libakonadi move as well as the huge API changes following it broke lots of the docs technical and content-wise|}}
|}

=== Supported Types ===

Overview on the current state of support for various types:

{|
|-
! Type !! Serializer !! Multipart Support !! Models !! Views !! Resources !! Notes
|-
|Email||yes||partial||MessageModel, MessageCollectionModel, threading proxy model||?||maildir, IMAP||threading agent
|-
|News||yes (1)||partial (1)||(1)||(1)||NNTP||
|-
|Contact||yes||no||ContactModel||-||vCard, facebook, KRes||
|-
|Events||yes||no||EventModel||-||iCal, KRes||
|-
|Notes||no||no||-||-||-||not started yet
|-
|Feeds||no||no||-||-||-||not started yet
|-
|Bookmarks||yes||no||-||-||local bookmarks, del.icio.us||
|}

(1) see Email

=== Mail specific extensions ===

{| class="sortable" border="1" cellpadding="5" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width: 100%;"
|- style="background: #ececec; white-space:nowrap;"
! Status !! Item !! Description !! Contact
{{FeatureTodo|Extend Message Model|Add all required columns, save/restore layout, flag delegate, configurable columns, etc.|}}
{{FeatureTodo|Share mail flag code|Standard actions, standard flag enum/constants, Nepomuk interaction|}}
{{FeatureTodo|Extend ENVELOPE|Add more information to the envelope payload part in the serializer plugin, eg. trheading information is missing|}}
{{FeatureTodo|Fix/finish threading||}}
|}

=== Event/Todo/Journal specific extensions ===

{| class="sortable" border="1" cellpadding="5" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width: 100%;"
|- style="background: #ececec; white-space:nowrap;"
! Status !! Item !! Description !! Contact
{{FeatureTodo|Todo proxy model|See KOrganizers To-Do view|Bruno?}}
{{FeatureInProgress|Subtype identification|See discussion on kde-pim mailinglist|Kevin?}}
{{FeatureTodo|Agenda view|KOrganizer agenda view based on Akonadi|Bruno?}}
{{FeatureTodo|Month view|KOrganizer month view based on Akonadi|Bruno?}}
{{FeatureTodo|Timeline view|KOrganizer timeline view based on Akonadi|}}
|}

=== Resources, Agents and others ===

{| class="sortable" border="1" cellpadding="5" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width: 100%;"
|- style="background: #ececec; white-space:nowrap;"
! Status !! Item !! Description !! Contact
{{FeatureInProgress|KResource Akonadi bridge|for applications using KCal or KABC|kevin.krammer@gmx.at|Kevin}}
{{FeatureInProgress|Akonadi KResource bridge|for data accessed through KCal or KABC resources|kevin.krammer@gmx.at|Kevin}}
{{FeatureTodo|Expire Agent||}}
{{FeatureTodo|MBOX Resource||Thomas}}
{{FeatureTodo|Extend IMAP Resource||}}
{{FeatureTodo|POP3 Resource||Thomas}}
{{FeatureTodo|RSS Resource||}}
{{FeatureTodo|Filter Agent||}}
{{FeatureTodo|Search||}}
{{FeatureTodo|Filter Rule GUI|Used by filters and searches|}}
|}

Resource status overview (this should list all resources existing in KDE3 or already under development for Akonadi):

{|
|-
! Resource !! Retrieve Collections !! Retrieve Items !! Change Collections !! Change Items !! Configuration !! Notes
|-
|iCal||yes (4)||yes (1) (2)||no||yes (5)||yes||does not yet watch for file changes
|-
|vCard||yes (4)||yes (1) (2)||no||?||yes||does not yet watch for file changes
|-
|maildir||yes (1) (4)||yes (1) (2)||?||?||yes||
|-
|mbox||no||no||no||no||no||not started yet, code exists in KMail
|-
|IMAP||yes (1) (4)?||yes (1) (2)||no||no||no||code exists in kio_imap4 and Mailody, support for extensions: quota, ACL, annotations missing, what about Kolab and Scalix?
|-
|POP3||no||no||no||no||no||not started yet,code exists in kio_pop3
|-
|NNTP||yes (4)||yes (2)||n/a||n/a||yes||Needs support for local collection names and collection hierarchy
|-
|Local Bookmarks||?||?||?||?||(3)||Code in akonadi/resources
|-
|OpenChange||?||?||?||?||?||Code in akonadi/resources
|-
|Facebook||?||?||?||?||?||Code in playground/pim
|-
|del.icio.us||?||?||?||yes||no||Code in playground/pim
|-
|KABC||no||yes||no||yes||yes||
|-
|KCal||no||yes||no||yes||yes||
|}

(1) only full sync supported currently, need optimization
(2) does not yet honor cache policy
(3) still relies on QSettings for configuration and/or doesn't provide configuration over D-Bus
(4) does not yet provide correct access control settings
(5) only adding new items, not changing existing ones

== Akonadi Braindump ==
Ideas/notes etc. on various open issues in Akonadi.

=== Akonadi Standard Actions ===

Idea: Have something like KStandardAction for Akonadi that not only includes the representation of the action but also its state management and the actual operations. Like libakonadi that should be splitted into a generic, type-independent part and be extensible for type-specific actions. This will enable code sharing among many applications and guarantee consistent actions everywhere.

State management: watch selection models of a collection and/or item model.

Use KXMLGUI for context menus in standard views to allow easy extensibility with custom actions.

Generic actions:
* new collection [done]
* new virtual collection
* delete collection [done for single selection]
* copy collection [done]
* cut collection
* paste collection [done]
* synchronize collection [done for single selection]
* synchronize resource
* synchronize everything
* show collection properties dialog [done]
* delete item(s) [done]
* copy item(s) [done]
* cut item(s)
* paste item(s) [done]
* paste native data
* tag item(s)
* comment item
* rate item(s)
* configure resource
* add resource? (would need a type parameter, etc.)
* delete resource
* manage local subscriptions [done]
* move to submenu
* copy to submenu

The list is definitely long enough to make this worthwhile.

=== Collection Model / Collection View ===

Ideas/missing features/bugs of the collection model/view:

* Enable/disable status columns
* Show status after the name (see KMail)
* Size column
* Save/restore layout
* Custom collection icons (see KMail, also needed for resource defined special folders (eg. Inbox)
* Status tooltips (see KMail in 3.5.9)
* Quick search
* Favorite folder view as proxy model on top of the normal collection model (FlatCollectionProxyModel might be helpful for there)
* Accumulated statistics (unread, total, size)
* Fix dnd: move/copy/cancel menu always shows up and never has any effect

=== Compatibility ===

Notes on how to keep long-term protocol, source and binary compatibility.

* Detect server version in Akonadi::Session, might be useful in case of protocol extensions/changes
* What about database server version updates?
* Versioning or any other kind of serialization format meta data, we'll need that in case of changes in serialization formats (see eg. Robert's compression patch where this is needed)
* <s>We currently use 32 bit ids, probably hard to change later on, is that enough?</s>
* Plugin versioning

=== Resource API issues ===

Notes/ideas/complaints about the Akonadi::ResourceBase API:

* Extremely error prone:
** Scheduler dead-locks when a requested operation is not correctly announced as finished, esp. a problem in error cases.
** Using the result methods multiple times or when not requested asserts
* Item streaming is missing, requiring all data to be in memory at once
* Non-incremental updates need to know the results of ItemSync to not have to provide all data, even for already existing/unchanged items.

=== API / BC issues ===

Smaller stuff that should be fixed before the ABI freeze and is not yet listed above:

* Cleanup the D-Bus format used by NotificationMessage
* No mentioning of "IMAP" in the public API, we are not using IMAP
* Naming and installed location of libraries, headers and executables (see discussion on kde-pim ML)
* Payload part labels are QStrings, attribute types are QByteArray

=== Deployment issues ===

* Multiple access: Should multiple Akonadi instances' mysqlds access a single set of data files the mysql will likely corrupt the data. This can happen in any NFS+YP installation where users can log onto any machine and access shared homes. MySQL relies on filesystem locking to prevent multiple access. [http://dev.mysql.com/doc/refman/6.0/en/multiple-servers.html MySQL multiple instance docu].
* [http://dev.mysql.com/doc/refman/6.0/en/innodb-restrictions.html InnoDB tables should not be used on NFS].
* NFS speed: MySQL documentation recommends against locating its data files on network shares.
* AppArmor: Distros' AppArmor profiles prevent MySQL from writing outside its defined data directory (usually /var/lib/mysql). This is a problem at least with *buntu and openSUSE. These will need to be adapted. It is possible to daisy-chain profiles so that MySQL started by Akonadi receives a different profile to MySQL running standalone. An empty profile has all rights. Another possibility is to adapt the general MySQL profile so it can write to ${XDG_DATA_HOME}/akonadi(usually ${HOME/}.local/share/akonadi). Both support for profile chaining and ${HOME} may depend on the version of AppArmor installed. What about SELinux?
* Backup: MySQL data files should not be backed up without telling the mysqld process, otherwise a corrupt backup will be made. LOCK TABLES and FLUSH TABLES at the least. A dump can be made or mysqlhotbackup may be used in some circumstances. We should consider sysadmins' backup techniques when planning/promoting Akonadi, as a simple rsync cronjob with running Akonadi will not work. [http://dev.mysql.com/doc/refman/6.0/en/backup.html MySQL backup advice].

=== Account Creation Wizard ===

Notes on the resource configuration wizard discussion.

* WizardBase class
* Wizard discovery via .desktop files
* A wizard can configure multiple resources (eg. IMAP + LDAP for Kolab) and non-resources (mailtransport)
* Optionally hide resources completely covered by wizards in the Add Account dialog
* List wizards in the Add Account dialog
* Store Account -> Resources information to offer deletion of depending resources

=== PostgreSQL datastore support ===

First review of the akonadi code reveals PGSQL Qt driver is already supported, but the code is not totally ready for it. Some first reading comments about where to patch for supporting PostgreSQL too:

==== akonadi/server/src/storage/dbinitializer.cpp ====

* line 201..., ALTER TABLE ADD [UNIQUE] INDEX syntax is MySQL only, better use the common one CREATE [UNIQUE] INDEX ... one [done with revision 789899]
* line 303, QString DbInitializer::sqlType(const QString & type), LONGBLOB is the MySQL type, PostgreSQL will use BYTEA.
* line 362, qFatal("Implement index support for your database!");
mysql: SHOW INDEXES FROM %1
pgsql: SELECT c2.relname, i.indisprimary, i.indisunique, i.indisclustered, i.indisvalid, pg_catalog.pg_get_indexdef(i.indexrelid, 0, true), c2.reltablespace
FROM pg_catalog.pg_class c, pg_catalog.pg_class c2, pg_catalog.pg_index i
WHERE c.oid = '16713' AND c.oid = i.indrelid AND i.indexrelid = c2.oid
ORDER BY i.indisprimary DESC, i.indisunique DESC, c2.relname

relname | indisprimary | indisunique | indisclustered | indisvalid | pg_get_indexdef | reltablespace
--------------+--------------+-------------+----------------+------------+--------------------------------------------------------------+---------------
foo_pkey | t | t | f | t | CREATE UNIQUE INDEX foo_pkey ON foo USING btree (id) | 0
foo_time_key | f | t | f | t | CREATE UNIQUE INDEX foo_time_key ON foo USING btree ("time") | 0
(2 lignes)

==== akonadi/server/src/storage/datastore.cpp ====

* line 700, qint64 DataStore::highestPimItemId() const, seems wrong for a concurrent program (SELECT MAX(col) FROM table; is not reliable if another thread is inserting at the same time) : check the callers
* line 794, qint64 DataStore::lastInsertId( const QSqlQuery & query ), PostgreSQL doesn't provide concurrent-bogus last_insert_id, but from 8.2 accepts the syntax INSERT INTO ... RETURNING col1, col2, ...;
* line 806, QString DataStore::dateTimeFromQDateTime( const QDateTime & dateTime ), use PostgreSQL to_char() formatting function for date rather than having Qt do it

== KMail Breakdown Plan ==
The current plan is to put some parts of KMail into a stand-alone
library, independent of KMail. This increases code reuse (for example, the message composer could be shared with Mailody) and makes the code a lot easier to maintain and to port to Akonadi.

{| class="sortable" border="1" cellpadding="5" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width: 100%;"
|- style="background: #ececec; white-space:nowrap;"
! Status !! Item !! Description !! Contact
{{FeatureTodo|Bodypart formatters||}}
{{FeatureTodo|Reader Window||}}
{{FeatureTodo|Composer: Editor||}}
{{FeatureTodo|Composer: Message Composer||}}
{{FeatureTodo|Composer: GUI Window||}}
{{FeatureTodo|Queue Manager for mailtransport||}}
{{FeatureTodo|Templates: Core||}}
{{FeatureTodo|Templates: GUI||}}
{{FeatureTodo|Port KMCommands||}}
{{FeatureTodo|Port away from KMMessage and KMFolder* everywhere it is left||}}
{{FeatureTodo|Migration application for index and other config||}}
{{FeatureTodo|Port MDNs||}}
|}

== The Road to World Domination ==

Sort of related so the stuff above but with a scope for all of KDE PIM and beyond.

{| class="sortable" border="1" cellpadding="5" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width: 100%;"
|- style="background: #ececec; white-space:nowrap;"
! Status !! Item !! Description !! Contact
{{FeatureTodo|Share identity config GUI parts|eg. the signature configuration widget|}}
{{FeatureTodo|Mailtransport Agent|Global shared outbox, central mail sending instance|}}
{{FeatureTodo|Recently sent to support in mailtransport|related to above, based on Akonadi/Nepomuk|}}
{{FeatureTodo|Composer engine|Shared stuff for KMail/KNode/Mailody: Crypto, editor, editor actions, attachment model, message assembly, etc.|}}
|}

== Akonadi FAQ ==

=== Where do I find the Akonadi config files? ===

''~/.config/akonadi/''

=== Where does Akonadi store my data? ===

''~/.local/share/akonadi/''

=== Which DBMS does Akonadi use? ===

So far only MySQL. There is some work on PostgreSQL support going on though.

=== Why not use sqlite? ===

We tried. Really. It can't handle the concurrent access very well.

=== Why not use MySQL/Embedded? ===

We tried that as well, there are two reasons for not using it: No support for the InnoDB engine (which we need for transaction support) and poor availability (only OpenSUSE provided usable packages, needed a patched QSQL driver).

=== Do I need a running MySQL server? ===

No. Akonadi starts its own local MySQL server. All you need is having the 'mysqld' binary installed at runtime (usually found in the mysql-server package of your distribution).

=== Can Akonadi use a normal MySQL server running on my system? ===

Yes, it can. You find the corresponding settings in ''~/.config/akonadi/akonadiserverrc''.

=== Can a single Akonadi instance be used by multiple users? ===

No. There has to be one Akonadi server instance per user. However, it is possible to use a shared database server.

=== Can I access the Akonadi server on a remote machine? ===
No. Akonadi is not a groupware server. It's a local cache only.

=== I have an unknown error 255 when running akonadictl on Ubuntu ===
Distributions using Apparmor require you to run '''aa-complain mysqld''' with root privileges then reload apparmor.

[[Category:PIM]]

Projects/KDE on Mac OS X

2008-04-18T23:29:35Z

Skierpage: /* Installation */ clarify this is for KDE4

== Introduction ==

KDE on Mac OS X has a long history, but is seeing new life in KDE4 and Qt4/Mac by bringing native KDE4 applications to the Mac OS X desktop.

== About KDE on Mac OS X ==

=== KDE 3 ===

If you are interested in installing KDE 3.x on Mac OS X, check out the [[Projects/KDE on Mac OS X/KDE 3|KDE 3]] page.

=== KDE 4 ===

KDE 4.x on Mac OS X is quickly reaching a stable stage, and currently could be considered a "technology preview". Official support for Mac OS X is targeted for KDE 4.1.0.

== Goals for KDE on Mac OS X ==

Mac OS X is already a "desktop environment" in the sense that it provides window management, application launching, etc. The goal of KDE on Mac OS X is to provide the rich frameworks and applications in KDE to a wider audience.

In KDE 4, we intend to have:

* [[Development/Architecture/KDE4/Solid|Solid]] hardware integration
* [[Development/Architecture/KDE4/Phonon|Phonon]] support (already finished, thanks to [http://arstechnica.com/journals/linux.ars/2007/12/13/trolltech-contributes-new-phonon-backends-to-kde Trolltech])
* [[Development/Architecture/KDE4/Strigi|Strigi]] integration with [http://en.wikipedia.org/wiki/Spotlight_(software) Spotlight]

Perhaps not all of these things will be available by 4.1, but the goal is to do as much as possible for release.

== KDE4 Installation ==

You must install at least Qt, kdesupport, and kdelibs for any of these packages to work. Note that kdelibs requires soprano and strigi. Also, kdepimlibs and kdebase are recommended since a number of things will want them. (...and it has Konqueror)

=== Download Torrent Files ===

'''''Please note:''''' since most people tend to download the complete package, downloading '''everything''' is usually faster (if you have broadband, obviously). And don't forget to seed!

<table>
<tr> <td>everything</td> <td>[http://ranger.users.finkproject.org/kde/10.4/everything-20080115.dmg.torrent 10.4/10.5]</td> </tr>
<tr> <td><s>amarok</s></td> <td><s>10.4/10.5</s> </td> <td>requires kdelibs, kdesupport, qt, strigi (temporarily not building)</td> </tr>
<tr> <td>blitz</td> <td>[http://ranger.users.finkproject.org/kde/10.4/blitz-20080115.dmg.torrent 10.4/10.5]</td> <td>requires kdelibs, kdesupport, qt, strigi</td> </tr>
<tr> <td>decibel</td> <td>[http://ranger.users.finkproject.org/kde/10.4/decibel-20080115.dmg.torrent 10.4/10.5]</td> <td>requires kdelibs, kdesupport, qt</td> </tr>
<tr> <td>kdeadmin</td> <td>[http://ranger.users.finkproject.org/kde/10.4/kdeadmin-20080115.dmg.torrent 10.4/10.5]</td> <td>requires kdelibs, kdepimlibs, qt, strigi</td> </tr>
<tr> <td>kdeartwork</td> <td>[http://ranger.users.finkproject.org/kde/10.4/kdeartwork-20080115.dmg.torrent 10.4/10.5]</td> <td>requires kdelibs, qt</td> </tr>
<tr> <td>kdebase</td> <td>[http://ranger.users.finkproject.org/kde/10.4/kdebase-20080115.dmg.torrent 10.4/10.5]</td> <td>requires blitz, kdelibs, kdepimlibs, kdesupport, qt, soprano, strigi</td> </tr>
<tr> <td>kdeedu</td> <td>[http://ranger.users.finkproject.org/kde/10.4/kdeedu-20080115.dmg.torrent 10.4/10.5]</td> <td>requires kdelibs, kdesupport, qt, strigi</td> </tr>
<tr> <td>kdegames</td> <td>[http://ranger.users.finkproject.org/kde/10.4/kdegames-20080115.dmg.torrent 10.4/10.5]</td> <td>requires kdelibs, kdesupport, qt, strigi</td> </tr>
<tr> <td>kdegraphics</td> <td>[http://ranger.users.finkproject.org/kde/10.4/kdegraphics-20080115.dmg.torrent 10.4/10.5]</td> <td>requires blitz, kdelibs, kdesupport, qt, strigi</td> </tr>
<tr> <td>kdelibs</td> <td>[http://ranger.users.finkproject.org/kde/10.4/kdelibs-20080115.dmg.torrent 10.4/10.5]</td> <td>requires kdesupport, qt, soprano, strigi</td> </tr>
<tr> <td>kdemultimedia</td> <td>[http://ranger.users.finkproject.org/kde/10.4/kdemultimedia-20080115.dmg.torrent 10.4/10.5]</td> <td>requires kdelibs, kdesupport, qt, strigi</td> </tr>
<tr> <td>kdenetwork</td> <td>[http://ranger.users.finkproject.org/kde/10.4/kdenetwork-20080115.dmg.torrent 10.4/10.5]</td> <td>requires kdelibs, kdepimlibs, kdesupport, qt, strigi</td> </tr>
<tr> <td><s>kdepim</s></td> <td><s>10.4/10.5</s>  </td> <td>requires kdelibs, kdepimlibs, kdesupport, qt, strigi (not included in KDE 4.0)</td> </tr>
<tr> <td>kdepimlibs</td> <td>[http://ranger.users.finkproject.org/kde/10.4/kdepimlibs-20080115.dmg.torrent 10.4/10.5]</td> <td>requires kdelibs, qt, strigi</td> </tr>
<tr> <td>kdesdk</td> <td>[http://ranger.users.finkproject.org/kde/10.4/kdesdk-20080115.dmg.torrent 10.4/10.5]</td> <td>requires kdelibs, kdepimlibs, kdesupport, qt, strigi</td> </tr>
<tr> <td>kdesupport</td> <td>[http://ranger.users.finkproject.org/kde/10.4/kdesupport-20080113.dmg.torrent 10.4/10.5]</td> <td>requires qt</td> </tr>
<tr> <td>kdetoys</td> <td>[http://ranger.users.finkproject.org/kde/10.4/kdetoys-20080115.dmg.torrent 10.4/10.5]</td> <td>requires kdelibs, qt, strigi</td> </tr>
<tr> <td>kdeutils</td> <td>[http://ranger.users.finkproject.org/kde/10.4/kdeutils-20080115.dmg.torrent 10.4/10.5]</td> <td>requires kdelibs, kdepimlibs, qt, strigi</td> </tr>
<tr> <td><s>kdevelop</s></td> <td><s>10.4/10.5</s> </td> <td>requires kdelibs, kdevplatform, qt, strigi (not included in KDE 4.0)</td> </tr>
<tr> <td>kdevplatform</td> <td>[http://ranger.users.finkproject.org/kde/10.4/kdevplatform-20080115.dmg.torrent 10.4/10.5]</td> <td>requires kdelibs, qt, strigi</td> </tr>
<tr> <td>kdewebdev</td> <td>[http://ranger.users.finkproject.org/kde/10.4/kdewebdev-20080115.dmg.torrent 10.4/10.5]</td> <td>requires kdelibs, kdesupport, qt, strigi</td> </tr>
<tr> <td>koffice</td> <td>[http://ranger.users.finkproject.org/kde/10.4/koffice-20080115.dmg.torrent 10.4/10.5]</td> <td>requires blitz, kdelibs, kdepimlibs, kdesupport, qt, strigi</td> </tr>
<tr> <td>qt-doc</td> <td>[http://ranger.users.finkproject.org/kde/10.4/qt-doc-20080102.dmg.torrent 10.4/10.5]</td> </tr>
<tr> <td>qt-extras</td> <td>[http://ranger.users.finkproject.org/kde/10.4/qt-extras-20080102.dmg.torrent 10.4/10.5]</td> <td>requires kdesupport, qt</td> </tr>
<tr> <td>qt</td> <td>[http://ranger.users.finkproject.org/kde/10.4/qt-20080102.dmg.torrent 10.4/10.5]</td> <td>requires kdesupport</td> </tr>
<tr> <td>soprano</td> <td>[http://ranger.users.finkproject.org/kde/10.4/soprano-20080115.dmg.torrent 10.4/10.5]</td> <td>requires kdesupport, qt</td> </tr>
<tr> <td>strigi</td> <td>[http://ranger.users.finkproject.org/kde/10.4/strigi-20080115.dmg.torrent 10.4/10.5]</td> <td>requires kdesupport, qt</td> </tr>
</table>

=== Download CMake (Developers) ===

If you want to compile against these snapshots, you also need cmake. You can get the latest release from [http://www.cmake.org/HTML/Download.html their download page].

== Running Apps ==

Running apps should usually work from Finder. But if for some reason they don't, you can try these two steps:

=== Environment ===

From the command line, update PATH and launch dbus, like so:

export PATH="/opt/kde4/bin:/opt/kde4-deps/bin:/opt/qt4/bin:$PATH"
eval `dbus-launch --auto-syntax`

=== Launching ===

Then, to start an app, you call it from the same terminal, like this:

open /opt/kde4/bin/konqueror.app

NOTE: Don't try to start the 'real' binary directly, like so:

/opt/kde4/bin/konqueror.app/Contents/MacOS/konqueror

since this will result in various interactions with the OS (drag and drop, for example) not working.

=== Troubleshooting ===

Sometimes, Installer.app fails to run the post-install. Try running:

/opt/kde4-deps/bin/update-kde-mac.sh

...and see if your application starts.

== Development (Helping Out) ==

=== Building ===

If you'd like to try building KDE yourself, it should (mostly) work out of the box. You can get [[Projects/KDE on Mac OS X/Tips On Building|tips on building here]] (including a link to the tools I use to generate these packages).

=== TODO ===

There's still a lot to do. I'm going to try to keep a running list of what needs to be done on the [[Projects/KDE on Mac OS X/TODO|TODO]] page.

=== Communicating (Real Time) ===

You can find the KDE4/Mac developers in the [irc://irc.freenode.net/%23kde-mac #kde-mac] IRC channel on FreeNode and folks working on KDE4 in general in the [irc://irc.freenode.net/%23kde-devel #kde-devel] channel. This should be the first place you look. If you have a question, be patient, sometimes we're logged in but not looking at IRC all the time. If you stick around, we'll answer.

=== Communicating (E-Mail) ===

The official list for KDE/Mac development is [https://mail.kde.org/mailman/listinfo/kde-mac kde-mac@kde.org].

There are lots of great mailing lists for more general KDE discussion. For a complete list, see [http://lists.kde.org/ the KDE mailing list page]. The KDE/Mac developers have been known to hang out on kde-buildsystem, kde-devel, and kde-nonlinux.

=== Bugs (Finding, and Reporting) ===

First of all, before doing anything else, check the [http://bugs.kde.org/ KDE bug page] to see if your problem has already been reported. If so, add as much as you can to the existing bug report to make it easier for developers to figure out what's gone wrong.

You might also want to try [[#Communicating (Real Time)|the IRC channel(s)]] before filing a bug, you're more likely to get a quick response there. Also be aware, we know there's still stuff broken on Mac OS X, so be gentle. :)

[[Category:Mac OSX]]

Projects/KDE on Mac OS X/KDE 3

2008-04-18T23:25:53Z

Skierpage: /* Fink */ now offers 3.5.9 unstable (I'm not sure about stable)

KDE 3.x is stable and has been running on Mac OS X for quite a while. Unlike KDE 4, however, they require an X11 server to operate.

== Installation ==

=== [http://www.finkproject.org/ Fink] ===

KDE 3.5.6 is currently available in Fink stable. To install the basic desktop, type (in a console window):

fink selfupdate-rsync
fink install kdebase3-unified

KDE 3.5.9 is in Fink unstable. First, [http://finkproject.org/faq/usage-fink.php#unstable enable unstable following the instructions in the Fink FAQ], then for the complete KDE desktop, type (in a console window):

fink selfupdate-rsync
fink install bundle-kde-ssl

If for some reason you can't use <code>selfupdate-rsync</code>, try <code>selfupdate-cvs</code> instead.

Note that KDE itself on Fink is very solid, it just hasn't been moved in it's entirety to Fink stable because of issues moving a few of it's dependencies to stable. It is recommended that you install the latest KDE from Fink unstable.

=== [http://www.macports.org/ MacPorts] ===

KDE 3.5.8 is in MacPorts. To install the complete KDE desktop, type (in a console window):

sudo port install kde

Projects/KDE on Windows/Installation

2008-02-26T22:58:37Z

Skierpage: /* Issues with KDE Installer for Windows */ note successful completion may not be

{{Template:I18n/Language Navigation Bar|Projects/KDE_on_Windows/Installation}}

{{note|Perhaps actual developers should summarize status of KDE4 on Windows here, while we encourage users to describe their experiences on the [[Talk:{{PAGENAME}}|Talk page?]]}}

== KDE Installer for Windows ==
You can use this installer to download and install the
various binary packages that you need to run KDE applications on MS Windows.
KDE is free and open source so you can build all the applications "from scratch" from their source code;
but as a convenience for others,
volunteers create these precompiled packages and make them available on the Internet.

'''Disclaimer''' These are early days for KDE4 on Windows,
some programs work better than others and some fail to run altogether.

'''If you experience any problems please have a look into our [http://lists.kde.org/?l=kde-windows&r=1&w=2| mailing list].'''

You can also use the KDE Installer for Windows to install source code and the packages that you need to ''build'' KDE4 on Windows
(although if you are building KDE4 on Windows you may prefer to use the emerge system to build KDE and its requirements from latest source);
see [[Getting Started/Build/KDE4/Windows]].

=== Summary of Steps ===
* Visit http://download.cegit.de/kde-windows/installer/
* Download and save the latest version to a directory, e.g. <tt>C:\KDE4</tt>
* Run the installer, download what you need (see [[#Download needed packages]] below).
* Add your lib directory, e.g. <tt>C:\KDE4\lib</tt> to your Windows %PATH%. (Start > Control Panel > System > Advanced > Environment Variables, double-click the Path System Variable and add this to your path separated by semicolon.)
* Add a KDEDIRS environment variable (Start > Control Panel > System > Advanced > Environment Variables, click [New] User variable and create Variable name <tt>KDEDIRS</tt> with Variable value the directory where you installed KDE4, e.g. <tt>C:\KDE4</tt>).
* [TEMPORARILY] Follow the instructions at [[#post-install steps]]
* Try running a Qt application in the <tt>bin</tt> directory, such as linguist.exe
* If that works, try running a KDE application such as <tt>kwrite.exe</tt>.

=== Download needed packages ===
A single program in the The K Desktop Environment depends on many other libraries and packages; that is why each .exe is comparatively small.
The KDE Installer for Windows has some awareness of dependencies,
but not complete.
So, the first few times you try to run an application you may see alerts about missing DLLs.

If you do not intend to build from source, do not click "all" and do not click "src", as you do not need to download the source for each package. ''Unclear whether you need lib for each''.

There are two development systems for KDE on Windows,
Microsoft's Visual C and [http://en.wikipedia.org/wiki/MinGW MinGW].
Even if you are only running binaries and do not intend to build KDE4 yourself,
you need to choose between these because of the provided runtime environments.
You're free to decide which to take.

The KDE programs themselves are organized into several groups: kdeedu, kdegames, and kdegraphics.

Here are some of the minimal packages you need to run a KDE application:
: dbus-msvc, kdebase-msvc, kdewin32-msvc, qt-msvc, vcredist, ??

The Dependencies tab for a particular package lists some of the additional packages it needs.
However, the dependency checking currently only works for first-level dependencies
Other dependencies are not easy to determine in advance.
For example, if you install kdegames only with its dependencies,
you will not be able to start it because you also need libstreamanalyze
(for which you have to install the strigi package).
rhabacker: This is fixed in installer version > 0.8.4.

[[Getting_Started/Build/KDE4/Windows/3rd-party_libraries]] is a more complete list of libraries that a full installation needs.

=== Issues with KDE Installer for Windows ===
If you find an issue, please report to [mailto:kde-windows@kde.org].

==== Successful? completion ====
If something goes wrong during installation, for example a file can't be replaced because it is still in use, the installer may still report successful completion. If you see any alert or failure message from the installer, when it completes quit and re-run it.

==== Dependencies, not detailed version dependencies ====
The installer tracks dependencies on packages,
but not particular ''versions'' of packages.
So in end user install mode, the installer won't alert you to the existence of a newer version of a supporting package, and doesn't know when one of the "high-level" end-user packages requires this newer version.
: As a workaround, if you go into %KDEDIRS%\manifest and delete the .mft and .ver files for a package (e.g. qt-msvc-4.3.3-2-bin.mft, qt-msvc-4.3.3-2-bin.ver, etc.), the installer will see that you've uninstalled a package. Then, should another package require that package the installer will download the most recent one available from the mirror.

== post-install steps ==
You currently need to run a number of command-line programs to set up KDE. Here are the steps.

===Run update-mime-database===
Be sure that you have no KDE-related applications: run the Windows Task Manager (taskmgr.exe), switch to its Processes tab, and kill all occurences of dbus-daemon.exe, kded4.exe, kioslave.exe and klauncher.exe (and all other KDE apps).

Open a Windows command prompt (cmd.exe) and navigate to the directory where you installed KDE. Say you installed KDE to C:\KDE4, then run from the cmd.exe window:
C:\KDE4> '''bin\update-mime-database C:\KDE4\share\mime'''
This will give you a lot of warning message. Most of them you can easily ignore; even if you should set [[KDE_System_Administration/Environment_Variables#XDG_DATA_HOME|XDG_DATA_HOME]] or [[KDE_System_Administration/Environment_Variables#XDG_DATA_DIRS|XDG_DATA_DIRS]] it worked perfectly. If it says you should rerun update-mime-database as root then you're not within your installation directory.

===Run kbuildsyscoca4===
After finishing the previous step, run
C:\KDE4> '''bin\kbuildsycoca4 --noincremental'''
If this tells you that your disk is full (which is most probably not the case) you have still some executables from KDE running. Please close them and try again.

Excuse us for the inconvenience — we hope for a better solution in the next release.

== Testing your installation ==
Navigate to the <tt>bin</tt> directory.

See if you can run the Qt program assistant.exe.
Qt programs have fewer dependencies than a full-blown KDE application.

If that works, try running a simple KDE application, such as lskat.exe from the kdegames package.

The first KDE application you run will start a console window in order to run the [http://en.wikipedia.org/wiki/D-Bus D-Bus daemon].

== Fine-tuning ==
===Set Oxygen style for widgets===
The default KDE widget style on Windows is the native one. You already have Oxygen style installed (which is a plugin library %KDEROOT%\lib\kde4\plugins\styles\oxygen.dll), so it can be used as well. To set it for a single user:
#edit <tt>%UserPROFILE%\.kde\share\config\kdeglobals</tt> with any text editor (e.g. kwrite)
#locate line containing "[General]" text, what is a section, if there is no such line, add one
#replace or add <tt>widgetStyle=....</tt> line with <tt>widgetStyle=oxygen</tt>.
Newly started applications should be displayed with Oxygen style now.

== Status ==
Using kdewin-installer-gui-0.8.6.exe to install 4.00.60 packages:
* starting a KDE program correctly starts dbus-daemon.exe
* many games run
* choosing File > Open correctly starts klauncher.exe, kioslave.exe and kded4.exe, and runs kbuildsycoca4.exe as needed.
* Full-text search in khelpcenter does not work because Perl scripts are disabled.
* Many applications have a generic icon in Windows Explorer.
* Applications that try to play sounds might display an alert about "Multimedia Backend" problems. This requires the Windows backend for [http://phonon.kde.org/ Phonon]. The amarok package installs an experimental Windows phonon backend. Amarok plays music!!

General notes:
* There are many other KDE programs that are not part of KDE 4.0.0 and are not currently packaged for Windows, such as KOffice 2.
* By design, KDE-windows does not provide the full-blown KDE desktop, thus no KWin composite manager, KDE-specific "start" menus, Plasma desktop, etc.

=== Package status and contents ===
{| border="0" cellpadding="2"
|-valign="top"
!package
!status
!contains applications
|-valign="top"
|kdebase
|packaged
|Konqueror, Dolphin, KWrite, etc.
|-valign="top"
|kdegames
|packaged
|Kgoldrunner, Kpat, KMahjongg, etc.
|-valign="top"
|kdesdk
|packaged
|Kate, Umbrello, etc.
|-valign="top"
|kdetoys
|packaged
|KTeatime, etc.
|-valign="top"
|kdeedu
|packaged
|Marble, Parley, KStars, KHangman, etc.
|-valign="top"
|kdegraphics
|not packaged
|Okular, kolourpaint, etc.
|-valign="top"
|amarok
|packaged
|Amarok music player
|-valign="top"
|koffice
|not packaged
|KWord, Krita, Karbon, etc.
|-valign="top"
|kdepim
|not building
|KMail, AKregator, etc.
|-valign="top"
|kdenetwork
|not building
|Kopete, KGet, etc.
|-valign="top"
|kdeutils
|not packaged
|KGpg, KWallet, etc.
|}

[[Category: MS Windows]]

Projects/KDE on Windows/Installation

2008-02-26T22:07:38Z

Skierpage: /* Issues with KDE Installer for Windows */ installation version dependency

{{Template:I18n/Language Navigation Bar|Projects/KDE_on_Windows/Installation}}

{{note|Perhaps actual developers should summarize status of KDE4 on Windows here, while we encourage users to describe their experiences on the [[Talk:{{PAGENAME}}|Talk page?]]}}

== KDE Installer for Windows ==
You can use this installer to download and install the
various binary packages that you need to run KDE applications on MS Windows.
KDE is free and open source so you can build all the applications "from scratch" from their source code;
but as a convenience for others,
volunteers create these precompiled packages and make them available on the Internet.

'''Disclaimer''' These are early days for KDE4 on Windows,
some programs work better than others and some fail to run altogether.

'''If you experience any problems please have a look into our [http://lists.kde.org/?l=kde-windows&r=1&w=2| mailing list].'''

You can also use the KDE Installer for Windows to install source code and the packages that you need to ''build'' KDE4 on Windows
(although if you are building KDE4 on Windows you may prefer to use the emerge system to build KDE and its requirements from latest source);
see [[Getting Started/Build/KDE4/Windows]].

=== Summary of Steps ===
* Visit http://download.cegit.de/kde-windows/installer/
* Download and save the latest version to a directory, e.g. <tt>C:\KDE4</tt>
* Run the installer, download what you need (see [[#Download needed packages]] below).
* Add your lib directory, e.g. <tt>C:\KDE4\lib</tt> to your Windows %PATH%. (Start > Control Panel > System > Advanced > Environment Variables, double-click the Path System Variable and add this to your path separated by semicolon.)
* Add a KDEDIRS environment variable (Start > Control Panel > System > Advanced > Environment Variables, click [New] User variable and create Variable name <tt>KDEDIRS</tt> with Variable value the directory where you installed KDE4, e.g. <tt>C:\KDE4</tt>).
* [TEMPORARILY] Follow the instructions at [[#post-install steps]]
* Try running a Qt application in the <tt>bin</tt> directory, such as linguist.exe
* If that works, try running a KDE application such as <tt>kwrite.exe</tt>.

=== Download needed packages ===
A single program in the The K Desktop Environment depends on many other libraries and packages; that is why each .exe is comparatively small.
The KDE Installer for Windows has some awareness of dependencies,
but not complete.
So, the first few times you try to run an application you may see alerts about missing DLLs.

If you do not intend to build from source, do not click "all" and do not click "src", as you do not need to download the source for each package. ''Unclear whether you need lib for each''.

There are two development systems for KDE on Windows,
Microsoft's Visual C and [http://en.wikipedia.org/wiki/MinGW MinGW].
Even if you are only running binaries and do not intend to build KDE4 yourself,
you need to choose between these because of the provided runtime environments.
You're free to decide which to take.

The KDE programs themselves are organized into several groups: kdeedu, kdegames, and kdegraphics.

Here are some of the minimal packages you need to run a KDE application:
: dbus-msvc, kdebase-msvc, kdewin32-msvc, qt-msvc, vcredist, ??

The Dependencies tab for a particular package lists some of the additional packages it needs.
However, the dependency checking currently only works for first-level dependencies
Other dependencies are not easy to determine in advance.
For example, if you install kdegames only with its dependencies,
you will not be able to start it because you also need libstreamanalyze
(for which you have to install the strigi package).
rhabacker: This is fixed in installer version > 0.8.4.

[[Getting_Started/Build/KDE4/Windows/3rd-party_libraries]] is a more complete list of libraries that a full installation needs.

=== Issues with KDE Installer for Windows ===
The installer tracks dependencies on packages,
but not particular ''versions'' of packages.
So in end user install mode, the installer won't alert you to the existence of a newer version of a supporting package, and doesn't know when one of the "high-level" end-user packages requires this newer version.
: As a workaround, if you go into %KDEDIRS%\manifest and delete the .mft and .ver files for a package (e.g. qt-msvc-4.3.3-2-bin.mft, qt-msvc-4.3.3-2-bin.ver, etc.), the installer will see that you've uninstalled a package. Then, should another package require that package the installer will download the most recent one available from the mirror.

If you find an issue, please report to [mailto:kde-windows@kde.org].

== post-install steps ==
You currently need to run a number of command-line programs to set up KDE. Here are the steps.

===Run update-mime-database===
Be sure that you have no KDE-related applications: run the Windows Task Manager (taskmgr.exe), switch to its Processes tab, and kill all occurences of dbus-daemon.exe, kded4.exe, kioslave.exe and klauncher.exe (and all other KDE apps).

Open a Windows command prompt (cmd.exe) and navigate to the directory where you installed KDE. Say you installed KDE to C:\KDE4, then run from the cmd.exe window:
C:\KDE4> '''bin\update-mime-database C:\KDE4\share\mime'''
This will give you a lot of warning message. Most of them you can easily ignore; even if you should set [[KDE_System_Administration/Environment_Variables#XDG_DATA_HOME|XDG_DATA_HOME]] or [[KDE_System_Administration/Environment_Variables#XDG_DATA_DIRS|XDG_DATA_DIRS]] it worked perfectly. If it says you should rerun update-mime-database as root then you're not within your installation directory.

===Run kbuildsyscoca4===
After finishing the previous step, run
C:\KDE4> '''bin\kbuildsycoca4 --noincremental'''
If this tells you that your disk is full (which is most probably not the case) you have still some executables from KDE running. Please close them and try again.

Excuse us for the inconvenience — we hope for a better solution in the next release.

== Testing your installation ==
Navigate to the <tt>bin</tt> directory.

See if you can run the Qt program assistant.exe.
Qt programs have fewer dependencies than a full-blown KDE application.

If that works, try running a simple KDE application, such as lskat.exe from the kdegames package.

The first KDE application you run will start a console window in order to run the [http://en.wikipedia.org/wiki/D-Bus D-Bus daemon].

== Fine-tuning ==
===Set Oxygen style for widgets===
The default KDE widget style on Windows is the native one. You already have Oxygen style installed (which is a plugin library %KDEROOT%\lib\kde4\plugins\styles\oxygen.dll), so it can be used as well. To set it for a single user:
#edit <tt>%UserPROFILE%\.kde\share\config\kdeglobals</tt> with any text editor (e.g. kwrite)
#locate line containing "[General]" text, what is a section, if there is no such line, add one
#replace or add <tt>widgetStyle=....</tt> line with <tt>widgetStyle=oxygen</tt>.
Newly started applications should be displayed with Oxygen style now.

== Status ==
Using kdewin-installer-gui-0.8.6.exe to install 4.00.60 packages:
* starting a KDE program correctly starts dbus-daemon.exe
* many games run
* choosing File > Open correctly starts klauncher.exe, kioslave.exe and kded4.exe, and runs kbuildsycoca4.exe as needed.
* Full-text search in khelpcenter does not work because Perl scripts are disabled.
* Many applications have a generic icon in Windows Explorer.
* Applications that try to play sounds might display an alert about "Multimedia Backend" problems. This requires the Windows backend for [http://phonon.kde.org/ Phonon]. The amarok package installs an experimental Windows phonon backend. Amarok plays music!!

General notes:
* There are many other KDE programs that are not part of KDE 4.0.0 and are not currently packaged for Windows, such as KOffice 2.
* By design, KDE-windows does not provide the full-blown KDE desktop, thus no KWin composite manager, KDE-specific "start" menus, Plasma desktop, etc.

=== Package status and contents ===
{| border="0" cellpadding="2"
|-valign="top"
!package
!status
!contains applications
|-valign="top"
|kdebase
|packaged
|Konqueror, Dolphin, KWrite, etc.
|-valign="top"
|kdegames
|packaged
|Kgoldrunner, Kpat, KMahjongg, etc.
|-valign="top"
|kdesdk
|packaged
|Kate, Umbrello, etc.
|-valign="top"
|kdetoys
|packaged
|KTeatime, etc.
|-valign="top"
|kdeedu
|packaged
|Marble, Parley, KStars, KHangman, etc.
|-valign="top"
|kdegraphics
|not packaged
|Okular, kolourpaint, etc.
|-valign="top"
|amarok
|packaged
|Amarok music player
|-valign="top"
|koffice
|not packaged
|KWord, Krita, Karbon, etc.
|-valign="top"
|kdepim
|not building
|KMail, AKregator, etc.
|-valign="top"
|kdenetwork
|not building
|Kopete, KGet, etc.
|-valign="top"
|kdeutils
|not packaged
|KGpg, KWallet, etc.
|}

[[Category: MS Windows]]

Talk:Projects/KDE on Windows/Installation

2008-02-26T22:00:57Z

Skierpage: /* Someone somewhere wants to uninstall... */ guess

Use this page to record your experiences with KDE on Windows.

Before reporting problems with the installer please make sure that you are using the [http://download.cegit.de/kde-windows/installer/kdewin-installer-gui-0.8.6.exe latest installer version] because your problem may already be fixed.

Click the + tab and enter <nowiki>~~~~</nowiki> as the subject to add your experiences. Include both your installer version and the KDE version (from the "installed" column for the kde* package names in the installer, or from the Help > About KDE dialog).

'''Please use only meaningful descriptions (the content will be edited). The software is in early beta now. The installer will receive usability improvements before the final release.'''

== 4.00.80 progress - skierpage (18 February 2008) ==
Amarok installs a phonon package, and sounds play!

Enabling sound in KHangMan doesn't work, when it tries to play .ogg file it crashes. Amarok hangs at 98% CPU trying to play .ogg file. This could be my Windows install of codecs, but .ogg files play fine in WMP, VLC, MPC, etc.

KHelpCenter: Search doesn't return anything (known issue). Top sections such as "Welcome to KDE" and "KDE Users' Manual" don't do anything ({{Bug|158030}}).

Clicking on known filetypes in Dolphin gives <tt>C:/Program Files/KDE/share/applications/kde4/''some app''.desktop' is malformatted.</tt> alert ({{Bug|156442}}). You can't run a .exe from Dolphin, it prompts you to choose an application to open it with ({{Bug|158034}}).

Help > Report Bug still broken.

== A Blog "review" with screenshots - MrCopilot (30 January 2008) ==
See http://mrcopilot.blogspot.com/2008/01/can-kde-save-dying-windows-platform.html , with screenshots and comments on many KDE applications running in MS Windows.

== Version 0.8.5 notes - 75.128.118.56 (26 January 2008)==
Since I am not what you call a Linux guru, I tried initially installing as an end-user. However, that seems to not install certain things, and once you have made that choice, there is no going back - you can't change the installer settings from End User to Developer, and I think that may be why several packages are not being installed (for example, the kruler.exe program is not installed, and is not available to be installed)
: kruler.exe is part of kdegraphics, and as "Status" says, not currently packaged

Another example: When running konquerer.exe, if I type http://www.google.com into the search bar, it complains about the following missing files: konq_aboutpage.dll, libkhtmlpart.dll, and katepart.dll. None of those files were available to install. Perhaps they are available if you say you are a developer, but I had no way to test that because the buttons that select end user or developer are grayed out.
: Works for me, did you set KDEDIR and add the lib directory to your PATH as per "Summary of Steps"?

I do have one request, after you get the problems fixed, please consider adding krusader to the list of supported packages.

== [[User:Skierpage|Skierpage]] 11:33, 18 January 2008 (CET) using 3.97 ==
Here's [[User:Skierpage]]'s experience using kdewin-installer-gui-0.8.4-4.exe to install 3.97 2007-12-31 files
on Windows XP SP2.

=== Continuing ===
* No khelpcenter, so no Help > ''Program'' Handbook
* Help > Report Bug... > Launch Bug Report Wizard still does nothing ({{Bug|156689}} filed)
* <del>Problems trying to save and open files in apps, KDE complains about their mime type.</del> Fixed by new Post-install steps on install page!
* Get Hot New Stuff still has problems trying to run gpg.exe.

::please file bugs at B.K.O. (bugs.kde.org) --[[User:SaroEngels|SaroEngels]] 01:11, 25 January 2008 (CET)

=== File Open Dialog ===
* clicking Network icon <del>crashes </del>({{Bug|156080}} filed, fixed in 4.00.80 it displays ''Local Network'')
* clicking Home icon does nothing ({{Bug|156690}} filed, still true in 4.00.80).
* clicking Root shows '''Custom''' in file path. (still true in 4.00.80).
* DebugView shows several <tt>[5940] class QStringList __thiscall Solid::Backends::Hal::HalManager::findDeviceByDeviceInterface(const enum Solid::DeviceInterface::Type &) error: "org.freedesktop.DBus.Error.ServiceUnknown" </tt>

=== Specific Apps ===
==== KStars ====
* during startup or Setup Wizard outputs <tt> kstars(5344) class KStarsDateTime __cdecl KStarsDateTime::fromString(const class QString &): "Could not parse Date/Time string: " "" </tt>
* can't view Web pages from Object Details dialog > Links > View Resource. No error, but no activity. Possibly at the same time saw output "[5344] kstars(5344)/kdeui (KNotification) void __thiscall KNotification::slotReceivedIdError(const class QDBusError &): Error while contacting notify daemon "The name org.kde.knotify was not provided by any .service files"
"
:: I know this last error - but I don't know another fix than kill all apps and restart yet. --[[User:SaroEngels|SaroEngels]] 01:10, 25 January 2008 (CET)

== Issues ==

== [[User:Skierpage|Skierpage]] 07:43, 5 November 2007 (CET) on 2007-11-03 ==
Here's [[User:Skierpage]]'s experience partially installing files with
kdewin-installer-gui-0.8.1-2.exe
on Windows XP SP2.

''Some of my problems were caused by the KDE Installer silently failing to install kdebase bin.''

=== General ===
Each app's Help > Handbook fails to start

About the time I tried the handbook the program couldn't find the KDE crash handler drkonqi.exe.

Submit Bug Report fails to load anything when you click [Launch Bug Wizard];
nothing displays in Process Monitor or DebugView.

Okular and KStars crashed just after trying to access ksyscoca and then "launching kbuildsycoca4". I ran kbuildsycoca4 by hand and then both applications got further.

My display got garbled, displaying what looks like a backing store of the current window in the top left. This first happened with kolf.exe, then happened to KDE Installer. Closing every K* app seemed to cure it.

=== Specific apps ===
bovo, kblackbox, kgeography pixeltool, etc. worked fine.

==== Dolphin ====
<del>1. Even after following instructions in kbuildsycoca4 section below, still mime type id not getting picked up. In the information section it "shows type: mime" instead of correct type. Because of the same reason, I think, it shows all the elements with same icon (binary) including directories.</del>
: Fixed in 4.00.80 after running "Post-install steps"

2. If icon is clicked, open with dialog opens and if I choose kate from the list following error box appears "Service 'C:/KDE 4.0/share/applications/kde4/kate.desktop' is malformatted"
: Still happens in 4.00.80

==== KStars ====
Looks '''awesome'''. In the list of cities in setup,
accented characters appear incorrectly as multiple characters,
as if the encoding is off. [http://www.skierpage.com/kde_bugs/kstars_setup_bad_chars.png See screenshot.]

When I clicked [Download extra data], it crashes. In DebugView, last thing it tried to do was open ksycoca and then launch kbuildsycoca4.

After running kbuildsycoca4 and restarting, KStars [Download extra data] created a "Get Hot New Stuff", but that window was obscured by both KStars and its wizard. It had a [Close] button but would not accept input. I was able to [Cancel] the KStars setup window, at which point both the KStars and Get Hot New Stuff windows appeared. There was nothing in Get Hot New Stuff for "KStarsAdd On Installer" (sic -- word layout bug), so I clicked [Close].

Had some problems adding a new location (fumbled original data). Steps to reproduce:
Settings / geographic. Add a new location (Foo, norway). Realize something went wrong, edit latitude (change from say 10 10 10.00 to 11 11 11.00). Click OK. Choose OK to Override data. OK out. Open Setting/geographic again - there are now two Foos with location == original, expected was one, updated location.

==== kbuildsycoca4 ====
<strike>As this seemed to be causing problems, I ran it myself in a command window. It said "kbuildsycoca4 running..." then exited, seemingly OK.</strike>

The problem is another one:
kbuildsycoca4 builds the readonly database ksycoca in C:\Documents and Settings\USER\.kde\ .
That requires update-mime-database to have been successfully run.

So after each installation:
1. kill all processes: kioslave.exe, klauncher.exe, kded4.exe
2. enter kdeenv.bat (or a your cmd with KDEROOT set) run:
cd %KDEROOT%
%KDEROOT%\bin\update-mime-database %KDEROOT%\share\mime
%KDEROOT%\bin\kbuildsycoca4 --noincremental

update-mime-database prints lots of warnings; ignore them.
Only an error that you should rerun it as root, means that you are in the wrong directory. - Change to kderoot and rerun.

kbuildsycoca has a similar issue: if there are still some processes accessing ksycoca it will ask you whether your disk is full. You should kill all processes that are accessing this file (see process explorer from sysinternals.com ) and rerun it.

This stuff is due to be run by the installer or by emerge. I will hopefully fix this in the next few days. Until then this has to be run by hand.
--[[User:SaroEngels|SaroEngels]] 01:08, 25 January 2008 (CET)

==== KColorChooser ====
crashes when you choose "Named Colors" from the list.
(It fails to open several .mo files and .js files,
then tries to read rgb.txt from various X11 directories and obviously it's not there,
and then crashes.)

==== kruler ====
kruler's cursor in North or South orientation shows the vertical arrowhead and line but has black and white garbage on the other half of it where the selection point would be.

==== okular ====
First time it started klauncher.exe process but hung without displaying anything.
I killed the okular process and tried again; second time okular crashed; DebugView indicated it was trying to open ksyscoca, and when that failed it tried to launch ksyscocabuilder.exe:
[4644] okular(4644)/kdecore (KSycoca) bool __thiscall KSycocaPrivate::checkDatabase(class QFlags<enum KSycocaPrivate::BehaviorIfNotFound>): We have no database.... launching kbuildsycoca4
After running kbuildsycoca4 by hand okular appeared OK. When I chose File > Open I got an alert
Windows - No Disk
Exception Processing Message c00000013 Parameters ''hex hex hex''
I clicked [Continue] and got this alert again.
I think each time Windows was spinning up my empty floppy or CD-ROM drive.
Then the file dialog appeared but also an alert
Error - okular
The process for the file protocol died unexpectedly.

Meanwhile DebugView showed
[2916] not able to find 'kio_file' because KDEDIRS environment variable is not set.
[2916] Set KDEDIRS to the KDE installation root dir and restart klauncher to fix this problem.

I clicked Root in the file dialog and okular generated a ton of DebugView output in kdecore (KUrl) and then crashed.

I followed the instructions about setting up KDEDIRS, killed klauncher.exe, restarted Okular. I still got errors about No Disk but no more "file protocol death". Howeer, clicking Root in the file dialog still generates a ton of DebugView output and Okular crashes.

Even when I navigate to a folder with .png images in it, Open a document displays nothing. Even if I choose PNG image, it displays nothing. However, if I enter *.png in the Filter, it displays appropriate files.

However, choosing a png file results in okular displaying
Can not find a plugin that is able to handle the passed document
and then an error alert. Same for selecting a *.bmp.

Weirdly, entering *.jpg in the Filter immediately exits okular, with no errors.
::KBUILDSYCOCA4
::UPDATE_MIME_TYPE_ERROR --[[User:SaroEngels|SaroEngels]] 00:52, 25 January 2008 (CET)

==== ktouch ====
Exits, DebugView shows
[3452] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283
: In 4.00.80 displays friendlier alert "Unable to use the '''Fake''' Multimedia Backend: The shared library was not found."

==== kbruch ====
The accelerator [Alt+e] for [Next Task] does not work.

==== KDE World Clock ====
<del>Is pitch dark. The tooltip shows current city and add flag works. DebugView shows:
[4524] QImage::scaled: Image is a null image
[4524] QPainter::begin: Paint device returned engine == 0, type: 3
[4524] QPainter::setCompositionMode: Painter not active
[4524] QPainter::begin: Paint device returned engine == 0, type: 2

Its context menu has Map Theme > Surface Depth / Flat World / Surface Depth / Flat World , i.e. two entries repeated. Whatever you choose is checked twice.

I can't uncheck Show Daylight, Show Cities, Show Flags in the context menu, they remain checked.</del>
: All fixed in 4.00.80 version!

==== kteatime ====
It does display a fabulous notification bubble from the system tray when the tea is ready! Howeer, DebugView indicates "error while contacting knotify server" (I had configured KTeaTime to Play a sound, Show a message in a popup and Mark taskbar entry) :
[6052] kteatime(6052)/kdeui (KNotification) unsigned int __thiscall KNotificationManager::notify(class KNotification *,const class QPixmap &,const class QStringList &,const class QList<struct QPair<class QString,class QString> > &,const class QString &): error while contacting knotify server

==== khangman ====
It put up a dialog towards the back about progress, but unlike earlier app, that completed and it then worked great. I chose to, roughly. get words in a new language, chose France from the dialog/ Get Hot New Stuff showed up and worked but displayed an alert:
Error - KHangMan
Cannot start ''gpg'' and retrieve the available keys. Make sure that ''gpg'' is installed, otherwise verification of the downloaded resources will be impossible.

I installed gpgme and reran khangman, but now Get Hot New Stuff, did not display any categories.

I changed settings to play sounds and it immediately crashed with
[6072] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283

I got around this crash by editing khangmanrc to disable audio.
Still nothing in Get Hot New Stuff.

==== Kig ====
It worked pretty well, I was able to save a .kig file.
It kept prompting
Format not supported - Kig
Kig does not support saving to any other format than its own.
[Save Kig Format] [Cancel]
but if I choose "Save Kig Format" I get the alert again.
Only cancel worked to save the file.

However, when I tried to open that file, the Open dialog displayed its type as "plain text document", opening it led to a "Format Not Supported" alert. DebugView showed:
[5432] kig(5432)/kdecore (KUrl) __thiscall KUrl::KUrl(const class KUrl &): KUrl::KUrl(KUrl) path "" toLocalFile ""
[5432] kig(5432) bool __thiscall KigPart::openFile(void): mimetype: "text/plain"

So there are problems with mime type handling.
(It's scary that mime problems will stop a program from editing a file, how do I force it?)

::UPDATE_MIME_TYPE_ERROR --[[User:SaroEngels|SaroEngels]] 00:50, 25 January 2008 (CET)
:: Yup, fixed now with your "Post-install steps", thanks!

==== KWordQuiz ====
I was able to download French vocabulary, but when I dismissed it, I got the same alert as KHangMan once displayed
Cannot start gpg and retrieve the available keys. Make sure that gpg is installed.

kdelibs/knewstuff/knewstuff2/core/security.cpp is trying to start gpg in a new KProcess. I don't have `gpg` in my path, I'm not sure what package it's in.

::PLEASE ASSIGN TO B.K.O --[[User:SaroEngels|SaroEngels]] 00:49, 25 January 2008 (CET)

==== KGoldRunner ====
The background appears but none of the tiles, and the icons for them in Create New Game are missing. So some directory is missing, could be <tt>C:\KDE4\share\pixmaps</tt> NAME NOT FOUND, I don't know where the tiles should be.

[[Category: MS Windows]]

::PLEASE ASSIGN TO B.K.O --[[User:SaroEngels|SaroEngels]] 00:48, 25 January 2008 (CET)

== installation ==
I tried the installer, but found it very inconvenient. It is very slow in downloading, does not support broken download, had no resume support etc... An option be given to download the required packages through torrent / download express etc. and then run the Installer from downloaded directory. An ISO image to download entire package may also be good idea. What about Localized KDE? I could not found that option either.

== bug reports ==
After several minutes trying to find an adress to submit bug reports for kde on windows I report here that I have given up! This site is the only one I found to tell anyone about the problems.

Please post a link to a forum/bugreport engine or some email address.

::Please try to help copy the bugs to http://bugs.kde.org. Try to set Platform MS Windows. Please have a look after ''your'' bugs. -- [[User:SaroEngels|SaroEngels]] 00:46, 25 January 2008 (CET)

== Download needed packages ==

== Unnecessarities in packages? ==

Some things I noticed:
* A lot of packages come with both release and debug binaries. The latter one are completely useless, at least to end users. It may be more sensible to separate debug binaries into their own packages.

rhabacker: where do you have seen this ? the qt bin package for example only contain end user applications and libraries. Debug libraries are located in the lib packages which are only installed in developer mode.

* There seem to be mingw+msvc versions even for seemingly C libraries, e.g. dbus. Such libraries are usually easily exchangeable between compilers (e.g. an MSVC compiled library with a C interface usually works w/ MinGW without problems). Perhaps this is an opportunity to remove some unnecessary packages?

chehrlic: All is fine here, we need it the way it is. We also know how to use mingw libs with msvc and vice versa but it only works under specific circumstances which are not met here.

::::FIXLATER - [[User:SaroEngels|SaroEngels]] 00:41, 25 January 2008 (CET)
::::No change here - [[User:chehrlic|chehrlic]] 07:04, 25 January 2008 (CET)

== Wishes ==
Everything's workin' perfect. But am i able to fully transform windows desktop environment into KDE ?
:[[User:Jstaniek|jstaniek]] 18:31, 30 January 2008 (CET) - short answer is NO. Not in the default setup, I guess. The transformation would break many native apps. Even if that can be fixed (really?), most users would still consider any such a full transformation as a breakage of the OS. What to do? '''As you apparently ask about replacing every part of Windows with KDE equivalents, just install Linux, BSD, etc. and and get all that immediately and natively'''.

Will kdegraphics be included in the next release?
Will the next release be built from 4.0.1 or 4.0.60 sources(from Dirk Mueller's snapshots)?

== First attempt at using ANY KDE installer for windows... - 212.32.82.218 ( 9 February 2008) ==

Guys - it's interesting that i'm in the position of needing to use KDE. I would use Linux in some form without ever going near Windows.

However, I need to provide support for many customers who need Windows and so am stuck with it.

So here we are, I want to get the features of some KDE and then I notice this site.

All goes well... used the [http://download.cegit.de/kde-windows/installer/kdewin-installer-gui-0.8.6.exe latest installer].

It goes well, and the installer stops.

The next instructions are to add Path references. Did that.

Then it is time for the fun...

bin\update-mime-database C:\KDE4\share\mime is the command to run next...

I've restarted so I expect it to do something specific. Nothing... then an error message.

Also, tried different options during the install process but got no further...

"Update-mime-database - Unable to Locate Component"
"This application has failed to start because libintl3.dll was not found. Re-installing the application may fix this problem."

I have no idea where to go, i've removed and reinstalled and get the same effect. I'm clearly being thick so will continue to search for the answer myself but any pointers would be lovely.

Cheers all.

rhabacker: This looks like a dependency problem - which requires to know which mirror you are using - without this information we cannot help.

dkintheuk: OK I posted the link i used in the body of this post. http://download.cegit.de/kde-windows/installer/kdewin-installer-gui-0.8.6.exe
I'm not sure what you mean by a dependancy problem - what do i look for and how do i determine what you guys need to know to help? Thanks for getting back to me though i do appreciate it.

dkintheuk: ok it's alive - used the next installer and it indicated that several components were not installed even though the previous installer said they were. I have amarok running right now and tried out some interesting things but can't get one thing to work...

I can't get bin\update-mime-database C:\KDE4\share\mime to work at all - it tells me that it doesn have permissions - yet it most definitely does... tested and tested and tested - permissions are properly set.

Ah well - happy bunny here - this is really fun.

== Someone somewhere wants to uninstall... ==
<nowiki> I want to know how to uninstall it. Thanks </nowiki>
: (Please sign your edits with <nowiki>~~~~</nowiki>!) I'm guessing something like:
:* In TaskMgr.exe processes, shut down kded4, dbus-daemon, klauncher, etc.
:* Run kdewin-installer, click each installed package until it shows a garbage can, then complete the installer
:* Remove lib directory from %PATH% and the KDEDIRS environment variable (see [[{{PAGENAME}}#Summary_of_Steps]]
:* clean up your Download Path of all the downloaded packages, and delete your install directory.
: -- [[User:Skierpage|Skierpage]] 23:00, 26 February 2008 (CET)

Talk:Projects/KDE on Windows/Installation

2008-02-19T07:02:56Z

Skierpage: /* 4.00.80 progress - skierpage (18 February 2008) */ more bug details

Use this page to record your experiences with KDE on Windows.

Before reporting problems with the installer please make sure that you are using the [http://download.cegit.de/kde-windows/installer/kdewin-installer-gui-0.8.6.exe latest installer version] because your problem may already be fixed.

Click the + tab and enter <nowiki>~~~~</nowiki> as the subject to add your experiences. Include both your installer version and the KDE version (from the "installed" column for the kde* package names in the installer, or from the Help > About KDE dialog).

'''Please use only meaningful descriptions (the content will be edited). The software is in early beta now. The installer will receive usability improvements before the final release.'''

== 4.00.80 progress - skierpage (18 February 2008) ==
Amarok installs a phonon package, and sounds play!

Enabling sound in KHangMan doesn't work, when it tries to play .ogg file it crashes. Amarok hangs at 98% CPU trying to play .ogg file. This could be my Windows install of codecs, but .ogg files play fine in WMP, VLC, MPC, etc.

KHelpCenter: Search doesn't return anything (known issue). Top sections such as "Welcome to KDE" and "KDE Users' Manual" don't do anything ({{Bug|158030}}).

Clicking on known filetypes in Dolphin gives <tt>C:/Program Files/KDE/share/applications/kde4/''some app''.desktop' is malformatted.</tt> alert ({{Bug|156442}}). You can't run a .exe from Dolphin, it prompts you to choose an application to open it with ({{Bug|158034}}).

Help > Report Bug still broken.

== A Blog "review" with screenshots - MrCopilot (30 January 2008) ==
See http://mrcopilot.blogspot.com/2008/01/can-kde-save-dying-windows-platform.html , with screenshots and comments on many KDE applications running in MS Windows.

== Version 0.8.5 notes - 75.128.118.56 (26 January 2008)==
Since I am not what you call a Linux guru, I tried initially installing as an end-user. However, that seems to not install certain things, and once you have made that choice, there is no going back - you can't change the installer settings from End User to Developer, and I think that may be why several packages are not being installed (for example, the kruler.exe program is not installed, and is not available to be installed)
: kruler.exe is part of kdegraphics, and as "Status" says, not currently packaged

Another example: When running konquerer.exe, if I type http://www.google.com into the search bar, it complains about the following missing files: konq_aboutpage.dll, libkhtmlpart.dll, and katepart.dll. None of those files were available to install. Perhaps they are available if you say you are a developer, but I had no way to test that because the buttons that select end user or developer are grayed out.
: Works for me, did you set KDEDIR and add the lib directory to your PATH as per "Summary of Steps"?

I do have one request, after you get the problems fixed, please consider adding krusader to the list of supported packages.

== [[User:Skierpage|Skierpage]] 11:33, 18 January 2008 (CET) using 3.97 ==
Here's [[User:Skierpage]]'s experience using kdewin-installer-gui-0.8.4-4.exe to install 3.97 2007-12-31 files
on Windows XP SP2.

=== Continuing ===
* No khelpcenter, so no Help > ''Program'' Handbook
* Help > Report Bug... > Launch Bug Report Wizard still does nothing ({{Bug|156689}} filed)
* <del>Problems trying to save and open files in apps, KDE complains about their mime type.</del> Fixed by new Post-install steps on install page!
* Get Hot New Stuff still has problems trying to run gpg.exe.

::please file bugs at B.K.O. (bugs.kde.org) --[[User:SaroEngels|SaroEngels]] 01:11, 25 January 2008 (CET)

=== File Open Dialog ===
* clicking Network icon <del>crashes </del>({{Bug|156080}} filed, fixed in 4.00.80 it displays ''Local Network'')
* clicking Home icon does nothing ({{Bug|156690}} filed, still true in 4.00.80).
* clicking Root shows '''Custom''' in file path. (still true in 4.00.80).
* DebugView shows several <tt>[5940] class QStringList __thiscall Solid::Backends::Hal::HalManager::findDeviceByDeviceInterface(const enum Solid::DeviceInterface::Type &) error: "org.freedesktop.DBus.Error.ServiceUnknown" </tt>

=== Specific Apps ===
==== KStars ====
* during startup or Setup Wizard outputs <tt> kstars(5344) class KStarsDateTime __cdecl KStarsDateTime::fromString(const class QString &): "Could not parse Date/Time string: " "" </tt>
* can't view Web pages from Object Details dialog > Links > View Resource. No error, but no activity. Possibly at the same time saw output "[5344] kstars(5344)/kdeui (KNotification) void __thiscall KNotification::slotReceivedIdError(const class QDBusError &): Error while contacting notify daemon "The name org.kde.knotify was not provided by any .service files"
"
:: I know this last error - but I don't know another fix than kill all apps and restart yet. --[[User:SaroEngels|SaroEngels]] 01:10, 25 January 2008 (CET)

== Issues ==

== [[User:Skierpage|Skierpage]] 07:43, 5 November 2007 (CET) on 2007-11-03 ==
Here's [[User:Skierpage]]'s experience partially installing files with
kdewin-installer-gui-0.8.1-2.exe
on Windows XP SP2.

''Some of my problems were caused by the KDE Installer silently failing to install kdebase bin.''

=== General ===
Each app's Help > Handbook fails to start

About the time I tried the handbook the program couldn't find the KDE crash handler drkonqi.exe.

Submit Bug Report fails to load anything when you click [Launch Bug Wizard];
nothing displays in Process Monitor or DebugView.

Okular and KStars crashed just after trying to access ksyscoca and then "launching kbuildsycoca4". I ran kbuildsycoca4 by hand and then both applications got further.

My display got garbled, displaying what looks like a backing store of the current window in the top left. This first happened with kolf.exe, then happened to KDE Installer. Closing every K* app seemed to cure it.

=== Specific apps ===
bovo, kblackbox, kgeography pixeltool, etc. worked fine.

==== Dolphin ====
<del>1. Even after following instructions in kbuildsycoca4 section below, still mime type id not getting picked up. In the information section it "shows type: mime" instead of correct type. Because of the same reason, I think, it shows all the elements with same icon (binary) including directories.</del>
: Fixed in 4.00.80 after running "Post-install steps"

2. If icon is clicked, open with dialog opens and if I choose kate from the list following error box appears "Service 'C:/KDE 4.0/share/applications/kde4/kate.desktop' is malformatted"
: Still happens in 4.00.80

==== KStars ====
Looks '''awesome'''. In the list of cities in setup,
accented characters appear incorrectly as multiple characters,
as if the encoding is off. [http://www.skierpage.com/kde_bugs/kstars_setup_bad_chars.png See screenshot.]

When I clicked [Download extra data], it crashes. In DebugView, last thing it tried to do was open ksycoca and then launch kbuildsycoca4.

After running kbuildsycoca4 and restarting, KStars [Download extra data] created a "Get Hot New Stuff", but that window was obscured by both KStars and its wizard. It had a [Close] button but would not accept input. I was able to [Cancel] the KStars setup window, at which point both the KStars and Get Hot New Stuff windows appeared. There was nothing in Get Hot New Stuff for "KStarsAdd On Installer" (sic -- word layout bug), so I clicked [Close].

Had some problems adding a new location (fumbled original data). Steps to reproduce:
Settings / geographic. Add a new location (Foo, norway). Realize something went wrong, edit latitude (change from say 10 10 10.00 to 11 11 11.00). Click OK. Choose OK to Override data. OK out. Open Setting/geographic again - there are now two Foos with location == original, expected was one, updated location.

==== kbuildsycoca4 ====
<strike>As this seemed to be causing problems, I ran it myself in a command window. It said "kbuildsycoca4 running..." then exited, seemingly OK.</strike>

The problem is another one:
kbuildsycoca4 builds the readonly database ksycoca in C:\Documents and Settings\USER\.kde\ .
That requires update-mime-database to have been successfully run.

So after each installation:
1. kill all processes: kioslave.exe, klauncher.exe, kded4.exe
2. enter kdeenv.bat (or a your cmd with KDEROOT set) run:
cd %KDEROOT%
%KDEROOT%\bin\update-mime-database %KDEROOT%\share\mime
%KDEROOT%\bin\kbuildsycoca4 --noincremental

update-mime-database prints lots of warnings; ignore them.
Only an error that you should rerun it as root, means that you are in the wrong directory. - Change to kderoot and rerun.

kbuildsycoca has a similar issue: if there are still some processes accessing ksycoca it will ask you whether your disk is full. You should kill all processes that are accessing this file (see process explorer from sysinternals.com ) and rerun it.

This stuff is due to be run by the installer or by emerge. I will hopefully fix this in the next few days. Until then this has to be run by hand.
--[[User:SaroEngels|SaroEngels]] 01:08, 25 January 2008 (CET)

==== KColorChooser ====
crashes when you choose "Named Colors" from the list.
(It fails to open several .mo files and .js files,
then tries to read rgb.txt from various X11 directories and obviously it's not there,
and then crashes.)

==== kruler ====
kruler's cursor in North or South orientation shows the vertical arrowhead and line but has black and white garbage on the other half of it where the selection point would be.

==== okular ====
First time it started klauncher.exe process but hung without displaying anything.
I killed the okular process and tried again; second time okular crashed; DebugView indicated it was trying to open ksyscoca, and when that failed it tried to launch ksyscocabuilder.exe:
[4644] okular(4644)/kdecore (KSycoca) bool __thiscall KSycocaPrivate::checkDatabase(class QFlags<enum KSycocaPrivate::BehaviorIfNotFound>): We have no database.... launching kbuildsycoca4
After running kbuildsycoca4 by hand okular appeared OK. When I chose File > Open I got an alert
Windows - No Disk
Exception Processing Message c00000013 Parameters ''hex hex hex''
I clicked [Continue] and got this alert again.
I think each time Windows was spinning up my empty floppy or CD-ROM drive.
Then the file dialog appeared but also an alert
Error - okular
The process for the file protocol died unexpectedly.

Meanwhile DebugView showed
[2916] not able to find 'kio_file' because KDEDIRS environment variable is not set.
[2916] Set KDEDIRS to the KDE installation root dir and restart klauncher to fix this problem.

I clicked Root in the file dialog and okular generated a ton of DebugView output in kdecore (KUrl) and then crashed.

I followed the instructions about setting up KDEDIRS, killed klauncher.exe, restarted Okular. I still got errors about No Disk but no more "file protocol death". Howeer, clicking Root in the file dialog still generates a ton of DebugView output and Okular crashes.

Even when I navigate to a folder with .png images in it, Open a document displays nothing. Even if I choose PNG image, it displays nothing. However, if I enter *.png in the Filter, it displays appropriate files.

However, choosing a png file results in okular displaying
Can not find a plugin that is able to handle the passed document
and then an error alert. Same for selecting a *.bmp.

Weirdly, entering *.jpg in the Filter immediately exits okular, with no errors.
::KBUILDSYCOCA4
::UPDATE_MIME_TYPE_ERROR --[[User:SaroEngels|SaroEngels]] 00:52, 25 January 2008 (CET)

==== ktouch ====
Exits, DebugView shows
[3452] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283
: In 4.00.80 displays friendlier alert "Unable to use the '''Fake''' Multimedia Backend: The shared library was not found."

==== kbruch ====
The accelerator [Alt+e] for [Next Task] does not work.

==== KDE World Clock ====
<del>Is pitch dark. The tooltip shows current city and add flag works. DebugView shows:
[4524] QImage::scaled: Image is a null image
[4524] QPainter::begin: Paint device returned engine == 0, type: 3
[4524] QPainter::setCompositionMode: Painter not active
[4524] QPainter::begin: Paint device returned engine == 0, type: 2

Its context menu has Map Theme > Surface Depth / Flat World / Surface Depth / Flat World , i.e. two entries repeated. Whatever you choose is checked twice.

I can't uncheck Show Daylight, Show Cities, Show Flags in the context menu, they remain checked.</del>
: All fixed in 4.00.80 version!

==== kteatime ====
It does display a fabulous notification bubble from the system tray when the tea is ready! Howeer, DebugView indicates "error while contacting knotify server" (I had configured KTeaTime to Play a sound, Show a message in a popup and Mark taskbar entry) :
[6052] kteatime(6052)/kdeui (KNotification) unsigned int __thiscall KNotificationManager::notify(class KNotification *,const class QPixmap &,const class QStringList &,const class QList<struct QPair<class QString,class QString> > &,const class QString &): error while contacting knotify server

==== khangman ====
It put up a dialog towards the back about progress, but unlike earlier app, that completed and it then worked great. I chose to, roughly. get words in a new language, chose France from the dialog/ Get Hot New Stuff showed up and worked but displayed an alert:
Error - KHangMan
Cannot start ''gpg'' and retrieve the available keys. Make sure that ''gpg'' is installed, otherwise verification of the downloaded resources will be impossible.

I installed gpgme and reran khangman, but now Get Hot New Stuff, did not display any categories.

I changed settings to play sounds and it immediately crashed with
[6072] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283

I got around this crash by editing khangmanrc to disable audio.
Still nothing in Get Hot New Stuff.

==== Kig ====
It worked pretty well, I was able to save a .kig file.
It kept prompting
Format not supported - Kig
Kig does not support saving to any other format than its own.
[Save Kig Format] [Cancel]
but if I choose "Save Kig Format" I get the alert again.
Only cancel worked to save the file.

However, when I tried to open that file, the Open dialog displayed its type as "plain text document", opening it led to a "Format Not Supported" alert. DebugView showed:
[5432] kig(5432)/kdecore (KUrl) __thiscall KUrl::KUrl(const class KUrl &): KUrl::KUrl(KUrl) path "" toLocalFile ""
[5432] kig(5432) bool __thiscall KigPart::openFile(void): mimetype: "text/plain"

So there are problems with mime type handling.
(It's scary that mime problems will stop a program from editing a file, how do I force it?)

::UPDATE_MIME_TYPE_ERROR --[[User:SaroEngels|SaroEngels]] 00:50, 25 January 2008 (CET)
:: Yup, fixed now with your "Post-install steps", thanks!

==== KWordQuiz ====
I was able to download French vocabulary, but when I dismissed it, I got the same alert as KHangMan once displayed
Cannot start gpg and retrieve the available keys. Make sure that gpg is installed.

kdelibs/knewstuff/knewstuff2/core/security.cpp is trying to start gpg in a new KProcess. I don't have `gpg` in my path, I'm not sure what package it's in.

::PLEASE ASSIGN TO B.K.O --[[User:SaroEngels|SaroEngels]] 00:49, 25 January 2008 (CET)

==== KGoldRunner ====
The background appears but none of the tiles, and the icons for them in Create New Game are missing. So some directory is missing, could be <tt>C:\KDE4\share\pixmaps</tt> NAME NOT FOUND, I don't know where the tiles should be.

[[Category: MS Windows]]

::PLEASE ASSIGN TO B.K.O --[[User:SaroEngels|SaroEngels]] 00:48, 25 January 2008 (CET)

== installation ==

== bug reports ==
After several minutes trying to find an adress to submit bug reports for kde on windows I report here that I have given up! This site is the only one I found to tell anyone about the problems.

Please post a link to a forum/bugreport engine or some email address.

::Please try to help copy the bugs to http://bugs.kde.org. Try to set Platform MS Windows. Please have a look after ''your'' bugs. -- [[User:SaroEngels|SaroEngels]] 00:46, 25 January 2008 (CET)

== Download needed packages ==

== Unnecessarities in packages? ==

Some things I noticed:
* A lot of packages come with both release and debug binaries. The latter one are completely useless, at least to end users. It may be more sensible to separate debug binaries into their own packages.

rhabacker: where do you have seen this ? the qt bin package for example only contain end user applications and libraries. Debug libraries are located in the lib packages which are only installed in developer mode.

* There seem to be mingw+msvc versions even for seemingly C libraries, e.g. dbus. Such libraries are usually easily exchangeable between compilers (e.g. an MSVC compiled library with a C interface usually works w/ MinGW without problems). Perhaps this is an opportunity to remove some unnecessary packages?

chehrlic: All is fine here, we need it the way it is. We also know how to use mingw libs with msvc and vice versa but it only works under specific circumstances which are not met here.

::::FIXLATER - [[User:SaroEngels|SaroEngels]] 00:41, 25 January 2008 (CET)
::::No change here - [[User:chehrlic|chehrlic]] 07:04, 25 January 2008 (CET)

== Wishes ==
Everything's workin' perfect. But am i able to fully transform windows desktop environment into KDE ?
:[[User:Jstaniek|jstaniek]] 18:31, 30 January 2008 (CET) - short answer is NO. Not in the default setup, I guess. The transformation would break many native apps. Even if that can be fixed (really?), most users would still consider any such a full transformation as a breakage of the OS. What to do? '''As you apparently ask about replacing every part of Windows with KDE equivalents, just install Linux, BSD, etc. and and get all that immediately and natively'''.

Will kdegraphics be included in the next release?
Will the next release be built from 4.0.1 or 4.0.60 sources(from Dirk Mueller's snapshots)?

== First attempt at using ANY KDE installer for windows... - 212.32.82.218 ( 9 February 2008) ==

Guys - it's interesting that i'm in the position of needing to use KDE. I would use Linux in some form without ever going near Windows.

However, I need to provide support for many customers who need Windows and so am stuck with it.

So here we are, I want to get the features of some KDE and then I notice this site.

All goes well... used the [http://download.cegit.de/kde-windows/installer/kdewin-installer-gui-0.8.6.exe latest installer].

It goes well, and the installer stops.

The next instructions are to add Path references. Did that.

Then it is time for the fun...

bin\update-mime-database C:\KDE4\share\mime is the command to run next...

I've restarted so I expect it to do something specific. Nothing... then an error message.

Also, tried different options during the install process but got no further...

"Update-mime-database - Unable to Locate Component"
"This application has failed to start because libintl3.dll was not found. Re-installing the application may fix this problem."

I have no idea where to go, i've removed and reinstalled and get the same effect. I'm clearly being thick so will continue to search for the answer myself but any pointers would be lovely.

Cheers all.

rhabacker: This looks like a dependency problem - which requires to know which mirror you are using - without this information we cannot help.

dkintheuk: OK I posted the link i used in the body of this post. http://download.cegit.de/kde-windows/installer/kdewin-installer-gui-0.8.6.exe
I'm not sure what you mean by a dependancy problem - what do i look for and how do i determine what you guys need to know to help? Thanks for getting back to me though i do appreciate it.

dkintheuk: ok it's alive - used the next installer and it indicated that several components were not installed even though the previous installer said they were. I have amarok running right now and tried out some interesting things but can't get one thing to work...

I can't get bin\update-mime-database C:\KDE4\share\mime to work at all - it tells me that it doesn have permissions - yet it most definitely does... tested and tested and tested - permissions are properly set.

Ah well - happy bunny here - this is really fun.

== Someone somewhere wants to uninstall... ==
<nowiki> I want to know how to uninstall it. Thanks </nowiki>

Talk:Projects/KDE on Windows/Installation

2008-02-19T00:49:49Z

Skierpage: /* A Blog "review" with screenshots - MrCopilot (30 January 2008) */

Use this page to record your experiences with KDE on Windows.

Before reporting problems with the installer please make sure that you are using the [http://download.cegit.de/kde-windows/installer/kdewin-installer-gui-0.8.6.exe latest installer version] because your problem may already be fixed.

Click the + tab and enter <nowiki>~~~~</nowiki> as the subject to add your experiences. Include both your installer version and the KDE version (from the "installed" column for the kde* package names in the installer, or from the Help > About KDE dialog).

'''Please use only meaningful descriptions (the content will be edited). The software is in early beta now. The installer will receive usability improvements before the final release.'''

== 4.00.80 progress - skierpage (18 February 2008) ==
Amarok installs a phonon package, and sounds play!

Enabling sound in KHangMan doesn't work, then on next start KHangMan displays
: ActiveMovie Window: khangman.exe - Unable To Locate Component This application has failed to start becasue libFLAC++.dll was not found. Re-installing the application may fix this problem.
and then crashes.

KHelpCenter fires up. Search doesn't return anything (known issue). Top sections "Welcome to KDE" and "KDE Users' Manual" don't do anything.

== A Blog "review" with screenshots - MrCopilot (30 January 2008) ==
See http://mrcopilot.blogspot.com/2008/01/can-kde-save-dying-windows-platform.html , with screenshots and comments on many KDE applications running in MS Windows.

== Version 0.8.5 notes - 75.128.118.56 (26 January 2008)==
Since I am not what you call a Linux guru, I tried initially installing as an end-user. However, that seems to not install certain things, and once you have made that choice, there is no going back - you can't change the installer settings from End User to Developer, and I think that may be why several packages are not being installed (for example, the kruler.exe program is not installed, and is not available to be installed)
: kruler.exe is part of kdegraphics, and as "Status" says, not currently packaged

Another example: When running konquerer.exe, if I type http://www.google.com into the search bar, it complains about the following missing files: konq_aboutpage.dll, libkhtmlpart.dll, and katepart.dll. None of those files were available to install. Perhaps they are available if you say you are a developer, but I had no way to test that because the buttons that select end user or developer are grayed out.
: Works for me, did you set KDEDIR and add the lib directory to your PATH as per "Summary of Steps"?

I do have one request, after you get the problems fixed, please consider adding krusader to the list of supported packages.

== [[User:Skierpage|Skierpage]] 11:33, 18 January 2008 (CET) using 3.97 ==
Here's [[User:Skierpage]]'s experience using kdewin-installer-gui-0.8.4-4.exe to install 3.97 2007-12-31 files
on Windows XP SP2.

=== Continuing ===
* No khelpcenter, so no Help > ''Program'' Handbook
* Help > Report Bug... > Launch Bug Report Wizard still does nothing ({{Bug|156689}} filed)
* <del>Problems trying to save and open files in apps, KDE complains about their mime type.</del> Fixed by new Post-install steps on install page!
* Get Hot New Stuff still has problems trying to run gpg.exe.

::please file bugs at B.K.O. (bugs.kde.org) --[[User:SaroEngels|SaroEngels]] 01:11, 25 January 2008 (CET)

=== File Open Dialog ===
* clicking Network icon <del>crashes </del>({{Bug|156080}} filed, fixed in 4.00.80 it displays ''Local Network'')
* clicking Home icon does nothing ({{Bug|156690}} filed, still true in 4.00.80).
* clicking Root shows '''Custom''' in file path. (still true in 4.00.80).
* DebugView shows several <tt>[5940] class QStringList __thiscall Solid::Backends::Hal::HalManager::findDeviceByDeviceInterface(const enum Solid::DeviceInterface::Type &) error: "org.freedesktop.DBus.Error.ServiceUnknown" </tt>

=== Specific Apps ===
==== KStars ====
* during startup or Setup Wizard outputs <tt> kstars(5344) class KStarsDateTime __cdecl KStarsDateTime::fromString(const class QString &): "Could not parse Date/Time string: " "" </tt>
* can't view Web pages from Object Details dialog > Links > View Resource. No error, but no activity. Possibly at the same time saw output "[5344] kstars(5344)/kdeui (KNotification) void __thiscall KNotification::slotReceivedIdError(const class QDBusError &): Error while contacting notify daemon "The name org.kde.knotify was not provided by any .service files"
"
:: I know this last error - but I don't know another fix than kill all apps and restart yet. --[[User:SaroEngels|SaroEngels]] 01:10, 25 January 2008 (CET)

== Issues ==

== [[User:Skierpage|Skierpage]] 07:43, 5 November 2007 (CET) on 2007-11-03 ==
Here's [[User:Skierpage]]'s experience partially installing files with
kdewin-installer-gui-0.8.1-2.exe
on Windows XP SP2.

''Some of my problems were caused by the KDE Installer silently failing to install kdebase bin.''

=== General ===
Each app's Help > Handbook fails to start

About the time I tried the handbook the program couldn't find the KDE crash handler drkonqi.exe.

Submit Bug Report fails to load anything when you click [Launch Bug Wizard];
nothing displays in Process Monitor or DebugView.

Okular and KStars crashed just after trying to access ksyscoca and then "launching kbuildsycoca4". I ran kbuildsycoca4 by hand and then both applications got further.

My display got garbled, displaying what looks like a backing store of the current window in the top left. This first happened with kolf.exe, then happened to KDE Installer. Closing every K* app seemed to cure it.

=== Specific apps ===
bovo, kblackbox, kgeography pixeltool, etc. worked fine.

==== Dolphin ====
<del>1. Even after following instructions in kbuildsycoca4 section below, still mime type id not getting picked up. In the information section it "shows type: mime" instead of correct type. Because of the same reason, I think, it shows all the elements with same icon (binary) including directories.</del>
: Fixed in 4.00.80 after running "Post-install steps"

2. If icon is clicked, open with dialog opens and if I choose kate from the list following error box appears "Service 'C:/KDE 4.0/share/applications/kde4/kate.desktop' is malformatted"
: Still happens in 4.00.80

==== KStars ====
Looks '''awesome'''. In the list of cities in setup,
accented characters appear incorrectly as multiple characters,
as if the encoding is off. [http://www.skierpage.com/kde_bugs/kstars_setup_bad_chars.png See screenshot.]

When I clicked [Download extra data], it crashes. In DebugView, last thing it tried to do was open ksycoca and then launch kbuildsycoca4.

After running kbuildsycoca4 and restarting, KStars [Download extra data] created a "Get Hot New Stuff", but that window was obscured by both KStars and its wizard. It had a [Close] button but would not accept input. I was able to [Cancel] the KStars setup window, at which point both the KStars and Get Hot New Stuff windows appeared. There was nothing in Get Hot New Stuff for "KStarsAdd On Installer" (sic -- word layout bug), so I clicked [Close].

Had some problems adding a new location (fumbled original data). Steps to reproduce:
Settings / geographic. Add a new location (Foo, norway). Realize something went wrong, edit latitude (change from say 10 10 10.00 to 11 11 11.00). Click OK. Choose OK to Override data. OK out. Open Setting/geographic again - there are now two Foos with location == original, expected was one, updated location.

==== kbuildsycoca4 ====
<strike>As this seemed to be causing problems, I ran it myself in a command window. It said "kbuildsycoca4 running..." then exited, seemingly OK.</strike>

The problem is another one:
kbuildsycoca4 builds the readonly database ksycoca in C:\Documents and Settings\USER\.kde\ .
That requires update-mime-database to have been successfully run.

So after each installation:
1. kill all processes: kioslave.exe, klauncher.exe, kded4.exe
2. enter kdeenv.bat (or a your cmd with KDEROOT set) run:
cd %KDEROOT%
%KDEROOT%\bin\update-mime-database %KDEROOT%\share\mime
%KDEROOT%\bin\kbuildsycoca4 --noincremental

update-mime-database prints lots of warnings; ignore them.
Only an error that you should rerun it as root, means that you are in the wrong directory. - Change to kderoot and rerun.

kbuildsycoca has a similar issue: if there are still some processes accessing ksycoca it will ask you whether your disk is full. You should kill all processes that are accessing this file (see process explorer from sysinternals.com ) and rerun it.

This stuff is due to be run by the installer or by emerge. I will hopefully fix this in the next few days. Until then this has to be run by hand.
--[[User:SaroEngels|SaroEngels]] 01:08, 25 January 2008 (CET)

==== KColorChooser ====
crashes when you choose "Named Colors" from the list.
(It fails to open several .mo files and .js files,
then tries to read rgb.txt from various X11 directories and obviously it's not there,
and then crashes.)

==== kruler ====
kruler's cursor in North or South orientation shows the vertical arrowhead and line but has black and white garbage on the other half of it where the selection point would be.

==== okular ====
First time it started klauncher.exe process but hung without displaying anything.
I killed the okular process and tried again; second time okular crashed; DebugView indicated it was trying to open ksyscoca, and when that failed it tried to launch ksyscocabuilder.exe:
[4644] okular(4644)/kdecore (KSycoca) bool __thiscall KSycocaPrivate::checkDatabase(class QFlags<enum KSycocaPrivate::BehaviorIfNotFound>): We have no database.... launching kbuildsycoca4
After running kbuildsycoca4 by hand okular appeared OK. When I chose File > Open I got an alert
Windows - No Disk
Exception Processing Message c00000013 Parameters ''hex hex hex''
I clicked [Continue] and got this alert again.
I think each time Windows was spinning up my empty floppy or CD-ROM drive.
Then the file dialog appeared but also an alert
Error - okular
The process for the file protocol died unexpectedly.

Meanwhile DebugView showed
[2916] not able to find 'kio_file' because KDEDIRS environment variable is not set.
[2916] Set KDEDIRS to the KDE installation root dir and restart klauncher to fix this problem.

I clicked Root in the file dialog and okular generated a ton of DebugView output in kdecore (KUrl) and then crashed.

I followed the instructions about setting up KDEDIRS, killed klauncher.exe, restarted Okular. I still got errors about No Disk but no more "file protocol death". Howeer, clicking Root in the file dialog still generates a ton of DebugView output and Okular crashes.

Even when I navigate to a folder with .png images in it, Open a document displays nothing. Even if I choose PNG image, it displays nothing. However, if I enter *.png in the Filter, it displays appropriate files.

However, choosing a png file results in okular displaying
Can not find a plugin that is able to handle the passed document
and then an error alert. Same for selecting a *.bmp.

Weirdly, entering *.jpg in the Filter immediately exits okular, with no errors.
::KBUILDSYCOCA4
::UPDATE_MIME_TYPE_ERROR --[[User:SaroEngels|SaroEngels]] 00:52, 25 January 2008 (CET)

==== ktouch ====
Exits, DebugView shows
[3452] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283
: In 4.00.80 displays friendlier alert "Unable to use the '''Fake''' Multimedia Backend: The shared library was not found."

==== kbruch ====
The accelerator [Alt+e] for [Next Task] does not work.

==== KDE World Clock ====
<del>Is pitch dark. The tooltip shows current city and add flag works. DebugView shows:
[4524] QImage::scaled: Image is a null image
[4524] QPainter::begin: Paint device returned engine == 0, type: 3
[4524] QPainter::setCompositionMode: Painter not active
[4524] QPainter::begin: Paint device returned engine == 0, type: 2

Its context menu has Map Theme > Surface Depth / Flat World / Surface Depth / Flat World , i.e. two entries repeated. Whatever you choose is checked twice.

I can't uncheck Show Daylight, Show Cities, Show Flags in the context menu, they remain checked.</del>
: All fixed in 4.00.80 version!

==== kteatime ====
It does display a fabulous notification bubble from the system tray when the tea is ready! Howeer, DebugView indicates "error while contacting knotify server" (I had configured KTeaTime to Play a sound, Show a message in a popup and Mark taskbar entry) :
[6052] kteatime(6052)/kdeui (KNotification) unsigned int __thiscall KNotificationManager::notify(class KNotification *,const class QPixmap &,const class QStringList &,const class QList<struct QPair<class QString,class QString> > &,const class QString &): error while contacting knotify server

==== khangman ====
It put up a dialog towards the back about progress, but unlike earlier app, that completed and it then worked great. I chose to, roughly. get words in a new language, chose France from the dialog/ Get Hot New Stuff showed up and worked but displayed an alert:
Error - KHangMan
Cannot start ''gpg'' and retrieve the available keys. Make sure that ''gpg'' is installed, otherwise verification of the downloaded resources will be impossible.

I installed gpgme and reran khangman, but now Get Hot New Stuff, did not display any categories.

I changed settings to play sounds and it immediately crashed with
[6072] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283

I got around this crash by editing khangmanrc to disable audio.
Still nothing in Get Hot New Stuff.

==== Kig ====
It worked pretty well, I was able to save a .kig file.
It kept prompting
Format not supported - Kig
Kig does not support saving to any other format than its own.
[Save Kig Format] [Cancel]
but if I choose "Save Kig Format" I get the alert again.
Only cancel worked to save the file.

However, when I tried to open that file, the Open dialog displayed its type as "plain text document", opening it led to a "Format Not Supported" alert. DebugView showed:
[5432] kig(5432)/kdecore (KUrl) __thiscall KUrl::KUrl(const class KUrl &): KUrl::KUrl(KUrl) path "" toLocalFile ""
[5432] kig(5432) bool __thiscall KigPart::openFile(void): mimetype: "text/plain"

So there are problems with mime type handling.
(It's scary that mime problems will stop a program from editing a file, how do I force it?)

::UPDATE_MIME_TYPE_ERROR --[[User:SaroEngels|SaroEngels]] 00:50, 25 January 2008 (CET)
:: Yup, fixed now with your "Post-install steps", thanks!

==== KWordQuiz ====
I was able to download French vocabulary, but when I dismissed it, I got the same alert as KHangMan once displayed
Cannot start gpg and retrieve the available keys. Make sure that gpg is installed.

kdelibs/knewstuff/knewstuff2/core/security.cpp is trying to start gpg in a new KProcess. I don't have `gpg` in my path, I'm not sure what package it's in.

::PLEASE ASSIGN TO B.K.O --[[User:SaroEngels|SaroEngels]] 00:49, 25 January 2008 (CET)

==== KGoldRunner ====
The background appears but none of the tiles, and the icons for them in Create New Game are missing. So some directory is missing, could be <tt>C:\KDE4\share\pixmaps</tt> NAME NOT FOUND, I don't know where the tiles should be.

[[Category: MS Windows]]

::PLEASE ASSIGN TO B.K.O --[[User:SaroEngels|SaroEngels]] 00:48, 25 January 2008 (CET)

== installation ==

== bug reports ==
After several minutes trying to find an adress to submit bug reports for kde on windows I report here that I have given up! This site is the only one I found to tell anyone about the problems.

Please post a link to a forum/bugreport engine or some email address.

::Please try to help copy the bugs to http://bugs.kde.org. Try to set Platform MS Windows. Please have a look after ''your'' bugs. -- [[User:SaroEngels|SaroEngels]] 00:46, 25 January 2008 (CET)

== Download needed packages ==

== Unnecessarities in packages? ==

Some things I noticed:
* A lot of packages come with both release and debug binaries. The latter one are completely useless, at least to end users. It may be more sensible to separate debug binaries into their own packages.

rhabacker: where do you have seen this ? the qt bin package for example only contain end user applications and libraries. Debug libraries are located in the lib packages which are only installed in developer mode.

* There seem to be mingw+msvc versions even for seemingly C libraries, e.g. dbus. Such libraries are usually easily exchangeable between compilers (e.g. an MSVC compiled library with a C interface usually works w/ MinGW without problems). Perhaps this is an opportunity to remove some unnecessary packages?

chehrlic: All is fine here, we need it the way it is. We also know how to use mingw libs with msvc and vice versa but it only works under specific circumstances which are not met here.

::::FIXLATER - [[User:SaroEngels|SaroEngels]] 00:41, 25 January 2008 (CET)
::::No change here - [[User:chehrlic|chehrlic]] 07:04, 25 January 2008 (CET)

== Wishes ==
Everything's workin' perfect. But am i able to fully transform windows desktop environment into KDE ?
:[[User:Jstaniek|jstaniek]] 18:31, 30 January 2008 (CET) - short answer is NO. Not in the default setup, I guess. The transformation would break many native apps. Even if that can be fixed (really?), most users would still consider any such a full transformation as a breakage of the OS. What to do? '''As you apparently ask about replacing every part of Windows with KDE equivalents, just install Linux, BSD, etc. and and get all that immediately and natively'''.

Will kdegraphics be included in the next release?
Will the next release be built from 4.0.1 or 4.0.60 sources(from Dirk Mueller's snapshots)?

== First attempt at using ANY KDE installer for windows... - 212.32.82.218 ( 9 February 2008) ==

Guys - it's interesting that i'm in the position of needing to use KDE. I would use Linux in some form without ever going near Windows.

However, I need to provide support for many customers who need Windows and so am stuck with it.

So here we are, I want to get the features of some KDE and then I notice this site.

All goes well... used the [http://download.cegit.de/kde-windows/installer/kdewin-installer-gui-0.8.6.exe latest installer].

It goes well, and the installer stops.

The next instructions are to add Path references. Did that.

Then it is time for the fun...

bin\update-mime-database C:\KDE4\share\mime is the command to run next...

I've restarted so I expect it to do something specific. Nothing... then an error message.

Also, tried different options during the install process but got no further...

"Update-mime-database - Unable to Locate Component"
"This application has failed to start because libintl3.dll was not found. Re-installing the application may fix this problem."

I have no idea where to go, i've removed and reinstalled and get the same effect. I'm clearly being thick so will continue to search for the answer myself but any pointers would be lovely.

Cheers all.

rhabacker: This looks like a dependency problem - which requires to know which mirror you are using - without this information we cannot help.

dkintheuk: OK I posted the link i used in the body of this post. http://download.cegit.de/kde-windows/installer/kdewin-installer-gui-0.8.6.exe
I'm not sure what you mean by a dependancy problem - what do i look for and how do i determine what you guys need to know to help? Thanks for getting back to me though i do appreciate it.

dkintheuk: ok it's alive - used the next installer and it indicated that several components were not installed even though the previous installer said they were. I have amarok running right now and tried out some interesting things but can't get one thing to work...

I can't get bin\update-mime-database C:\KDE4\share\mime to work at all - it tells me that it doesn have permissions - yet it most definitely does... tested and tested and tested - permissions are properly set.

Ah well - happy bunny here - this is really fun.

== Someone somewhere wants to uninstall... ==
<nowiki> I want to know how to uninstall it. Thanks </nowiki>

Talk:Projects/KDE on Windows/Installation

2008-02-19T00:30:15Z

Skierpage: reorganize, move random question to new section, move "use latest installer" to top

Use this page to record your experiences with KDE on Windows.

Before reporting problems with the installer please make sure that you are using the [http://download.cegit.de/kde-windows/installer/kdewin-installer-gui-0.8.6.exe latest installer version] because your problem may already be fixed.

Click the + tab and enter <nowiki>~~~~</nowiki> as the subject to add your experiences. Include both your installer version and the KDE version (from the "installed" column for the kde* package names in the installer, or from the Help > About KDE dialog).

'''Please use only meaningful descriptions (the content will be edited). The software is in early beta now. The installer will receive usability improvements before the final release.'''

== A Blog "review" with screenshots - MrCopilot (30 January 2008) ==
See http://mrcopilot.blogspot.com/2008/01/can-kde-save-dying-windows-platform.html , with screenshots and comments on many KDE applications running in MS Windows.

== Version 0.8.5 notes - 75.128.118.56 (26 January 2008)==
Since I am not what you call a Linux guru, I tried initially installing as an end-user. However, that seems to not install certain things, and once you have made that choice, there is no going back - you can't change the installer settings from End User to Developer, and I think that may be why several packages are not being installed (for example, the kruler.exe program is not installed, and is not available to be installed)
: kruler.exe is part of kdegraphics, and as "Status" says, not currently packaged

Another example: When running konquerer.exe, if I type http://www.google.com into the search bar, it complains about the following missing files: konq_aboutpage.dll, libkhtmlpart.dll, and katepart.dll. None of those files were available to install. Perhaps they are available if you say you are a developer, but I had no way to test that because the buttons that select end user or developer are grayed out.
: Works for me, did you set KDEDIR and add the lib directory to your PATH as per "Summary of Steps"?

I do have one request, after you get the problems fixed, please consider adding krusader to the list of supported packages.

== [[User:Skierpage|Skierpage]] 11:33, 18 January 2008 (CET) using 3.97 ==
Here's [[User:Skierpage]]'s experience using kdewin-installer-gui-0.8.4-4.exe to install 3.97 2007-12-31 files
on Windows XP SP2.

=== Continuing ===
* No khelpcenter, so no Help > ''Program'' Handbook
* Help > Report Bug... > Launch Bug Report Wizard still does nothing ({{Bug|156689}} filed)
* <del>Problems trying to save and open files in apps, KDE complains about their mime type.</del> Fixed by new Post-install steps on install page!
* Get Hot New Stuff still has problems trying to run gpg.exe.

::please file bugs at B.K.O. (bugs.kde.org) --[[User:SaroEngels|SaroEngels]] 01:11, 25 January 2008 (CET)

=== File Open Dialog ===
* clicking Network icon <del>crashes </del>({{Bug|156080}} filed, fixed in 4.00.80 it displays ''Local Network'')
* clicking Home icon does nothing ({{Bug|156690}} filed, still true in 4.00.80).
* clicking Root shows '''Custom''' in file path. (still true in 4.00.80).
* DebugView shows several <tt>[5940] class QStringList __thiscall Solid::Backends::Hal::HalManager::findDeviceByDeviceInterface(const enum Solid::DeviceInterface::Type &) error: "org.freedesktop.DBus.Error.ServiceUnknown" </tt>

=== Specific Apps ===
==== KStars ====
* during startup or Setup Wizard outputs <tt> kstars(5344) class KStarsDateTime __cdecl KStarsDateTime::fromString(const class QString &): "Could not parse Date/Time string: " "" </tt>
* can't view Web pages from Object Details dialog > Links > View Resource. No error, but no activity. Possibly at the same time saw output "[5344] kstars(5344)/kdeui (KNotification) void __thiscall KNotification::slotReceivedIdError(const class QDBusError &): Error while contacting notify daemon "The name org.kde.knotify was not provided by any .service files"
"
:: I know this last error - but I don't know another fix than kill all apps and restart yet. --[[User:SaroEngels|SaroEngels]] 01:10, 25 January 2008 (CET)

== Issues ==

== [[User:Skierpage|Skierpage]] 07:43, 5 November 2007 (CET) on 2007-11-03 ==
Here's [[User:Skierpage]]'s experience partially installing files with
kdewin-installer-gui-0.8.1-2.exe
on Windows XP SP2.

''Some of my problems were caused by the KDE Installer silently failing to install kdebase bin.''

=== General ===
Each app's Help > Handbook fails to start

About the time I tried the handbook the program couldn't find the KDE crash handler drkonqi.exe.

Submit Bug Report fails to load anything when you click [Launch Bug Wizard];
nothing displays in Process Monitor or DebugView.

Okular and KStars crashed just after trying to access ksyscoca and then "launching kbuildsycoca4". I ran kbuildsycoca4 by hand and then both applications got further.

My display got garbled, displaying what looks like a backing store of the current window in the top left. This first happened with kolf.exe, then happened to KDE Installer. Closing every K* app seemed to cure it.

=== Specific apps ===
bovo, kblackbox, kgeography pixeltool, etc. worked fine.

==== Dolphin ====
<del>1. Even after following instructions in kbuildsycoca4 section below, still mime type id not getting picked up. In the information section it "shows type: mime" instead of correct type. Because of the same reason, I think, it shows all the elements with same icon (binary) including directories.</del>
: Fixed in 4.00.80 after running "Post-install steps"

2. If icon is clicked, open with dialog opens and if I choose kate from the list following error box appears "Service 'C:/KDE 4.0/share/applications/kde4/kate.desktop' is malformatted"
: Still happens in 4.00.80

==== KStars ====
Looks '''awesome'''. In the list of cities in setup,
accented characters appear incorrectly as multiple characters,
as if the encoding is off. [http://www.skierpage.com/kde_bugs/kstars_setup_bad_chars.png See screenshot.]

When I clicked [Download extra data], it crashes. In DebugView, last thing it tried to do was open ksycoca and then launch kbuildsycoca4.

After running kbuildsycoca4 and restarting, KStars [Download extra data] created a "Get Hot New Stuff", but that window was obscured by both KStars and its wizard. It had a [Close] button but would not accept input. I was able to [Cancel] the KStars setup window, at which point both the KStars and Get Hot New Stuff windows appeared. There was nothing in Get Hot New Stuff for "KStarsAdd On Installer" (sic -- word layout bug), so I clicked [Close].

Had some problems adding a new location (fumbled original data). Steps to reproduce:
Settings / geographic. Add a new location (Foo, norway). Realize something went wrong, edit latitude (change from say 10 10 10.00 to 11 11 11.00). Click OK. Choose OK to Override data. OK out. Open Setting/geographic again - there are now two Foos with location == original, expected was one, updated location.

==== kbuildsycoca4 ====
<strike>As this seemed to be causing problems, I ran it myself in a command window. It said "kbuildsycoca4 running..." then exited, seemingly OK.</strike>

The problem is another one:
kbuildsycoca4 builds the readonly database ksycoca in C:\Documents and Settings\USER\.kde\ .
That requires update-mime-database to have been successfully run.

So after each installation:
1. kill all processes: kioslave.exe, klauncher.exe, kded4.exe
2. enter kdeenv.bat (or a your cmd with KDEROOT set) run:
cd %KDEROOT%
%KDEROOT%\bin\update-mime-database %KDEROOT%\share\mime
%KDEROOT%\bin\kbuildsycoca4 --noincremental

update-mime-database prints lots of warnings; ignore them.
Only an error that you should rerun it as root, means that you are in the wrong directory. - Change to kderoot and rerun.

kbuildsycoca has a similar issue: if there are still some processes accessing ksycoca it will ask you whether your disk is full. You should kill all processes that are accessing this file (see process explorer from sysinternals.com ) and rerun it.

This stuff is due to be run by the installer or by emerge. I will hopefully fix this in the next few days. Until then this has to be run by hand.
--[[User:SaroEngels|SaroEngels]] 01:08, 25 January 2008 (CET)

==== KColorChooser ====
crashes when you choose "Named Colors" from the list.
(It fails to open several .mo files and .js files,
then tries to read rgb.txt from various X11 directories and obviously it's not there,
and then crashes.)

==== kruler ====
kruler's cursor in North or South orientation shows the vertical arrowhead and line but has black and white garbage on the other half of it where the selection point would be.

==== okular ====
First time it started klauncher.exe process but hung without displaying anything.
I killed the okular process and tried again; second time okular crashed; DebugView indicated it was trying to open ksyscoca, and when that failed it tried to launch ksyscocabuilder.exe:
[4644] okular(4644)/kdecore (KSycoca) bool __thiscall KSycocaPrivate::checkDatabase(class QFlags<enum KSycocaPrivate::BehaviorIfNotFound>): We have no database.... launching kbuildsycoca4
After running kbuildsycoca4 by hand okular appeared OK. When I chose File > Open I got an alert
Windows - No Disk
Exception Processing Message c00000013 Parameters ''hex hex hex''
I clicked [Continue] and got this alert again.
I think each time Windows was spinning up my empty floppy or CD-ROM drive.
Then the file dialog appeared but also an alert
Error - okular
The process for the file protocol died unexpectedly.

Meanwhile DebugView showed
[2916] not able to find 'kio_file' because KDEDIRS environment variable is not set.
[2916] Set KDEDIRS to the KDE installation root dir and restart klauncher to fix this problem.

I clicked Root in the file dialog and okular generated a ton of DebugView output in kdecore (KUrl) and then crashed.

I followed the instructions about setting up KDEDIRS, killed klauncher.exe, restarted Okular. I still got errors about No Disk but no more "file protocol death". Howeer, clicking Root in the file dialog still generates a ton of DebugView output and Okular crashes.

Even when I navigate to a folder with .png images in it, Open a document displays nothing. Even if I choose PNG image, it displays nothing. However, if I enter *.png in the Filter, it displays appropriate files.

However, choosing a png file results in okular displaying
Can not find a plugin that is able to handle the passed document
and then an error alert. Same for selecting a *.bmp.

Weirdly, entering *.jpg in the Filter immediately exits okular, with no errors.
::KBUILDSYCOCA4
::UPDATE_MIME_TYPE_ERROR --[[User:SaroEngels|SaroEngels]] 00:52, 25 January 2008 (CET)

==== ktouch ====
Exits, DebugView shows
[3452] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283
: In 4.00.80 displays friendlier alert "Unable to use the '''Fake''' Multimedia Backend: The shared library was not found."

==== kbruch ====
The accelerator [Alt+e] for [Next Task] does not work.

==== KDE World Clock ====
<del>Is pitch dark. The tooltip shows current city and add flag works. DebugView shows:
[4524] QImage::scaled: Image is a null image
[4524] QPainter::begin: Paint device returned engine == 0, type: 3
[4524] QPainter::setCompositionMode: Painter not active
[4524] QPainter::begin: Paint device returned engine == 0, type: 2

Its context menu has Map Theme > Surface Depth / Flat World / Surface Depth / Flat World , i.e. two entries repeated. Whatever you choose is checked twice.

I can't uncheck Show Daylight, Show Cities, Show Flags in the context menu, they remain checked.</del>
: All fixed in 4.00.80 version!

==== kteatime ====
It does display a fabulous notification bubble from the system tray when the tea is ready! Howeer, DebugView indicates "error while contacting knotify server" (I had configured KTeaTime to Play a sound, Show a message in a popup and Mark taskbar entry) :
[6052] kteatime(6052)/kdeui (KNotification) unsigned int __thiscall KNotificationManager::notify(class KNotification *,const class QPixmap &,const class QStringList &,const class QList<struct QPair<class QString,class QString> > &,const class QString &): error while contacting knotify server

==== khangman ====
It put up a dialog towards the back about progress, but unlike earlier app, that completed and it then worked great. I chose to, roughly. get words in a new language, chose France from the dialog/ Get Hot New Stuff showed up and worked but displayed an alert:
Error - KHangMan
Cannot start ''gpg'' and retrieve the available keys. Make sure that ''gpg'' is installed, otherwise verification of the downloaded resources will be impossible.

I installed gpgme and reran khangman, but now Get Hot New Stuff, did not display any categories.

I changed settings to play sounds and it immediately crashed with
[6072] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283

I got around this crash by editing khangmanrc to disable audio.
Still nothing in Get Hot New Stuff.

==== Kig ====
It worked pretty well, I was able to save a .kig file.
It kept prompting
Format not supported - Kig
Kig does not support saving to any other format than its own.
[Save Kig Format] [Cancel]
but if I choose "Save Kig Format" I get the alert again.
Only cancel worked to save the file.

However, when I tried to open that file, the Open dialog displayed its type as "plain text document", opening it led to a "Format Not Supported" alert. DebugView showed:
[5432] kig(5432)/kdecore (KUrl) __thiscall KUrl::KUrl(const class KUrl &): KUrl::KUrl(KUrl) path "" toLocalFile ""
[5432] kig(5432) bool __thiscall KigPart::openFile(void): mimetype: "text/plain"

So there are problems with mime type handling.
(It's scary that mime problems will stop a program from editing a file, how do I force it?)

::UPDATE_MIME_TYPE_ERROR --[[User:SaroEngels|SaroEngels]] 00:50, 25 January 2008 (CET)
:: Yup, fixed now with your "Post-install steps", thanks!

==== KWordQuiz ====
I was able to download French vocabulary, but when I dismissed it, I got the same alert as KHangMan once displayed
Cannot start gpg and retrieve the available keys. Make sure that gpg is installed.

kdelibs/knewstuff/knewstuff2/core/security.cpp is trying to start gpg in a new KProcess. I don't have `gpg` in my path, I'm not sure what package it's in.

::PLEASE ASSIGN TO B.K.O --[[User:SaroEngels|SaroEngels]] 00:49, 25 January 2008 (CET)

==== KGoldRunner ====
The background appears but none of the tiles, and the icons for them in Create New Game are missing. So some directory is missing, could be <tt>C:\KDE4\share\pixmaps</tt> NAME NOT FOUND, I don't know where the tiles should be.

[[Category: MS Windows]]

::PLEASE ASSIGN TO B.K.O --[[User:SaroEngels|SaroEngels]] 00:48, 25 January 2008 (CET)

== installation ==

== bug reports ==
After several minutes trying to find an adress to submit bug reports for kde on windows I report here that I have given up! This site is the only one I found to tell anyone about the problems.

Please post a link to a forum/bugreport engine or some email address.

::Please try to help copy the bugs to http://bugs.kde.org. Try to set Platform MS Windows. Please have a look after ''your'' bugs. -- [[User:SaroEngels|SaroEngels]] 00:46, 25 January 2008 (CET)

== Download needed packages ==

== Unnecessarities in packages? ==

Some things I noticed:
* A lot of packages come with both release and debug binaries. The latter one are completely useless, at least to end users. It may be more sensible to separate debug binaries into their own packages.

rhabacker: where do you have seen this ? the qt bin package for example only contain end user applications and libraries. Debug libraries are located in the lib packages which are only installed in developer mode.

* There seem to be mingw+msvc versions even for seemingly C libraries, e.g. dbus. Such libraries are usually easily exchangeable between compilers (e.g. an MSVC compiled library with a C interface usually works w/ MinGW without problems). Perhaps this is an opportunity to remove some unnecessary packages?

chehrlic: All is fine here, we need it the way it is. We also know how to use mingw libs with msvc and vice versa but it only works under specific circumstances which are not met here.

::::FIXLATER - [[User:SaroEngels|SaroEngels]] 00:41, 25 January 2008 (CET)
::::No change here - [[User:chehrlic|chehrlic]] 07:04, 25 January 2008 (CET)

== Wishes ==
Everything's workin' perfect. But am i able to fully transform windows desktop environment into KDE ?
:[[User:Jstaniek|jstaniek]] 18:31, 30 January 2008 (CET) - short answer is NO. Not in the default setup, I guess. The transformation would break many native apps. Even if that can be fixed (really?), most users would still consider any such a full transformation as a breakage of the OS. What to do? '''As you apparently ask about replacing every part of Windows with KDE equivalents, just install Linux, BSD, etc. and and get all that immediately and natively'''.

Will kdegraphics be included in the next release?
Will the next release be built from 4.0.1 or 4.0.60 sources(from Dirk Mueller's snapshots)?

== First attempt at using ANY KDE installer for windows... - 212.32.82.218 ( 9 February 2008) ==

Guys - it's interesting that i'm in the position of needing to use KDE. I would use Linux in some form without ever going near Windows.

However, I need to provide support for many customers who need Windows and so am stuck with it.

So here we are, I want to get the features of some KDE and then I notice this site.

All goes well... used the [http://download.cegit.de/kde-windows/installer/kdewin-installer-gui-0.8.6.exe latest installer].

It goes well, and the installer stops.

The next instructions are to add Path references. Did that.

Then it is time for the fun...

bin\update-mime-database C:\KDE4\share\mime is the command to run next...

I've restarted so I expect it to do something specific. Nothing... then an error message.

Also, tried different options during the install process but got no further...

"Update-mime-database - Unable to Locate Component"
"This application has failed to start because libintl3.dll was not found. Re-installing the application may fix this problem."

I have no idea where to go, i've removed and reinstalled and get the same effect. I'm clearly being thick so will continue to search for the answer myself but any pointers would be lovely.

Cheers all.

rhabacker: This looks like a dependency problem - which requires to know which mirror you are using - without this information we cannot help.

dkintheuk: OK I posted the link i used in the body of this post. http://download.cegit.de/kde-windows/installer/kdewin-installer-gui-0.8.6.exe
I'm not sure what you mean by a dependancy problem - what do i look for and how do i determine what you guys need to know to help? Thanks for getting back to me though i do appreciate it.

dkintheuk: ok it's alive - used the next installer and it indicated that several components were not installed even though the previous installer said they were. I have amarok running right now and tried out some interesting things but can't get one thing to work...

I can't get bin\update-mime-database C:\KDE4\share\mime to work at all - it tells me that it doesn have permissions - yet it most definitely does... tested and tested and tested - permissions are properly set.

Ah well - happy bunny here - this is really fun.

== Someone somewhere wants to uninstall... ==
<nowiki> I want to know how to uninstall it. Thanks </nowiki>

Talk:Projects/KDE on Windows/Installation

2008-02-19T00:23:23Z

Skierpage: /* First attempt at using ANY KDE installer for windows... */ identify and date commenter

Use this page to record your experiences with KDE on Windows.
Click the + tab and enter <nowiki>~~~~</nowiki> as the subject to add your experiences. Include both your installer version and the KDE version (from the "installed" column for the kde* package names in the installer, or from the Help > About KDE dialog).
<nowiki> I want to know how to uninstall it. Thanks </nowiki>
'''Please use only meaningful descriptions (the content will be edited). The software is in early beta now. The installer will receive usability improvements before the final release.'''

== A Blog "review" with screenshots - MrCopilot (30 January 2008) ==
See http://mrcopilot.blogspot.com/2008/01/can-kde-save-dying-windows-platform.html , with screenshots and comments on many KDE applications running in MS Windows.

== Version 0.8.5 notes - 75.128.118.56 (26 January 2008)==
Since I am not what you call a Linux guru, I tried initially installing as an end-user. However, that seems to not install certain things, and once you have made that choice, there is no going back - you can't change the installer settings from End User to Developer, and I think that may be why several packages are not being installed (for example, the kruler.exe program is not installed, and is not available to be installed)
: kruler.exe is part of kdegraphics, and as "Status" says, not currently packaged

Another example: When running konquerer.exe, if I type http://www.google.com into the search bar, it complains about the following missing files: konq_aboutpage.dll, libkhtmlpart.dll, and katepart.dll. None of those files were available to install. Perhaps they are available if you say you are a developer, but I had no way to test that because the buttons that select end user or developer are grayed out.
: Works for me, did you set KDEDIR and add the lib directory to your PATH as per "Summary of Steps"?

I do have one request, after you get the problems fixed, please consider adding krusader to the list of supported packages.

== [[User:Skierpage|Skierpage]] 11:33, 18 January 2008 (CET) using 3.97 ==
Here's [[User:Skierpage]]'s experience using kdewin-installer-gui-0.8.4-4.exe to install 3.97 2007-12-31 files
on Windows XP SP2.

=== Continuing ===
* No khelpcenter, so no Help > ''Program'' Handbook
* Help > Report Bug... > Launch Bug Report Wizard still does nothing ({{Bug|156689}} filed)
* <del>Problems trying to save and open files in apps, KDE complains about their mime type.</del> Fixed by new Post-install steps on install page!
* Get Hot New Stuff still has problems trying to run gpg.exe.

::please file bugs at B.K.O. (bugs.kde.org) --[[User:SaroEngels|SaroEngels]] 01:11, 25 January 2008 (CET)

=== File Open Dialog ===
* clicking Network icon <del>crashes </del>({{Bug|156080}} filed, fixed in 4.00.80 it displays ''Local Network'')
* clicking Home icon does nothing ({{Bug|156690}} filed, still true in 4.00.80).
* clicking Root shows '''Custom''' in file path. (still true in 4.00.80).
* DebugView shows several <tt>[5940] class QStringList __thiscall Solid::Backends::Hal::HalManager::findDeviceByDeviceInterface(const enum Solid::DeviceInterface::Type &) error: "org.freedesktop.DBus.Error.ServiceUnknown" </tt>

=== Specific Apps ===
==== KStars ====
* during startup or Setup Wizard outputs <tt> kstars(5344) class KStarsDateTime __cdecl KStarsDateTime::fromString(const class QString &): "Could not parse Date/Time string: " "" </tt>
* can't view Web pages from Object Details dialog > Links > View Resource. No error, but no activity. Possibly at the same time saw output "[5344] kstars(5344)/kdeui (KNotification) void __thiscall KNotification::slotReceivedIdError(const class QDBusError &): Error while contacting notify daemon "The name org.kde.knotify was not provided by any .service files"
"
:: I know this last error - but I don't know another fix than kill all apps and restart yet. --[[User:SaroEngels|SaroEngels]] 01:10, 25 January 2008 (CET)

== Installer ==

before reporting problems with the installer please make sure that you are using the latest version because your problem may already be fixed.

== Issues ==

== [[User:Skierpage|Skierpage]] 07:43, 5 November 2007 (CET) on 2007-11-03 ==
Here's [[User:Skierpage]]'s experience partially installing files with
kdewin-installer-gui-0.8.1-2.exe
on Windows XP SP2.

''Some of my problems were caused by the KDE Installer silently failing to install kdebase bin.''

=== General ===
Each app's Help > Handbook fails to start

About the time I tried the handbook the program couldn't find the KDE crash handler drkonqi.exe.

Submit Bug Report fails to load anything when you click [Launch Bug Wizard];
nothing displays in Process Monitor or DebugView.

Okular and KStars crashed just after trying to access ksyscoca and then "launching kbuildsycoca4". I ran kbuildsycoca4 by hand and then both applications got further.

My display got garbled, displaying what looks like a backing store of the current window in the top left. This first happened with kolf.exe, then happened to KDE Installer. Closing every K* app seemed to cure it.

=== Specific apps ===
bovo, kblackbox, kgeography pixeltool, etc. worked fine.

==== Dolphin ====
<del>1. Even after following instructions in kbuildsycoca4 section below, still mime type id not getting picked up. In the information section it "shows type: mime" instead of correct type. Because of the same reason, I think, it shows all the elements with same icon (binary) including directories.</del>
: Fixed in 4.00.80 after running "Post-install steps"

2. If icon is clicked, open with dialog opens and if I choose kate from the list following error box appears "Service 'C:/KDE 4.0/share/applications/kde4/kate.desktop' is malformatted"
: Still happens in 4.00.80

==== KStars ====
Looks '''awesome'''. In the list of cities in setup,
accented characters appear incorrectly as multiple characters,
as if the encoding is off. [http://www.skierpage.com/kde_bugs/kstars_setup_bad_chars.png See screenshot.]

When I clicked [Download extra data], it crashes. In DebugView, last thing it tried to do was open ksycoca and then launch kbuildsycoca4.

After running kbuildsycoca4 and restarting, KStars [Download extra data] created a "Get Hot New Stuff", but that window was obscured by both KStars and its wizard. It had a [Close] button but would not accept input. I was able to [Cancel] the KStars setup window, at which point both the KStars and Get Hot New Stuff windows appeared. There was nothing in Get Hot New Stuff for "KStarsAdd On Installer" (sic -- word layout bug), so I clicked [Close].

Had some problems adding a new location (fumbled original data). Steps to reproduce:
Settings / geographic. Add a new location (Foo, norway). Realize something went wrong, edit latitude (change from say 10 10 10.00 to 11 11 11.00). Click OK. Choose OK to Override data. OK out. Open Setting/geographic again - there are now two Foos with location == original, expected was one, updated location.

==== kbuildsycoca4 ====
<strike>As this seemed to be causing problems, I ran it myself in a command window. It said "kbuildsycoca4 running..." then exited, seemingly OK.</strike>

The problem is another one:
kbuildsycoca4 builds the readonly database ksycoca in C:\Documents and Settings\USER\.kde\ .
That requires update-mime-database to have been successfully run.

So after each installation:
1. kill all processes: kioslave.exe, klauncher.exe, kded4.exe
2. enter kdeenv.bat (or a your cmd with KDEROOT set) run:
cd %KDEROOT%
%KDEROOT%\bin\update-mime-database %KDEROOT%\share\mime
%KDEROOT%\bin\kbuildsycoca4 --noincremental

update-mime-database prints lots of warnings; ignore them.
Only an error that you should rerun it as root, means that you are in the wrong directory. - Change to kderoot and rerun.

kbuildsycoca has a similar issue: if there are still some processes accessing ksycoca it will ask you whether your disk is full. You should kill all processes that are accessing this file (see process explorer from sysinternals.com ) and rerun it.

This stuff is due to be run by the installer or by emerge. I will hopefully fix this in the next few days. Until then this has to be run by hand.
--[[User:SaroEngels|SaroEngels]] 01:08, 25 January 2008 (CET)

==== KColorChooser ====
crashes when you choose "Named Colors" from the list.
(It fails to open several .mo files and .js files,
then tries to read rgb.txt from various X11 directories and obviously it's not there,
and then crashes.)

==== kruler ====
kruler's cursor in North or South orientation shows the vertical arrowhead and line but has black and white garbage on the other half of it where the selection point would be.

==== okular ====
First time it started klauncher.exe process but hung without displaying anything.
I killed the okular process and tried again; second time okular crashed; DebugView indicated it was trying to open ksyscoca, and when that failed it tried to launch ksyscocabuilder.exe:
[4644] okular(4644)/kdecore (KSycoca) bool __thiscall KSycocaPrivate::checkDatabase(class QFlags<enum KSycocaPrivate::BehaviorIfNotFound>): We have no database.... launching kbuildsycoca4
After running kbuildsycoca4 by hand okular appeared OK. When I chose File > Open I got an alert
Windows - No Disk
Exception Processing Message c00000013 Parameters ''hex hex hex''
I clicked [Continue] and got this alert again.
I think each time Windows was spinning up my empty floppy or CD-ROM drive.
Then the file dialog appeared but also an alert
Error - okular
The process for the file protocol died unexpectedly.

Meanwhile DebugView showed
[2916] not able to find 'kio_file' because KDEDIRS environment variable is not set.
[2916] Set KDEDIRS to the KDE installation root dir and restart klauncher to fix this problem.

I clicked Root in the file dialog and okular generated a ton of DebugView output in kdecore (KUrl) and then crashed.

I followed the instructions about setting up KDEDIRS, killed klauncher.exe, restarted Okular. I still got errors about No Disk but no more "file protocol death". Howeer, clicking Root in the file dialog still generates a ton of DebugView output and Okular crashes.

Even when I navigate to a folder with .png images in it, Open a document displays nothing. Even if I choose PNG image, it displays nothing. However, if I enter *.png in the Filter, it displays appropriate files.

However, choosing a png file results in okular displaying
Can not find a plugin that is able to handle the passed document
and then an error alert. Same for selecting a *.bmp.

Weirdly, entering *.jpg in the Filter immediately exits okular, with no errors.
::KBUILDSYCOCA4
::UPDATE_MIME_TYPE_ERROR --[[User:SaroEngels|SaroEngels]] 00:52, 25 January 2008 (CET)

==== ktouch ====
Exits, DebugView shows
[3452] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283
: In 4.00.80 displays friendlier alert "Unable to use the '''Fake''' Multimedia Backend: The shared library was not found."

==== kbruch ====
The accelerator [Alt+e] for [Next Task] does not work.

==== KDE World Clock ====
<del>Is pitch dark. The tooltip shows current city and add flag works. DebugView shows:
[4524] QImage::scaled: Image is a null image
[4524] QPainter::begin: Paint device returned engine == 0, type: 3
[4524] QPainter::setCompositionMode: Painter not active
[4524] QPainter::begin: Paint device returned engine == 0, type: 2

Its context menu has Map Theme > Surface Depth / Flat World / Surface Depth / Flat World , i.e. two entries repeated. Whatever you choose is checked twice.

I can't uncheck Show Daylight, Show Cities, Show Flags in the context menu, they remain checked.</del>
: All fixed in 4.00.80 version!

==== kteatime ====
It does display a fabulous notification bubble from the system tray when the tea is ready! Howeer, DebugView indicates "error while contacting knotify server" (I had configured KTeaTime to Play a sound, Show a message in a popup and Mark taskbar entry) :
[6052] kteatime(6052)/kdeui (KNotification) unsigned int __thiscall KNotificationManager::notify(class KNotification *,const class QPixmap &,const class QStringList &,const class QList<struct QPair<class QString,class QString> > &,const class QString &): error while contacting knotify server

==== khangman ====
It put up a dialog towards the back about progress, but unlike earlier app, that completed and it then worked great. I chose to, roughly. get words in a new language, chose France from the dialog/ Get Hot New Stuff showed up and worked but displayed an alert:
Error - KHangMan
Cannot start ''gpg'' and retrieve the available keys. Make sure that ''gpg'' is installed, otherwise verification of the downloaded resources will be impossible.

I installed gpgme and reran khangman, but now Get Hot New Stuff, did not display any categories.

I changed settings to play sounds and it immediately crashed with
[6072] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283

I got around this crash by editing khangmanrc to disable audio.
Still nothing in Get Hot New Stuff.

==== Kig ====
It worked pretty well, I was able to save a .kig file.
It kept prompting
Format not supported - Kig
Kig does not support saving to any other format than its own.
[Save Kig Format] [Cancel]
but if I choose "Save Kig Format" I get the alert again.
Only cancel worked to save the file.

However, when I tried to open that file, the Open dialog displayed its type as "plain text document", opening it led to a "Format Not Supported" alert. DebugView showed:
[5432] kig(5432)/kdecore (KUrl) __thiscall KUrl::KUrl(const class KUrl &): KUrl::KUrl(KUrl) path "" toLocalFile ""
[5432] kig(5432) bool __thiscall KigPart::openFile(void): mimetype: "text/plain"

So there are problems with mime type handling.
(It's scary that mime problems will stop a program from editing a file, how do I force it?)

::UPDATE_MIME_TYPE_ERROR --[[User:SaroEngels|SaroEngels]] 00:50, 25 January 2008 (CET)
:: Yup, fixed now with your "Post-install steps", thanks!

==== KWordQuiz ====
I was able to download French vocabulary, but when I dismissed it, I got the same alert as KHangMan once displayed
Cannot start gpg and retrieve the available keys. Make sure that gpg is installed.

kdelibs/knewstuff/knewstuff2/core/security.cpp is trying to start gpg in a new KProcess. I don't have `gpg` in my path, I'm not sure what package it's in.

::PLEASE ASSIGN TO B.K.O --[[User:SaroEngels|SaroEngels]] 00:49, 25 January 2008 (CET)

==== KGoldRunner ====
The background appears but none of the tiles, and the icons for them in Create New Game are missing. So some directory is missing, could be <tt>C:\KDE4\share\pixmaps</tt> NAME NOT FOUND, I don't know where the tiles should be.

[[Category: MS Windows]]

::PLEASE ASSIGN TO B.K.O --[[User:SaroEngels|SaroEngels]] 00:48, 25 January 2008 (CET)

== installation ==

== bug reports ==
After several minutes trying to find an adress to submit bug reports for kde on windows I report here that I have given up! This site is the only one I found to tell anyone about the problems.

Please post a link to a forum/bugreport engine or some email address.

::Please try to help copy the bugs to http://bugs.kde.org. Try to set Platform MS Windows. Please have a look after ''your'' bugs. -- [[User:SaroEngels|SaroEngels]] 00:46, 25 January 2008 (CET)

== Download needed packages ==

== Unnecessarities in packages? ==

Some things I noticed:
* A lot of packages come with both release and debug binaries. The latter one are completely useless, at least to end users. It may be more sensible to separate debug binaries into their own packages.

rhabacker: where do you have seen this ? the qt bin package for example only contain end user applications and libraries. Debug libraries are located in the lib packages which are only installed in developer mode.

* There seem to be mingw+msvc versions even for seemingly C libraries, e.g. dbus. Such libraries are usually easily exchangeable between compilers (e.g. an MSVC compiled library with a C interface usually works w/ MinGW without problems). Perhaps this is an opportunity to remove some unnecessary packages?

chehrlic: All is fine here, we need it the way it is. We also know how to use mingw libs with msvc and vice versa but it only works under specific circumstances which are not met here.

::::FIXLATER - [[User:SaroEngels|SaroEngels]] 00:41, 25 January 2008 (CET)
::::No change here - [[User:chehrlic|chehrlic]] 07:04, 25 January 2008 (CET)

== Wishes ==
Everything's workin' perfect. But am i able to fully transform windows desktop environment into KDE ?
:[[User:Jstaniek|jstaniek]] 18:31, 30 January 2008 (CET) - short answer is NO. Not in the default setup, I guess. The transformation would break many native apps. Even if that can be fixed (really?), most users would still consider any such a full transformation as a breakage of the OS. What to do? '''As you apparently ask about replacing every part of Windows with KDE equivalents, just install Linux, BSD, etc. and and get all that immediately and natively'''.

Will kdegraphics be included in the next release?
Will the next release be built from 4.0.1 or 4.0.60 sources(from Dirk Mueller's snapshots)?

== First attempt at using ANY KDE installer for windows... - 212.32.82.218 ( 9 February 2008) ==

Guys - it's interesting that i'm in the position of needing to use KDE. I would use Linux in some form without ever going near Windows.

However, I need to provide support for many customers who need Windows and so am stuck with it.

So here we are, I want to get the features of some KDE and then I notice this site.

All goes well... used the [http://download.cegit.de/kde-windows/installer/kdewin-installer-gui-0.8.6.exe latest installer].

It goes well, and the installer stops.

The next instructions are to add Path references. Did that.

Then it is time for the fun...

bin\update-mime-database C:\KDE4\share\mime is the command to run next...

I've restarted so I expect it to do something specific. Nothing... then an error message.

Also, tried different options during the install process but got no further...

"Update-mime-database - Unable to Locate Component"
"This application has failed to start because libintl3.dll was not found. Re-installing the application may fix this problem."

I have no idea where to go, i've removed and reinstalled and get the same effect. I'm clearly being thick so will continue to search for the answer myself but any pointers would be lovely.

Cheers all.

rhabacker: This looks like a dependency problem - which requires to know which mirror you are using - without this information we cannot help.

dkintheuk: OK I posted the link i used in the body of this post. http://download.cegit.de/kde-windows/installer/kdewin-installer-gui-0.8.6.exe
I'm not sure what you mean by a dependancy problem - what do i look for and how do i determine what you guys need to know to help? Thanks for getting back to me though i do appreciate it.

dkintheuk: ok it's alive - used the next installer and it indicated that several components were not installed even though the previous installer said they were. I have amarok running right now and tried out some interesting things but can't get one thing to work...

I can't get bin\update-mime-database C:\KDE4\share\mime to work at all - it tells me that it doesn have permissions - yet it most definitely does... tested and tested and tested - permissions are properly set.

Ah well - happy bunny here - this is really fun.

Projects/KDE on Windows/Installation

2008-02-19T00:05:08Z

Skierpage: /* Status */ mention generic icons

{{Template:I18n/Language Navigation Bar|Projects/KDE_on_Windows/Installation}}

{{note|Perhaps actual developers should summarize status of KDE4 on Windows here, while we encourage users to describe their experiences on the [[Talk:{{PAGENAME}}|Talk page?]]}}

== KDE Installer for Windows ==
You can use this installer to download and install the
various binary packages that you need to run KDE applications on MS Windows.
KDE is free and open source so you can build all the applications "from scratch" from their source code;
but as a convenience for others,
volunteers create these precompiled packages and make them available on the Internet.

'''Disclaimer''' These are early days for KDE4 on Windows,
some programs work better than others and some fail to run altogether.

'''If you experience any problems please have a look into our [http://lists.kde.org/?l=kde-windows&r=1&w=2| mailing list].'''

You can also use the KDE Installer for Windows to install source code and the packages that you need to ''build'' KDE4 on Windows
(although if you are building KDE4 on Windows you may prefer to use the emerge system to build KDE and its requirements from latest source);
see [[Getting Started/Build/KDE4/Windows]].

=== Summary of Steps ===
* Visit http://download.cegit.de/kde-windows/installer/
* Download and save the latest version to a directory, e.g. <tt>C:\KDE4</tt>
* Run the installer, download what you need (see [[#Download needed packages]] below).
* Add your lib directory, e.g. <tt>C:\KDE4\lib</tt> to your Windows %PATH%. (Start > Control Panel > System > Advanced > Environment Variables, double-click the Path System Variable and add this to your path separated by semicolon.)
* Add a KDEDIRS environment variable (Start > Control Panel > System > Advanced > Environment Variables, click [New] User variable and create Variable name <tt>KDEDIRS</tt> with Variable value the directory where you installed KDE4, e.g. <tt>C:\KDE4</tt>).
* [TEMPORARILY] Follow the instructions at [[#post-install steps]]
* Try running a Qt application in the <tt>bin</tt> directory, such as linguist.exe
* If that works, try running a KDE application such as <tt>kwrite.exe</tt>.

=== Download needed packages ===
A single program in the The K Desktop Environment depends on many other libraries and packages; that is why each .exe is comparatively small.
The KDE Installer for Windows has some awareness of dependencies,
but not complete.
So, the first few times you try to run an application you may see alerts about missing DLLs.

If you do not intend to build from source, do not click "all" and do not click "src", as you do not need to download the source for each package. ''Unclear whether you need lib for each''.

There are two development systems for KDE on Windows,
Microsoft's Visual C and [http://en.wikipedia.org/wiki/MinGW MinGW].
Even if you are only running binaries and do not intend to build KDE4 yourself,
you need to choose between these because of the provided runtime environments.
You're free to decide which to take.

The KDE programs themselves are organized into several groups: kdeedu, kdegames, and kdegraphics.

Here are some of the minimal packages you need to run a KDE application:
: dbus-msvc, kdebase-msvc, kdewin32-msvc, qt-msvc, vcredist, ??

The Dependencies tab for a particular package lists some of the additional packages it needs.
However, the dependency checking currently only works for first-level dependencies
Other dependencies are not easy to determine in advance.
For example, if you install kdegames only with its dependencies,
you will not be able to start it because you also need libstreamanalyze
(for which you have to install the strigi package).
rhabacker: This is fixed in installer version > 0.8.4.

[[Getting_Started/Build/KDE4/Windows/3rd-party_libraries]] is a more complete list of libraries that a full installation needs.

=== Issues with KDE Installer for Windows ===
Currently no issues known. If you found an issue, please report to [mailto:kde-windows@kde.org].

== post-install steps ==
You currently need to run a number of command-line programs to set up KDE. Here are the steps.

===Run update-mime-database===
Be sure that you have no KDE-related applications: run the Windows Task Manager (taskmgr.exe), switch to its Processes tab, and kill all occurences of dbus-daemon.exe, kded4.exe, kioslave.exe and klauncher.exe (and all other KDE apps).

Open a Windows command prompt (cmd.exe) and navigate to the directory where you installed KDE. Say you installed KDE to C:\KDE4, then run from the cmd.exe window:
C:\KDE4> '''bin\update-mime-database C:\KDE4\share\mime'''
This will give you a lot of warning message. Most of them you can easily ignore; even if you should set [[KDE_System_Administration/Environment_Variables#XDG_DATA_HOME|XDG_DATA_HOME]] or [[KDE_System_Administration/Environment_Variables#XDG_DATA_DIRS|XDG_DATA_DIRS]] it worked perfectly. If it says you should rerun update-mime-database as root then you're not within your installation directory.

===Run kbuildsyscoca4===
After finishing the previous step, run
C:\KDE4> '''bin\kbuildsycoca4 --noincremental'''
If this tells you that your disk is full (which is most probably not the case) you have still some executables from KDE running. Please close them and try again.

Excuse us for the inconvenience — we hope for a better solution in the next release.

== Testing your installation ==
Navigate to the <tt>bin</tt> directory.

See if you can run the Qt program assistant.exe.
Qt programs have fewer dependencies than a full-blown KDE application.

If that works, try running a simple KDE application, such as lskat.exe from the kdegames package.

The first KDE application you run will start a console window in order to run the [http://en.wikipedia.org/wiki/D-Bus D-Bus daemon].

== Fine-tuning ==
===Set Oxygen style for widgets===
The default KDE widget style on Windows is the native one. You already have Oxygen style installed (which is a plugin library %KDEROOT%\lib\kde4\plugins\styles\oxygen.dll), so it can be used as well. To set it for a single user:
#edit <tt>%UserPROFILE%\.kde\share\config\kdeglobals</tt> with any text editor (e.g. kwrite)
#locate line containing "[General]" text, what is a section, if there is no such line, add one
#replace or add <tt>widgetStyle=....</tt> line with <tt>widgetStyle=oxygen</tt>.
Newly started applications should be displayed with Oxygen style now.

== Status ==
Using kdewin-installer-gui-0.8.6.exe to install 4.00.60 packages:
* starting a KDE program correctly starts dbus-daemon.exe
* many games run
* choosing File > Open correctly starts klauncher.exe, kioslave.exe and kded4.exe, and runs kbuildsycoca4.exe as needed.
* Full-text search in khelpcenter does not work because Perl scripts are disabled.
* Many applications have a generic icon in Windows Explorer.
* Applications that try to play sounds might display an alert about "Multimedia Backend" problems. This requires the Windows backend for [http://phonon.kde.org/ Phonon]. The amarok package installs an experimental Windows phonon backend. Amarok plays music!!

General notes:
* There are many other KDE programs that are not part of KDE 4.0.0 and are not currently packaged for Windows, such as KOffice 2.
* By design, KDE-windows does not provide the full-blown KDE desktop, thus no KWin composite manager, KDE-specific "start" menus, Plasma desktop, etc.

=== Package status and contents ===
{| border="0" cellpadding="2"
|-valign="top"
!package
!status
!contains applications
|-valign="top"
|kdebase
|packaged
|Konqueror, Dolphin, KWrite, etc.
|-valign="top"
|kdegames
|packaged
|Kgoldrunner, Kpat, KMahjongg, etc.
|-valign="top"
|kdesdk
|packaged
|Kate, Umbrello, etc.
|-valign="top"
|kdetoys
|packaged
|KTeatime, etc.
|-valign="top"
|kdeedu
|packaged
|Marble, Parley, KStars, KHangman, etc.
|-valign="top"
|kdegraphics
|not packaged
|Okular, kolourpaint, etc.
|-valign="top"
|amarok
|packaged
|Amarok music player
|-valign="top"
|koffice
|not packaged
|KWord, Krita, Karbon, etc.
|-valign="top"
|kdepim
|not building
|KMail, AKregator, etc.
|-valign="top"
|kdenetwork
|not building
|Kopete, KGet, etc.
|-valign="top"
|kdeutils
|not packaged
|KGpg, KWallet, etc.
|}

[[Category: MS Windows]]

Projects/KDE on Windows/Installation

2008-02-18T23:44:53Z

Skierpage: /* Status */ khelpcenter works, explain Amarok

{{Template:I18n/Language Navigation Bar|Projects/KDE_on_Windows/Installation}}

{{note|Perhaps actual developers should summarize status of KDE4 on Windows here, while we encourage users to describe their experiences on the [[Talk:{{PAGENAME}}|Talk page?]]}}

== KDE Installer for Windows ==
You can use this installer to download and install the
various binary packages that you need to run KDE applications on MS Windows.
KDE is free and open source so you can build all the applications "from scratch" from their source code;
but as a convenience for others,
volunteers create these precompiled packages and make them available on the Internet.

'''Disclaimer''' These are early days for KDE4 on Windows,
some programs work better than others and some fail to run altogether.

'''If you experience any problems please have a look into our [http://lists.kde.org/?l=kde-windows&r=1&w=2| mailing list].'''

You can also use the KDE Installer for Windows to install source code and the packages that you need to ''build'' KDE4 on Windows
(although if you are building KDE4 on Windows you may prefer to use the emerge system to build KDE and its requirements from latest source);
see [[Getting Started/Build/KDE4/Windows]].

=== Summary of Steps ===
* Visit http://download.cegit.de/kde-windows/installer/
* Download and save the latest version to a directory, e.g. <tt>C:\KDE4</tt>
* Run the installer, download what you need (see [[#Download needed packages]] below).
* Add your lib directory, e.g. <tt>C:\KDE4\lib</tt> to your Windows %PATH%. (Start > Control Panel > System > Advanced > Environment Variables, double-click the Path System Variable and add this to your path separated by semicolon.)
* Add a KDEDIRS environment variable (Start > Control Panel > System > Advanced > Environment Variables, click [New] User variable and create Variable name <tt>KDEDIRS</tt> with Variable value the directory where you installed KDE4, e.g. <tt>C:\KDE4</tt>).
* [TEMPORARILY] Follow the instructions at [[#post-install steps]]
* Try running a Qt application in the <tt>bin</tt> directory, such as linguist.exe
* If that works, try running a KDE application such as <tt>kwrite.exe</tt>.

=== Download needed packages ===
A single program in the The K Desktop Environment depends on many other libraries and packages; that is why each .exe is comparatively small.
The KDE Installer for Windows has some awareness of dependencies,
but not complete.
So, the first few times you try to run an application you may see alerts about missing DLLs.

If you do not intend to build from source, do not click "all" and do not click "src", as you do not need to download the source for each package. ''Unclear whether you need lib for each''.

There are two development systems for KDE on Windows,
Microsoft's Visual C and [http://en.wikipedia.org/wiki/MinGW MinGW].
Even if you are only running binaries and do not intend to build KDE4 yourself,
you need to choose between these because of the provided runtime environments.
You're free to decide which to take.

The KDE programs themselves are organized into several groups: kdeedu, kdegames, and kdegraphics.

Here are some of the minimal packages you need to run a KDE application:
: dbus-msvc, kdebase-msvc, kdewin32-msvc, qt-msvc, vcredist, ??

The Dependencies tab for a particular package lists some of the additional packages it needs.
However, the dependency checking currently only works for first-level dependencies
Other dependencies are not easy to determine in advance.
For example, if you install kdegames only with its dependencies,
you will not be able to start it because you also need libstreamanalyze
(for which you have to install the strigi package).
rhabacker: This is fixed in installer version > 0.8.4.

[[Getting_Started/Build/KDE4/Windows/3rd-party_libraries]] is a more complete list of libraries that a full installation needs.

=== Issues with KDE Installer for Windows ===
Currently no issues known. If you found an issue, please report to [mailto:kde-windows@kde.org].

== post-install steps ==
You currently need to run a number of command-line programs to set up KDE. Here are the steps.

===Run update-mime-database===
Be sure that you have no KDE-related applications: run the Windows Task Manager (taskmgr.exe), switch to its Processes tab, and kill all occurences of dbus-daemon.exe, kded4.exe, kioslave.exe and klauncher.exe (and all other KDE apps).

Open a Windows command prompt (cmd.exe) and navigate to the directory where you installed KDE. Say you installed KDE to C:\KDE4, then run from the cmd.exe window:
C:\KDE4> '''bin\update-mime-database C:\KDE4\share\mime'''
This will give you a lot of warning message. Most of them you can easily ignore; even if you should set [[KDE_System_Administration/Environment_Variables#XDG_DATA_HOME|XDG_DATA_HOME]] or [[KDE_System_Administration/Environment_Variables#XDG_DATA_DIRS|XDG_DATA_DIRS]] it worked perfectly. If it says you should rerun update-mime-database as root then you're not within your installation directory.

===Run kbuildsyscoca4===
After finishing the previous step, run
C:\KDE4> '''bin\kbuildsycoca4 --noincremental'''
If this tells you that your disk is full (which is most probably not the case) you have still some executables from KDE running. Please close them and try again.

Excuse us for the inconvenience — we hope for a better solution in the next release.

== Testing your installation ==
Navigate to the <tt>bin</tt> directory.

See if you can run the Qt program assistant.exe.
Qt programs have fewer dependencies than a full-blown KDE application.

If that works, try running a simple KDE application, such as lskat.exe from the kdegames package.

The first KDE application you run will start a console window in order to run the [http://en.wikipedia.org/wiki/D-Bus D-Bus daemon].

== Fine-tuning ==
===Set Oxygen style for widgets===
The default KDE widget style on Windows is the native one. You already have Oxygen style installed (which is a plugin library %KDEROOT%\lib\kde4\plugins\styles\oxygen.dll), so it can be used as well. To set it for a single user:
#edit <tt>%UserPROFILE%\.kde\share\config\kdeglobals</tt> with any text editor (e.g. kwrite)
#locate line containing "[General]" text, what is a section, if there is no such line, add one
#replace or add <tt>widgetStyle=....</tt> line with <tt>widgetStyle=oxygen</tt>.
Newly started applications should be displayed with Oxygen style now.

== Status ==
Using kdewin-installer-gui-0.8.6.exe to install 4.00.60 packages:
* starting a KDE program correctly starts dbus-daemon.exe
* many games run
* choosing File > Open correctly starts klauncher.exe, kioslave.exe and kded4.exe, and runs kbuildsycoca4.exe as needed.
* Full-text search in khelpcenter does not work because Perl scripts are disabled.
* Applications that try to play sounds might display an alert about "Multimedia Backend" problems. This requires the Windows backend for [http://phonon.kde.org/ Phonon].

General notes:
* There are many other KDE programs that are not part of KDE 4.0.0 and are not currently packaged for Windows, such as KOffice 2.
* By design, KDE-windows does not provide the full-blown KDE desktop, thus no KWin composite manager, KDE-specific "start" menus, Plasma desktop, etc.

=== Package status and contents ===
{| border="0" cellpadding="2"
|-valign="top"
!package
!status
!contains applications
|-valign="top"
|kdebase
|packaged
|Konqueror, Dolphin, KWrite, etc.
|-valign="top"
|kdegames
|packaged
|Kgoldrunner, Kpat, KMahjongg, etc.
|-valign="top"
|kdesdk
|packaged
|Kate, Umbrello, etc.
|-valign="top"
|kdetoys
|packaged
|KTeatime, etc.
|-valign="top"
|kdeedu
|packaged
|Marble, Parley, KStars, KHangman, etc.
|-valign="top"
|kdegraphics
|not packaged
|Okular, kolourpaint, etc.
|-valign="top"
|amarok
|packaged
|Amarok music player
|-valign="top"
|koffice
|not packaged
|KWord, Krita, Karbon, etc.
|-valign="top"
|kdepim
|not building
|KMail, AKregator, etc.
|-valign="top"
|kdenetwork
|not building
|Kopete, KGet, etc.
|-valign="top"
|kdeutils
|not packaged
|KGpg, KWallet, etc.
|}

[[Category: MS Windows]]

Projects/KDE on Windows/Installation

2008-02-18T23:39:56Z

Skierpage: /* Testing your installation */ don't suggest kruler, kdegraphics not currently built

{{Template:I18n/Language Navigation Bar|Projects/KDE_on_Windows/Installation}}

{{note|Perhaps actual developers should summarize status of KDE4 on Windows here, while we encourage users to describe their experiences on the [[Talk:{{PAGENAME}}|Talk page?]]}}

== KDE Installer for Windows ==
You can use this installer to download and install the
various binary packages that you need to run KDE applications on MS Windows.
KDE is free and open source so you can build all the applications "from scratch" from their source code;
but as a convenience for others,
volunteers create these precompiled packages and make them available on the Internet.

'''Disclaimer''' These are early days for KDE4 on Windows,
some programs work better than others and some fail to run altogether.

'''If you experience any problems please have a look into our [http://lists.kde.org/?l=kde-windows&r=1&w=2| mailing list].'''

You can also use the KDE Installer for Windows to install source code and the packages that you need to ''build'' KDE4 on Windows
(although if you are building KDE4 on Windows you may prefer to use the emerge system to build KDE and its requirements from latest source);
see [[Getting Started/Build/KDE4/Windows]].

=== Summary of Steps ===
* Visit http://download.cegit.de/kde-windows/installer/
* Download and save the latest version to a directory, e.g. <tt>C:\KDE4</tt>
* Run the installer, download what you need (see [[#Download needed packages]] below).
* Add your lib directory, e.g. <tt>C:\KDE4\lib</tt> to your Windows %PATH%. (Start > Control Panel > System > Advanced > Environment Variables, double-click the Path System Variable and add this to your path separated by semicolon.)
* Add a KDEDIRS environment variable (Start > Control Panel > System > Advanced > Environment Variables, click [New] User variable and create Variable name <tt>KDEDIRS</tt> with Variable value the directory where you installed KDE4, e.g. <tt>C:\KDE4</tt>).
* [TEMPORARILY] Follow the instructions at [[#post-install steps]]
* Try running a Qt application in the <tt>bin</tt> directory, such as linguist.exe
* If that works, try running a KDE application such as <tt>kwrite.exe</tt>.

=== Download needed packages ===
A single program in the The K Desktop Environment depends on many other libraries and packages; that is why each .exe is comparatively small.
The KDE Installer for Windows has some awareness of dependencies,
but not complete.
So, the first few times you try to run an application you may see alerts about missing DLLs.

If you do not intend to build from source, do not click "all" and do not click "src", as you do not need to download the source for each package. ''Unclear whether you need lib for each''.

There are two development systems for KDE on Windows,
Microsoft's Visual C and [http://en.wikipedia.org/wiki/MinGW MinGW].
Even if you are only running binaries and do not intend to build KDE4 yourself,
you need to choose between these because of the provided runtime environments.
You're free to decide which to take.

The KDE programs themselves are organized into several groups: kdeedu, kdegames, and kdegraphics.

Here are some of the minimal packages you need to run a KDE application:
: dbus-msvc, kdebase-msvc, kdewin32-msvc, qt-msvc, vcredist, ??

The Dependencies tab for a particular package lists some of the additional packages it needs.
However, the dependency checking currently only works for first-level dependencies
Other dependencies are not easy to determine in advance.
For example, if you install kdegames only with its dependencies,
you will not be able to start it because you also need libstreamanalyze
(for which you have to install the strigi package).
rhabacker: This is fixed in installer version > 0.8.4.

[[Getting_Started/Build/KDE4/Windows/3rd-party_libraries]] is a more complete list of libraries that a full installation needs.

=== Issues with KDE Installer for Windows ===
Currently no issues known. If you found an issue, please report to [mailto:kde-windows@kde.org].

== post-install steps ==
You currently need to run a number of command-line programs to set up KDE. Here are the steps.

===Run update-mime-database===
Be sure that you have no KDE-related applications: run the Windows Task Manager (taskmgr.exe), switch to its Processes tab, and kill all occurences of dbus-daemon.exe, kded4.exe, kioslave.exe and klauncher.exe (and all other KDE apps).

Open a Windows command prompt (cmd.exe) and navigate to the directory where you installed KDE. Say you installed KDE to C:\KDE4, then run from the cmd.exe window:
C:\KDE4> '''bin\update-mime-database C:\KDE4\share\mime'''
This will give you a lot of warning message. Most of them you can easily ignore; even if you should set [[KDE_System_Administration/Environment_Variables#XDG_DATA_HOME|XDG_DATA_HOME]] or [[KDE_System_Administration/Environment_Variables#XDG_DATA_DIRS|XDG_DATA_DIRS]] it worked perfectly. If it says you should rerun update-mime-database as root then you're not within your installation directory.

===Run kbuildsyscoca4===
After finishing the previous step, run
C:\KDE4> '''bin\kbuildsycoca4 --noincremental'''
If this tells you that your disk is full (which is most probably not the case) you have still some executables from KDE running. Please close them and try again.

Excuse us for the inconvenience — we hope for a better solution in the next release.

== Testing your installation ==
Navigate to the <tt>bin</tt> directory.

See if you can run the Qt program assistant.exe.
Qt programs have fewer dependencies than a full-blown KDE application.

If that works, try running a simple KDE application, such as lskat.exe from the kdegames package.

The first KDE application you run will start a console window in order to run the [http://en.wikipedia.org/wiki/D-Bus D-Bus daemon].

== Fine-tuning ==
===Set Oxygen style for widgets===
The default KDE widget style on Windows is the native one. You already have Oxygen style installed (which is a plugin library %KDEROOT%\lib\kde4\plugins\styles\oxygen.dll), so it can be used as well. To set it for a single user:
#edit <tt>%UserPROFILE%\.kde\share\config\kdeglobals</tt> with any text editor (e.g. kwrite)
#locate line containing "[General]" text, what is a section, if there is no such line, add one
#replace or add <tt>widgetStyle=....</tt> line with <tt>widgetStyle=oxygen</tt>.
Newly started applications should be displayed with Oxygen style now.

== Status ==
Using kdewin-installer-gui-0.8.6.exe to install 4.00.60 packages:
* starting a KDE program correctly starts dbus-daemon.exe
* many games run
* choosing File > Open correctly starts klauncher.exe, kioslave.exe and kded4.exe, and runs kbuildsycoca4.exe as needed.
* Help > ''Program'' Handbook (often mapped to the [F1] key) does not work because the KDE Help Center is not available on Windows. This is due to its use of the K3Process interface and external dependencies not ported such as perl scripts, htdig, and other libraries.
** khelpcenter will be included in the next unstable release. The K3Process issues are fixed now. Perl scripts are disabled, which means there is no fulltext search. -- rhabacker
* Applications that try to play sounds might display an alert about "Multimedia Backend" problems. This requires the Windows backend for [http://phonon.kde.org/ Phonon].

General notes:
* There are many other KDE programs that are not part of KDE 4.0.0 and are not currently packaged for Windows, such as KOffice 2.
* By design, KDE-windows does not provide the full-blown KDE desktop, thus no KWin composite manager, KDE-specific "start" menus, Plasma desktop, etc.

=== Package status and contents ===
{| border="0" cellpadding="2"
|-valign="top"
!package
!status
!contains applications
|-valign="top"
|kdebase
|packaged
|Konqueror, Dolphin, KWrite, etc.
|-valign="top"
|kdegames
|packaged
|Kgoldrunner, Kpat, KMahjongg, etc.
|-valign="top"
|kdesdk
|packaged
|Kate, Umbrello, etc.
|-valign="top"
|kdetoys
|packaged
|KTeatime, etc.
|-valign="top"
|kdeedu
|packaged
|Marble, Parley, KStars, KHangman, etc.
|-valign="top"
|kdegraphics
|not packaged
|Okular, kolourpaint, etc.
|-valign="top"
|amarok
|packaged
|Amarok
|-valign="top"
|koffice
|not packaged
|KWord, Krita, Karbon, etc.
|-valign="top"
|kdepim
|not building
|KMail, AKregator, etc.
|-valign="top"
|kdenetwork
|not building
|Kopete, KGet, etc.
|-valign="top"
|kdeutils
|not packaged
|KGpg, KWallet, etc.
|}

[[Category: MS Windows]]

Projects/KDE on Windows/Installation

2008-02-02T10:32:04Z

Skierpage: /* Run kbuildsyscoca4 */ fix formatting

{{note|Perhaps actual developers should summarize status of KDE4 on Windows here, while we encourage users to describe their experiences on the [[Talk:{{PAGENAME}}|Talk page?]]}}

== KDE Installer for Windows ==
You can use this installer to download and install the
various binary packages that you need to run KDE applications on MS Windows.
KDE is free and open source so you can build all the applications "from scratch" from their source code;
but as a convenience for others,
volunteers create these precompiled packages and make them available on the Internet.

'''Disclaimer''' These are early days for KDE4 on Windows,
some programs work better than others and some fail to run altogether.

'''If you experience any problems please have a look into our [http://lists.kde.org/?l=kde-windows&r=1&w=2| mailing list].'''

You can also use the KDE Installer for Windows to install source code and the packages that you need to ''build'' KDE4 on Windows
(although if you are building KDE4 on Windows you may prefer to use the emerge system to build KDE and its requirements from latest source);
see [[Getting Started/Build/KDE4/Windows]].

=== Summary of Steps ===
* Visit http://download.cegit.de/kde-windows/installer/
* Download and save the latest version to a directory, e.g. <tt>C:\KDE4</tt>
* Run the installer, download what you need (see [[#Download needed packages]] below).
* Add your lib directory, e.g. <tt>C:\KDE4\lib</tt> to your Windows %PATH%. (Start > Control Panel > System > Advanced > Environment Variables, double-click the Path System Variable and add this to your path separated by semicolon.)
* Add a KDEDIRS environment variable (Start > Control Panel > System > Advanced > Environment Variables, click [New] User variable and create Variable name <tt>KDEDIRS</tt> with Variable value the directory where you installed KDE4, e.g. <tt>C:\KDE4</tt>).
* [TEMPORARILY] Follow the instructions at [[#post-install steps]]
* Try running a Qt application in the <tt>bin</tt> directory, such as linguist.exe
* If that works, try running a KDE application such as <tt>kwrite.exe</tt>.

=== Download needed packages ===
A single program in the The K Desktop Environment depends on many other libraries and packages; that is why each .exe is comparatively small.
The KDE Installer for Windows has some awareness of dependencies,
but not complete.
So, the first few times you try to run an application you may see alerts about missing DLLs.

If you do not intend to build from source, do not click "all" and do not click "src", as you do not need to download the source for each package. ''Unclear whether you need lib for each''.

There are two development systems for KDE on Windows,
Microsoft's Visual C and [http://en.wikipedia.org/wiki/MinGW MinGW].
Even if you are only running binaries and do not intend to build KDE4 yourself,
you need to choose between these because of the provided runtime environments.
You're free to decide which to take.

The KDE programs themselves are organized into several groups: kdeedu, kdegames, and kdegraphics.

Here are some of the minimal packages you need to run a KDE application:
: dbus-msvc, kdebase-msvc, kdewin32-msvc, qt-msvc, vcredist, ??

The Dependencies tab for a particular package lists some of the additional packages it needs.
However, the dependency checking currently only works for first-level dependencies
Other dependencies are not easy to determine in advance.
For example, if you install kdegames only with its dependencies,
you will not be able to start it because you also need libstreamanalyze
(for which you have to install the strigi package).
rhabacker: This is fixed in installer version > 0.8.4.

[[Getting_Started/Build/KDE4/Windows/3rd-party_libraries]] is a more complete list of libraries that a full installation needs.

=== Issues with KDE Installer for Windows ===
Currently no issues known. If you found an issue, please report to [mailto:kde-windows@kde.org].

== post-install steps ==
You currently need to run a number of command-line programs to set up KDE. Here are the steps.

===Run update-mime-database===
Be sure that you have no KDE-related applications: run the Windows Task Manager (taskmgr.exe), switch to its Processes tab, and kill all occurences of dbus-daemon.exe, kded4.exe, kioslave.exe and klauncher.exe (and all other KDE apps).

Open a Windows command prompt (cmd.exe) and navigate to the directory where you installed KDE. Say you installed KDE to C:\KDE4, then run from the cmd.exe window:
C:\KDE4> '''bin\update-mime-database C:\KDE4\share\mime'''
This will give you a lot of warning message. Most of them you can easily ignore; even if you should set [[KDE_System_Administration/Environment_Variables#XDG_DATA_HOME|XDG_DATA_HOME]] or [[KDE_System_Administration/Environment_Variables#XDG_DATA_DIRS|XDG_DATA_DIRS]] it worked perfectly. If it says you should rerun update-mime-database as root then you're not within your installation directory.

===Run kbuildsyscoca4===
After finishing the previous step, run
C:\KDE4> '''bin\kbuildsycoca4 --noincremental'''
If this tells you that your disk is full (which is most probably not the case) you have still some executables from KDE running. Please close them and try again.

Excuse us for the inconvenience — we hope for a better solution in the next release.

== Testing your installation ==
Navigate to the <tt>bin</tt> directory.

See if you can run the Qt program assistant.exe.
Qt programs have fewer dependencies than a full-blown KDE application.

If that works, try running a simple KDE application, such as kruler.exe from the kdegraphics package.

The first KDE application you run will start a console window in order to run the [http://en.wikipedia.org/wiki/D-Bus D-Bus daemon].

== Fine-tuning ==
===Set Oxygen style for widgets===
The default KDE widget style on Windows is the native one. You already have Oxygen style installed (which is a plugin library %KDEROOT%\lib\kde4\plugins\styles\oxygen.dll), so it can be used as well. To set it for a single user:
#edit <tt>%UserPROFILE%\.kde\share\config\kdeglobals</tt> with any text editor (e.g. kwrite)
#locate line containing "[General]" text, what is a section, if there is no such line, add one
#replace or add <tt>widgetStyle=....</tt> line with <tt>widgetStyle=oxygen</tt>.
Newly started applications should be displayed with Oxygen style now.

== Status ==
Using kdewin-installer-gui-0.8.5.exe to install 4.00.80 packages:
* starting a KDE program correctly starts dbus-daemon.exe
* many games run
* choosing File > Open correctly starts klauncher.exe, kioslave.exe and kded4.exe, and runs kbuildsycoca4.exe as needed.
* Help > ''Program'' Handbook (often mapped to the [F1] key) does not work because the KDE Help Center is not available on Windows. This is due to its use of the K3Process interface and external dependencies not ported such as perl scripts, htdig, and other libraries.
** khelpcenter will be included in the next unstable release. The K3Process issues are fixed now. Perl scripts are disabled, which means there is no fulltext search. -- rhabacker
* Applications that try to play sounds will display an alert about "Multimedia Backend" problems. A Windows backend for [http://phonon.kde.org/ Phonon] is not packaged yet.

General notes:
* There are many other KDE programs that are not part of KDE 4.0.0 and are not currently packaged for Windows, such as KOffice 2 and Amarok.
* By design, KDE-windows does not provide the full-blown KDE desktop, thus no KWin composite manager, KDE-specific "start" menus, Plasma desktop, etc.

=== Package status and contents ===
{| border="0" cellpadding="2"
|-valign="top"
!package
!status
!contains applications
|-valign="top"
|kdebase
|packaged
|Konqueror, Dolphin, KWrite, etc.
|-valign="top"
|kdegames
|packaged
|Kgoldrunner, Kpat, KMahjongg, etc.
|-valign="top"
|kdesdk
|packaged
|Kate, Umbrello, etc.
|-valign="top"
|kdetoys
|packaged
|KTeatime, etc.
|-valign="top"
|kdeedu
|packaged
|Marble, Parley, KStars, KHangman, etc.
|-valign="top"
|kdegraphics
|not packaged
|Okular, kolourpaint, etc.
|-valign="top"
|amarok
|not packaged
|Amarok
|-valign="top"
|koffice
|not packaged
|KWord, Krita, Karbon, etc.
|-valign="top"
|kdepim
|not building
|KMail, AKregator, etc.
|-valign="top"
|kdenetwork
|not building
|Kopete, KGet, etc.
|}

[[Category: MS Windows]]

Projects/KDE on Windows/Installation

2008-02-02T10:31:27Z

Skierpage: /* Run update-mime-database */ fix formatting

{{note|Perhaps actual developers should summarize status of KDE4 on Windows here, while we encourage users to describe their experiences on the [[Talk:{{PAGENAME}}|Talk page?]]}}

== KDE Installer for Windows ==
You can use this installer to download and install the
various binary packages that you need to run KDE applications on MS Windows.
KDE is free and open source so you can build all the applications "from scratch" from their source code;
but as a convenience for others,
volunteers create these precompiled packages and make them available on the Internet.

'''Disclaimer''' These are early days for KDE4 on Windows,
some programs work better than others and some fail to run altogether.

'''If you experience any problems please have a look into our [http://lists.kde.org/?l=kde-windows&r=1&w=2| mailing list].'''

You can also use the KDE Installer for Windows to install source code and the packages that you need to ''build'' KDE4 on Windows
(although if you are building KDE4 on Windows you may prefer to use the emerge system to build KDE and its requirements from latest source);
see [[Getting Started/Build/KDE4/Windows]].

=== Summary of Steps ===
* Visit http://download.cegit.de/kde-windows/installer/
* Download and save the latest version to a directory, e.g. <tt>C:\KDE4</tt>
* Run the installer, download what you need (see [[#Download needed packages]] below).
* Add your lib directory, e.g. <tt>C:\KDE4\lib</tt> to your Windows %PATH%. (Start > Control Panel > System > Advanced > Environment Variables, double-click the Path System Variable and add this to your path separated by semicolon.)
* Add a KDEDIRS environment variable (Start > Control Panel > System > Advanced > Environment Variables, click [New] User variable and create Variable name <tt>KDEDIRS</tt> with Variable value the directory where you installed KDE4, e.g. <tt>C:\KDE4</tt>).
* [TEMPORARILY] Follow the instructions at [[#post-install steps]]
* Try running a Qt application in the <tt>bin</tt> directory, such as linguist.exe
* If that works, try running a KDE application such as <tt>kwrite.exe</tt>.

=== Download needed packages ===
A single program in the The K Desktop Environment depends on many other libraries and packages; that is why each .exe is comparatively small.
The KDE Installer for Windows has some awareness of dependencies,
but not complete.
So, the first few times you try to run an application you may see alerts about missing DLLs.

If you do not intend to build from source, do not click "all" and do not click "src", as you do not need to download the source for each package. ''Unclear whether you need lib for each''.

There are two development systems for KDE on Windows,
Microsoft's Visual C and [http://en.wikipedia.org/wiki/MinGW MinGW].
Even if you are only running binaries and do not intend to build KDE4 yourself,
you need to choose between these because of the provided runtime environments.
You're free to decide which to take.

The KDE programs themselves are organized into several groups: kdeedu, kdegames, and kdegraphics.

Here are some of the minimal packages you need to run a KDE application:
: dbus-msvc, kdebase-msvc, kdewin32-msvc, qt-msvc, vcredist, ??

The Dependencies tab for a particular package lists some of the additional packages it needs.
However, the dependency checking currently only works for first-level dependencies
Other dependencies are not easy to determine in advance.
For example, if you install kdegames only with its dependencies,
you will not be able to start it because you also need libstreamanalyze
(for which you have to install the strigi package).
rhabacker: This is fixed in installer version > 0.8.4.

[[Getting_Started/Build/KDE4/Windows/3rd-party_libraries]] is a more complete list of libraries that a full installation needs.

=== Issues with KDE Installer for Windows ===
Currently no issues known. If you found an issue, please report to [mailto:kde-windows@kde.org].

== post-install steps ==
You currently need to run a number of command-line programs to set up KDE. Here are the steps.

===Run update-mime-database===
Be sure that you have no KDE-related applications: run the Windows Task Manager (taskmgr.exe), switch to its Processes tab, and kill all occurences of dbus-daemon.exe, kded4.exe, kioslave.exe and klauncher.exe (and all other KDE apps).

Open a Windows command prompt (cmd.exe) and navigate to the directory where you installed KDE. Say you installed KDE to C:\KDE4, then run from the cmd.exe window:
C:\KDE4> '''bin\update-mime-database C:\KDE4\share\mime'''
This will give you a lot of warning message. Most of them you can easily ignore; even if you should set [[KDE_System_Administration/Environment_Variables#XDG_DATA_HOME|XDG_DATA_HOME]] or [[KDE_System_Administration/Environment_Variables#XDG_DATA_DIRS|XDG_DATA_DIRS]] it worked perfectly. If it says you should rerun update-mime-database as root then you're not within your installation directory.

===Run kbuildsyscoca4===
After finishing the previous step, run <pre>C:\KDE4> '''bin\kbuildsycoca4 --noincremental'''</pre> If this tells you that your disk is full (which is most probably not the case) you have still some executables from KDE running. Please close them and try again.

Excuse us for the inconvenience — we hope for a better solution in the next release.

== Testing your installation ==
Navigate to the <tt>bin</tt> directory.

See if you can run the Qt program assistant.exe.
Qt programs have fewer dependencies than a full-blown KDE application.

If that works, try running a simple KDE application, such as kruler.exe from the kdegraphics package.

The first KDE application you run will start a console window in order to run the [http://en.wikipedia.org/wiki/D-Bus D-Bus daemon].

== Fine-tuning ==
===Set Oxygen style for widgets===
The default KDE widget style on Windows is the native one. You already have Oxygen style installed (which is a plugin library %KDEROOT%\lib\kde4\plugins\styles\oxygen.dll), so it can be used as well. To set it for a single user:
#edit <tt>%UserPROFILE%\.kde\share\config\kdeglobals</tt> with any text editor (e.g. kwrite)
#locate line containing "[General]" text, what is a section, if there is no such line, add one
#replace or add <tt>widgetStyle=....</tt> line with <tt>widgetStyle=oxygen</tt>.
Newly started applications should be displayed with Oxygen style now.

== Status ==
Using kdewin-installer-gui-0.8.5.exe to install 4.00.80 packages:
* starting a KDE program correctly starts dbus-daemon.exe
* many games run
* choosing File > Open correctly starts klauncher.exe, kioslave.exe and kded4.exe, and runs kbuildsycoca4.exe as needed.
* Help > ''Program'' Handbook (often mapped to the [F1] key) does not work because the KDE Help Center is not available on Windows. This is due to its use of the K3Process interface and external dependencies not ported such as perl scripts, htdig, and other libraries.
** khelpcenter will be included in the next unstable release. The K3Process issues are fixed now. Perl scripts are disabled, which means there is no fulltext search. -- rhabacker
* Applications that try to play sounds will display an alert about "Multimedia Backend" problems. A Windows backend for [http://phonon.kde.org/ Phonon] is not packaged yet.

General notes:
* There are many other KDE programs that are not part of KDE 4.0.0 and are not currently packaged for Windows, such as KOffice 2 and Amarok.
* By design, KDE-windows does not provide the full-blown KDE desktop, thus no KWin composite manager, KDE-specific "start" menus, Plasma desktop, etc.

=== Package status and contents ===
{| border="0" cellpadding="2"
|-valign="top"
!package
!status
!contains applications
|-valign="top"
|kdebase
|packaged
|Konqueror, Dolphin, KWrite, etc.
|-valign="top"
|kdegames
|packaged
|Kgoldrunner, Kpat, KMahjongg, etc.
|-valign="top"
|kdesdk
|packaged
|Kate, Umbrello, etc.
|-valign="top"
|kdetoys
|packaged
|KTeatime, etc.
|-valign="top"
|kdeedu
|packaged
|Marble, Parley, KStars, KHangman, etc.
|-valign="top"
|kdegraphics
|not packaged
|Okular, kolourpaint, etc.
|-valign="top"
|amarok
|not packaged
|Amarok
|-valign="top"
|koffice
|not packaged
|KWord, Krita, Karbon, etc.
|-valign="top"
|kdepim
|not building
|KMail, AKregator, etc.
|-valign="top"
|kdenetwork
|not building
|Kopete, KGet, etc.
|}

[[Category: MS Windows]]

Talk:Projects/KDE on Windows/Installation

2008-02-02T07:56:14Z

Skierpage: /* KDE World Clock */ fixed

Use this page to record your experiences with KDE on Windows.
Click the + tab and enter <nowiki>~~~~</nowiki> as the subject to add your experiences. Include both your installer version and the KDE version (from the "installed" column for the kde* package names in the installer, or from the Help > About KDE dialog).
<nowiki> I want to know how to uninstall it. Thanks </nowiki>
'''Please use only meaningful descriptions (the content will be edited). The software is in early beta now. The installer will receive usability improvements before the final release.'''

== A Blog "review" with screenshots - MrCopilot (30 January 2008) ==
See http://mrcopilot.blogspot.com/2008/01/can-kde-save-dying-windows-platform.html , with screenshots and comments on many KDE applications running in MS Windows.

== Version 0.8.5 notes - 75.128.118.56 (26 January 2008)==
Since I am not what you call a Linux guru, I tried initially installing as an end-user. However, that seems to not install certain things, and once you have made that choice, there is no going back - you can't change the installer settings from End User to Developer, and I think that may be why several packages are not being installed (for example, the kruler.exe program is not installed, and is not available to be installed)
: kruler.exe is part of kdegraphics, and as "Status" says, not currently packaged

Another example: When running konquerer.exe, if I type http://www.google.com into the search bar, it complains about the following missing files: konq_aboutpage.dll, libkhtmlpart.dll, and katepart.dll. None of those files were available to install. Perhaps they are available if you say you are a developer, but I had no way to test that because the buttons that select end user or developer are grayed out.
: Works for me, did you set KDEDIR and add the lib directory to your PATH as per "Summary of Steps"?

I do have one request, after you get the problems fixed, please consider adding krusader to the list of supported packages.

== [[User:Skierpage|Skierpage]] 11:33, 18 January 2008 (CET) using 3.97 ==
Here's [[User:Skierpage]]'s experience using kdewin-installer-gui-0.8.4-4.exe to install 3.97 2007-12-31 files
on Windows XP SP2.

=== Continuing ===
* No khelpcenter, so no Help > ''Program'' Handbook
* Help > Report Bug... > Launch Bug Report Wizard still does nothing ({{Bug|156689}} filed)
* <del>Problems trying to save and open files in apps, KDE complains about their mime type.</del> Fixed by new Post-install steps on install page!
* Get Hot New Stuff still has problems trying to run gpg.exe.

::please file bugs at B.K.O. (bugs.kde.org) --[[User:SaroEngels|SaroEngels]] 01:11, 25 January 2008 (CET)

=== File Open Dialog ===
* clicking Network icon <del>crashes </del>({{Bug|156080}} filed, fixed in 4.00.80 it displays ''Local Network'')
* clicking Home icon does nothing ({{Bug|156690}} filed, still true in 4.00.80).
* clicking Root shows '''Custom''' in file path. (still true in 4.00.80).
* DebugView shows several <tt>[5940] class QStringList __thiscall Solid::Backends::Hal::HalManager::findDeviceByDeviceInterface(const enum Solid::DeviceInterface::Type &) error: "org.freedesktop.DBus.Error.ServiceUnknown" </tt>

=== Specific Apps ===
==== KStars ====
* during startup or Setup Wizard outputs <tt> kstars(5344) class KStarsDateTime __cdecl KStarsDateTime::fromString(const class QString &): "Could not parse Date/Time string: " "" </tt>
* can't view Web pages from Object Details dialog > Links > View Resource. No error, but no activity. Possibly at the same time saw output "[5344] kstars(5344)/kdeui (KNotification) void __thiscall KNotification::slotReceivedIdError(const class QDBusError &): Error while contacting notify daemon "The name org.kde.knotify was not provided by any .service files"
"
:: I know this last error - but I don't know another fix than kill all apps and restart yet. --[[User:SaroEngels|SaroEngels]] 01:10, 25 January 2008 (CET)

== Installer ==

<strike>_ The following concerns 0.8.1-2 and 0.8.2 :

# Too much has to be done manually to qualify it as an "installer" for now.
# It hangs far too often (over 50% in more than a dozen runs).
# It lacks a "Select all" option.
# It does not report correctly as to what it has done - many of the KDE packages and the QT package show as uninstalled after more than a dozen attempts. And yes, the messages scrolled very prettily. And several times the process ran to the point where I could press the "Finish" button and did so.
# It does not have a search option so that one can chase down a missing DLL (e.g. "kdecore.dll").
# The error message box after a failed download does NOT give the name of the package that failed nor why it failed (not on server, comm.failure, already on local disk, etc.). I narrowed the failed downloads to some of the "tools".
# The process does NOT put either a "Start-Here.html" or some sort of read-me file in the base directory (e.g. "KDE4").
</strike>

== Issues ==
1)The installer seems to also like to crash. Anyone want to post alternative setup instructions?

2)The installer should not install documentation automatically if the user install the binary package

heres a killer libkdewin32.dll not properly installed
AKA this is useless.
Installer is a mess , can't uninstall either properly.
Got one game to work
but others kept that lib error.
Not going to bother fixing. You shouldn't say this is ready when its clearly not even installable properly.
Note rerun the installer 8 times you might get it to run.
Its still trying to uninstall.

== [[User:Skierpage|Skierpage]] 07:43, 5 November 2007 (CET) on 2007-11-03 ==
Here's [[User:Skierpage]]'s experience partially installing files with
kdewin-installer-gui-0.8.1-2.exe
on Windows XP SP2.

''Some of my problems were caused by the KDE Installer silently failing to install kdebase bin.''

=== General ===
Each app's Help > Handbook fails to start

About the time I tried the handbook the program couldn't find the KDE crash handler drkonqi.exe.

Submit Bug Report fails to load anything when you click [Launch Bug Wizard];
nothing displays in Process Monitor or DebugView.

Okular and KStars crashed just after trying to access ksyscoca and then "launching kbuildsycoca4". I ran kbuildsycoca4 by hand and then both applications got further.

My display got garbled, displaying what looks like a backing store of the current window in the top left. This first happened with kolf.exe, then happened to KDE Installer. Closing every K* app seemed to cure it.

=== Specific apps ===
bovo, kblackbox, kgeography pixeltool, etc. worked fine.

==== Dolphin ====
<del>1. Even after following instructions in kbuildsycoca4 section below, still mime type id not getting picked up. In the information section it "shows type: mime" instead of correct type. Because of the same reason, I think, it shows all the elements with same icon (binary) including directories.</del>
: Fixed in 4.00.80 after running "Post-install steps"

2. If icon is clicked, open with dialog opens and if I choose kate from the list following error box appears "Service 'C:/KDE 4.0/share/applications/kde4/kate.desktop' is malformatted"
: Still happens in 4.00.80

==== KStars ====
Looks '''awesome'''. In the list of cities in setup,
accented characters appear incorrectly as multiple characters,
as if the encoding is off. [http://www.skierpage.com/kde_bugs/kstars_setup_bad_chars.png See screenshot.]

When I clicked [Download extra data], it crashes. In DebugView, last thing it tried to do was open ksycoca and then launch kbuildsycoca4.

After running kbuildsycoca4 and restarting, KStars [Download extra data] created a "Get Hot New Stuff", but that window was obscured by both KStars and its wizard. It had a [Close] button but would not accept input. I was able to [Cancel] the KStars setup window, at which point both the KStars and Get Hot New Stuff windows appeared. There was nothing in Get Hot New Stuff for "KStarsAdd On Installer" (sic -- word layout bug), so I clicked [Close].

Had some problems adding a new location (fumbled original data). Steps to reproduce:
Settings / geographic. Add a new location (Foo, norway). Realize something went wrong, edit latitude (change from say 10 10 10.00 to 11 11 11.00). Click OK. Choose OK to Override data. OK out. Open Setting/geographic again - there are now two Foos with location == original, expected was one, updated location.

==== kbuildsycoca4 ====
<strike>As this seemed to be causing problems, I ran it myself in a command window. It said "kbuildsycoca4 running..." then exited, seemingly OK.</strike>

The problem is another one:
kbuildsycoca4 builds the readonly database ksycoca in C:\Documents and Settings\USER\.kde\ .
That requires update-mime-database to have been successfully run.

So after each installation:
1. kill all processes: kioslave.exe, klauncher.exe, kded4.exe
2. enter kdeenv.bat (or a your cmd with KDEROOT set) run:
cd %KDEROOT%
%KDEROOT%\bin\update-mime-database %KDEROOT%\share\mime
%KDEROOT%\bin\kbuildsycoca4 --noincremental

update-mime-database prints lots of warnings; ignore them.
Only an error that you should rerun it as root, means that you are in the wrong directory. - Change to kderoot and rerun.

kbuildsycoca has a similar issue: if there are still some processes accessing ksycoca it will ask you whether your disk is full. You should kill all processes that are accessing this file (see process explorer from sysinternals.com ) and rerun it.

This stuff is due to be run by the installer or by emerge. I will hopefully fix this in the next few days. Until then this has to be run by hand.
--[[User:SaroEngels|SaroEngels]] 01:08, 25 January 2008 (CET)

==== KColorChooser ====
crashes when you choose "Named Colors" from the list.
(It fails to open several .mo files and .js files,
then tries to read rgb.txt from various X11 directories and obviously it's not there,
and then crashes.)

==== kruler ====
kruler's cursor in North or South orientation shows the vertical arrowhead and line but has black and white garbage on the other half of it where the selection point would be.

==== okular ====
First time it started klauncher.exe process but hung without displaying anything.
I killed the okular process and tried again; second time okular crashed; DebugView indicated it was trying to open ksyscoca, and when that failed it tried to launch ksyscocabuilder.exe:
[4644] okular(4644)/kdecore (KSycoca) bool __thiscall KSycocaPrivate::checkDatabase(class QFlags<enum KSycocaPrivate::BehaviorIfNotFound>): We have no database.... launching kbuildsycoca4
After running kbuildsycoca4 by hand okular appeared OK. When I chose File > Open I got an alert
Windows - No Disk
Exception Processing Message c00000013 Parameters ''hex hex hex''
I clicked [Continue] and got this alert again.
I think each time Windows was spinning up my empty floppy or CD-ROM drive.
Then the file dialog appeared but also an alert
Error - okular
The process for the file protocol died unexpectedly.

Meanwhile DebugView showed
[2916] not able to find 'kio_file' because KDEDIRS environment variable is not set.
[2916] Set KDEDIRS to the KDE installation root dir and restart klauncher to fix this problem.

I clicked Root in the file dialog and okular generated a ton of DebugView output in kdecore (KUrl) and then crashed.

I followed the instructions about setting up KDEDIRS, killed klauncher.exe, restarted Okular. I still got errors about No Disk but no more "file protocol death". Howeer, clicking Root in the file dialog still generates a ton of DebugView output and Okular crashes.

Even when I navigate to a folder with .png images in it, Open a document displays nothing. Even if I choose PNG image, it displays nothing. However, if I enter *.png in the Filter, it displays appropriate files.

However, choosing a png file results in okular displaying
Can not find a plugin that is able to handle the passed document
and then an error alert. Same for selecting a *.bmp.

Weirdly, entering *.jpg in the Filter immediately exits okular, with no errors.
::KBUILDSYCOCA4
::UPDATE_MIME_TYPE_ERROR --[[User:SaroEngels|SaroEngels]] 00:52, 25 January 2008 (CET)

==== ktouch ====
Exits, DebugView shows
[3452] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283
: In 4.00.80 displays friendlier alert "Unable to use the '''Fake''' Multimedia Backend: The shared library was not found."

==== kbruch ====
The accelerator [Alt+e] for [Next Task] does not work.

==== KDE World Clock ====
<del>Is pitch dark. The tooltip shows current city and add flag works. DebugView shows:
[4524] QImage::scaled: Image is a null image
[4524] QPainter::begin: Paint device returned engine == 0, type: 3
[4524] QPainter::setCompositionMode: Painter not active
[4524] QPainter::begin: Paint device returned engine == 0, type: 2

Its context menu has Map Theme > Surface Depth / Flat World / Surface Depth / Flat World , i.e. two entries repeated. Whatever you choose is checked twice.

I can't uncheck Show Daylight, Show Cities, Show Flags in the context menu, they remain checked.</del>
: All fixed in 4.00.80 version!

==== kteatime ====
It does display a fabulous notification bubble from the system tray when the tea is ready! Howeer, DebugView indicates "error while contacting knotify server" (I had configured KTeaTime to Play a sound, Show a message in a popup and Mark taskbar entry) :
[6052] kteatime(6052)/kdeui (KNotification) unsigned int __thiscall KNotificationManager::notify(class KNotification *,const class QPixmap &,const class QStringList &,const class QList<struct QPair<class QString,class QString> > &,const class QString &): error while contacting knotify server

==== khangman ====
It put up a dialog towards the back about progress, but unlike earlier app, that completed and it then worked great. I chose to, roughly. get words in a new language, chose France from the dialog/ Get Hot New Stuff showed up and worked but displayed an alert:
Error - KHangMan
Cannot start ''gpg'' and retrieve the available keys. Make sure that ''gpg'' is installed, otherwise verification of the downloaded resources will be impossible.

I installed gpgme and reran khangman, but now Get Hot New Stuff, did not display any categories.

I changed settings to play sounds and it immediately crashed with
[6072] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283

I got around this crash by editing khangmanrc to disable audio.
Still nothing in Get Hot New Stuff.

==== Kig ====
It worked pretty well, I was able to save a .kig file.
It kept prompting
Format not supported - Kig
Kig does not support saving to any other format than its own.
[Save Kig Format] [Cancel]
but if I choose "Save Kig Format" I get the alert again.
Only cancel worked to save the file.

However, when I tried to open that file, the Open dialog displayed its type as "plain text document", opening it led to a "Format Not Supported" alert. DebugView showed:
[5432] kig(5432)/kdecore (KUrl) __thiscall KUrl::KUrl(const class KUrl &): KUrl::KUrl(KUrl) path "" toLocalFile ""
[5432] kig(5432) bool __thiscall KigPart::openFile(void): mimetype: "text/plain"

So there are problems with mime type handling.
(It's scary that mime problems will stop a program from editing a file, how do I force it?)

::UPDATE_MIME_TYPE_ERROR --[[User:SaroEngels|SaroEngels]] 00:50, 25 January 2008 (CET)
:: Yup, fixed now with your "Post-install steps", thanks!

==== KWordQuiz ====
I was able to download French vocabulary, but when I dismissed it, I got the same alert as KHangMan once displayed
Cannot start gpg and retrieve the available keys. Make sure that gpg is installed.

kdelibs/knewstuff/knewstuff2/core/security.cpp is trying to start gpg in a new KProcess. I don't have `gpg` in my path, I'm not sure what package it's in.

::PLEASE ASSIGN TO B.K.O --[[User:SaroEngels|SaroEngels]] 00:49, 25 January 2008 (CET)

==== KGoldRunner ====
The background appears but none of the tiles, and the icons for them in Create New Game are missing. So some directory is missing, could be <tt>C:\KDE4\share\pixmaps</tt> NAME NOT FOUND, I don't know where the tiles should be.

[[Category: MS Windows]]

::PLEASE ASSIGN TO B.K.O --[[User:SaroEngels|SaroEngels]] 00:48, 25 January 2008 (CET)

== installation ==

I went through the installer (version 0.8.5), and when it got to the select mirror screen, all the mirrors are blank.

I have no idea what to add to the list.

* I can confirm that problem - happened here too.
* Here the same problem, are there any mirrors one can add manually?

:: Should work now, if not mirrors are here: [http://webdev.cegit.de/snapshots/kde-windows/mirrors.lst] --[[User:SaroEngels|SaroEngels]] 00:47, 25 January 2008 (CET)

== bug reports ==
After several minutes trying to find an adress to submit bug reports for kde on windows I report here that I have given up! This site is the only one I found to tell anyone about the problems.

Please post a link to a forum/bugreport engine or some email address.

::Please try to help copy the bugs to http://bugs.kde.org. Try to set Platform MS Windows. Please have a look after ''your'' bugs. -- [[User:SaroEngels|SaroEngels]] 00:46, 25 January 2008 (CET)

== Download needed packages ==

<strike>I started the installer and ended up with the dialog 'Download needed packages'. The docu says something about manual selection of the dependencies - WTF. On Linux nobody would even think to let the user select manually the required ones out of thousends of packages, but on windows one has to select the required ones out of ~100 Packages ?
I would not mind to install every package that might be required, but the installer has no option the select 'all'.</strike>

Edit: I now found out that if one selects one of the kde suites, that then the dependencies are resolved. So I propose to make this installer more suitable for non kde programmers an in general easier to understand.

::::Comment: this was a temporary solution in the wiki: the dependency tracking didn'T work correctly please fix in wiki if you can. - [[User:SaroEngels|SaroEngels]] 00:42, 25 January 2008 (CET)

== Unnecessarities in packages? ==

Some things I noticed:
* A lot of packages come with both release and debug binaries. The latter one are completely useless, at least to end users. It may be more sensible to separate debug binaries into their own packages.

rhabacker: where do you have seen this ? the qt bin package for example only contain end user applications and libraries. Debug libraries are located in the lib packages which are only installed in developer mode.

* There seem to be mingw+msvc versions even for seemingly C libraries, e.g. dbus. Such libraries are usually easily exchangeable between compilers (e.g. an MSVC compiled library with a C interface usually works w/ MinGW without problems). Perhaps this is an opportunity to remove some unnecessary packages?

chehrlic: All is fine here, we need it the way it is. We also know how to use mingw libs with msvc and vice versa but it only works under specific circumstances which are not met here.

::::FIXLATER - [[User:SaroEngels|SaroEngels]] 00:41, 25 January 2008 (CET)
::::No change here - [[User:chehrlic|chehrlic]] 07:04, 25 January 2008 (CET)

== Wishes ==
Everything's workin' perfect. But am i able to fully transform windows desktop environment into KDE ?
:[[User:Jstaniek|jstaniek]] 18:31, 30 January 2008 (CET) - short answer is NO. Not in the default setup, I guess. The transformation would break many native apps. Even if that can be fixed (really?), most users would still consider any such a full transformation as a breakage of the OS. What to do? '''As you apparently ask about replacing every part of Windows with KDE equivalents, just install Linux, BSD, etc. and and get all that immediately and natively'''.

Talk:Projects/KDE on Windows/Installation

2008-02-02T07:52:36Z

Skierpage: Link to MrCopilot's fine blog post.

Use this page to record your experiences with KDE on Windows.
Click the + tab and enter <nowiki>~~~~</nowiki> as the subject to add your experiences. Include both your installer version and the KDE version (from the "installed" column for the kde* package names in the installer, or from the Help > About KDE dialog).
<nowiki> I want to know how to uninstall it. Thanks </nowiki>
'''Please use only meaningful descriptions (the content will be edited). The software is in early beta now. The installer will receive usability improvements before the final release.'''

== A Blog "review" with screenshots - MrCopilot (30 January 2008) ==
See http://mrcopilot.blogspot.com/2008/01/can-kde-save-dying-windows-platform.html , with screenshots and comments on many KDE applications running in MS Windows.

== Version 0.8.5 notes - 75.128.118.56 (26 January 2008)==
Since I am not what you call a Linux guru, I tried initially installing as an end-user. However, that seems to not install certain things, and once you have made that choice, there is no going back - you can't change the installer settings from End User to Developer, and I think that may be why several packages are not being installed (for example, the kruler.exe program is not installed, and is not available to be installed)
: kruler.exe is part of kdegraphics, and as "Status" says, not currently packaged

Another example: When running konquerer.exe, if I type http://www.google.com into the search bar, it complains about the following missing files: konq_aboutpage.dll, libkhtmlpart.dll, and katepart.dll. None of those files were available to install. Perhaps they are available if you say you are a developer, but I had no way to test that because the buttons that select end user or developer are grayed out.
: Works for me, did you set KDEDIR and add the lib directory to your PATH as per "Summary of Steps"?

I do have one request, after you get the problems fixed, please consider adding krusader to the list of supported packages.

== [[User:Skierpage|Skierpage]] 11:33, 18 January 2008 (CET) using 3.97 ==
Here's [[User:Skierpage]]'s experience using kdewin-installer-gui-0.8.4-4.exe to install 3.97 2007-12-31 files
on Windows XP SP2.

=== Continuing ===
* No khelpcenter, so no Help > ''Program'' Handbook
* Help > Report Bug... > Launch Bug Report Wizard still does nothing ({{Bug|156689}} filed)
* <del>Problems trying to save and open files in apps, KDE complains about their mime type.</del> Fixed by new Post-install steps on install page!
* Get Hot New Stuff still has problems trying to run gpg.exe.

::please file bugs at B.K.O. (bugs.kde.org) --[[User:SaroEngels|SaroEngels]] 01:11, 25 January 2008 (CET)

=== File Open Dialog ===
* clicking Network icon <del>crashes </del>({{Bug|156080}} filed, fixed in 4.00.80 it displays ''Local Network'')
* clicking Home icon does nothing ({{Bug|156690}} filed, still true in 4.00.80).
* clicking Root shows '''Custom''' in file path. (still true in 4.00.80).
* DebugView shows several <tt>[5940] class QStringList __thiscall Solid::Backends::Hal::HalManager::findDeviceByDeviceInterface(const enum Solid::DeviceInterface::Type &) error: "org.freedesktop.DBus.Error.ServiceUnknown" </tt>

=== Specific Apps ===
==== KStars ====
* during startup or Setup Wizard outputs <tt> kstars(5344) class KStarsDateTime __cdecl KStarsDateTime::fromString(const class QString &): "Could not parse Date/Time string: " "" </tt>
* can't view Web pages from Object Details dialog > Links > View Resource. No error, but no activity. Possibly at the same time saw output "[5344] kstars(5344)/kdeui (KNotification) void __thiscall KNotification::slotReceivedIdError(const class QDBusError &): Error while contacting notify daemon "The name org.kde.knotify was not provided by any .service files"
"
:: I know this last error - but I don't know another fix than kill all apps and restart yet. --[[User:SaroEngels|SaroEngels]] 01:10, 25 January 2008 (CET)

== Installer ==

<strike>_ The following concerns 0.8.1-2 and 0.8.2 :

# Too much has to be done manually to qualify it as an "installer" for now.
# It hangs far too often (over 50% in more than a dozen runs).
# It lacks a "Select all" option.
# It does not report correctly as to what it has done - many of the KDE packages and the QT package show as uninstalled after more than a dozen attempts. And yes, the messages scrolled very prettily. And several times the process ran to the point where I could press the "Finish" button and did so.
# It does not have a search option so that one can chase down a missing DLL (e.g. "kdecore.dll").
# The error message box after a failed download does NOT give the name of the package that failed nor why it failed (not on server, comm.failure, already on local disk, etc.). I narrowed the failed downloads to some of the "tools".
# The process does NOT put either a "Start-Here.html" or some sort of read-me file in the base directory (e.g. "KDE4").
</strike>

== Issues ==
1)The installer seems to also like to crash. Anyone want to post alternative setup instructions?

2)The installer should not install documentation automatically if the user install the binary package

heres a killer libkdewin32.dll not properly installed
AKA this is useless.
Installer is a mess , can't uninstall either properly.
Got one game to work
but others kept that lib error.
Not going to bother fixing. You shouldn't say this is ready when its clearly not even installable properly.
Note rerun the installer 8 times you might get it to run.
Its still trying to uninstall.

== [[User:Skierpage|Skierpage]] 07:43, 5 November 2007 (CET) on 2007-11-03 ==
Here's [[User:Skierpage]]'s experience partially installing files with
kdewin-installer-gui-0.8.1-2.exe
on Windows XP SP2.

''Some of my problems were caused by the KDE Installer silently failing to install kdebase bin.''

=== General ===
Each app's Help > Handbook fails to start

About the time I tried the handbook the program couldn't find the KDE crash handler drkonqi.exe.

Submit Bug Report fails to load anything when you click [Launch Bug Wizard];
nothing displays in Process Monitor or DebugView.

Okular and KStars crashed just after trying to access ksyscoca and then "launching kbuildsycoca4". I ran kbuildsycoca4 by hand and then both applications got further.

My display got garbled, displaying what looks like a backing store of the current window in the top left. This first happened with kolf.exe, then happened to KDE Installer. Closing every K* app seemed to cure it.

=== Specific apps ===
bovo, kblackbox, kgeography pixeltool, etc. worked fine.

==== Dolphin ====
<del>1. Even after following instructions in kbuildsycoca4 section below, still mime type id not getting picked up. In the information section it "shows type: mime" instead of correct type. Because of the same reason, I think, it shows all the elements with same icon (binary) including directories.</del>
: Fixed in 4.00.80 after running "Post-install steps"

2. If icon is clicked, open with dialog opens and if I choose kate from the list following error box appears "Service 'C:/KDE 4.0/share/applications/kde4/kate.desktop' is malformatted"
: Still happens in 4.00.80

==== KStars ====
Looks '''awesome'''. In the list of cities in setup,
accented characters appear incorrectly as multiple characters,
as if the encoding is off. [http://www.skierpage.com/kde_bugs/kstars_setup_bad_chars.png See screenshot.]

When I clicked [Download extra data], it crashes. In DebugView, last thing it tried to do was open ksycoca and then launch kbuildsycoca4.

After running kbuildsycoca4 and restarting, KStars [Download extra data] created a "Get Hot New Stuff", but that window was obscured by both KStars and its wizard. It had a [Close] button but would not accept input. I was able to [Cancel] the KStars setup window, at which point both the KStars and Get Hot New Stuff windows appeared. There was nothing in Get Hot New Stuff for "KStarsAdd On Installer" (sic -- word layout bug), so I clicked [Close].

Had some problems adding a new location (fumbled original data). Steps to reproduce:
Settings / geographic. Add a new location (Foo, norway). Realize something went wrong, edit latitude (change from say 10 10 10.00 to 11 11 11.00). Click OK. Choose OK to Override data. OK out. Open Setting/geographic again - there are now two Foos with location == original, expected was one, updated location.

==== kbuildsycoca4 ====
<strike>As this seemed to be causing problems, I ran it myself in a command window. It said "kbuildsycoca4 running..." then exited, seemingly OK.</strike>

The problem is another one:
kbuildsycoca4 builds the readonly database ksycoca in C:\Documents and Settings\USER\.kde\ .
That requires update-mime-database to have been successfully run.

So after each installation:
1. kill all processes: kioslave.exe, klauncher.exe, kded4.exe
2. enter kdeenv.bat (or a your cmd with KDEROOT set) run:
cd %KDEROOT%
%KDEROOT%\bin\update-mime-database %KDEROOT%\share\mime
%KDEROOT%\bin\kbuildsycoca4 --noincremental

update-mime-database prints lots of warnings; ignore them.
Only an error that you should rerun it as root, means that you are in the wrong directory. - Change to kderoot and rerun.

kbuildsycoca has a similar issue: if there are still some processes accessing ksycoca it will ask you whether your disk is full. You should kill all processes that are accessing this file (see process explorer from sysinternals.com ) and rerun it.

This stuff is due to be run by the installer or by emerge. I will hopefully fix this in the next few days. Until then this has to be run by hand.
--[[User:SaroEngels|SaroEngels]] 01:08, 25 January 2008 (CET)

==== KColorChooser ====
crashes when you choose "Named Colors" from the list.
(It fails to open several .mo files and .js files,
then tries to read rgb.txt from various X11 directories and obviously it's not there,
and then crashes.)

==== kruler ====
kruler's cursor in North or South orientation shows the vertical arrowhead and line but has black and white garbage on the other half of it where the selection point would be.

==== okular ====
First time it started klauncher.exe process but hung without displaying anything.
I killed the okular process and tried again; second time okular crashed; DebugView indicated it was trying to open ksyscoca, and when that failed it tried to launch ksyscocabuilder.exe:
[4644] okular(4644)/kdecore (KSycoca) bool __thiscall KSycocaPrivate::checkDatabase(class QFlags<enum KSycocaPrivate::BehaviorIfNotFound>): We have no database.... launching kbuildsycoca4
After running kbuildsycoca4 by hand okular appeared OK. When I chose File > Open I got an alert
Windows - No Disk
Exception Processing Message c00000013 Parameters ''hex hex hex''
I clicked [Continue] and got this alert again.
I think each time Windows was spinning up my empty floppy or CD-ROM drive.
Then the file dialog appeared but also an alert
Error - okular
The process for the file protocol died unexpectedly.

Meanwhile DebugView showed
[2916] not able to find 'kio_file' because KDEDIRS environment variable is not set.
[2916] Set KDEDIRS to the KDE installation root dir and restart klauncher to fix this problem.

I clicked Root in the file dialog and okular generated a ton of DebugView output in kdecore (KUrl) and then crashed.

I followed the instructions about setting up KDEDIRS, killed klauncher.exe, restarted Okular. I still got errors about No Disk but no more "file protocol death". Howeer, clicking Root in the file dialog still generates a ton of DebugView output and Okular crashes.

Even when I navigate to a folder with .png images in it, Open a document displays nothing. Even if I choose PNG image, it displays nothing. However, if I enter *.png in the Filter, it displays appropriate files.

However, choosing a png file results in okular displaying
Can not find a plugin that is able to handle the passed document
and then an error alert. Same for selecting a *.bmp.

Weirdly, entering *.jpg in the Filter immediately exits okular, with no errors.
::KBUILDSYCOCA4
::UPDATE_MIME_TYPE_ERROR --[[User:SaroEngels|SaroEngels]] 00:52, 25 January 2008 (CET)

==== ktouch ====
Exits, DebugView shows
[3452] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283
: In 4.00.80 displays friendlier alert "Unable to use the '''Fake''' Multimedia Backend: The shared library was not found."

==== kbruch ====
The accelerator [Alt+e] for [Next Task] does not work.

==== KDE World Clock ====
Is pitch dark. The tooltip shows current city and add flag works. DebugView shows:
[4524]
[4524] QImage::scaled: Image is a null image
[4524] QPainter::begin: Paint device returned engine == 0, type: 3
[4524] QPainter::setCompositionMode: Painter not active
[4524] QPainter::begin: Paint device returned engine == 0, type: 2

Its context menu has Map Theme > Surface Depth / Flat World / Surface Depth / Flat World , i.e. two entries repeated. Whatever you choose is checked twice.

I can't uncheck Show Daylight, Show Cities, Show Flags in the context menu, they remain checked.

==== kteatime ====
It does display a fabulous notification bubble from the system tray when the tea is ready! Howeer, DebugView indicates "error while contacting knotify server" (I had configured KTeaTime to Play a sound, Show a message in a popup and Mark taskbar entry) :
[6052] kteatime(6052)/kdeui (KNotification) unsigned int __thiscall KNotificationManager::notify(class KNotification *,const class QPixmap &,const class QStringList &,const class QList<struct QPair<class QString,class QString> > &,const class QString &): error while contacting knotify server

==== khangman ====
It put up a dialog towards the back about progress, but unlike earlier app, that completed and it then worked great. I chose to, roughly. get words in a new language, chose France from the dialog/ Get Hot New Stuff showed up and worked but displayed an alert:
Error - KHangMan
Cannot start ''gpg'' and retrieve the available keys. Make sure that ''gpg'' is installed, otherwise verification of the downloaded resources will be impossible.

I installed gpgme and reran khangman, but now Get Hot New Stuff, did not display any categories.

I changed settings to play sounds and it immediately crashed with
[6072] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283

I got around this crash by editing khangmanrc to disable audio.
Still nothing in Get Hot New Stuff.

==== Kig ====
It worked pretty well, I was able to save a .kig file.
It kept prompting
Format not supported - Kig
Kig does not support saving to any other format than its own.
[Save Kig Format] [Cancel]
but if I choose "Save Kig Format" I get the alert again.
Only cancel worked to save the file.

However, when I tried to open that file, the Open dialog displayed its type as "plain text document", opening it led to a "Format Not Supported" alert. DebugView showed:
[5432] kig(5432)/kdecore (KUrl) __thiscall KUrl::KUrl(const class KUrl &): KUrl::KUrl(KUrl) path "" toLocalFile ""
[5432] kig(5432) bool __thiscall KigPart::openFile(void): mimetype: "text/plain"

So there are problems with mime type handling.
(It's scary that mime problems will stop a program from editing a file, how do I force it?)

::UPDATE_MIME_TYPE_ERROR --[[User:SaroEngels|SaroEngels]] 00:50, 25 January 2008 (CET)
:: Yup, fixed now with your "Post-install steps", thanks!

==== KWordQuiz ====
I was able to download French vocabulary, but when I dismissed it, I got the same alert as KHangMan once displayed
Cannot start gpg and retrieve the available keys. Make sure that gpg is installed.

kdelibs/knewstuff/knewstuff2/core/security.cpp is trying to start gpg in a new KProcess. I don't have `gpg` in my path, I'm not sure what package it's in.

::PLEASE ASSIGN TO B.K.O --[[User:SaroEngels|SaroEngels]] 00:49, 25 January 2008 (CET)

==== KGoldRunner ====
The background appears but none of the tiles, and the icons for them in Create New Game are missing. So some directory is missing, could be <tt>C:\KDE4\share\pixmaps</tt> NAME NOT FOUND, I don't know where the tiles should be.

[[Category: MS Windows]]

::PLEASE ASSIGN TO B.K.O --[[User:SaroEngels|SaroEngels]] 00:48, 25 January 2008 (CET)

== installation ==

I went through the installer (version 0.8.5), and when it got to the select mirror screen, all the mirrors are blank.

I have no idea what to add to the list.

* I can confirm that problem - happened here too.
* Here the same problem, are there any mirrors one can add manually?

:: Should work now, if not mirrors are here: [http://webdev.cegit.de/snapshots/kde-windows/mirrors.lst] --[[User:SaroEngels|SaroEngels]] 00:47, 25 January 2008 (CET)

== bug reports ==
After several minutes trying to find an adress to submit bug reports for kde on windows I report here that I have given up! This site is the only one I found to tell anyone about the problems.

Please post a link to a forum/bugreport engine or some email address.

::Please try to help copy the bugs to http://bugs.kde.org. Try to set Platform MS Windows. Please have a look after ''your'' bugs. -- [[User:SaroEngels|SaroEngels]] 00:46, 25 January 2008 (CET)

== Download needed packages ==

<strike>I started the installer and ended up with the dialog 'Download needed packages'. The docu says something about manual selection of the dependencies - WTF. On Linux nobody would even think to let the user select manually the required ones out of thousends of packages, but on windows one has to select the required ones out of ~100 Packages ?
I would not mind to install every package that might be required, but the installer has no option the select 'all'.</strike>

Edit: I now found out that if one selects one of the kde suites, that then the dependencies are resolved. So I propose to make this installer more suitable for non kde programmers an in general easier to understand.

::::Comment: this was a temporary solution in the wiki: the dependency tracking didn'T work correctly please fix in wiki if you can. - [[User:SaroEngels|SaroEngels]] 00:42, 25 January 2008 (CET)

== Unnecessarities in packages? ==

Some things I noticed:
* A lot of packages come with both release and debug binaries. The latter one are completely useless, at least to end users. It may be more sensible to separate debug binaries into their own packages.

rhabacker: where do you have seen this ? the qt bin package for example only contain end user applications and libraries. Debug libraries are located in the lib packages which are only installed in developer mode.

* There seem to be mingw+msvc versions even for seemingly C libraries, e.g. dbus. Such libraries are usually easily exchangeable between compilers (e.g. an MSVC compiled library with a C interface usually works w/ MinGW without problems). Perhaps this is an opportunity to remove some unnecessary packages?

chehrlic: All is fine here, we need it the way it is. We also know how to use mingw libs with msvc and vice versa but it only works under specific circumstances which are not met here.

::::FIXLATER - [[User:SaroEngels|SaroEngels]] 00:41, 25 January 2008 (CET)
::::No change here - [[User:chehrlic|chehrlic]] 07:04, 25 January 2008 (CET)

== Wishes ==
Everything's workin' perfect. But am i able to fully transform windows desktop environment into KDE ?
:[[User:Jstaniek|jstaniek]] 18:31, 30 January 2008 (CET) - short answer is NO. Not in the default setup, I guess. The transformation would break many native apps. Even if that can be fixed (really?), most users would still consider any such a full transformation as a breakage of the OS. What to do? '''As you apparently ask about replacing every part of Windows with KDE equivalents, just install Linux, BSD, etc. and and get all that immediately and natively'''.

Talk:Projects/KDE on Windows/Installation

2008-02-02T07:48:50Z

Skierpage: /* Version 0.8.5 notes */ identify author, some comments

Use this page to record your experiences with KDE on Windows.
Click the + tab and enter <nowiki>~~~~</nowiki> as the subject to add your experiences. Include both your installer version and the KDE version (from the "installed" column for the kde* package names in the installer, or from the Help > About KDE dialog).
<nowiki> I want to know how to uninstall it. Thanks </nowiki>
'''Please use only meaningful descriptions (the content will be edited). The software is in early beta now. The installer will receive usability improvements before the final release.'''

== Version 0.8.5 notes - 75.128.118.56 (26 January 2008)==
Since I am not what you call a Linux guru, I tried initially installing as an end-user. However, that seems to not install certain things, and once you have made that choice, there is no going back - you can't change the installer settings from End User to Developer, and I think that may be why several packages are not being installed (for example, the kruler.exe program is not installed, and is not available to be installed)
: Part of kdegraphics, and as "Status" says, not currently packaged

Another example: When running konquerer.exe, if I type http://www.google.com into the search bar, it complains about the following missing files: konq_aboutpage.dll, libkhtmlpart.dll, and katepart.dll. None of those files were available to install. Perhaps they are available if you say you are a developer, but I had no way to test that because the buttons that select end user or developer are grayed out.
: Works for me, did you set KDEDIR and add lib to your PATH as per "Summary of Steps"?

I do have one request, after you get the problems fixed, please consider adding krusader to the list of supported packages.

== [[User:Skierpage|Skierpage]] 11:33, 18 January 2008 (CET) using 3.97 ==
Here's [[User:Skierpage]]'s experience using kdewin-installer-gui-0.8.4-4.exe to install 3.97 2007-12-31 files
on Windows XP SP2.

=== Continuing ===
* No khelpcenter, so no Help > ''Program'' Handbook
* Help > Report Bug... > Launch Bug Report Wizard still does nothing ({{Bug|156689}} filed)
* <del>Problems trying to save and open files in apps, KDE complains about their mime type.</del> Fixed by new Post-install steps on install page!
* Get Hot New Stuff still has problems trying to run gpg.exe.

::please file bugs at B.K.O. (bugs.kde.org) --[[User:SaroEngels|SaroEngels]] 01:11, 25 January 2008 (CET)

=== File Open Dialog ===
* clicking Network icon <del>crashes </del>({{Bug|156080}} filed, fixed in 4.00.80 it displays ''Local Network'')
* clicking Home icon does nothing ({{Bug|156690}} filed, still true in 4.00.80).
* clicking Root shows '''Custom''' in file path. (still true in 4.00.80).
* DebugView shows several <tt>[5940] class QStringList __thiscall Solid::Backends::Hal::HalManager::findDeviceByDeviceInterface(const enum Solid::DeviceInterface::Type &) error: "org.freedesktop.DBus.Error.ServiceUnknown" </tt>

=== Specific Apps ===
==== KStars ====
* during startup or Setup Wizard outputs <tt> kstars(5344) class KStarsDateTime __cdecl KStarsDateTime::fromString(const class QString &): "Could not parse Date/Time string: " "" </tt>
* can't view Web pages from Object Details dialog > Links > View Resource. No error, but no activity. Possibly at the same time saw output "[5344] kstars(5344)/kdeui (KNotification) void __thiscall KNotification::slotReceivedIdError(const class QDBusError &): Error while contacting notify daemon "The name org.kde.knotify was not provided by any .service files"
"
:: I know this last error - but I don't know another fix than kill all apps and restart yet. --[[User:SaroEngels|SaroEngels]] 01:10, 25 January 2008 (CET)

== Installer ==

<strike>_ The following concerns 0.8.1-2 and 0.8.2 :

# Too much has to be done manually to qualify it as an "installer" for now.
# It hangs far too often (over 50% in more than a dozen runs).
# It lacks a "Select all" option.
# It does not report correctly as to what it has done - many of the KDE packages and the QT package show as uninstalled after more than a dozen attempts. And yes, the messages scrolled very prettily. And several times the process ran to the point where I could press the "Finish" button and did so.
# It does not have a search option so that one can chase down a missing DLL (e.g. "kdecore.dll").
# The error message box after a failed download does NOT give the name of the package that failed nor why it failed (not on server, comm.failure, already on local disk, etc.). I narrowed the failed downloads to some of the "tools".
# The process does NOT put either a "Start-Here.html" or some sort of read-me file in the base directory (e.g. "KDE4").
</strike>

== Issues ==
1)The installer seems to also like to crash. Anyone want to post alternative setup instructions?

2)The installer should not install documentation automatically if the user install the binary package

heres a killer libkdewin32.dll not properly installed
AKA this is useless.
Installer is a mess , can't uninstall either properly.
Got one game to work
but others kept that lib error.
Not going to bother fixing. You shouldn't say this is ready when its clearly not even installable properly.
Note rerun the installer 8 times you might get it to run.
Its still trying to uninstall.

== [[User:Skierpage|Skierpage]] 07:43, 5 November 2007 (CET) on 2007-11-03 ==
Here's [[User:Skierpage]]'s experience partially installing files with
kdewin-installer-gui-0.8.1-2.exe
on Windows XP SP2.

''Some of my problems were caused by the KDE Installer silently failing to install kdebase bin.''

=== General ===
Each app's Help > Handbook fails to start

About the time I tried the handbook the program couldn't find the KDE crash handler drkonqi.exe.

Submit Bug Report fails to load anything when you click [Launch Bug Wizard];
nothing displays in Process Monitor or DebugView.

Okular and KStars crashed just after trying to access ksyscoca and then "launching kbuildsycoca4". I ran kbuildsycoca4 by hand and then both applications got further.

My display got garbled, displaying what looks like a backing store of the current window in the top left. This first happened with kolf.exe, then happened to KDE Installer. Closing every K* app seemed to cure it.

=== Specific apps ===
bovo, kblackbox, kgeography pixeltool, etc. worked fine.

==== Dolphin ====
<del>1. Even after following instructions in kbuildsycoca4 section below, still mime type id not getting picked up. In the information section it "shows type: mime" instead of correct type. Because of the same reason, I think, it shows all the elements with same icon (binary) including directories.</del>
: Fixed in 4.00.80 after running "Post-install steps"

2. If icon is clicked, open with dialog opens and if I choose kate from the list following error box appears "Service 'C:/KDE 4.0/share/applications/kde4/kate.desktop' is malformatted"
: Still happens in 4.00.80

==== KStars ====
Looks '''awesome'''. In the list of cities in setup,
accented characters appear incorrectly as multiple characters,
as if the encoding is off. [http://www.skierpage.com/kde_bugs/kstars_setup_bad_chars.png See screenshot.]

When I clicked [Download extra data], it crashes. In DebugView, last thing it tried to do was open ksycoca and then launch kbuildsycoca4.

After running kbuildsycoca4 and restarting, KStars [Download extra data] created a "Get Hot New Stuff", but that window was obscured by both KStars and its wizard. It had a [Close] button but would not accept input. I was able to [Cancel] the KStars setup window, at which point both the KStars and Get Hot New Stuff windows appeared. There was nothing in Get Hot New Stuff for "KStarsAdd On Installer" (sic -- word layout bug), so I clicked [Close].

Had some problems adding a new location (fumbled original data). Steps to reproduce:
Settings / geographic. Add a new location (Foo, norway). Realize something went wrong, edit latitude (change from say 10 10 10.00 to 11 11 11.00). Click OK. Choose OK to Override data. OK out. Open Setting/geographic again - there are now two Foos with location == original, expected was one, updated location.

==== kbuildsycoca4 ====
<strike>As this seemed to be causing problems, I ran it myself in a command window. It said "kbuildsycoca4 running..." then exited, seemingly OK.</strike>

The problem is another one:
kbuildsycoca4 builds the readonly database ksycoca in C:\Documents and Settings\USER\.kde\ .
That requires update-mime-database to have been successfully run.

So after each installation:
1. kill all processes: kioslave.exe, klauncher.exe, kded4.exe
2. enter kdeenv.bat (or a your cmd with KDEROOT set) run:
cd %KDEROOT%
%KDEROOT%\bin\update-mime-database %KDEROOT%\share\mime
%KDEROOT%\bin\kbuildsycoca4 --noincremental

update-mime-database prints lots of warnings; ignore them.
Only an error that you should rerun it as root, means that you are in the wrong directory. - Change to kderoot and rerun.

kbuildsycoca has a similar issue: if there are still some processes accessing ksycoca it will ask you whether your disk is full. You should kill all processes that are accessing this file (see process explorer from sysinternals.com ) and rerun it.

This stuff is due to be run by the installer or by emerge. I will hopefully fix this in the next few days. Until then this has to be run by hand.
--[[User:SaroEngels|SaroEngels]] 01:08, 25 January 2008 (CET)

==== KColorChooser ====
crashes when you choose "Named Colors" from the list.
(It fails to open several .mo files and .js files,
then tries to read rgb.txt from various X11 directories and obviously it's not there,
and then crashes.)

==== kruler ====
kruler's cursor in North or South orientation shows the vertical arrowhead and line but has black and white garbage on the other half of it where the selection point would be.

==== okular ====
First time it started klauncher.exe process but hung without displaying anything.
I killed the okular process and tried again; second time okular crashed; DebugView indicated it was trying to open ksyscoca, and when that failed it tried to launch ksyscocabuilder.exe:
[4644] okular(4644)/kdecore (KSycoca) bool __thiscall KSycocaPrivate::checkDatabase(class QFlags<enum KSycocaPrivate::BehaviorIfNotFound>): We have no database.... launching kbuildsycoca4
After running kbuildsycoca4 by hand okular appeared OK. When I chose File > Open I got an alert
Windows - No Disk
Exception Processing Message c00000013 Parameters ''hex hex hex''
I clicked [Continue] and got this alert again.
I think each time Windows was spinning up my empty floppy or CD-ROM drive.
Then the file dialog appeared but also an alert
Error - okular
The process for the file protocol died unexpectedly.

Meanwhile DebugView showed
[2916] not able to find 'kio_file' because KDEDIRS environment variable is not set.
[2916] Set KDEDIRS to the KDE installation root dir and restart klauncher to fix this problem.

I clicked Root in the file dialog and okular generated a ton of DebugView output in kdecore (KUrl) and then crashed.

I followed the instructions about setting up KDEDIRS, killed klauncher.exe, restarted Okular. I still got errors about No Disk but no more "file protocol death". Howeer, clicking Root in the file dialog still generates a ton of DebugView output and Okular crashes.

Even when I navigate to a folder with .png images in it, Open a document displays nothing. Even if I choose PNG image, it displays nothing. However, if I enter *.png in the Filter, it displays appropriate files.

However, choosing a png file results in okular displaying
Can not find a plugin that is able to handle the passed document
and then an error alert. Same for selecting a *.bmp.

Weirdly, entering *.jpg in the Filter immediately exits okular, with no errors.
::KBUILDSYCOCA4
::UPDATE_MIME_TYPE_ERROR --[[User:SaroEngels|SaroEngels]] 00:52, 25 January 2008 (CET)

==== ktouch ====
Exits, DebugView shows
[3452] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283
: In 4.00.80 displays friendlier alert "Unable to use the '''Fake''' Multimedia Backend: The shared library was not found."

==== kbruch ====
The accelerator [Alt+e] for [Next Task] does not work.

==== KDE World Clock ====
Is pitch dark. The tooltip shows current city and add flag works. DebugView shows:
[4524]
[4524] QImage::scaled: Image is a null image
[4524] QPainter::begin: Paint device returned engine == 0, type: 3
[4524] QPainter::setCompositionMode: Painter not active
[4524] QPainter::begin: Paint device returned engine == 0, type: 2

Its context menu has Map Theme > Surface Depth / Flat World / Surface Depth / Flat World , i.e. two entries repeated. Whatever you choose is checked twice.

I can't uncheck Show Daylight, Show Cities, Show Flags in the context menu, they remain checked.

==== kteatime ====
It does display a fabulous notification bubble from the system tray when the tea is ready! Howeer, DebugView indicates "error while contacting knotify server" (I had configured KTeaTime to Play a sound, Show a message in a popup and Mark taskbar entry) :
[6052] kteatime(6052)/kdeui (KNotification) unsigned int __thiscall KNotificationManager::notify(class KNotification *,const class QPixmap &,const class QStringList &,const class QList<struct QPair<class QString,class QString> > &,const class QString &): error while contacting knotify server

==== khangman ====
It put up a dialog towards the back about progress, but unlike earlier app, that completed and it then worked great. I chose to, roughly. get words in a new language, chose France from the dialog/ Get Hot New Stuff showed up and worked but displayed an alert:
Error - KHangMan
Cannot start ''gpg'' and retrieve the available keys. Make sure that ''gpg'' is installed, otherwise verification of the downloaded resources will be impossible.

I installed gpgme and reran khangman, but now Get Hot New Stuff, did not display any categories.

I changed settings to play sounds and it immediately crashed with
[6072] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283

I got around this crash by editing khangmanrc to disable audio.
Still nothing in Get Hot New Stuff.

==== Kig ====
It worked pretty well, I was able to save a .kig file.
It kept prompting
Format not supported - Kig
Kig does not support saving to any other format than its own.
[Save Kig Format] [Cancel]
but if I choose "Save Kig Format" I get the alert again.
Only cancel worked to save the file.

However, when I tried to open that file, the Open dialog displayed its type as "plain text document", opening it led to a "Format Not Supported" alert. DebugView showed:
[5432] kig(5432)/kdecore (KUrl) __thiscall KUrl::KUrl(const class KUrl &): KUrl::KUrl(KUrl) path "" toLocalFile ""
[5432] kig(5432) bool __thiscall KigPart::openFile(void): mimetype: "text/plain"

So there are problems with mime type handling.
(It's scary that mime problems will stop a program from editing a file, how do I force it?)

::UPDATE_MIME_TYPE_ERROR --[[User:SaroEngels|SaroEngels]] 00:50, 25 January 2008 (CET)
:: Yup, fixed now with your "Post-install steps", thanks!

==== KWordQuiz ====
I was able to download French vocabulary, but when I dismissed it, I got the same alert as KHangMan once displayed
Cannot start gpg and retrieve the available keys. Make sure that gpg is installed.

kdelibs/knewstuff/knewstuff2/core/security.cpp is trying to start gpg in a new KProcess. I don't have `gpg` in my path, I'm not sure what package it's in.

::PLEASE ASSIGN TO B.K.O --[[User:SaroEngels|SaroEngels]] 00:49, 25 January 2008 (CET)

==== KGoldRunner ====
The background appears but none of the tiles, and the icons for them in Create New Game are missing. So some directory is missing, could be <tt>C:\KDE4\share\pixmaps</tt> NAME NOT FOUND, I don't know where the tiles should be.

[[Category: MS Windows]]

::PLEASE ASSIGN TO B.K.O --[[User:SaroEngels|SaroEngels]] 00:48, 25 January 2008 (CET)

== installation ==

I went through the installer (version 0.8.5), and when it got to the select mirror screen, all the mirrors are blank.

I have no idea what to add to the list.

* I can confirm that problem - happened here too.
* Here the same problem, are there any mirrors one can add manually?

:: Should work now, if not mirrors are here: [http://webdev.cegit.de/snapshots/kde-windows/mirrors.lst] --[[User:SaroEngels|SaroEngels]] 00:47, 25 January 2008 (CET)

== bug reports ==
After several minutes trying to find an adress to submit bug reports for kde on windows I report here that I have given up! This site is the only one I found to tell anyone about the problems.

Please post a link to a forum/bugreport engine or some email address.

::Please try to help copy the bugs to http://bugs.kde.org. Try to set Platform MS Windows. Please have a look after ''your'' bugs. -- [[User:SaroEngels|SaroEngels]] 00:46, 25 January 2008 (CET)

== Download needed packages ==

<strike>I started the installer and ended up with the dialog 'Download needed packages'. The docu says something about manual selection of the dependencies - WTF. On Linux nobody would even think to let the user select manually the required ones out of thousends of packages, but on windows one has to select the required ones out of ~100 Packages ?
I would not mind to install every package that might be required, but the installer has no option the select 'all'.</strike>

Edit: I now found out that if one selects one of the kde suites, that then the dependencies are resolved. So I propose to make this installer more suitable for non kde programmers an in general easier to understand.

::::Comment: this was a temporary solution in the wiki: the dependency tracking didn'T work correctly please fix in wiki if you can. - [[User:SaroEngels|SaroEngels]] 00:42, 25 January 2008 (CET)

== Unnecessarities in packages? ==

Some things I noticed:
* A lot of packages come with both release and debug binaries. The latter one are completely useless, at least to end users. It may be more sensible to separate debug binaries into their own packages.

rhabacker: where do you have seen this ? the qt bin package for example only contain end user applications and libraries. Debug libraries are located in the lib packages which are only installed in developer mode.

* There seem to be mingw+msvc versions even for seemingly C libraries, e.g. dbus. Such libraries are usually easily exchangeable between compilers (e.g. an MSVC compiled library with a C interface usually works w/ MinGW without problems). Perhaps this is an opportunity to remove some unnecessary packages?

chehrlic: All is fine here, we need it the way it is. We also know how to use mingw libs with msvc and vice versa but it only works under specific circumstances which are not met here.

::::FIXLATER - [[User:SaroEngels|SaroEngels]] 00:41, 25 January 2008 (CET)
::::No change here - [[User:chehrlic|chehrlic]] 07:04, 25 January 2008 (CET)

== Wishes ==
Everything's workin' perfect. But am i able to fully transform windows desktop environment into KDE ?
:[[User:Jstaniek|jstaniek]] 18:31, 30 January 2008 (CET) - short answer is NO. Not in the default setup, I guess. The transformation would break many native apps. Even if that can be fixed (really?), most users would still consider any such a full transformation as a breakage of the OS. What to do? '''As you apparently ask about replacing every part of Windows with KDE equivalents, just install Linux, BSD, etc. and and get all that immediately and natively'''.

Projects/KDE on Windows/Installation

2008-02-02T07:37:38Z

Skierpage: /* Status */ mention sound issue, format

{{note|Perhaps actual developers should summarize status of KDE4 on Windows here, while we encourage users to describe their experiences on the [[Talk:{{PAGENAME}}|Talk page?]]}}

== KDE Installer for Windows ==
You can use this installer to download and install the
various binary packages that you need to run KDE applications on MS Windows.
KDE is free and open source so you can build all the applications "from scratch" from their source code;
but as a convenience for others,
volunteers create these precompiled packages and make them available on the Internet.

'''Disclaimer''' These are early days for KDE4 on Windows,
some programs work better than others and some fail to run altogether.

'''If you experience any problems please have a look into our [http://lists.kde.org/?l=kde-windows&r=1&w=2| mailing list].'''

You can also use the KDE Installer for Windows to install source code and the packages that you need to ''build'' KDE4 on Windows
(although if you are building KDE4 on Windows you may prefer to use the emerge system to build KDE and its requirements from latest source);
see [[Getting Started/Build/KDE4/Windows]].

=== Summary of Steps ===
* Visit http://download.cegit.de/kde-windows/installer/
* Download and save the latest version to a directory, e.g. <tt>C:\KDE4</tt>
* Run the installer, download what you need (see [[#Download needed packages]] below).
* Add your lib directory, e.g. <tt>C:\KDE4\lib</tt> to your Windows %PATH%. (Start > Control Panel > System > Advanced > Environment Variables, double-click the Path System Variable and add this to your path separated by semicolon.)
* Add a KDEDIRS environment variable (Start > Control Panel > System > Advanced > Environment Variables, click [New] User variable and create Variable name <tt>KDEDIRS</tt> with Variable value the directory where you installed KDE4, e.g. <tt>C:\KDE4</tt>).
* [TEMPORARILY] Follow the instructions at [[#post-install steps]]
* Try running a Qt application in the <tt>bin</tt> directory, such as linguist.exe
* If that works, try running a KDE application such as <tt>kwrite.exe</tt>.

=== Download needed packages ===
A single program in the The K Desktop Environment depends on many other libraries and packages; that is why each .exe is comparatively small.
The KDE Installer for Windows has some awareness of dependencies,
but not complete.
So, the first few times you try to run an application you may see alerts about missing DLLs.

If you do not intend to build from source, do not click "all" and do not click "src", as you do not need to download the source for each package. ''Unclear whether you need lib for each''.

There are two development systems for KDE on Windows,
Microsoft's Visual C and [http://en.wikipedia.org/wiki/MinGW MinGW].
Even if you are only running binaries and do not intend to build KDE4 yourself,
you need to choose between these because of the provided runtime environments.
You're free to decide which to take.

The KDE programs themselves are organized into several groups: kdeedu, kdegames, and kdegraphics.

Here are some of the minimal packages you need to run a KDE application:
: dbus-msvc, kdebase-msvc, kdewin32-msvc, qt-msvc, vcredist, ??

The Dependencies tab for a particular package lists some of the additional packages it needs.
However, the dependency checking currently only works for first-level dependencies
Other dependencies are not easy to determine in advance.
For example, if you install kdegames only with its dependencies,
you will not be able to start it because you also need libstreamanalyze
(for which you have to install the strigi package).
rhabacker: This is fixed in installer version > 0.8.4.

[[Getting_Started/Build/KDE4/Windows/3rd-party_libraries]] is a more complete list of libraries that a full installation needs.

=== Issues with KDE Installer for Windows ===
Currently no issues known. If you found an issue, please report to [mailto:kde-windows@kde.org].

== post-install steps ==
You currently need to run a number of command-line programs to set up KDE. Here are the steps.

===Run update-mime-database===
Be sure that you have no KDE-related applications: run the Windows Task Manager (taskmgr.exe), switch to its Processes tab, and kill all occurences of dbus-daemon.exe, kded4.exe, kioslave.exe and klauncher.exe (and all other KDE apps).

Open a Windows command prompt (cmd.exe) and navigate to the directory where you installed KDE. Say you installed KDE to C:\KDE4, then run from the cmd.exe window:<pre>C:\KDE4> '''bin\update-mime-database C:\KDE4\share\mime'''</pre>This will give you a lot of warning message. Most of them you can easily ignore; even if you should set [[KDE_System_Administration/Environment_Variables#XDG_DATA_HOME|XDG_DATA_HOME]] or [[KDE_System_Administration/Environment_Variables#XDG_DATA_DIRS|XDG_DATA_DIRS]] it worked perfectly. If it says you should rerun update-mime-database as root then you're not within your installation directory.

===Run kbuildsyscoca4===
After finishing the previous step, run <pre>C:\KDE4> '''bin\kbuildsycoca4 --noincremental'''</pre> If this tells you that your disk is full (which is most probably not the case) you have still some executables from KDE running. Please close them and try again.

Excuse us for the inconvenience — we hope for a better solution in the next release.

== Testing your installation ==
Navigate to the <tt>bin</tt> directory.

See if you can run the Qt program assistant.exe.
Qt programs have fewer dependencies than a full-blown KDE application.

If that works, try running a simple KDE application, such as kruler.exe from the kdegraphics package.

The first KDE application you run will start a console window in order to run the [http://en.wikipedia.org/wiki/D-Bus D-Bus daemon].

== Fine-tuning ==
===Set Oxygen style for widgets===
The default KDE widget style on Windows is the native one. You already have Oxygen style installed (which is a plugin library %KDEROOT%\lib\kde4\plugins\styles\oxygen.dll), so it can be used as well. To set it for a single user:
#edit <tt>%UserPROFILE%\.kde\share\config\kdeglobals</tt> with any text editor (e.g. kwrite)
#locate line containing "[General]" text, what is a section, if there is no such line, add one
#replace or add <tt>widgetStyle=....</tt> line with <tt>widgetStyle=oxygen</tt>.
Newly started applications should be displayed with Oxygen style now.

== Status ==
Using kdewin-installer-gui-0.8.5.exe to install 4.00.80 packages:
* starting a KDE program correctly starts dbus-daemon.exe
* many games run
* choosing File > Open correctly starts klauncher.exe, kioslave.exe and kded4.exe, and runs kbuildsycoca4.exe as needed.
* Help > ''Program'' Handbook (often mapped to the [F1] key) does not work because the KDE Help Center is not available on Windows. This is due to its use of the K3Process interface and external dependencies not ported such as perl scripts, htdig, and other libraries.
** khelpcenter will be included in the next unstable release. The K3Process issues are fixed now. Perl scripts are disabled, which means there is no fulltext search. -- rhabacker
* Applications that try to play sounds will display an alert about "Multimedia Backend" problems. A Windows backend for [http://phonon.kde.org/ Phonon] is not packaged yet.

General notes:
* There are many other KDE programs that are not part of KDE 4.0.0 and are not currently packaged for Windows, such as KOffice 2 and Amarok.
* By design, KDE-windows does not provide the full-blown KDE desktop, thus no KWin composite manager, KDE-specific "start" menus, Plasma desktop, etc.

=== Package status and contents ===
{| border="0" cellpadding="2"
|-valign="top"
!package
!status
!contains applications
|-valign="top"
|kdebase
|packaged
|Konqueror, Dolphin, KWrite, etc.
|-valign="top"
|kdegames
|packaged
|Kgoldrunner, Kpat, KMahjongg, etc.
|-valign="top"
|kdesdk
|packaged
|Kate, Umbrello, etc.
|-valign="top"
|kdetoys
|packaged
|KTeatime, etc.
|-valign="top"
|kdeedu
|packaged
|Marble, Parley, KStars, KHangman, etc.
|-valign="top"
|kdegraphics
|not packaged
|Okular, kolourpaint, etc.
|-valign="top"
|amarok
|not packaged
|Amarok
|-valign="top"
|koffice
|not packaged
|KWord, Krita, Karbon, etc.
|-valign="top"
|kdepim
|not building
|KMail, AKregator, etc.
|-valign="top"
|kdenetwork
|not building
|Kopete, KGet, etc.
|}

[[Category: MS Windows]]

Projects/KDE on Windows/Installation

2008-02-02T07:28:59Z

Skierpage: remove bogus Author added by 222.66.141.26

{{note|Perhaps actual developers should summarize status of KDE4 on Windows here, while we encourage users to describe their experiences on the [[Talk:{{PAGENAME}}|Talk page?]]}}

== KDE Installer for Windows ==
You can use this installer to download and install the
various binary packages that you need to run KDE applications on MS Windows.
KDE is free and open source so you can build all the applications "from scratch" from their source code;
but as a convenience for others,
volunteers create these precompiled packages and make them available on the Internet.

'''Disclaimer''' These are early days for KDE4 on Windows,
some programs work better than others and some fail to run altogether.

'''If you experience any problems please have a look into our [http://lists.kde.org/?l=kde-windows&r=1&w=2| mailing list].'''

You can also use the KDE Installer for Windows to install source code and the packages that you need to ''build'' KDE4 on Windows
(although if you are building KDE4 on Windows you may prefer to use the emerge system to build KDE and its requirements from latest source);
see [[Getting Started/Build/KDE4/Windows]].

=== Summary of Steps ===
* Visit http://download.cegit.de/kde-windows/installer/
* Download and save the latest version to a directory, e.g. <tt>C:\KDE4</tt>
* Run the installer, download what you need (see [[#Download needed packages]] below).
* Add your lib directory, e.g. <tt>C:\KDE4\lib</tt> to your Windows %PATH%. (Start > Control Panel > System > Advanced > Environment Variables, double-click the Path System Variable and add this to your path separated by semicolon.)
* Add a KDEDIRS environment variable (Start > Control Panel > System > Advanced > Environment Variables, click [New] User variable and create Variable name <tt>KDEDIRS</tt> with Variable value the directory where you installed KDE4, e.g. <tt>C:\KDE4</tt>).
* [TEMPORARILY] Follow the instructions at [[#post-install steps]]
* Try running a Qt application in the <tt>bin</tt> directory, such as linguist.exe
* If that works, try running a KDE application such as <tt>kwrite.exe</tt>.

=== Download needed packages ===
A single program in the The K Desktop Environment depends on many other libraries and packages; that is why each .exe is comparatively small.
The KDE Installer for Windows has some awareness of dependencies,
but not complete.
So, the first few times you try to run an application you may see alerts about missing DLLs.

If you do not intend to build from source, do not click "all" and do not click "src", as you do not need to download the source for each package. ''Unclear whether you need lib for each''.

There are two development systems for KDE on Windows,
Microsoft's Visual C and [http://en.wikipedia.org/wiki/MinGW MinGW].
Even if you are only running binaries and do not intend to build KDE4 yourself,
you need to choose between these because of the provided runtime environments.
You're free to decide which to take.

The KDE programs themselves are organized into several groups: kdeedu, kdegames, and kdegraphics.

Here are some of the minimal packages you need to run a KDE application:
: dbus-msvc, kdebase-msvc, kdewin32-msvc, qt-msvc, vcredist, ??

The Dependencies tab for a particular package lists some of the additional packages it needs.
However, the dependency checking currently only works for first-level dependencies
Other dependencies are not easy to determine in advance.
For example, if you install kdegames only with its dependencies,
you will not be able to start it because you also need libstreamanalyze
(for which you have to install the strigi package).
rhabacker: This is fixed in installer version > 0.8.4.

[[Getting_Started/Build/KDE4/Windows/3rd-party_libraries]] is a more complete list of libraries that a full installation needs.

=== Issues with KDE Installer for Windows ===
Currently no issues known. If you found an issue, please report to [mailto:kde-windows@kde.org].

== post-install steps ==
You currently need to run a number of command-line programs to set up KDE. Here are the steps.

===Run update-mime-database===
Be sure that you have no KDE-related applications: run the Windows Task Manager (taskmgr.exe), switch to its Processes tab, and kill all occurences of dbus-daemon.exe, kded4.exe, kioslave.exe and klauncher.exe (and all other KDE apps).

Open a Windows command prompt (cmd.exe) and navigate to the directory where you installed KDE. Say you installed KDE to C:\KDE4, then run from the cmd.exe window:<pre>C:\KDE4> '''bin\update-mime-database C:\KDE4\share\mime'''</pre>This will give you a lot of warning message. Most of them you can easily ignore; even if you should set [[KDE_System_Administration/Environment_Variables#XDG_DATA_HOME|XDG_DATA_HOME]] or [[KDE_System_Administration/Environment_Variables#XDG_DATA_DIRS|XDG_DATA_DIRS]] it worked perfectly. If it says you should rerun update-mime-database as root then you're not within your installation directory.

===Run kbuildsyscoca4===
After finishing the previous step, run <pre>C:\KDE4> '''bin\kbuildsycoca4 --noincremental'''</pre> If this tells you that your disk is full (which is most probably not the case) you have still some executables from KDE running. Please close them and try again.

Excuse us for the inconvenience — we hope for a better solution in the next release.

== Testing your installation ==
Navigate to the <tt>bin</tt> directory.

See if you can run the Qt program assistant.exe.
Qt programs have fewer dependencies than a full-blown KDE application.

If that works, try running a simple KDE application, such as kruler.exe from the kdegraphics package.

The first KDE application you run will start a console window in order to run the [http://en.wikipedia.org/wiki/D-Bus D-Bus daemon].

== Fine-tuning ==
===Set Oxygen style for widgets===
The default KDE widget style on Windows is the native one. You already have Oxygen style installed (which is a plugin library %KDEROOT%\lib\kde4\plugins\styles\oxygen.dll), so it can be used as well. To set it for a single user:
#edit <tt>%UserPROFILE%\.kde\share\config\kdeglobals</tt> with any text editor (e.g. kwrite)
#locate line containing "[General]" text, what is a section, if there is no such line, add one
#replace or add <tt>widgetStyle=....</tt> line with <tt>widgetStyle=oxygen</tt>.
Newly started applications should be displayed with Oxygen style now.

== Status ==
Using kdewin-installer-gui-0.8.5.exe to install 4.00.80 packages:
* starting a KDE program correctly starts dbus-daemon.exe
* many games run
* choosing File > Open correctly starts klauncher.exe, kioslave.exe and kded4.exe, and runs kbuildsycoca4.exe as needed.
* Help > ''Program'' Handbook (often mapped to the [F1] key) does not work because the KDE Help Center is not available on Windows. This is due to its use of the K3Process interface and external dependencies not ported such as perl scripts, htdig, and other libraries.
rhabacker: khelpcenter will be included in the next unstable release. The K3Process issues are fixed now. Perl scripts are disabled, which means there is no fulltext search.

General notes:
* There are many other KDE programs that are not part of KDE 4.0.0 and are not currently packaged for Windows, such as KOffice 2 and Amarok.
* By design, KDE-windows does not provide the full-blown KDE desktop, thus no KWin composite manager, KDE-specific "start" menus, Plasma desktop, etc.

=== Package status and contents ===
{| border="0" cellpadding="2"
|-valign="top"
!package
!status
!contains applications
|-valign="top"
|kdebase
|packaged
|Konqueror, Dolphin, KWrite, etc.
|-valign="top"
|kdegames
|packaged
|Kgoldrunner, Kpat, KMahjongg, etc.
|-valign="top"
|kdesdk
|packaged
|Kate, Umbrello, etc.
|-valign="top"
|kdetoys
|packaged
|KTeatime, etc.
|-valign="top"
|kdeedu
|packaged
|Marble, Parley, KStars, KHangman, etc.
|-valign="top"
|kdegraphics
|not packaged
|Okular, kolourpaint, etc.
|-valign="top"
|amarok
|not packaged
|Amarok
|-valign="top"
|koffice
|not packaged
|KWord, Krita, Karbon, etc.
|-valign="top"
|kdepim
|not building
|KMail, AKregator, etc.
|-valign="top"
|kdenetwork
|not building
|Kopete, KGet, etc.
|}

[[Category: MS Windows]]

Projects/KDE on Windows/Installation

2008-01-27T23:17:34Z

Skierpage: /* Status */ subsection for package status

{{note|Perhaps actual developers should summarize status of KDE4 on Windows here, while we encourage users to describe their experiences on the [[Talk:{{PAGENAME}}|Talk page?]]}}

== KDE Installer for Windows ==
You can use this installer to download and install the
various binary packages that you need to run KDE applications on MS Windows.
KDE is free and open source so you can build all the applications "from scratch" from their source code;
but as a convenience for others,
volunteers create these precompiled packages and make them available on the Internet.

'''Disclaimer''' These are early days for KDE4 on Windows,
some programs work better than others and some fail to run altogether.

'''If you experience any problems please have a look into our [http://lists.kde.org/?l=kde-windows&r=1&w=2| mailing list].'''

You can also use the KDE Installer for Windows to install source code and the packages that you need to ''build'' KDE4 on Windows
(although if you are building KDE4 on Windows you may prefer to use the emerge system to build KDE and its requirements from latest source);
see [[Getting Started/Build/KDE4/Windows]].

=== Summary of Steps ===
* Visit http://download.cegit.de/kde-windows/installer/
* Download and save the latest version to a directory, e.g. <tt>C:\KDE4</tt>
* Run the installer, download what you need (see [[#Download needed packages]] below).
* Add your lib directory, e.g. <tt>C:\KDE4\lib</tt> to your Windows %PATH%. (Start > Control Panel > System > Advanced > Environment Variables, double-click the Path System Variable and add this to your path separated by semicolon.)
* Add a KDEDIRS environment variable (Start > Control Panel > System > Advanced > Environment Variables, click [New] User variable and create Variable name <tt>KDEDIRS</tt> with Variable value the directory where you installed KDE4, e.g. <tt>C:\KDE4</tt>).
* [TEMPORARILY] Follow the instructions at [[#post-install steps]]
* Try running a Qt application in the <tt>bin</tt> directory, such as linguist.exe
* If that works, try running a KDE application such as <tt>kwrite.exe</tt>.

=== Download needed packages ===
A single program in the The K Desktop Environment depends on many other libraries and packages; that is why each .exe is comparatively small.
The KDE Installer for Windows has some awareness of dependencies,
but not complete.
So, the first few times you try to run an application you may see alerts about missing DLLs.

If you do not intend to build from source, do not click "all" and do not click "src", as you do not need to download the source for each package. ''Unclear whether you need lib for each''.

There are two development systems for KDE on Windows,
Microsoft's Visual C and [http://en.wikipedia.org/wiki/MinGW MinGW].
Even if you are only running binaries and do not intend to build KDE4 yourself,
you need to choose between these because of the provided runtime environments.
You're free to decide which to take.

The KDE programs themselves are organized into several groups: kdeedu, kdegames, and kdegraphics.

Here are some of the minimal packages you need to run a KDE application:
: dbus-msvc, kdebase-msvc, kdewin32-msvc, qt-msvc, vcredist, ??

The Dependencies tab for a particular package lists some of the additional packages it needs.
However, the dependency checking currently only works for first-level dependencies
Other dependencies are not easy to determine in advance.
For example, if you install kdegames only with its dependencies,
you will not be able to start it because you also need libstreamanalyze
(for which you have to install the strigi package).

[[Getting_Started/Build/KDE4/Windows/3rd-party_libraries]] is a more complete list of libraries that a full installation needs.

=== Issues with KDE Installer for Windows ===
Currently no issues known. If you found an issue, please report to [mailto:kde-windows@kde.org].

== post-install steps ==
You currently need to run two command-line programs to set up KDE, update-mime-database and kbuildsyscoca4. Here are the steps.

Be sure that you have no KDE-related applications running:
Start the Windows Task Manager (taskmgr.exe), switch to its Processes tab, and kill all occurences of dbus-daemon.exe, kded4.exe, kioslave.exe and klauncher.exe (and all other KDE apps).

Open a Windows command prompt (cmd.exe) and navigate to the directory where you installed KDE.
Say you installed KDE to C:\KDE4, then run from the cmd.exe window:
C:\KDE4> '''bin\update-mime-database C:\KDE4\share\mime'''
This will give you a lot of warning message. Most of them you can easily ignore;
even if you should set XDG_DATA_HOME or XDG_DATA_DIRS it worked perfectly.
If it says you should rerun update-mime-database as root then you're not within your installation directory.
Then run
C:\KDE4> '''bin\kbuildsycoca4 --noincremental'''
If this tells you that your disk is full (which is most probably not the case)
you have still some executables from KDE running. Please close them and try again.

Excuse us for the inconvenience — we hope for a better solution in the next release.

== Testing your installation ==
Navigate to the <tt>bin</tt> directory.

See if you can run the Qt program assistant.exe.
Qt programs have fewer dependencies than a full-blown KDE application.

If that works, try running a simple KDE application, such as kruler.exe from the kdegraphics package.

The first KDE application you run will start a console window in order to run the [http://en.wikipedia.org/wiki/D-Bus D-Bus daemon].

== Status ==

Using kdewin-installer-gui-0.8.5.exe to install 4.00.80 packages:
* starting a KDE program correctly starts dbus-daemon.exe
* many games run
* choosing File > Open correctly starts klauncher.exe, kioslave.exe and kded4.exe, and runs kbuildsycoca4.exe as needed.
* Help > ''Program'' Handbook (often mapped to the [F1] key) does not work because the KDE Help Center is not available on Windows. This is due to its use of the K3Process interface and external dependencies not ported such as perl scripts, htdig, and other libraries.

General notes:
* There are many other KDE programs that are not part of KDE 4.0.0 and are not currently packaged for Windows, such as KOffice 2 and Amarok.
* By design, KDE-windows does not provide the full-blown KDE desktop, thus no KWin composite manager, KDE-specific "start" menus, Plasma desktop, etc.

=== Package status and contents ===
{| border="0" cellpadding="2"
|-valign="top"
!package
!status
!contains applications
|-valign="top"
|kdebase
|packaged
|Konqueror, Dolphin, KWrite, etc.
|-valign="top"
|kdegames
|packaged
|Kgoldrunner, Kpat, KMahjongg, etc.
|-valign="top"
|kdesdk
|packaged
|Kate, Umbrello, etc.
|-valign="top"
|kdetoys
|packaged
|KTeatime, etc.
|-valign="top"
|kdeedu
|packaged
|Marble, Parley, KStars, KHangman, etc.
|-valign="top"
|kdegraphics
|not packaged
|Okular, kolourpaint, etc.
|-valign="top"
|amarok
|not packaged
|Amarok
|-valign="top"
|koffice
|not packaged
|KWord, Krita, Karbon, etc.
|-valign="top"
|kdepim
|not building
|KMail, AKregator, etc.
|-valign="top"
|kdenetwork
|not building
|Kopete, KGet, etc.
|}

[[Category: MS Windows]]

Projects/KDE on Windows/Installation

2008-01-27T23:13:56Z

Skierpage: /* Issues with KDE Installer for Windows */ remove pointless (spam?) link to Cyrillic website

{{note|Perhaps actual developers should summarize status of KDE4 on Windows here, while we encourage users to describe their experiences on the [[Talk:{{PAGENAME}}|Talk page?]]}}

== KDE Installer for Windows ==
You can use this installer to download and install the
various binary packages that you need to run KDE applications on MS Windows.
KDE is free and open source so you can build all the applications "from scratch" from their source code;
but as a convenience for others,
volunteers create these precompiled packages and make them available on the Internet.

'''Disclaimer''' These are early days for KDE4 on Windows,
some programs work better than others and some fail to run altogether.

'''If you experience any problems please have a look into our [http://lists.kde.org/?l=kde-windows&r=1&w=2| mailing list].'''

You can also use the KDE Installer for Windows to install source code and the packages that you need to ''build'' KDE4 on Windows
(although if you are building KDE4 on Windows you may prefer to use the emerge system to build KDE and its requirements from latest source);
see [[Getting Started/Build/KDE4/Windows]].

=== Summary of Steps ===
* Visit http://download.cegit.de/kde-windows/installer/
* Download and save the latest version to a directory, e.g. <tt>C:\KDE4</tt>
* Run the installer, download what you need (see [[#Download needed packages]] below).
* Add your lib directory, e.g. <tt>C:\KDE4\lib</tt> to your Windows %PATH%. (Start > Control Panel > System > Advanced > Environment Variables, double-click the Path System Variable and add this to your path separated by semicolon.)
* Add a KDEDIRS environment variable (Start > Control Panel > System > Advanced > Environment Variables, click [New] User variable and create Variable name <tt>KDEDIRS</tt> with Variable value the directory where you installed KDE4, e.g. <tt>C:\KDE4</tt>).
* [TEMPORARILY] Follow the instructions at [[#post-install steps]]
* Try running a Qt application in the <tt>bin</tt> directory, such as linguist.exe
* If that works, try running a KDE application such as <tt>kwrite.exe</tt>.

=== Download needed packages ===
A single program in the The K Desktop Environment depends on many other libraries and packages; that is why each .exe is comparatively small.
The KDE Installer for Windows has some awareness of dependencies,
but not complete.
So, the first few times you try to run an application you may see alerts about missing DLLs.

If you do not intend to build from source, do not click "all" and do not click "src", as you do not need to download the source for each package. ''Unclear whether you need lib for each''.

There are two development systems for KDE on Windows,
Microsoft's Visual C and [http://en.wikipedia.org/wiki/MinGW MinGW].
Even if you are only running binaries and do not intend to build KDE4 yourself,
you need to choose between these because of the provided runtime environments.
You're free to decide which to take.

The KDE programs themselves are organized into several groups: kdeedu, kdegames, and kdegraphics.

Here are some of the minimal packages you need to run a KDE application:
: dbus-msvc, kdebase-msvc, kdewin32-msvc, qt-msvc, vcredist, ??

The Dependencies tab for a particular package lists some of the additional packages it needs.
However, the dependency checking currently only works for first-level dependencies
Other dependencies are not easy to determine in advance.
For example, if you install kdegames only with its dependencies,
you will not be able to start it because you also need libstreamanalyze
(for which you have to install the strigi package).

[[Getting_Started/Build/KDE4/Windows/3rd-party_libraries]] is a more complete list of libraries that a full installation needs.

=== Issues with KDE Installer for Windows ===
Currently no issues known. If you found an issue, please report to [mailto:kde-windows@kde.org].

== post-install steps ==
You currently need to run two command-line programs to set up KDE, update-mime-database and kbuildsyscoca4. Here are the steps.

Be sure that you have no KDE-related applications running:
Start the Windows Task Manager (taskmgr.exe), switch to its Processes tab, and kill all occurences of dbus-daemon.exe, kded4.exe, kioslave.exe and klauncher.exe (and all other KDE apps).

Open a Windows command prompt (cmd.exe) and navigate to the directory where you installed KDE.
Say you installed KDE to C:\KDE4, then run from the cmd.exe window:
C:\KDE4> '''bin\update-mime-database C:\KDE4\share\mime'''
This will give you a lot of warning message. Most of them you can easily ignore;
even if you should set XDG_DATA_HOME or XDG_DATA_DIRS it worked perfectly.
If it says you should rerun update-mime-database as root then you're not within your installation directory.
Then run
C:\KDE4> '''bin\kbuildsycoca4 --noincremental'''
If this tells you that your disk is full (which is most probably not the case)
you have still some executables from KDE running. Please close them and try again.

Excuse us for the inconvenience — we hope for a better solution in the next release.

== Testing your installation ==
Navigate to the <tt>bin</tt> directory.

See if you can run the Qt program assistant.exe.
Qt programs have fewer dependencies than a full-blown KDE application.

If that works, try running a simple KDE application, such as kruler.exe from the kdegraphics package.

The first KDE application you run will start a console window in order to run the [http://en.wikipedia.org/wiki/D-Bus D-Bus daemon].

== Status ==

Using kdewin-installer-gui-0.8.4-4.exe to install 3.97 2007-12-31 packages:
* starting a KDE program correctly starts dbus-daemon.exe
* many games run
* choosing File > Open correctly starts klauncher.exe, kioslave.exe and kded4.exe, and runs kbuildsycoca4.exe as needed.
* Help > ''Program'' Handbook (often mapped to the [F1] key) does not work because the KDE Help Center is not available on Windows. This is due to its use of the K3Process interface and external dependencies not ported such as perl scripts, htdig, and other libraries.

{| border="0" cellpadding="2"
|-valign="top"
|<tt>package</tt>
|<tt>status</tt>
|<tt>list of contained applications</tt>
|-valign="top"
|kdebase
|packaged
|Konqueror, Dolphin, KWrite, etc.
|-valign="top"
|kdegames
|packaged
|Kgoldrunner, Kpat, KMahjongg, etc.
|-valign="top"
|kdesdk
|packaged
|Kate, Umbrello, etc.
|-valign="top"
|kdetoys
|packaged
|KTeatime, etc.
|-valign="top"
|kdeedu
|packaged
|Marble, Parley, KStars, KHangman, etc.
|-valign="top"
|kdegraphics
|not packaged
|Okular, kolourpaint, etc.
|-valign="top"
|amarok
|not packaged
|Amarok
|-valign="top"
|koffice
|not packaged
|KWord, Krita, Karbon, etc.
|-valign="top"
|kdepim
|not building
|KMail, AKregator, etc.
|-valign="top"
|kdenetwork
|not building
|Kopete, KGet, etc.
|}

General notes:
* There are many other KDE programs that are not part of KDE 4.0.0 and are not currently packaged for Windows, such as KOffice 2 and Amarok.
* By design, KDE-windows does not provide the full-blown KDE desktop, thus no KWin composite manager, KDE-specific "start" menus, Plasma desktop, etc.

[[Category: MS Windows]]

Projects/KDE on Windows/Installation

2008-01-19T00:45:51Z

Skierpage: /* Status */ more general disclaimers

Talk:Projects/KDE on Windows/Installation

2008-01-18T12:58:13Z

Skierpage: typo

Use this page to record your experiences with KDE on Windows.
Click the + tab and enter <nowiki>~~~~</nowiki> as the subject to add your experiences. Include your installer version.

== [[User:Skierpage|Skierpage]] 11:33, 18 January 2008 (CET) using 3.97 ==
Here's [[User:Skierpage]]'s experience using kdewin-installer-gui-0.8.4-4.exe to install 3.97 2007-12-31 files
on Windows XP SP2.

=== Continuing ===
* No khelpcenter, so no Help > ''Program'' Handbook
* Help > Report Bug... > Launch Bug Report Wizard still does nothing.
* Problems trying to save and open files in apps, KDE complains about their mime type.
* Get Hot New Stuff still has problems trying to run gpg.exe.

=== File Open Dialog ===
* clicking Network icon crashes (bug 156080 filed)
* clicking Home icon does nothing
* clicking Root shows '''Custom''' in file path.
* DebugView shows several <tt>[5940] class QStringList __thiscall Solid::Backends::Hal::HalManager::findDeviceByDeviceInterface(const enum Solid::DeviceInterface::Type &) error: "org.freedesktop.DBus.Error.ServiceUnknown" </tt>

=== Specific Apps ===
==== KStars ====
* during startup or Setup Wizard outputs <tt> kstars(5344) class KStarsDateTime __cdecl KStarsDateTime::fromString(const class QString &): "Could not parse Date/Time string: " "" </tt>
* can't view Web pages from Object Details dialog > Links > View Resource. No error, but no activity. Possibly at the same time saw output "[5344] kstars(5344)/kdeui (KNotification) void __thiscall KNotification::slotReceivedIdError(const class QDBusError &): Error while contacting notify daemon "The name org.kde.knotify was not provided by any .service files"
"

== Installer A Lame Duck ==

_ The following concerns 0.8.1-2 and 0.8.2 :

# It is NOT an installer - it is a transplanter. Too much has to be done manually to qualify it as an "installer".
# It hangs far too often (over 50% in more than a dozen runs).
# It lacks a "Select all" option.
# It does not report correctly as to what it has done - many of the KDE packages and the QT package show as uninstalled after more than a dozen attempts. And yes, the messages scrolled very prettily. And several times the process ran to the point where I could press the "Finish" button and did so.
# It does not have a search option so that one can chase down a missing DLL (e.g. "kdecore.dll").
# The error message box after a failed download does NOT give the name of the package that failed nor why it failed (not on server, comm.failure, already on local disk, etc.). I narrowed the failed downloads to some of the "tools".
# The process does NOT put either a "Start-Here.html" or some sort of read-me file in the base directory (e.g. "KDE4").
== Issues ==
1)The installer seems to also like to crash. Anyone want to post alternative setup instructions?

2)The installer should not install documentation automatically if the user install the binary package

== [[User:Skierpage|Skierpage]] 07:43, 5 November 2007 (CET) on 2007-11-03 ==
Here's [[User:Skierpage]]'s experience partially installing files with
kdewin-installer-gui-0.8.1-2.exe
on Windows XP SP2.

''Some of my problems were caused by the KDE Installer silently failing to install kdebase bin.''

=== General ===
Each app's Help > Handbook fails to start

About the time I tried the handbook the program couldn't find the KDE crash handler drkonqi.exe.

Submit Bug Report fails to load anything when you click [Launch Bug Wizard];
nothing displays in Process Monitor or DebugView.

Okular and KStars crashed just after trying to access ksyscoca and then "launching kbuildsycoca4". I ran kbuildsycoca4 by hand and then both applications got further.

My display got garbled, displaying what looks like a backing store of the current window in the top left. This first happened with kolf.exe, then happened to KDE Installer. Closing every K* app seemed to cure it.

=== Specific apps ===
bovo, kblackbox, kgeography pixeltool, etc. worked fine.

==== KStars ====
Looks '''awesome'''. In the list of cities in setup,
accented characters appear incorrectly as multiple characters,
as if the encoding is off. [http://www.skierpage.com/kde_bugs/kstars_setup_bad_chars.png See screenshot.]

When I clicked [Download extra data], it crashes. In DebugView, last thing it tried to do was open ksycoca and then launch kbuildsycoca4.

After running kbuildsycoca4 and restarting, KStars [Download extra data] created a "Get Hot New Stuff", but that window was obscured by both KStars and its wizard. It had a [Close] button but would not accept input. I was able to [Cancel] the KStars setup window, at which point both the KStars and Get Hot New Stuff windows appeared. There was nothing in Get Hot New Stuff for "KStarsAdd On Installer" (sic -- word layout bug), so I clicked [Close].

==== kbuildsycoca4 ====
As this seemed to be causing problems, I ran it myself in a command window. It said "kbuildsycoca4 running..." then exited, seemingly OK.

==== KColorChooser ====
crashes when you choose "Named Colors" from the list.
(It fails to open several .mo files and .js files,
then tries to read rgb.txt from various X11 directories and obviously it's not there,
and then crashes.)

==== kruler ====
kruler's cursor in North or South orientation shows the vertical arrowhead and line but has black and white garbage on the other half of it where the selection point would be.

==== okular ====
First time it started klauncher.exe process but hung without displaying anything.
I killed the okular process and tried again; second time okular crashed; DebugView indicated it was trying to open ksyscoca, and when that failed it tried to launch ksyscocabuilder.exe:
[4644] okular(4644)/kdecore (KSycoca) bool __thiscall KSycocaPrivate::checkDatabase(class QFlags<enum KSycocaPrivate::BehaviorIfNotFound>): We have no database.... launching kbuildsycoca4
After running kbuildsycoca4 by hand okular appeared OK. When I chose File > Open I got an alert
Windows - No Disk
Exception Processing Message c00000013 Parameters ''hex hex hex''
I clicked [Continue] and got this alert again.
I think each time Windows was spinning up my empty floppy or CD-ROM drive.
Then the file dialog appeared but also an alert
Error - okular
The process for the file protocol died unexpectedly.

Meanwhile DebugView showed
[2916] not able to find 'kio_file' because KDEDIRS environment variable is not set.
[2916] Set KDEDIRS to the KDE installation root dir and restart klauncher to fix this problem.

I clicked Root in the file dialog and okular generated a ton of DebugView output in kdecore (KUrl) and then crashed.

I followed the instructions about setting up KDEDIRS, killed klauncher.exe, restarted Okular. I still got errors about No Disk but no more "file protocol death". Howeer, clicking Root in the file dialog still generates a ton of DebugView output and Okular crashes.

Even when I navigate to a folder with .png images in it, Open a document displays nothing. Even if I choose PNG image, it displays nothing. However, if I enter *.png in the Filter, it displays appropriate files.

However, choosing a png file results in okular displaying
Can not find a plugin that is able to handle the passed document
and then an error alert. Same for selecting a *.bmp.

Weirdly, entering *.jpg in the Filter immediately exits okular, with no errors.

==== ktouch ====
Exits, DebugView shows
[3452] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283

==== kbruch ====
The accelerator [Alt+e] for [Next Task] does not work.

==== KDE World Clock ====
Is pitch dark. The tooltip shows current city and add flag works. DebugView shows:
[4524]
[4524] QImage::scaled: Image is a null image
[4524] QPainter::begin: Paint device returned engine == 0, type: 3
[4524] QPainter::setCompositionMode: Painter not active
[4524] QPainter::begin: Paint device returned engine == 0, type: 2

Its context menu has Map Theme > Surface Depth / Flat World / Surface Depth / Flat World , i.e. two entries repeated. Whatever you choose is checked twice.

I can't uncheck Show Daylight, Show Cities, Show Flags in the context menu, they remain checked.

==== kteatime ====
It does display a fabulous notification bubble from the system tray when the tea is ready! Howeer, DebugView indicates "error while contacting knotify server" (I had configured KTeaTime to Play a sound, Show a message in a popup and Mark taskbar entry) :
[6052] kteatime(6052)/kdeui (KNotification) unsigned int __thiscall KNotificationManager::notify(class KNotification *,const class QPixmap &,const class QStringList &,const class QList<struct QPair<class QString,class QString> > &,const class QString &): error while contacting knotify server

==== khangman ====
It put up a dialog towards the back about progress, but unlike earlier app, that completed and it then worked great. I chose to, roughly. get words in a new language, chose France from the dialog/ Get Hot New Stuff showed up and worked but displayed an alert:
Error - KHangMan
Cannot start ''gpg'' and retrieve the available keys. Make sure that ''gpg'' is installed, otherwise verification of the downloaded resources will be impossible.

I installed gpgme and reran khangman, but now Get Hot New Stuff, did not display any categories.

I changed settings to play sounds and it immediately crashed with
[6072] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283

I got around this crash by editing khangmanrc to disable audio.
Still nothing in Get Hot New Stuff.

==== Kig ====
It worked pretty well, I was able to save a .kig file.
It kept prompting
Format not supported - Kig
Kig does not support saving to any other format than its own.
[Save Kig Format] [Cancel]
but if I choose "Save Kig Format" I get the alert again.
Only cancel worked to save the file.

However, when I tried to open that file, the Open dialog displayed its type as "plain text document", opening it led to a "Format Not Supported" alert. DebugView showed:
[5432] kig(5432)/kdecore (KUrl) __thiscall KUrl::KUrl(const class KUrl &): KUrl::KUrl(KUrl) path "" toLocalFile ""
[5432] kig(5432) bool __thiscall KigPart::openFile(void): mimetype: "text/plain"

So there are problems with mime type handling.
(It's scary that mime problems will stop a program from editing a file, how do I force it?)

==== KWordQuiz ====
I was able to download French vocabulary, but when I dismissed it, I got the same alert as KHangMan once displayed
Cannot start gpg and retrieve the available keys. Make sure that gpg is installed.

kdelibs/knewstuff/knewstuff2/core/security.cpp is trying to start gpg in a new KProcess. I don't have `gpg` in my path, I'm not sure what package it's in.

==== KGoldRunner ====
The background appears but none of the tiles, and the icons for them in Create New Game are missing. So some directory is missing, could be <tt>C:\KDE4\share\pixmaps</tt> NAME NOT FOUND, I don't know where the tiles should be.

[[Category: MS Windows]]

Talk:Projects/KDE on Windows/Installation

2008-01-18T10:33:03Z

Skierpage: reorganize, new 3.97 review section

Use this page to record your experiences with KDE on Windows.
Click the + tab and enter <nowiki>~~~~</nowiki> as the subject to add your experiences. Include your installer version.

2== [[User:Skierpage|Skierpage]] 11:33, 18 January 2008 (CET) using 3.97 ==
Here's [[User:Skierpage]]'s experience using kdewin-installer-gui-0.8.4-4.exe to install 3.97 2007-12-31 files
on Windows XP SP2.

=== Continuing ===
* No khelpcenter, so no Help > ''Program'' Handbook
* Help > Report Bug... > Launch Bug Report Wizard still does nothing.
* Problems trying to save and open files in apps, KDE complains about their mime type.
* Get Hot New Stuff still has problems trying to run gpg.exe.

=== File Open Dialog ===
* clicking Network icon crashes (bug 156080 filed)
* clicking Home icon does nothing
* clicking Root shows '''Custom''' in file path.
* DebugView shows several <tt>[5940] class QStringList __thiscall Solid::Backends::Hal::HalManager::findDeviceByDeviceInterface(const enum Solid::DeviceInterface::Type &) error: "org.freedesktop.DBus.Error.ServiceUnknown" </tt>

=== Specific Apps ===
==== KStars ====
* during startup or Setup Wizard outputs <tt> kstars(5344) class KStarsDateTime __cdecl KStarsDateTime::fromString(const class QString &): "Could not parse Date/Time string: " "" </tt>
* can't view Web pages from Object Details dialog > Links > View Resource. No error, but no activity. Possibly at the same time saw output "[5344] kstars(5344)/kdeui (KNotification) void __thiscall KNotification::slotReceivedIdError(const class QDBusError &): Error while contacting notify daemon "The name org.kde.knotify was not provided by any .service files"
"

== Installer A Lame Duck ==

_ The following concerns 0.8.1-2 and 0.8.2 :

# It is NOT an installer - it is a transplanter. Too much has to be done manually to qualify it as an "installer".
# It hangs far too often (over 50% in more than a dozen runs).
# It lacks a "Select all" option.
# It does not report correctly as to what it has done - many of the KDE packages and the QT package show as uninstalled after more than a dozen attempts. And yes, the messages scrolled very prettily. And several times the process ran to the point where I could press the "Finish" button and did so.
# It does not have a search option so that one can chase down a missing DLL (e.g. "kdecore.dll").
# The error message box after a failed download does NOT give the name of the package that failed nor why it failed (not on server, comm.failure, already on local disk, etc.). I narrowed the failed downloads to some of the "tools".
# The process does NOT put either a "Start-Here.html" or some sort of read-me file in the base directory (e.g. "KDE4").
== Issues ==
1)The installer seems to also like to crash. Anyone want to post alternative setup instructions?

2)The installer should not install documentation automatically if the user install the binary package

== [[User:Skierpage|Skierpage]] 07:43, 5 November 2007 (CET) on 2007-11-03 ==
Here's [[User:Skierpage]]'s experience partially installing files with
kdewin-installer-gui-0.8.1-2.exe
on Windows XP SP2.

''Some of my problems were caused by the KDE Installer silently failing to install kdebase bin.''

=== General ===
Each app's Help > Handbook fails to start

About the time I tried the handbook the program couldn't find the KDE crash handler drkonqi.exe.

Submit Bug Report fails to load anything when you click [Launch Bug Wizard];
nothing displays in Process Monitor or DebugView.

Okular and KStars crashed just after trying to access ksyscoca and then "launching kbuildsycoca4". I ran kbuildsycoca4 by hand and then both applications got further.

My display got garbled, displaying what looks like a backing store of the current window in the top left. This first happened with kolf.exe, then happened to KDE Installer. Closing every K* app seemed to cure it.

=== Specific apps ===
bovo, kblackbox, kgeography pixeltool, etc. worked fine.

==== KStars ====
Looks '''awesome'''. In the list of cities in setup,
accented characters appear incorrectly as multiple characters,
as if the encoding is off. [http://www.skierpage.com/kde_bugs/kstars_setup_bad_chars.png See screenshot.]

When I clicked [Download extra data], it crashes. In DebugView, last thing it tried to do was open ksycoca and then launch kbuildsycoca4.

After running kbuildsycoca4 and restarting, KStars [Download extra data] created a "Get Hot New Stuff", but that window was obscured by both KStars and its wizard. It had a [Close] button but would not accept input. I was able to [Cancel] the KStars setup window, at which point both the KStars and Get Hot New Stuff windows appeared. There was nothing in Get Hot New Stuff for "KStarsAdd On Installer" (sic -- word layout bug), so I clicked [Close].

==== kbuildsycoca4 ====
As this seemed to be causing problems, I ran it myself in a command window. It said "kbuildsycoca4 running..." then exited, seemingly OK.

==== KColorChooser ====
crashes when you choose "Named Colors" from the list.
(It fails to open several .mo files and .js files,
then tries to read rgb.txt from various X11 directories and obviously it's not there,
and then crashes.)

==== kruler ====
kruler's cursor in North or South orientation shows the vertical arrowhead and line but has black and white garbage on the other half of it where the selection point would be.

==== okular ====
First time it started klauncher.exe process but hung without displaying anything.
I killed the okular process and tried again; second time okular crashed; DebugView indicated it was trying to open ksyscoca, and when that failed it tried to launch ksyscocabuilder.exe:
[4644] okular(4644)/kdecore (KSycoca) bool __thiscall KSycocaPrivate::checkDatabase(class QFlags<enum KSycocaPrivate::BehaviorIfNotFound>): We have no database.... launching kbuildsycoca4
After running kbuildsycoca4 by hand okular appeared OK. When I chose File > Open I got an alert
Windows - No Disk
Exception Processing Message c00000013 Parameters ''hex hex hex''
I clicked [Continue] and got this alert again.
I think each time Windows was spinning up my empty floppy or CD-ROM drive.
Then the file dialog appeared but also an alert
Error - okular
The process for the file protocol died unexpectedly.

Meanwhile DebugView showed
[2916] not able to find 'kio_file' because KDEDIRS environment variable is not set.
[2916] Set KDEDIRS to the KDE installation root dir and restart klauncher to fix this problem.

I clicked Root in the file dialog and okular generated a ton of DebugView output in kdecore (KUrl) and then crashed.

I followed the instructions about setting up KDEDIRS, killed klauncher.exe, restarted Okular. I still got errors about No Disk but no more "file protocol death". Howeer, clicking Root in the file dialog still generates a ton of DebugView output and Okular crashes.

Even when I navigate to a folder with .png images in it, Open a document displays nothing. Even if I choose PNG image, it displays nothing. However, if I enter *.png in the Filter, it displays appropriate files.

However, choosing a png file results in okular displaying
Can not find a plugin that is able to handle the passed document
and then an error alert. Same for selecting a *.bmp.

Weirdly, entering *.jpg in the Filter immediately exits okular, with no errors.

==== ktouch ====
Exits, DebugView shows
[3452] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283

==== kbruch ====
The accelerator [Alt+e] for [Next Task] does not work.

==== KDE World Clock ====
Is pitch dark. The tooltip shows current city and add flag works. DebugView shows:
[4524]
[4524] QImage::scaled: Image is a null image
[4524] QPainter::begin: Paint device returned engine == 0, type: 3
[4524] QPainter::setCompositionMode: Painter not active
[4524] QPainter::begin: Paint device returned engine == 0, type: 2

Its context menu has Map Theme > Surface Depth / Flat World / Surface Depth / Flat World , i.e. two entries repeated. Whatever you choose is checked twice.

I can't uncheck Show Daylight, Show Cities, Show Flags in the context menu, they remain checked.

==== kteatime ====
It does display a fabulous notification bubble from the system tray when the tea is ready! Howeer, DebugView indicates "error while contacting knotify server" (I had configured KTeaTime to Play a sound, Show a message in a popup and Mark taskbar entry) :
[6052] kteatime(6052)/kdeui (KNotification) unsigned int __thiscall KNotificationManager::notify(class KNotification *,const class QPixmap &,const class QStringList &,const class QList<struct QPair<class QString,class QString> > &,const class QString &): error while contacting knotify server

==== khangman ====
It put up a dialog towards the back about progress, but unlike earlier app, that completed and it then worked great. I chose to, roughly. get words in a new language, chose France from the dialog/ Get Hot New Stuff showed up and worked but displayed an alert:
Error - KHangMan
Cannot start ''gpg'' and retrieve the available keys. Make sure that ''gpg'' is installed, otherwise verification of the downloaded resources will be impossible.

I installed gpgme and reran khangman, but now Get Hot New Stuff, did not display any categories.

I changed settings to play sounds and it immediately crashed with
[6072] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283

I got around this crash by editing khangmanrc to disable audio.
Still nothing in Get Hot New Stuff.

==== Kig ====
It worked pretty well, I was able to save a .kig file.
It kept prompting
Format not supported - Kig
Kig does not support saving to any other format than its own.
[Save Kig Format] [Cancel]
but if I choose "Save Kig Format" I get the alert again.
Only cancel worked to save the file.

However, when I tried to open that file, the Open dialog displayed its type as "plain text document", opening it led to a "Format Not Supported" alert. DebugView showed:
[5432] kig(5432)/kdecore (KUrl) __thiscall KUrl::KUrl(const class KUrl &): KUrl::KUrl(KUrl) path "" toLocalFile ""
[5432] kig(5432) bool __thiscall KigPart::openFile(void): mimetype: "text/plain"

So there are problems with mime type handling.
(It's scary that mime problems will stop a program from editing a file, how do I force it?)

==== KWordQuiz ====
I was able to download French vocabulary, but when I dismissed it, I got the same alert as KHangMan once displayed
Cannot start gpg and retrieve the available keys. Make sure that gpg is installed.

kdelibs/knewstuff/knewstuff2/core/security.cpp is trying to start gpg in a new KProcess. I don't have `gpg` in my path, I'm not sure what package it's in.

==== KGoldRunner ====
The background appears but none of the tiles, and the icons for them in Create New Game are missing. So some directory is missing, could be <tt>C:\KDE4\share\pixmaps</tt> NAME NOT FOUND, I don't know where the tiles should be.

[[Category: MS Windows]]

Projects/KDE on Windows/Installation

2008-01-18T10:15:37Z

Skierpage: /* Status */ some other issues

Projects/KDE on Windows/Installation

2008-01-18T09:53:09Z

Skierpage: /* Status */ update with broad status

Getting Started/Build/Windows/emerge

2007-12-22T00:07:44Z

Skierpage: /* Notes */ link to KDEwin-installer

emerge is a tool to build the KDE sources and its third party requirements on MS Windows. It is the '''easy''' way to build KDE on MS Windows.

== Set up ==
Create a directory if possible in your harddrive's root e.g. C:\kderoot or D:\kderoot (You will need this PATH later). This directory will contain the whole kde installation later.

emerge.bat invokes an emerge.py script written in Python, so you first need to [http://www.python.org/download/ install a Python Interpreter].

The latest source code for windows emerge and the rest of KDE is stored in a [http://subversion.tigris.org/ Subversion] repository. You need a subversion client for the first checkout.

Check out the sources from the svn-directory of emerge into a new directory, which in this example we will call ''kderoot''.
If you have [http://subversion.tigris.org/project_packages.html#windows Subversion command-line tool], you can accomplish this with the following command:
<pre>svn co svn://anonsvn.kde.org/home/kde/trunk/kdesupport/kdewin32/emerge</pre>

Alternatively, you can checkout the sources using a program like [http://tortoisesvn.tigris.org/ TortoiseSVN].

Be sure to use a copy of Subversion that was built on Windows so that checked-out files do not use UNIX line endings. If you check out with UNIX line endings, the ''patch'' program will fail when attempting to apply a patch whose line endings don't match the system's.

After checkout you need to have directory ''kderoot\emerge'' else you can copy your emerge directory to that location.

Create the directory kderoot\etc. Copy the file '''kderoot\emerge\kdesettings-example.bat''' to '''kderoot\etc\kdesettings.bat''' and change it according to your [[#emerge_commandline_options_.2F_emerge_settings|needs]].
Then run it.

'''Be sure that you neither have the msys/bin nor the cygwin/bin in your path. If so you have to definitely remove it.'''

=== Compiling ===
emerge uses either the MinGW ("Minimalist GNU for Windows") GCC compiler and tools to build Qt and KDE from source code or one of the Microsoft Compilers (> Visual Studio 2003).

Currently, there is no dependency on the compilers in any of the packages. So, unless you call '''emerge mingw''' manually, have the compiler installed and in your path or alter the environment configuration scripts to add your existing MinGW bin directory to the ''PATH'' variable, compiling anything will choke. If you run '''emerge mingw''', you will not need to modify the environment configuration scripts to point to a custom location.

If you see an error about ''cc1plus'' not being found, either add MinGW's ''\libexec\gcc\mingw32\3.4.5'' to your ''PATH'' (in command line set PATH=%PATH%;path\to\directory) variable or copy the contents of this directory to MinGW's ''bin'' directory. The prior is preferred.

Everything applies to MS Visual Studio Compilers in a similar manner.

In vista, the mingw directory may need to be moved to c:\ in order to compile properly.

== Running emerge ==

Start a console window and run
C:\kderoot\emerge\kdeenv.bat

Check your path (run: <tt>echo %PATH%</tt>), it should have python and various directories within kderoot in it.

You can get 'some' help if you run:
C:\kderoot\emerge\bin>emerge --help

Below the directory '''kderoot\emerge\portage''' are subdirectories for categories as subdirectories which contain the instructions for individual packages.
The emerge script automatically handles package dependencies (except for the compiler, see [[#Compiling]]).

To build every required package for e.g. '''kdebase''' enter '''emerge kdebase'''.
If you want to make a dry run, add the option '''-p''' to it.

Start with '''emerge qt''' and if that completes successfully, run '''emerge [TARGET]''' where [TARGET] has to be replaced with the target you want to build.

== What emerge does ==
emerge will fetch Windows versions of numerous UNIX-like utilities and libraries from the Internet, putting them in '''kderoot\bin''', then get the Win32 support files, then Subversion, then Perl and the Qt libraries, etc.

Then emerge compiles the Qt libraries, this takes hours.

'''emerge ''package'' ''' performs the separate actions <tt>--fetch</tt>, <tt>--unpack</tt>, <tt>--compile</tt>, <tt>--install</tt>, <tt>--manifest</tt>, and <tt>--qmerge</tt>.

== emerge commandline options / emerge settings ==
There are some options that can be used when building with emerge.

{| border="0" cellpadding="2"
|-valign="top"
|<tt>-v</tt>
|<tt>EMERGE_VERBOSE</tt>
|width="5%"|
|This option augments the verbosity level - currently the highest verbosity level is 3 (<tt>-v -v -v</tt>). A verbosity level of 0 should give no output and equals to <tt>-q</tt>. You can set <tt>EMERGE_VERBOSE=3</tt> instead in the environment of the commandline or within your '''kdesettings.bat''' file.
|-valign="top"
|<tt>--nocopy</tt>
|<tt>EMERGE_NOCOPY</tt>
|
|This very useful option suppresses copying the sources from the local subversion tree to a directory within the build directory. It shouldn't be used while packaging; in the other cases it reduces the amount of harddisk used though and removes the copying time.You can set <tt>EMERGE_NOCOPY=True</tt> or <tt>=False</tt> instead.
|-valign="top"
|<tt>--offline</tt>
|
|
|This option suppresses the update step of the local tree - which needs some time. Be aware though that you have to have existing sources already if you want to use this option.
|-valign="top"
|<tt>-t</tt>
|<tt>EMERGE_BUILDTESTS</tt>
|
|This option enables or disables KDE4 buildtests for KDE modules. Other packages will not change. Use <tt>EMERGE_BUILDTESTS=True</tt> or <tt>=False</tt>.
|}

== Notes ==

emerge is mostly usable together with the [[Projects/KDE_on_Windows/Installation#KDE_Installer_for_Windows|kdewin-installer]] but we're currently still working on some packages which are packaged in a wrong way.
It is not recommended to use another layout then '''installer''' for '''directory_layout''' in the '''kdesettings.bat''' anymore (see that file for more detailed information).

emerge creates lots of files in '''\kderoot\tmp''' during build.
After a package is successfully installed
(check '''\kderoot\etc\portage\installed''' or the directory '''\kderoot\manifest\'''), you can delete its temporary directory.

Windows emerge is derived from the Gentoo portage system, but we are currently not enforcing compatibility. If you have questions about that please contact us at the channel #kde-windows on irc.freenode.net.

[[Category:MS Windows]]

Getting Started/Build/Windows/emerge

2007-11-16T00:27:46Z

Skierpage: /* What emerge does */ more details

emerge is a tool to build the KDE sources and its third party requirements on MS Windows.

It automates much of the downloading, patching and compiling described in [[../GCC_And_MinGW]]

== Set up ==
emerge.bat invokes an emerge.py script written in Python, so you first need to [http://www.python.org/download/ install the Python language].

The latest source code for Emerge and the rest of KDE is stored in a [http://subversion.tigris.org/ Subversion] repository.

Check out the sources from the svn-directory of emerge into a new directory, which in this example we will call ''kderoot''.
If you have [http://subversion.tigris.org/project_packages.html#windows Subversion command-line tool], you can accomplish this with the following command:
<pre>svn co svn://anonsvn.kde.org/home/kde/trunk/kdesupport/kdewin32/emerge</pre>

Alternatively, you can checkout the sources using a program like [http://tortoisesvn.tigris.org/ TortoiseSVN].

Be sure to use a copy of Subversion that was built on Windows so that checked-out files do not use UNIX line endings. If you check out with UNIX line endings, the ''patch'' program will fail when attempting to apply a patch whose line endings don't match the system's.

Create the directory kderoot\etc. Copy the file '''kderoot\emerge\kdesettings-environment.bat''' to '''kderoot\etc\kdesettings.bat''' and change it according to your needs. Then run it.

=== Compiling ===
emerge uses either the MinGW ("Minimalist GNU for Windows") GCC compiler and tools to build Qt and KDE from source code or on of the Microsoft Compilers (> Visual Studio 2003).

Currently, there is no dependency on the compilers in any of the packages. So, unless you call '''emerge mingw''' manually, have the compiler installed and in your path or alter the environment configuration scripts to add your existing MinGW bin directory to the ''PATH'' variable, compiling anything will choke. If you run '''emerge mingw''', you will not need to modify the environment configuration scripts to point to a custom location.

If you see an error about ''cc1plus'' not being found, either add MinGW's ''\libexec\gcc\mingw32\3.4.5'' to your ''PATH'' variable or copy the contents of this directory to MinGW's ''bin'' directory. The prior is preferred.

Everything applies to MS Visual Studio Compilers in a similar manner.

== Running emerge ==

Start a console window and run
C:\kderoot\etc\kdesettings

Check your path (run: <tt>echo %PATH%</tt>), it should have python and various directories within kderoot in it.

You can get 'some' help if you run:
C:\kderoot\emerge\bin>emerge --help</pre>

Below the directory '''kderoot\emerge\portage''' are subdirectories for categories as subdirectories which contain the instructions for individual packages.
The emerge script automatically handles package dependencies (except for the compiler, see [[#Compiling]]).

To build every required package for e.g. '''kdebase''' enter '''emerge kdebase'''.
If you want to make a dry run, add the option '''-p''' to it.

Start with '''emerge qt''' and when that completes successfully, run '''emerge kdelibs'''.

== What emerge does ==
emerge will fetch Windows versions of numerous UNIX-like utilities and libraries from the Internet, putting them in '''kderoot\bin''', then get the Win32 support files, then Subversion, then Perl and the Qt libraries, etc.

Then emerge compiles the Qt libraries, this takes hours.

'''emerge ''package'' ''' performs the separate actions <tt>--fetch</tt>, <tt>--unpack</tt>, <tt>--compile</tt>, <tt>--install</tt>, <tt>--manifest</tt>, and <tt>--qmerge</tt>.

== Notes ==

emerge is mostly usable together with the kdewin-installer but we're currently still working on some packages which are packaged in a wrong way.
It is not recommended to use another layout then '''installer''' for '''directory_layout''' in the '''kdesettings.bat''' anymore (see that file for more detailed information).

emerge creates lots of files in '''\kderoot\tmp''' during build.
After a package is successfully installed
(check '''\kderoot\etc\portage\installed'''), you can delete its temporary directory.

emerge is derived from the Gentoo portage system,
that has documentation for the portage format and emerge program.

[[Category:MS Windows]]

Getting Started/Build/Windows/emerge

2007-11-16T00:24:16Z

Skierpage: /* Running emerge */ change suggestions.

emerge is a tool to build the KDE sources and its third party requirements on MS Windows.

It automates much of the downloading, patching and compiling described in [[../GCC_And_MinGW]]

== Set up ==
emerge.bat invokes an emerge.py script written in Python, so you first need to [http://www.python.org/download/ install the Python language].

The latest source code for Emerge and the rest of KDE is stored in a [http://subversion.tigris.org/ Subversion] repository.

Check out the sources from the svn-directory of emerge into a new directory, which in this example we will call ''kderoot''.
If you have [http://subversion.tigris.org/project_packages.html#windows Subversion command-line tool], you can accomplish this with the following command:
<pre>svn co svn://anonsvn.kde.org/home/kde/trunk/kdesupport/kdewin32/emerge</pre>

Alternatively, you can checkout the sources using a program like [http://tortoisesvn.tigris.org/ TortoiseSVN].

Be sure to use a copy of Subversion that was built on Windows so that checked-out files do not use UNIX line endings. If you check out with UNIX line endings, the ''patch'' program will fail when attempting to apply a patch whose line endings don't match the system's.

Create the directory kderoot\etc. Copy the file '''kderoot\emerge\kdesettings-environment.bat''' to '''kderoot\etc\kdesettings.bat''' and change it according to your needs. Then run it.

=== Compiling ===
emerge uses either the MinGW ("Minimalist GNU for Windows") GCC compiler and tools to build Qt and KDE from source code or on of the Microsoft Compilers (> Visual Studio 2003).

Currently, there is no dependency on the compilers in any of the packages. So, unless you call '''emerge mingw''' manually, have the compiler installed and in your path or alter the environment configuration scripts to add your existing MinGW bin directory to the ''PATH'' variable, compiling anything will choke. If you run '''emerge mingw''', you will not need to modify the environment configuration scripts to point to a custom location.

If you see an error about ''cc1plus'' not being found, either add MinGW's ''\libexec\gcc\mingw32\3.4.5'' to your ''PATH'' variable or copy the contents of this directory to MinGW's ''bin'' directory. The prior is preferred.

Everything applies to MS Visual Studio Compilers in a similar manner.

== Running emerge ==

Start a console window and run
C:\kderoot\etc\kdesettings

Check your path (run: <tt>echo %PATH%</tt>), it should have python and various directories within kderoot in it.

You can get 'some' help if you run:
C:\kderoot\emerge\bin>emerge --help</pre>

Below the directory '''kderoot\emerge\portage''' are subdirectories for categories as subdirectories which contain the instructions for individual packages.
The emerge script automatically handles package dependencies (except for the compiler, see [[#Compiling]]).

To build every required package for e.g. '''kdebase''' enter '''emerge kdebase'''.
If you want to make a dry run, add the option '''-p''' to it.

Start with '''emerge qt''' and when that completes successfully, run '''emerge kdelibs'''.

== What emerge does ==
emerge will fetch Windows versions of numerous UNIX-like utilities and libraries from the Internet, putting them in '''kderoot\bin''', then get the Win32 support files, then Subversion, then Perl and the Qt libraries, etc.

Then emerge compiles the Qt libraries, this takes hours.

== Notes ==

emerge is mostly usable together with the kdewin-installer but we're currently still working on some packages which are packaged in a wrong way.
It is not recommended to use another layout then '''installer''' for '''directory_layout''' in the '''kdesettings.bat''' anymore (see that file for more detailed information).

emerge creates lots of files in '''\kderoot\tmp''' during build.
After a package is successfully installed
(check '''\kderoot\etc\portage\installed'''), you can delete its temporary directory.

emerge is derived from the Gentoo portage system,
that has documentation for the portage format and emerge program.

[[Category:MS Windows]]

Getting Started/Build/Windows/emerge

2007-11-16T00:11:18Z

Skierpage: /* Notes */ more notes

emerge is a tool to build the KDE sources and its third party requirements on MS Windows.

It automates much of the downloading, patching and compiling described in [[../GCC_And_MinGW]]

== Set up ==
emerge.bat invokes an emerge.py script written in Python, so you first need to [http://www.python.org/download/ install the Python language].

The latest source code for Emerge and the rest of KDE is stored in a [http://subversion.tigris.org/ Subversion] repository.

Check out the sources from the svn-directory of emerge into a new directory, which in this example we will call ''kderoot''.
If you have [http://subversion.tigris.org/project_packages.html#windows Subversion command-line tool], you can accomplish this with the following command:
<pre>svn co svn://anonsvn.kde.org/home/kde/trunk/kdesupport/kdewin32/emerge</pre>

Alternatively, you can checkout the sources using a program like [http://tortoisesvn.tigris.org/ TortoiseSVN].

Be sure to use a copy of Subversion that was built on Windows so that checked-out files do not use UNIX line endings. If you check out with UNIX line endings, the ''patch'' program will fail when attempting to apply a patch whose line endings don't match the system's.

Create the directory kderoot\etc. Copy the file '''kderoot\emerge\kdesettings-environment.bat''' to '''kderoot\etc\kdesettings.bat''' and change it according to your needs. Then run it.

=== Compiling ===
emerge uses either the MinGW ("Minimalist GNU for Windows") GCC compiler and tools to build Qt and KDE from source code or on of the Microsoft Compilers (> Visual Studio 2003).

Currently, there is no dependency on the compilers in any of the packages. So, unless you call '''emerge mingw''' manually, have the compiler installed and in your path or alter the environment configuration scripts to add your existing MinGW bin directory to the ''PATH'' variable, compiling anything will choke. If you run '''emerge mingw''', you will not need to modify the environment configuration scripts to point to a custom location.

If you see an error about ''cc1plus'' not being found, either add MinGW's ''\libexec\gcc\mingw32\3.4.5'' to your ''PATH'' variable or copy the contents of this directory to MinGW's ''bin'' directory. The prior is preferred.

Everything applies to MS Visual Studio Compilers in a similar manner.

== Running emerge ==

Start a console window and run
C:\kderoot\etc\kdesettings

Check your path (run: <tt>echo %PATH%</tt>), it should have python and various directories within kderoot in it.

You can get 'some' help if you run:
C:\kderoot\emerge\bin>emerge --help</pre>

Below the directory '''kderoot\emerge\portage''' are subdirectories for categories as subdirectories which contain the instructions for individual packages.
The emerge script automatically handles package dependencies (except for the compiler, see [[#Compiling]]).

To build every required package for e.g. '''kdebase''' enter '''emerge kdebase'''.
If you want to make a dry run, add the option '''-p''' to it.

Start with '''emerge qt''' and when that completes successfully, run '''emerge kdebase'''.

== What emerge does ==
emerge will fetch Windows versions of numerous UNIX-like utilities and libraries from the Internet, putting them in '''kderoot\bin''', then get the Win32 support files, then Subversion, then Perl and the Qt libraries, etc.

Then emerge compiles the Qt libraries, this takes hours.

== Notes ==

emerge is mostly usable together with the kdewin-installer but we're currently still working on some packages which are packaged in a wrong way.
It is not recommended to use another layout then '''installer''' for '''directory_layout''' in the '''kdesettings.bat''' anymore (see that file for more detailed information).

emerge creates lots of files in '''\kderoot\tmp''' during build.
After a package is successfully installed
(check '''\kderoot\etc\portage\installed'''), you can delete its temporary directory.

emerge is derived from the Gentoo portage system,
that has documentation for the portage format and emerge program.

[[Category:MS Windows]]

Getting Started/Build/Windows/emerge

2007-11-16T00:05:42Z

Skierpage: /* Running emerge */ formatting

emerge is a tool to build the KDE sources and its third party requirements on MS Windows.

It automates much of the downloading, patching and compiling described in [[../GCC_And_MinGW]]

== Set up ==
emerge.bat invokes an emerge.py script written in Python, so you first need to [http://www.python.org/download/ install the Python language].

The latest source code for Emerge and the rest of KDE is stored in a [http://subversion.tigris.org/ Subversion] repository.

Check out the sources from the svn-directory of emerge into a new directory, which in this example we will call ''kderoot''.
If you have [http://subversion.tigris.org/project_packages.html#windows Subversion command-line tool], you can accomplish this with the following command:
<pre>svn co svn://anonsvn.kde.org/home/kde/trunk/kdesupport/kdewin32/emerge</pre>

Alternatively, you can checkout the sources using a program like [http://tortoisesvn.tigris.org/ TortoiseSVN].

Be sure to use a copy of Subversion that was built on Windows so that checked-out files do not use UNIX line endings. If you check out with UNIX line endings, the ''patch'' program will fail when attempting to apply a patch whose line endings don't match the system's.

Create the directory kderoot\etc. Copy the file '''kderoot\emerge\kdesettings-environment.bat''' to '''kderoot\etc\kdesettings.bat''' and change it according to your needs. Then run it.

=== Compiling ===
emerge uses either the MinGW ("Minimalist GNU for Windows") GCC compiler and tools to build Qt and KDE from source code or on of the Microsoft Compilers (> Visual Studio 2003).

Currently, there is no dependency on the compilers in any of the packages. So, unless you call '''emerge mingw''' manually, have the compiler installed and in your path or alter the environment configuration scripts to add your existing MinGW bin directory to the ''PATH'' variable, compiling anything will choke. If you run '''emerge mingw''', you will not need to modify the environment configuration scripts to point to a custom location.

If you see an error about ''cc1plus'' not being found, either add MinGW's ''\libexec\gcc\mingw32\3.4.5'' to your ''PATH'' variable or copy the contents of this directory to MinGW's ''bin'' directory. The prior is preferred.

Everything applies to MS Visual Studio Compilers in a similar manner.

== Running emerge ==

Start a console window and run
C:\kderoot\etc\kdesettings

Check your path (run: <tt>echo %PATH%</tt>), it should have python and various directories within kderoot in it.

You can get 'some' help if you run:
C:\kderoot\emerge\bin>emerge --help</pre>

Below the directory '''kderoot\emerge\portage''' are subdirectories for categories as subdirectories which contain the instructions for individual packages.
The emerge script automatically handles package dependencies (except for the compiler, see [[#Compiling]]).

To build every required package for e.g. '''kdebase''' enter '''emerge kdebase'''.
If you want to make a dry run, add the option '''-p''' to it.

Start with '''emerge qt''' and when that completes successfully, run '''emerge kdebase'''.

== What emerge does ==
emerge will fetch Windows versions of numerous UNIX-like utilities and libraries from the Internet, putting them in '''kderoot\bin''', then get the Win32 support files, then Subversion, then Perl and the Qt libraries, etc.

Then emerge compiles the Qt libraries, this takes hours.

== Notes ==

emerge is mostly usable together with the kdewin-installer but we're currently still working on some packages which are packaged in a wrong way.
It is not recommended to use another layout then '''installer''' for '''directory_layout''' in the '''kdesettings.bat''' anymore (see that file for more detailed information).

[[Category:MS Windows]]

Getting Started/Build/Windows/emerge

2007-11-16T00:02:59Z

Skierpage: /* Running emerge */ more details

emerge is a tool to build the KDE sources and its third party requirements on MS Windows.

It automates much of the downloading, patching and compiling described in [[../GCC_And_MinGW]]

== Set up ==
emerge.bat invokes an emerge.py script written in Python, so you first need to [http://www.python.org/download/ install the Python language].

The latest source code for Emerge and the rest of KDE is stored in a [http://subversion.tigris.org/ Subversion] repository.

Check out the sources from the svn-directory of emerge into a new directory, which in this example we will call ''kderoot''.
If you have [http://subversion.tigris.org/project_packages.html#windows Subversion command-line tool], you can accomplish this with the following command:
<pre>svn co svn://anonsvn.kde.org/home/kde/trunk/kdesupport/kdewin32/emerge</pre>

Alternatively, you can checkout the sources using a program like [http://tortoisesvn.tigris.org/ TortoiseSVN].

Be sure to use a copy of Subversion that was built on Windows so that checked-out files do not use UNIX line endings. If you check out with UNIX line endings, the ''patch'' program will fail when attempting to apply a patch whose line endings don't match the system's.

Create the directory kderoot\etc. Copy the file '''kderoot\emerge\kdesettings-environment.bat''' to '''kderoot\etc\kdesettings.bat''' and change it according to your needs. Then run it.

=== Compiling ===
emerge uses either the MinGW ("Minimalist GNU for Windows") GCC compiler and tools to build Qt and KDE from source code or on of the Microsoft Compilers (> Visual Studio 2003).

Currently, there is no dependency on the compilers in any of the packages. So, unless you call '''emerge mingw''' manually, have the compiler installed and in your path or alter the environment configuration scripts to add your existing MinGW bin directory to the ''PATH'' variable, compiling anything will choke. If you run '''emerge mingw''', you will not need to modify the environment configuration scripts to point to a custom location.

If you see an error about ''cc1plus'' not being found, either add MinGW's ''\libexec\gcc\mingw32\3.4.5'' to your ''PATH'' variable or copy the contents of this directory to MinGW's ''bin'' directory. The prior is preferred.

Everything applies to MS Visual Studio Compilers in a similar manner.

== Running emerge ==

Start a console window and run <pre>C:\kderoot\etc\kdesettings</pre>.

Check your path (run: <pre>echo %PATH%</pre>), it should have python and various directories in kderoot in it.

You can get 'some' help if you run: <pre>C:\kderoot\emerge\bin>emerge --help</pre>

Below the directory '''kderoot\emerge\portage''' are subdirectories for categories as subdirectories which contain the instructions for individual packages.
The emerge script automatically handles package dependencies (except for the compiler, see [[#Compiling]]).

To build every required package for e.g. '''kdebase''' enter '''emerge kdebase'''.
If you want to make a dry run, add the option '''-p''' to it.

Start with '''emerge qt''' and when that completes successfully, run '''emerge kdebase'''.

== What emerge does ==
emerge will fetch Windows versions of numerous UNIX-like utilities and libraries from the Internet, putting them in '''kderoot\bin''', then get the Win32 support files, then Subversion, then Perl and the Qt libraries, etc.

Then emerge compiles the Qt libraries, this takes hours.

== Notes ==

emerge is mostly usable together with the kdewin-installer but we're currently still working on some packages which are packaged in a wrong way.
It is not recommended to use another layout then '''installer''' for '''directory_layout''' in the '''kdesettings.bat''' anymore (see that file for more detailed information).

[[Category:MS Windows]]

Getting Started/Build/Windows/emerge

2007-11-15T22:55:44Z

Skierpage: typo

emerge is a tool to build the KDE sources and its third party requirements on MS Windows.

It automates much of the downloading, patching and compiling described in [[../GCC_And_MinGW]]

== Set up ==
emerge.bat invokes an emerge.py script written in Python, so you first need to [http://www.python.org/download/ install the Python language].

The latest source code for Emerge and the rest of KDE is stored in a [http://subversion.tigris.org/ Subversion] repository.

Check out the sources from the svn-directory of emerge into a new directory, which in this example we will call ''kderoot''.
If you have [http://subversion.tigris.org/project_packages.html#windows Subversion command-line tool], you can accomplish this with the following command:
<pre>svn co svn://anonsvn.kde.org/home/kde/trunk/kdesupport/kdewin32/emerge</pre>

Alternatively, you can checkout the sources using a program like [http://tortoisesvn.tigris.org/ TortoiseSVN].

Be sure to use a copy of Subversion that was built on Windows so that checked-out files do not use UNIX line endings. If you check out with UNIX line endings, the ''patch'' program will fail when attempting to apply a patch whose line endings don't match the system's.

Create the directory kderoot\etc. Copy the file '''kderoot\emerge\kdesettings-environment.bat''' to '''kderoot\etc\kdesettings.bat''' and change it according to your needs. Then run it.

=== Compiling ===
emerge uses the MinGW ("Minimalist GNU for Windows") GCC compiler and tools to build Qt and KDE from source code.

Currently, there is no dependency on MinGW in any of the packages. So, unless you call '''emerge mingw''' manually, or alter the environment configuration scripts to add your existing MinGW bin directory to the ''PATH'' variable, compiling anything will choke. If you run '''emerge mingw''', you will not need to modify the environment configuration scripts to point to a custom location.

If you see an error about ''cc1plus'' not being found, either add MinGW's ''\libexec\gcc\mingw32\3.4.5'' to your ''PATH'' variable or copy the contents of this directory to MinGW's ''bin'' directory. The prior is preferred.

== Running emerge ==

Start a console window and run <pre>C:\kderoot\etc\kdesettings</pre>.

Check your path (run: <pre>echo %PATH%</pre>), it should have python and various directories in kderoot in it.

You can get 'some' help if you run: <pre>C:\kderoot\emerge\bin>emerge --help</pre>

Below the directory '''kderoot\emerge\portage''' you have the categories as subdirectories which contain individual packages.

To build every required package for e.g. '''kdebase''' enter '''emerge kdebase'''.
If you want to make a dry run, add the option '''-p''' to it.

== What emerge does ==
emerge will fetch Windows versions of numerous UNIX-like utilities and libraries from the Internet, putting them in '''kderoot\bin''', then get the Win32 support files, then Subversion, then Perl and the Qt libraries, etc.

Then emerge compiles the Qt libraries, this takes hours.

== Notes ==

emerge is mostly usable together with the kdewin-installer but we're currently still working on some packages which are packaged in a wrong way.
It is not recommended to use another layout then '''installer''' for '''directory_layout''' in the '''kdesettings.bat''' anymore (see that file for more detailed information).

[[Category:MS Windows]]

Getting Started/Build/Windows/emerge

2007-11-15T22:55:20Z

Skierpage: move compiling section to top, more notes

emerge is a tool to acquirebuild the KDE sources and its third party requirements on MS Windows.

It automates much of the downloading, patching and compiling described in [[../GCC_And_MinGW]]

== Set up ==
emerge.bat invokes an emerge.py script written in Python, so you first need to [http://www.python.org/download/ install the Python language].

The latest source code for Emerge and the rest of KDE is stored in a [http://subversion.tigris.org/ Subversion] repository.

Check out the sources from the svn-directory of emerge into a new directory, which in this example we will call ''kderoot''.
If you have [http://subversion.tigris.org/project_packages.html#windows Subversion command-line tool], you can accomplish this with the following command:
<pre>svn co svn://anonsvn.kde.org/home/kde/trunk/kdesupport/kdewin32/emerge</pre>

Alternatively, you can checkout the sources using a program like [http://tortoisesvn.tigris.org/ TortoiseSVN].

Be sure to use a copy of Subversion that was built on Windows so that checked-out files do not use UNIX line endings. If you check out with UNIX line endings, the ''patch'' program will fail when attempting to apply a patch whose line endings don't match the system's.

Create the directory kderoot\etc. Copy the file '''kderoot\emerge\kdesettings-environment.bat''' to '''kderoot\etc\kdesettings.bat''' and change it according to your needs. Then run it.

=== Compiling ===
emerge uses the MinGW ("Minimalist GNU for Windows") GCC compiler and tools to build Qt and KDE from source code.

Currently, there is no dependency on MinGW in any of the packages. So, unless you call '''emerge mingw''' manually, or alter the environment configuration scripts to add your existing MinGW bin directory to the ''PATH'' variable, compiling anything will choke. If you run '''emerge mingw''', you will not need to modify the environment configuration scripts to point to a custom location.

If you see an error about ''cc1plus'' not being found, either add MinGW's ''\libexec\gcc\mingw32\3.4.5'' to your ''PATH'' variable or copy the contents of this directory to MinGW's ''bin'' directory. The prior is preferred.

== Running emerge ==

Start a console window and run <pre>C:\kderoot\etc\kdesettings</pre>.

Check your path (run: <pre>echo %PATH%</pre>), it should have python and various directories in kderoot in it.

You can get 'some' help if you run: <pre>C:\kderoot\emerge\bin>emerge --help</pre>

Below the directory '''kderoot\emerge\portage''' you have the categories as subdirectories which contain individual packages.

To build every required package for e.g. '''kdebase''' enter '''emerge kdebase'''.
If you want to make a dry run, add the option '''-p''' to it.

== What emerge does ==
emerge will fetch Windows versions of numerous UNIX-like utilities and libraries from the Internet, putting them in '''kderoot\bin''', then get the Win32 support files, then Subversion, then Perl and the Qt libraries, etc.

Then emerge compiles the Qt libraries, this takes hours.

== Notes ==

emerge is mostly usable together with the kdewin-installer but we're currently still working on some packages which are packaged in a wrong way.
It is not recommended to use another layout then '''installer''' for '''directory_layout''' in the '''kdesettings.bat''' anymore (see that file for more detailed information).

[[Category:MS Windows]]

Getting Started/Build/Windows/emerge

2007-11-15T22:20:05Z

Skierpage: more structure, more info

emerge is a tool to build the kde sources and its third party requirements on MS Windows.

== Set up ==
emerge.bat invokes an emerge.py script written in Python, so you first need to [http://www.python.org/download/ install the Python language].

The latest source code for Emerge and the rest of KDE is stored in a [http://subversion.tigris.org/ Subversion] repository.

Check out the sources from the svn-directory of emerge into a new directory, which in this example we will call ''kderoot''.
If you have [http://subversion.tigris.org/project_packages.html#windows Subversion command-line tool], you can accomplish this with the following command:
<pre>svn co svn://anonsvn.kde.org/home/kde/trunk/kdesupport/kdewin32/emerge</pre>

Alternatively, you can checkout the sources using a program like [http://tortoisesvn.tigris.org/ TortoiseSVN].

Be sure to use a copy of Subversion that was built on Windows so that checked-out files do not use UNIX line endings. If you check out with UNIX line endings, the ''patch'' program will fail when attempting to apply a patch whose line endings don't match the system's.

Create the directory kderoot\etc. Copy the file '''kderoot\emerge\kdesettings-environment.bat''' to '''kderoot\etc\kdesettings.bat''' and change it according to your needs. Then run it.

== Running emerge ==

You can get 'some' help if you run: <pre>C:\kderoot\emerge\bin>emerge --help</pre>

Below the directory '''kderoot\emerge\portage''' you have the categories as subdirectories which contain individual packages.

To build every required package for e.g. '''kdebase''' enter '''emerge kdebase'''.
If you want to make a dry run, add the option '''-p''' to it.

== What emerge does ==
emerge will fetch Windows versions of numerous UNIX-like utilities and libraries from the Internet, putting them in '''kderoot\bin''', then get the Win32 support files, then Subversion, then Perl, the Qt libraries, etc.

== Notes ==

emerge is mostly usable together with the kdewin-installer but we're currently still working on some packages which are packaged in a wrong way.
It is not recommended to use another layout then '''installer''' for '''directory_layout''' in the '''kdesettings.bat''' anymore (see that file for more detailed information).

=== Compiling ===
You need MinGW to build KDE.

Currently, there is no dependency on MinGW in any of the packages. So, unless you call '''emerge mingw''' manually, or alter the environment configuration scripts to add your existing MinGW bin directory to the ''PATH'' variable, compiling anything will choke. If you run '''emerge mingw''', you will not need to modify the environment configuration scripts to point to a custom location.

If you see an error about ''cc1plus'' not being found, either add MinGW's ''\libexec\gcc\mingw32\3.4.5'' to your ''PATH'' variable or copy the contents of this directory to MinGW's ''bin'' directory. The prior is preferred.

[[Category:MS Windows]]

Getting Started/Build/Windows/emerge

2007-11-15T22:01:08Z

Skierpage: /* What emerge does */

emerge is a tool to build the kde sources and its third party requirements on MS Windows.

It is written in Python, so you first need to [http://www.python.org/download/ install the Python language].

The latest source code for Emerge and the rest of KDE is stored in a [http://subversion.tigris.org/ Subversion] repository.

To start an emerge-based install, checkout the sources from the svn-directory of emerge into a new directory, which in this example we will call ''kderoot''.
If you have [http://subversion.tigris.org/project_packages.html#windows Subversion command-line tool], you can accomplish this with the following command:
<pre>svn co svn://anonsvn.kde.org/home/kde/trunk/kdesupport/kdewin32/emerge</pre>

Alternatively, you can checkout the sources using a program like [http://tortoisesvn.tigris.org/ TortoiseSVN].

Be sure to use a copy of Subversion that was built on Windows so that checked-out files do not use UNIX line endings. If you check out with UNIX line endings, the ''patch'' program will fail when attempting to apply a patch whose line endings don't match the system's.

Create the directory kderoot\etc. Copy the file '''kderoot\emerge\kdesettings-environment.bat''' to '''kderoot\etc\kdesettings.bat''' and change it according to your needs. Then run it.

You can get 'some' help if you run: <pre>C:\kderoot\emerge\bin>emerge --help</pre>

Below the directory '''kderoot\emerge\portage''' you have the categories as subdirectories which contain individual packages.

To build every required package for e.g. '''kdebase''' enter '''emerge kdebase'''.
If you want to make a dry run, add the option '''-p''' to it.

== What emerge does ==
emerge will fetch Windows versions of numerous UNIX-like utilities and libraries from the Internet, putting them in '''kderoot\bin''', then get the Win32 support files, then Subversion, then Perl, the Qt libraries, etc.

== Notes ==

emerge is mostly usable together with the kdewin-installer but we're currently still working on some packages which are packaged in a wrong way.
It is not recommended to use another layout then '''installer''' for '''directory_layout''' in the '''kdesettings.bat''' anymore (see that file for more detailed information).

=== Compiling ===
You need MinGW to build KDE.

Currently, there is no dependency on MinGW in any of the packages. So, unless you call '''emerge mingw''' manually, or alter the environment configuration scripts to add your existing MinGW bin directory to the ''PATH'' variable, compiling anything will choke. If you run '''emerge mingw''', you will not need to modify the environment configuration scripts to point to a custom location.

If you see an error about ''cc1plus'' not being found, either add MinGW's ''\libexec\gcc\mingw32\3.4.5'' to your ''PATH'' variable or copy the contents of this directory to MinGW's ''bin'' directory. The prior is preferred.

[[Category:MS Windows]]

Getting Started/Build/Windows/emerge

2007-11-15T21:47:33Z

Skierpage: /* Notes */ subsection about compiling

emerge is a tool to build the kde sources and its third party requirements on MS Windows.

It is written in Python, so you first need to [http://www.python.org/download/ install the Python language].

The latest source code for Emerge and the rest of KDE is stored in a [http://subversion.tigris.org/ Subversion] repository.

To start an emerge-based install, checkout the sources from the svn-directory of emerge into a new directory, which in this example we will call ''kderoot''.
If you have [http://subversion.tigris.org/project_packages.html#windows Subversion command-line tool], you can accomplish this with the following command:
<pre>svn co svn://anonsvn.kde.org/home/kde/trunk/kdesupport/kdewin32/emerge</pre>

Alternatively, you can checkout the sources using a program like [http://tortoisesvn.tigris.org/ TortoiseSVN].

Be sure to use a copy of Subversion that was built on Windows so that checked-out files do not use UNIX line endings. If you check out with UNIX line endings, the ''patch'' program will fail when attempting to apply a patch whose line endings don't match the system's.

Create the directory kderoot\etc. Copy the file '''kderoot\emerge\kdesettings-environment.bat''' to '''kderoot\etc\kdesettings.bat''' and change it according to your needs. Then run it.

You can get 'some' help if you run: <pre>C:\kderoot\emerge\bin>emerge --help</pre>

Below the directory '''kderoot\emerge\portage''' you have the categories as subdirectories which contain individual packages.

To build every required package for e.g. '''kdebase''' enter '''emerge kdebase'''.
If you want to make a dry run, add the option '''-p''' to it.

== What emerge does ==
emerge will fetch Windows versions of numerous UNIX-like utilities and libraries from the Internet, putting them in '''kderoot\bin''', then get the MinGW compiler, then Subversion, then Perl, the Qt libraries, etc.

== Notes ==

emerge is mostly usable together with the kdewin-installer but we're currently still working on some packages which are packaged in a wrong way.
It is not recommended to use another layout then '''installer''' for '''directory_layout''' in the '''kdesettings.bat''' anymore (see that file for more detailed information).

=== Compiling ===
You need MinGW to build KDE.

Currently, there is no dependency on MinGW in any of the packages. So, unless you call '''emerge mingw''' manually, or alter the environment configuration scripts to add your existing MinGW bin directory to the ''PATH'' variable, compiling anything will choke. If you run '''emerge mingw''', you will not need to modify the environment configuration scripts to point to a custom location.

If you see an error about ''cc1plus'' not being found, either add MinGW's ''\libexec\gcc\mingw32\3.4.5'' to your ''PATH'' variable or copy the contents of this directory to MinGW's ''bin'' directory. The prior is preferred.

[[Category:MS Windows]]

Talk:Projects/KDE on Windows/Installation

2007-11-15T11:10:38Z

Skierpage: /* General */ drkonqi.exe?

Use this page to record your experiences with KDE on Windows.
Click the + tab and enter <nowiki>~~~~</nowiki> as the subject to add your experiences. Include your installer version.

== [[User:Skierpage|Skierpage]] 07:43, 5 November 2007 (CET) on 2007-11-03 ==
Here's [[User:Skierpage]]'s experience partially installing files with
kdewin-installer-gui-0.8.1-2.exe
on Windows XP SP2.

''Some of my problems were caused by the KDE Installer silently failing to install kdebase bin.''

=== General ===
Each app's Help > Handbook fails to start

About the time I tried the handbook the program couldn't find the KDE crash handler drkonqi.exe.

Submit Bug Report fails to load anything when you click [Launch Bug Wizard];
nothing displays in Process Monitor or DebugView.

Okular and KStars crashed just after trying to access ksyscoca and then "launching kbuildsycoca4". I ran kbuildsycoca4 by hand and then both applications got further.

My display got garbled, displaying what looks like a backing store of the current window in the top left. This first happened with kolf.exe, then happened to KDE Installer. Closing every K* app seemed to cure it.

=== Specific apps ===
bovo, kblackbox, kgeography pixeltool, etc. worked fine.

==== KStars ====
Looks '''awesome'''. In the list of cities in setup,
accented characters appear incorrectly as multiple characters,
as if the encoding is off. [http://www.skierpage.com/kde_bugs/kstars_setup_bad_chars.png See screenshot.]

When I clicked [Download extra data], it crashes. In DebugView, last thing it tried to do was open ksycoca and then launch kbuildsycoca4.

After running kbuildsycoca4 and restarting, KStars [Download extra data] created a "Get Hot New Stuff", but that window was obscured by both KStars and its wizard. It had a [Close] button but would not accept input. I was able to [Cancel] the KStars setup window, at which point both the KStars and Get Hot New Stuff windows appeared. There was nothing in Get Hot New Stuff for "KStarsAdd On Installer" (sic -- word layout bug), so I clicked [Close].

==== kbuildsycoca4 ====
As this seemed to be causing problems, I ran it myself in a command window. It said "kbuildsycoca4 running..." then exited, seemingly OK.

==== KColorChooser ====
crashes when you choose "Named Colors" from the list.
(It fails to open several .mo files and .js files,
then tries to read rgb.txt from various X11 directories and obviously it's not there,
and then crashes.)

==== kruler ====
kruler's cursor in North or South orientation shows the vertical arrowhead and line but has black and white garbage on the other half of it where the selection point would be.

==== okular ====
First time it started klauncher.exe process but hung without displaying anything.
I killed the okular process and tried again; second time okular crashed; DebugView indicated it was trying to open ksyscoca, and when that failed it tried to launch ksyscocabuilder.exe:
[4644] okular(4644)/kdecore (KSycoca) bool __thiscall KSycocaPrivate::checkDatabase(class QFlags<enum KSycocaPrivate::BehaviorIfNotFound>): We have no database.... launching kbuildsycoca4
After running kbuildsycoca4 by hand okular appeared OK. When I chose File > Open I got an alert
Windows - No Disk
Exception Processing Message c00000013 Parameters ''hex hex hex''
I clicked [Continue] and got this alert again.
I think each time Windows was spinning up my empty floppy or CD-ROM drive.
Then the file dialog appeared but also an alert
Error - okular
The process for the file protocol died unexpectedly.

Meanwhile DebugView showed
[2916] not able to find 'kio_file' because KDEDIRS environment variable is not set.
[2916] Set KDEDIRS to the KDE installation root dir and restart klauncher to fix this problem.

I clicked Root in the file dialog and okular generated a ton of DebugView output in kdecore (KUrl) and then crashed.

I followed the instructions about setting up KDEDIRS, killed klauncher.exe, restarted Okular. I still got errors about No Disk but no more "file protocol death". Howeer, clicking Root in the file dialog still generates a ton of DebugView output and Okular crashes.

Even when I navigate to a folder with .png images in it, Open a document displays nothing. Even if I choose PNG image, it displays nothing. However, if I enter *.png in the Filter, it displays appropriate files.

However, choosing a png file results in okular displaying
Can not find a plugin that is able to handle the passed document
and then an error alert. Same for selecting a *.bmp.

Weirdly, entering *.jpg in the Filter immediately exits okular, with no errors.

==== ktouch ====
Exits, DebugView shows
[3452] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283

==== kbruch ====
The accelerator [Alt+e] for [Next Task] does not work.

==== KDE World Clock ====
Is pitch dark. The tooltip shows current city and add flag works. DebugView shows:
[4524]
[4524] QImage::scaled: Image is a null image
[4524] QPainter::begin: Paint device returned engine == 0, type: 3
[4524] QPainter::setCompositionMode: Painter not active
[4524] QPainter::begin: Paint device returned engine == 0, type: 2

Its context menu has Map Theme > Surface Depth / Flat World / Surface Depth / Flat World , i.e. two entries repeated. Whatever you choose is checked twice.

I can't uncheck Show Daylight, Show Cities, Show Flags in the context menu, they remain checked.

==== kteatime ====
It does display a fabulous notification bubble from the system tray when the tea is ready! Howeer, DebugView indicates "error while contacting knotify server" (I had configured KTeaTime to Play a sound, Show a message in a popup and Mark taskbar entry) :
[6052] kteatime(6052)/kdeui (KNotification) unsigned int __thiscall KNotificationManager::notify(class KNotification *,const class QPixmap &,const class QStringList &,const class QList<struct QPair<class QString,class QString> > &,const class QString &): error while contacting knotify server

==== khangman ====
It put up a dialog towards the back about progress, but unlike earlier app, that completed and it then worked great. I chose to, roughly. get words in a new language, chose France from the dialog/ Get Hot New Stuff showed up and worked but displayed an alert:
Error - KHangMan
Cannot start ''gpg'' and retrieve the available keys. Make sure that ''gpg'' is installed, otherwise verification of the downloaded resources will be impossible.

I installed gpgme and reran khangman, but now Get Hot New Stuff, did not display any categories.

I changed settings to play sounds and it immediately crashed with
[6072] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283

I got around this crash by editing khangmanrc to disable audio.
Still nothing in Get Hot New Stuff.

==== Kig ====
It worked pretty well, I was able to save a .kig file.
It kept prompting
Format not supported - Kig
Kig does not support saving to any other format than its own.
[Save Kig Format] [Cancel]
but if I choose "Save Kig Format" I get the alert again.
Only cancel worked to save the file.

However, when I tried to open that file, the Open dialog displayed its type as "plain text document", opening it led to a "Format Not Supported" alert. DebugView showed:
[5432] kig(5432)/kdecore (KUrl) __thiscall KUrl::KUrl(const class KUrl &): KUrl::KUrl(KUrl) path "" toLocalFile ""
[5432] kig(5432) bool __thiscall KigPart::openFile(void): mimetype: "text/plain"

So there are problems with mime type handling.
(It's scary that mime problems will stop a program from editing a file, how do I force it?)

==== KWordQuiz ====
I was able to download French vocabulary, but when I dismissed it, I got the same alert as KHangMan once displayed
Cannot start gpg and retrieve the available keys. Make sure that gpg is installed.

kdelibs/knewstuff/knewstuff2/core/security.cpp is trying to start gpg in a new KProcess. I don't have `gpg` in my path, I'm not sure what package it's in.

==== KGoldRunner ====
The background appears but none of the tiles, and the icons for them in Create New Game are missing. So some directory is missing, could be <tt>C:\KDE4\share\pixmaps</tt> NAME NOT FOUND, I don't know where the tiles should be.

[[Category: MS Windows]]

Getting Started/Build/Windows/emerge

2007-11-15T11:01:09Z

Skierpage: some more detail, headings

emerge is a tool to build the kde sources and its third party requirements on MS Windows.

It is written in Python, so you first need to [http://www.python.org/download/ install the Python language].

The latest source code for Emerge and the rest of KDE is stored in a [http://subversion.tigris.org/ Subversion] repository.

To start an emerge-based install, checkout the sources from the svn-directory of emerge into a new directory, which in this example we will call ''kderoot''.
If you have [http://subversion.tigris.org/project_packages.html#windows Subversion command-line tool], you can accomplish this with the following command:
<pre>svn co svn://anonsvn.kde.org/home/kde/trunk/kdesupport/kdewin32/emerge</pre>

Alternatively, you can checkout the sources using a program like [http://tortoisesvn.tigris.org/ TortoiseSVN].

Be sure to use a copy of Subversion that was built on Windows so that checked-out files do not use UNIX line endings. If you check out with UNIX line endings, the ''patch'' program will fail when attempting to apply a patch whose line endings don't match the system's.

Create the directory kderoot\etc. Copy the file '''kderoot\emerge\kdesettings-environment.bat''' to '''kderoot\etc\kdesettings.bat''' and change it according to your needs. Then run it.

You can get 'some' help if you run: <pre>C:\kderoot\emerge\bin>emerge --help</pre>

Below the directory '''kderoot\emerge\portage''' you have the categories as subdirectories which contain individual packages.

To build every required package for e.g. '''kdebase''' enter '''emerge kdebase'''.
If you want to make a dry run, add the option '''-p''' to it.

== What emerge does ==
emerge will fetch Windows versions of numerous UNIX-like utilities and libraries from the Internet, putting them in '''kderoot\bin''', then get the MinGW compiler, then Subversion, then Perl, the Qt libraries, etc.

== Notes ==

emerge is mostly usable together with the kdewin-installer but we're currently still working on some packages which are packaged in a wrong way.
It is not recommended to use another layout then '''installer''' for '''directory_layout''' in the '''kdesettings.bat''' anymore (see that file for more detailed information).

Currently, there is no dependency on MinGW in any of the packages. So, unless you call '''emerge mingw''' manually, or alter the environment configuration scripts to put the path to your MinGW bin directory in the ''PATH'' variable, compiling anything will choke. If you run '''emerge mingw''', you will not need to modify the environment configuration scripts to point to a custom location.

If you see an error about ''cc1plus'' not being found, either add MinGW's ''\libexec\gcc\mingw32\3.4.5'' to your ''PATH'' variable or copy the contents of this directory to MinGW's ''bin'' directory. The prior is preferred.

[[Category:MS Windows]]

Talk:Installing third party softwares in terminal/Build/KDE4/Windows/emerge

2007-11-15T10:08:51Z

Skierpage: Oddness?

please add some more things in the article...

== Oddness? ==

I added to the article. I don't understand the comment about
: "emerge is mostly usable together with the kdewin-installer". I've used the latter to install stuff to C:\KDE4, but I'm using emerge in C:\kderoot.

It doesn't seem to have any dependencies on kdewin-installer, are you saying that it can reuse those packages or the same bin directory? If so presumably I need to make my emerge DOWNLOADDIR (default C:\distfiles) match my kdewin-installer "package download path"

I noticed that kderoot\bin had
libeay32.dll, libiconv2.dll, libintl3.dll, ssleay32.dll
before the win32libs step, but that adds new versions of these to bin.

I notice that kderoot\tmp had 561 MB of stuff in it, can this be removed?

kdesettings.bat is not adding KDEROOT\bin and KDEROOT\lib to my PATH, it's some weirdness with the if test in the batch file.

-- [[User:Skierpage|Skierpage]] 11:08, 15 November 2007 (CET)

Talk:Projects/KDE on Windows/Installation

2007-11-15T09:55:50Z

Skierpage: /* General */

Use this page to record your experiences with KDE on Windows.
Click the + tab and enter <nowiki>~~~~</nowiki> as the subject to add your experiences. Include your installer version.

== [[User:Skierpage|Skierpage]] 07:43, 5 November 2007 (CET) on 2007-11-03 ==
Here's [[User:Skierpage]]'s experience partially installing files with
kdewin-installer-gui-0.8.1-2.exe
on Windows XP SP2.

''Some of my problems were caused by the KDE Installer silently failing to install kdebase bin.''

=== General ===
Each app's Help > Handbook fails to start

Submit Bug Report fails to load anything when you click [Launch Bug Wizard];
nothing displays in Process Monitor or DebugView.

Okular and KStars crashed just after trying to access ksyscoca and then "launching kbuildsycoca4". I ran kbuildsycoca4 by hand and then both applications got further.

My display got garbled, displaying what looks like a backing store of the current window in the top left. This first happened with kolf.exe, then happened to KDE Installer. Closing every K* app seemed to cure it.

=== Specific apps ===
bovo, kblackbox, kgeography pixeltool, etc. worked fine.

==== KStars ====
Looks '''awesome'''. In the list of cities in setup,
accented characters appear incorrectly as multiple characters,
as if the encoding is off. [http://www.skierpage.com/kde_bugs/kstars_setup_bad_chars.png See screenshot.]

When I clicked [Download extra data], it crashes. In DebugView, last thing it tried to do was open ksycoca and then launch kbuildsycoca4.

After running kbuildsycoca4 and restarting, KStars [Download extra data] created a "Get Hot New Stuff", but that window was obscured by both KStars and its wizard. It had a [Close] button but would not accept input. I was able to [Cancel] the KStars setup window, at which point both the KStars and Get Hot New Stuff windows appeared. There was nothing in Get Hot New Stuff for "KStarsAdd On Installer" (sic -- word layout bug), so I clicked [Close].

==== kbuildsycoca4 ====
As this seemed to be causing problems, I ran it myself in a command window. It said "kbuildsycoca4 running..." then exited, seemingly OK.

==== KColorChooser ====
crashes when you choose "Named Colors" from the list.
(It fails to open several .mo files and .js files,
then tries to read rgb.txt from various X11 directories and obviously it's not there,
and then crashes.)

==== kruler ====
kruler's cursor in North or South orientation shows the vertical arrowhead and line but has black and white garbage on the other half of it where the selection point would be.

==== okular ====
First time it started klauncher.exe process but hung without displaying anything.
I killed the okular process and tried again; second time okular crashed; DebugView indicated it was trying to open ksyscoca, and when that failed it tried to launch ksyscocabuilder.exe:
[4644] okular(4644)/kdecore (KSycoca) bool __thiscall KSycocaPrivate::checkDatabase(class QFlags<enum KSycocaPrivate::BehaviorIfNotFound>): We have no database.... launching kbuildsycoca4
After running kbuildsycoca4 by hand okular appeared OK. When I chose File > Open I got an alert
Windows - No Disk
Exception Processing Message c00000013 Parameters ''hex hex hex''
I clicked [Continue] and got this alert again.
I think each time Windows was spinning up my empty floppy or CD-ROM drive.
Then the file dialog appeared but also an alert
Error - okular
The process for the file protocol died unexpectedly.

Meanwhile DebugView showed
[2916] not able to find 'kio_file' because KDEDIRS environment variable is not set.
[2916] Set KDEDIRS to the KDE installation root dir and restart klauncher to fix this problem.

I clicked Root in the file dialog and okular generated a ton of DebugView output in kdecore (KUrl) and then crashed.

I followed the instructions about setting up KDEDIRS, killed klauncher.exe, restarted Okular. I still got errors about No Disk but no more "file protocol death". Howeer, clicking Root in the file dialog still generates a ton of DebugView output and Okular crashes.

Even when I navigate to a folder with .png images in it, Open a document displays nothing. Even if I choose PNG image, it displays nothing. However, if I enter *.png in the Filter, it displays appropriate files.

However, choosing a png file results in okular displaying
Can not find a plugin that is able to handle the passed document
and then an error alert. Same for selecting a *.bmp.

Weirdly, entering *.jpg in the Filter immediately exits okular, with no errors.

==== ktouch ====
Exits, DebugView shows
[3452] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283

==== kbruch ====
The accelerator [Alt+e] for [Next Task] does not work.

==== KDE World Clock ====
Is pitch dark. The tooltip shows current city and add flag works. DebugView shows:
[4524]
[4524] QImage::scaled: Image is a null image
[4524] QPainter::begin: Paint device returned engine == 0, type: 3
[4524] QPainter::setCompositionMode: Painter not active
[4524] QPainter::begin: Paint device returned engine == 0, type: 2

Its context menu has Map Theme > Surface Depth / Flat World / Surface Depth / Flat World , i.e. two entries repeated. Whatever you choose is checked twice.

I can't uncheck Show Daylight, Show Cities, Show Flags in the context menu, they remain checked.

==== kteatime ====
It does display a fabulous notification bubble from the system tray when the tea is ready! Howeer, DebugView indicates "error while contacting knotify server" (I had configured KTeaTime to Play a sound, Show a message in a popup and Mark taskbar entry) :
[6052] kteatime(6052)/kdeui (KNotification) unsigned int __thiscall KNotificationManager::notify(class KNotification *,const class QPixmap &,const class QStringList &,const class QList<struct QPair<class QString,class QString> > &,const class QString &): error while contacting knotify server

==== khangman ====
It put up a dialog towards the back about progress, but unlike earlier app, that completed and it then worked great. I chose to, roughly. get words in a new language, chose France from the dialog/ Get Hot New Stuff showed up and worked but displayed an alert:
Error - KHangMan
Cannot start ''gpg'' and retrieve the available keys. Make sure that ''gpg'' is installed, otherwise verification of the downloaded resources will be impossible.

I installed gpgme and reran khangman, but now Get Hot New Stuff, did not display any categories.

I changed settings to play sounds and it immediately crashed with
[6072] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283

I got around this crash by editing khangmanrc to disable audio.
Still nothing in Get Hot New Stuff.

==== Kig ====
It worked pretty well, I was able to save a .kig file.
It kept prompting
Format not supported - Kig
Kig does not support saving to any other format than its own.
[Save Kig Format] [Cancel]
but if I choose "Save Kig Format" I get the alert again.
Only cancel worked to save the file.

However, when I tried to open that file, the Open dialog displayed its type as "plain text document", opening it led to a "Format Not Supported" alert. DebugView showed:
[5432] kig(5432)/kdecore (KUrl) __thiscall KUrl::KUrl(const class KUrl &): KUrl::KUrl(KUrl) path "" toLocalFile ""
[5432] kig(5432) bool __thiscall KigPart::openFile(void): mimetype: "text/plain"

So there are problems with mime type handling.
(It's scary that mime problems will stop a program from editing a file, how do I force it?)

==== KWordQuiz ====
I was able to download French vocabulary, but when I dismissed it, I got the same alert as KHangMan once displayed
Cannot start gpg and retrieve the available keys. Make sure that gpg is installed.

kdelibs/knewstuff/knewstuff2/core/security.cpp is trying to start gpg in a new KProcess. I don't have `gpg` in my path, I'm not sure what package it's in.

==== KGoldRunner ====
The background appears but none of the tiles, and the icons for them in Create New Game are missing. So some directory is missing, could be <tt>C:\KDE4\share\pixmaps</tt> NAME NOT FOUND, I don't know where the tiles should be.

[[Category: MS Windows]]

Talk:Projects/KDE on Windows/Installation

2007-11-15T08:52:28Z

Skierpage: add KGoldRunner

Use this page to record your experiences with KDE on Windows.
Click the + tab and enter <nowiki>~~~~</nowiki> as the subject to add your experiences. Include your installer version.

== [[User:Skierpage|Skierpage]] 07:43, 5 November 2007 (CET) on 2007-11-03 ==
Here's [[User:Skierpage]]'s experience partially installing files with
kdewin-installer-gui-0.8.1-2.exe
on Windows XP SP2.

''Some of my problems were caused by the KDE Installer silently failing to install kdebase bin.''

=== General ===
Each app's Help fails to start

Submit Bug Report fails to load anything when you click [Launch Bug Wizard];
nothing displays in Process Monitor or DebugView.

Okular and KStars crashed just after trying to access ksyscoca and then "launching kbuildsycoca4". I ran kbuildsycoca4 by hand and then both applications got further.

My display got garbled, displaying what looks like a backing store of the current window in the top left. This first happened with kolf.exe, then happened to KDE Installer. Closing every K* app seemed to cure it.

=== Specific apps ===
bovo, kblackbox, kgeography pixeltool, etc. worked fine.

==== KStars ====
Looks '''awesome'''. In the list of cities in setup,
accented characters appear incorrectly as multiple characters,
as if the encoding is off. [http://www.skierpage.com/kde_bugs/kstars_setup_bad_chars.png See screenshot.]

When I clicked [Download extra data], it crashes. In DebugView, last thing it tried to do was open ksycoca and then launch kbuildsycoca4.

After running kbuildsycoca4 and restarting, KStars [Download extra data] created a "Get Hot New Stuff", but that window was obscured by both KStars and its wizard. It had a [Close] button but would not accept input. I was able to [Cancel] the KStars setup window, at which point both the KStars and Get Hot New Stuff windows appeared. There was nothing in Get Hot New Stuff for "KStarsAdd On Installer" (sic -- word layout bug), so I clicked [Close].

==== kbuildsycoca4 ====
As this seemed to be causing problems, I ran it myself in a command window. It said "kbuildsycoca4 running..." then exited, seemingly OK.

==== KColorChooser ====
crashes when you choose "Named Colors" from the list.
(It fails to open several .mo files and .js files,
then tries to read rgb.txt from various X11 directories and obviously it's not there,
and then crashes.)

==== kruler ====
kruler's cursor in North or South orientation shows the vertical arrowhead and line but has black and white garbage on the other half of it where the selection point would be.

==== okular ====
First time it started klauncher.exe process but hung without displaying anything.
I killed the okular process and tried again; second time okular crashed; DebugView indicated it was trying to open ksyscoca, and when that failed it tried to launch ksyscocabuilder.exe:
[4644] okular(4644)/kdecore (KSycoca) bool __thiscall KSycocaPrivate::checkDatabase(class QFlags<enum KSycocaPrivate::BehaviorIfNotFound>): We have no database.... launching kbuildsycoca4
After running kbuildsycoca4 by hand okular appeared OK. When I chose File > Open I got an alert
Windows - No Disk
Exception Processing Message c00000013 Parameters ''hex hex hex''
I clicked [Continue] and got this alert again.
I think each time Windows was spinning up my empty floppy or CD-ROM drive.
Then the file dialog appeared but also an alert
Error - okular
The process for the file protocol died unexpectedly.

Meanwhile DebugView showed
[2916] not able to find 'kio_file' because KDEDIRS environment variable is not set.
[2916] Set KDEDIRS to the KDE installation root dir and restart klauncher to fix this problem.

I clicked Root in the file dialog and okular generated a ton of DebugView output in kdecore (KUrl) and then crashed.

I followed the instructions about setting up KDEDIRS, killed klauncher.exe, restarted Okular. I still got errors about No Disk but no more "file protocol death". Howeer, clicking Root in the file dialog still generates a ton of DebugView output and Okular crashes.

Even when I navigate to a folder with .png images in it, Open a document displays nothing. Even if I choose PNG image, it displays nothing. However, if I enter *.png in the Filter, it displays appropriate files.

However, choosing a png file results in okular displaying
Can not find a plugin that is able to handle the passed document
and then an error alert. Same for selecting a *.bmp.

Weirdly, entering *.jpg in the Filter immediately exits okular, with no errors.

==== ktouch ====
Exits, DebugView shows
[3452] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283

==== kbruch ====
The accelerator [Alt+e] for [Next Task] does not work.

==== KDE World Clock ====
Is pitch dark. The tooltip shows current city and add flag works. DebugView shows:
[4524]
[4524] QImage::scaled: Image is a null image
[4524] QPainter::begin: Paint device returned engine == 0, type: 3
[4524] QPainter::setCompositionMode: Painter not active
[4524] QPainter::begin: Paint device returned engine == 0, type: 2

Its context menu has Map Theme > Surface Depth / Flat World / Surface Depth / Flat World , i.e. two entries repeated. Whatever you choose is checked twice.

I can't uncheck Show Daylight, Show Cities, Show Flags in the context menu, they remain checked.

==== kteatime ====
It does display a fabulous notification bubble from the system tray when the tea is ready! Howeer, DebugView indicates "error while contacting knotify server" (I had configured KTeaTime to Play a sound, Show a message in a popup and Mark taskbar entry) :
[6052] kteatime(6052)/kdeui (KNotification) unsigned int __thiscall KNotificationManager::notify(class KNotification *,const class QPixmap &,const class QStringList &,const class QList<struct QPair<class QString,class QString> > &,const class QString &): error while contacting knotify server

==== khangman ====
It put up a dialog towards the back about progress, but unlike earlier app, that completed and it then worked great. I chose to, roughly. get words in a new language, chose France from the dialog/ Get Hot New Stuff showed up and worked but displayed an alert:
Error - KHangMan
Cannot start ''gpg'' and retrieve the available keys. Make sure that ''gpg'' is installed, otherwise verification of the downloaded resources will be impossible.

I installed gpgme and reran khangman, but now Get Hot New Stuff, did not display any categories.

I changed settings to play sounds and it immediately crashed with
[6072] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283

I got around this crash by editing khangmanrc to disable audio.
Still nothing in Get Hot New Stuff.

==== Kig ====
It worked pretty well, I was able to save a .kig file.
It kept prompting
Format not supported - Kig
Kig does not support saving to any other format than its own.
[Save Kig Format] [Cancel]
but if I choose "Save Kig Format" I get the alert again.
Only cancel worked to save the file.

However, when I tried to open that file, the Open dialog displayed its type as "plain text document", opening it led to a "Format Not Supported" alert. DebugView showed:
[5432] kig(5432)/kdecore (KUrl) __thiscall KUrl::KUrl(const class KUrl &): KUrl::KUrl(KUrl) path "" toLocalFile ""
[5432] kig(5432) bool __thiscall KigPart::openFile(void): mimetype: "text/plain"

So there are problems with mime type handling.
(It's scary that mime problems will stop a program from editing a file, how do I force it?)

==== KWordQuiz ====
I was able to download French vocabulary, but when I dismissed it, I got the same alert as KHangMan once displayed
Cannot start gpg and retrieve the available keys. Make sure that gpg is installed.

kdelibs/knewstuff/knewstuff2/core/security.cpp is trying to start gpg in a new KProcess. I don't have `gpg` in my path, I'm not sure what package it's in.

==== KGoldRunner ====
The background appears but none of the tiles, and the icons for them in Create New Game are missing. So some directory is missing, could be <tt>C:\KDE4\share\pixmaps</tt> NAME NOT FOUND, I don't know where the tiles should be.

[[Category: MS Windows]]

Getting Started/Build/Windows/emerge

2007-11-15T07:04:13Z

Skierpage: clarify some points

emerge is a tool to build the kde sources and its third party requirements on MS Windows.

It is written in Python, so you first need to [http://www.python.org/download/ install the Python language].

The latest source code for Emerge and the rest of KDE is stored in a [http://subversion.tigris.org/ Subversion] repository.

To start an emerge-based install, checkout the sources from the svn-directory of emerge into a new directory, which in this example we will call ''kderoot''.
If you have [http://subversion.tigris.org/project_packages.html#windows Subversion command-line tool], you can accomplish this with the following command:
<pre>svn co svn://anonsvn.kde.org/home/kde/trunk/kdesupport/kdewin32/emerge</pre>

Alternatively, you can checkout the sources using a program like [http://tortoisesvn.tigris.org/ TortoiseSVN].

Be sure to use a copy of Subversion that was built on Windows so that checked-out files do not use UNIX line endings. If you check out with UNIX line endings, the ''patch'' program will fail when attempting to apply a patch whose line endings don't match the system's.

Create the directory kderoot\etc. Copy the file '''kderoot\emerge\kdesettings-environment.bat''' to '''kderoot\etc\kdesettings.bat''' and change it according to your needs. Then run it.

You can get 'some' help if you run: <pre>C:\kderoot\emerge\bin>emerge --help</pre>

Below the directory '''kderoot\emerge\portage''' you have the categories as subdirectories which contain individual packages.

To build every required package for e.g. '''kdebase''' enter '''emerge kdebase'''.
If you want to make a dry run, add the option '''-p''' to it.

emerge is mostly usable together with the kdewin-installer but we're currently still working on some packages which are packaged in a wrong way.
It is not recommended to use another layout then '''installer''' for '''directory_layout''' in the '''kdesettings.bat''' anymore (see that file for more detailed information).

Currently, there is no dependency on MinGW in any of the packages. So, unless you call '''emerge mingw''' manually, or alter the environment configuration scripts to put the path to your MinGW bin directory in the ''PATH'' variable, compiling anything will choke. If you run '''emerge mingw''', you will not need to modify the environment configuration scripts to point to a custom location.

If you see an error about ''cc1plus'' not being found, either add MinGW's ''\libexec\gcc\mingw32\3.4.5'' to your ''PATH'' variable or copy the contents of this directory to MinGW's ''bin'' directory. The prior is preferred.

[[Category:MS Windows]]

Talk:Projects/KDE on Windows/Installation

2007-11-07T06:58:05Z

Skierpage: /* Skierpage 07:43, 5 November 2007 (CET) on 2007-11-03 */ updates

Use this page to record your experiences with KDE on Windows.
Click the + tab and enter <nowiki>~~~~</nowiki> as the subject to add your experiences. Include your installer version.

== [[User:Skierpage|Skierpage]] 07:43, 5 November 2007 (CET) on 2007-11-03 ==
Here's [[User:Skierpage]]'s experience partially installing files with
kdewin-installer-gui-0.8.1-2.exe
on Windows XP SP2.

''Some of my problems were caused by the KDE Installer silently failing to install kdebase bin.''

=== General ===
Each app's Help fails to start

Submit Bug Report fails to load anything when you click [Launch Bug Wizard];
nothing displays in Process Monitor or DebugView.

Okular and KStars crashed just after trying to access ksyscoca and then "launching kbuildsycoca4". I ran kbuildsycoca4 by hand and then both applications got further.

My display got garbled, displaying what looks like a backing store of the current window in the top left. This first happened with kolf.exe, then happened to KDE Installer. Closing every K* app seemed to cure it.

=== Specific apps ===
bovo, kblackbox, kgeography pixeltool, etc. worked fine.

==== KStars ====
Looks '''awesome'''. In the list of cities in setup,
accented characters appear incorrectly as multiple characters,
as if the encoding is off. [http://www.skierpage.com/kde_bugs/kstars_setup_bad_chars.png See screenshot.]

When I clicked [Download extra data], it crashes. In DebugView, last thing it tried to do was open ksycoca and then launch kbuildsycoca4.

After running kbuildsycoca4 and restarting, KStars [Download extra data] created a "Get Hot New Stuff", but that window was obscured by both KStars and its wizard. It had a [Close] button but would not accept input. I was able to [Cancel] the KStars setup window, at which point both the KStars and Get Hot New Stuff windows appeared. There was nothing in Get Hot New Stuff for "KStarsAdd On Installer" (sic -- word layout bug), so I clicked [Close].

==== kbuildsycoca4 ====
As this seemed to be causing problems, I ran it myself in a command window. It said "kbuildsycoca4 running..." then exited, seemingly OK.

==== KColorChooser ====
crashes when you choose "Named Colors" from the list.
(It fails to open several .mo files and .js files,
then tries to read rgb.txt from various X11 directories and obviously it's not there,
and then crashes.)

==== kruler ====
kruler's cursor in North or South orientation shows the vertical arrowhead and line but has black and white garbage on the other half of it where the selection point would be.

==== okular ====
First time it started klauncher.exe process but hung without displaying anything.
I killed the okular process and tried again; second time okular crashed; DebugView indicated it was trying to open ksyscoca, and when that failed it tried to launch ksyscocabuilder.exe:
[4644] okular(4644)/kdecore (KSycoca) bool __thiscall KSycocaPrivate::checkDatabase(class QFlags<enum KSycocaPrivate::BehaviorIfNotFound>): We have no database.... launching kbuildsycoca4
After running kbuildsycoca4 by hand okular appeared OK. When I chose File > Open I got an alert
Windows - No Disk
Exception Processing Message c00000013 Parameters ''hex hex hex''
I clicked [Continue] and got this alert again.
I think each time Windows was spinning up my empty floppy or CD-ROM drive.
Then the file dialog appeared but also an alert
Error - okular
The process for the file protocol died unexpectedly.

Meanwhile DebugView showed
[2916] not able to find 'kio_file' because KDEDIRS environment variable is not set.
[2916] Set KDEDIRS to the KDE installation root dir and restart klauncher to fix this problem.

I clicked Root in the file dialog and okular generated a ton of DebugView output in kdecore (KUrl) and then crashed.

I followed the instructions about setting up KDEDIRS, killed klauncher.exe, restarted Okular. I still got errors about No Disk but no more "file protocol death". Howeer, clicking Root in the file dialog still generates a ton of DebugView output and Okular crashes.

Even when I navigate to a folder with .png images in it, Open a document displays nothing. Even if I choose PNG image, it displays nothing. However, if I enter *.png in the Filter, it displays appropriate files.

However, choosing a png file results in okular displaying
Can not find a plugin that is able to handle the passed document
and then an error alert. Same for selecting a *.bmp.

Weirdly, entering *.jpg in the Filter immediately exits okular, with no errors.

==== ktouch ====
Exits, DebugView shows
[3452] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283

==== kbruch ====
The accelerator [Alt+e] for [Next Task] does not work.

==== KDE World Clock ====
Is pitch dark. The tooltip shows current city and add flag works. DebugView shows:
[4524]
[4524] QImage::scaled: Image is a null image
[4524] QPainter::begin: Paint device returned engine == 0, type: 3
[4524] QPainter::setCompositionMode: Painter not active
[4524] QPainter::begin: Paint device returned engine == 0, type: 2

Its context menu has Map Theme > Surface Depth / Flat World / Surface Depth / Flat World , i.e. two entries repeated. Whatever you choose is checked twice.

I can't uncheck Show Daylight, Show Cities, Show Flags in the context menu, they remain checked.

==== kteatime ====
It does display a fabulous notification bubble from the system tray when the tea is ready! Howeer, DebugView indicates "error while contacting knotify server" (I had configured KTeaTime to Play a sound, Show a message in a popup and Mark taskbar entry) :
[6052] kteatime(6052)/kdeui (KNotification) unsigned int __thiscall KNotificationManager::notify(class KNotification *,const class QPixmap &,const class QStringList &,const class QList<struct QPair<class QString,class QString> > &,const class QString &): error while contacting knotify server

==== khangman ====
It put up a dialog towards the back about progress, but unlike earlier app, that completed and it then worked great. I chose to, roughly. get words in a new language, chose France from the dialog/ Get Hot New Stuff showed up and worked but displayed an alert:
Error - KHangMan
Cannot start ''gpg'' and retrieve the available keys. Make sure that ''gpg'' is installed, otherwise verification of the downloaded resources will be impossible.

I installed gpgme and reran khangman, but now Get Hot New Stuff, did not display any categories.

I changed settings to play sounds and it immediately crashed with
[6072] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283

I got around this crash by editing khangmanrc to disable audio.
Still nothing in Get Hot New Stuff.

==== Kig ====
It worked pretty well, I was able to save a .kig file.
It kept prompting
Format not supported - Kig
Kig does not support saving to any other format than its own.
[Save Kig Format] [Cancel]
but if I choose "Save Kig Format" I get the alert again.
Only cancel worked to save the file.

However, when I tried to open that file, the Open dialog displayed its type as "plain text document", opening it led to a "Format Not Supported" alert. DebugView showed:
[5432] kig(5432)/kdecore (KUrl) __thiscall KUrl::KUrl(const class KUrl &): KUrl::KUrl(KUrl) path "" toLocalFile ""
[5432] kig(5432) bool __thiscall KigPart::openFile(void): mimetype: "text/plain"

So there are problems with mime type handling.
(It's scary that mime problems will stop a program from editing a file, how do I force it?)

==== KWordQuiz ====
I was able to download French vocabulary, but when I dismissed it, I got the same alert as KHangMan once displayed
Cannot start gpg and retrieve the available keys. Make sure that gpg is installed.

kdelibs/knewstuff/knewstuff2/core/security.cpp is trying to start gpg in a new KProcess. I don't have `gpg` in my path, I'm not sure what package it's in.

[[Category: MS Windows]]

Projects/KDE on Windows/Installation

2007-11-06T22:52:03Z

Skierpage: explain corrupted download issue better

Projects/KDE on Windows/Installation

2007-11-06T22:26:09Z

Skierpage: /* Download needed packages */ add kdebase

Talk:Projects/Documentation/KDE4

2007-11-06T21:49:46Z

Skierpage: Update http://docs.kde.org/ ?!

I wanted do add a link to the style guide. Is this the most recent version?
http://l10n.kde.org/docs/styleguide/index.html

---[[User:Cbs|Cbs]]

== Update http://docs.kde.org/ ?! ==

I'm getting started with KDE4. I just want to know what KDED4 is, or what KTeaTime does. There is a http://docs.kde.org/ but it makes '''no reference''' to KDE4 at all. Please someone add something at that web site for people trying to use KDE4, even if it's just
: This is only for the current KDE 3.5 series of releases. KDE4 users, see X Y Z.

And I think similar disclaimers belong in prominent documents there like "An Introduction to KDE" and "The KDE User Guide". Those do not reference a KDE version at all.

Is http://docs.kde.org/ going to be updated for KDE4? It's great to have all the handbooks and such online. -- [[User:Skierpage|Skierpage]] 22:49, 6 November 2007 (CET)

Talk:Projects/KDE on Windows/Installation

2007-11-06T05:19:57Z

Skierpage: /* Specific apps */ khangman

Use this page to record your experiences with KDE on Windows.
Click the + tab and enter <nowiki>~~~~</nowiki> as the subject to add your experiences. Include your installer version.

== [[User:Skierpage|Skierpage]] 07:43, 5 November 2007 (CET) on 2007-11-03 ==
Here's [[User:Skierpage]]'s experience partially installing files with
kdewin-installer-gui-0.8.1-2.exe
on Windows XP SP2.

=== General ===
Each app's Help fails to start

Most (all?) apps print ''"[2180] kmahjongg(2180)/kdecore (KIconLoader): Error: standard icon theme "oxygen" not found!"'' in DebugView.
Prior to this alert ProcessView shows
20910 10:25:18.5194281 PM kruler.exe 3792 QueryOpen C:\Documents and Settings\S Page\.kde\share\apps\kruler\icons\oxygen PATH NOT FOUND
20911 10:25:18.5195058 PM kruler.exe 3792 QueryOpen C:\KDE4\share\apps\kruler\icons\oxygen PATH NOT FOUND
However I do have a C:\KDE4\share\icons\oxygen directory.

The app toolbar in KMahjongg and Kolf is too tall (but that's probably the missing oxygen icons!), see [http://www.skierpage.com/kde_bugs/kmahjongg_tall_toolbar.png screenshot].

Submit Bug Report fails to load anything when you click [Launch Bug Wizard];
nothing displays in Process Monitor or DebugView.

Okular and KStars crashed just after trying to access ksyscoca and then "launching kbuildsycoca4". I ran kbuildsycoca4 by hand and then both applications got further.

My display got garbled, displaying what looks like a backing store of the current window in the top left. This first happened with kolf.exe, then happened to KDE Installer. Closing every K* app seemed to cure it.

=== Specific apps ===
bovo, kblackbox, kgeography pixeltool, etc. worked fine.

==== KStars ====
Looks '''awesome'''. In the list of cities in setup,
accented characters appear incorrectly as multiple characters,
as if the encoding is off. [http://www.skierpage.com/kde_bugs/kstars_setup_bad_chars.png See screenshot.]

When I clicked [Download extra data], it crashes. In DebugView, last thing it tried to do was open ksycoca and then launch kbuildsycoca4.

After running kbuildsycoca4 and restarting, KStars [Download extra data] created a "Get Hot New Stuff", but that window was obscured by both KStars and its wizard. It had a [Close] button but would not accept input. I was able to [Cancel] the KStars setup window, at which point both the KStars and Get Hot New Stuff windows appeared. There was nothing in Get Hot New Stuff for "KStarsAdd On Installer" (sic -- word layout bug), so I clicked [Close].

==== kbuildsycoca4 ====
As this seemed to be causing problems, I ran it myself in a command window. It said "kbuildsycoca4 running..." then exited, seemingly OK.

==== KColorChooser ====
crashes when you choose "Named Colors" from the list.
(It fails to open several .mo files and .js files,
then tries to read rgb.txt from various X11 directories and obviously it's not there,
and then crashes.)

==== kruler ====
kruler's cursor in North or South orientation shows the vertical arrowhead and line but has black and white garbage on the other half of it where the selection point would be.

==== okular ====
First time it started klauncher.exe process but hung without displaying anything.
I killed the okular process and tried again; second time okular crashed; DebugView indicated it was trying to open ksyscoca, and when that failed it tried to launch ksyscocabuilder.exe:
[4644] okular(4644)/kdecore (KSycoca) bool __thiscall KSycocaPrivate::checkDatabase(class QFlags<enum KSycocaPrivate::BehaviorIfNotFound>): We have no database.... launching kbuildsycoca4
After running kbuildsycoca4 by hand okular appeared OK. When I chose File > Open I got an alert
Windows - No Disk
Exception Processing Message c00000013 Parameters ''hex hex hex''
I clicked [Continue] and got this alert again.
I think each time Windows was spinning up my empty floppy or CD-ROM drive.
Then the file dialog appeared but also an alert
Error - okular
The process for the file protocol died unexpectedly.

Meanwhile DebugView showed
[2916] not able to find 'kio_file' because KDEDIRS environment variable is not set.
[2916] Set KDEDIRS to the KDE installation root dir and restart klauncher to fix this problem.

I clicked Root in the file dialog and okular generated a ton of DebugView output in kdecore (KUrl) and then crashed.

I followed the instructions about setting up KDEDIRS, killed klauncher.exe, restarted Okular. I still got errors about No Disk but no more "file protocol death". Howeer, clicking Root in the file dialog still generates a ton of DebugView output and Okular crashes.

Even when I navigate to a folder with .png images in it, Open a document displays nothing. Even if I choose PNG image, it displays nothing. However, if I enter *.png in the Filter, it displays appropriate files.

However, choosing a png file results in okular displaying
Can not find a plugin that is able to handle the passed document
and then an error alert. Same for selecting a *.bmp.

Weirdly, entering *.jpg in the Filter immediately exits okular, with no errors.

==== ktouch ====
Exits, DebugView shows
[3452] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283

==== kbruch ====
The accelerator [Alt+e] for [Next Task] does not work.

==== KDE World Clock ====
Is pitch dark. The tooltip shows current city and add flag works. DebugView shows:
[4524]
[4524] QImage::scaled: Image is a null image
[4524] QPainter::begin: Paint device returned engine == 0, type: 3
[4524] QPainter::setCompositionMode: Painter not active
[4524] QPainter::begin: Paint device returned engine == 0, type: 2

Its context menu has Map Theme > Surface Depth / Flat World / Surface Depth / Flat World , i.e. two entries repeated. Whatever you choose is checked twice.

I can't uncheck Show Daylight, Show Cities, Show Flags in the context menu, they remain checked.

==== kteatime ====
Does not display anything, although it does make space for itself in my system tray area. DebugView shows:
[6052] kteatime(6052)/kdecore (KIconLoader): Error: standard icon theme "oxygen" not found!
[6052]
[6052] QSystemTrayIcon::setVisible: No Icon set

When I turn it on, DebugView displays two new lines every few seconds:
[6052] QPainter::begin: Paint device returned engine == 0, type: 2
[6052] QPainter::setRenderHint: Painter must be active to set rendering hints

It does display a fabulous notification bubble from the system tray when the tea is ready! Howeer, DebugView indicates "error while contacting knotify server" (I had configured KTeaTime to Play a sound, Show a message in a popup and Mark taskbar entry) :
[6052] kteatime(6052)/kdeui (KNotification) unsigned int __thiscall KNotificationManager::notify(class KNotification *,const class QPixmap &,const class QStringList &,const class QList<struct QPair<class QString,class QString> > &,const class QString &): error while contacting knotify server

==== khangman ====
It put up a dialog towards the back about progress, but unlike earlier app, that completed and it then worked great. I chose to, roughly. get words in a new language, chose France from the dialog/ Get Hot New Stuff showed up and worked but displayed an alert:
Error - KHangMan
Cannot start ''gpg'' and retrieve the available keys. Make sure that ''gpg'' is installed, otherwise verification of the downloaded resources will be impossible.

I installed gpgme and reran khangman, but now it hung at Get Hot New Stuff, it did not display any categories.

I changed settings to play sounds and it immediately crashed with
[6072] ASSERT failure in class Phonon::PlatformPlugin *__thiscall Phonon::FactoryPrivate::platformPlugin(void): "The plugin 'C:/KDE4/lib/kde4/plugins/phonon_platform/kde.dll' uses incompatible Qt library. (Cannot mix debug and release libraries.)", file D:\kde-msvc\tmp\kdelibs-beta4-3.95.1.20071029\work\kdelibs\phonon\factory.cpp, line 283

[[Category: MS Windows]]

Talk:Projects/KDE on Windows/Installation

2007-11-06T05:03:36Z

Skierpage: /* Specific apps */ kblackbox fine!

Talk:Projects/KDE on Windows/Installation

2007-11-06T04:43:19Z

Skierpage: /* kteatime */ error at notify time

Talk:Projects/KDE on Windows/Installation

2007-11-06T04:38:19Z

Skierpage: /* Specific apps */ KTeaTime

Talk:Projects/KDE on Windows/Installation

2007-11-06T04:27:38Z

Skierpage: /* kbruch */ forgot closing tag

Talk:Projects/KDE on Windows/Installation

2007-11-06T04:25:35Z

Skierpage: /* Specific apps */ add KDE World Clock

Projects/KDE on Windows/Installation

2007-11-06T02:38:33Z

Skierpage: /* Download needed packages */ notes from Ben Aceler

Talk:Projects/KDE on Windows/Installation

2007-11-06T02:11:57Z

Skierpage: /* Specific apps */ kbruch

Projects/KDE on Windows/Installation

2007-11-06T02:08:11Z

Skierpage: /* Summary of Steps */ add KDEDIRS

Projects/KDE on Windows/Installation

2007-11-06T01:57:16Z

Skierpage: /* Status */ note No Disk alert

Talk:Projects/KDE on Windows/Installation

2007-11-05T12:18:50Z

Skierpage: ktouch, working apps

Projects/KDE on Windows

2007-11-05T10:43:33Z

Skierpage: /* Communications */ add SVN link

[[Image:Konqi-win.png|frame|right|Konqi, the KDE mascot now also supporting MS Windows]]"''KDE libraries and applications are available to you, no matter you are commercial developer, manager or free software hacker. You are invited not only just use the toolkit - you can contribute your own solutions and improvements to the KDE community.''"

==Overview==
*[http://windows.kde.org windows.kde.org]
*[[/Presentations|Presentations]]

==Resources==
*[https://mail.kde.org/mailman/listinfo/kde-windows kde-windows mailing list]
*[irc://irc.freenode.net/kde-windows #kde-windows channel on irc.freenode.net]
*[http://websvn.kde.org/trunk/kdesupport/kdewin32/ kdewin32 code in Subversion]

==Development==
*[[/Meetings|Meetings]]
*[[Getting_Started/Build/KDE4/Windows|Build KDE 4 on Windows]]
*[[/Running|Run KDE 4 on Windows]] using the KDE Installer for Windows

==Other Web Sites==
*http://kdelibs.com (former KDElibs/windows site, now aimed at ISVs)

[[Category:MS Windows]]

Projects/KDE on Windows

2007-11-05T09:43:11Z

Skierpage: links to IRC and mailing list

[[Image:Konqi-win.png|frame|right|Konqi, the KDE mascot now also supporting MS Windows]]"''KDE libraries and applications are available to you, no matter you are commercial developer, manager or free software hacker. You are invited not only just use the toolkit - you can contribute your own solutions and improvements to the KDE community.''"

==Overview==
*[http://windows.kde.org windows.kde.org]
*[[/Presentations|Presentations]]

==Communications==
*[https://mail.kde.org/mailman/listinfo/kde-windows kde-windows mailing list]
*[irc://irc.freenode.net/kde-windows #kde-windows channel on irc.freenode.net]

==Development==
*[[/Meetings|Meetings]]
*[[Getting_Started/Build/KDE4/Windows|Build KDE 4 on Windows]]
*[[/Running|Run KDE 4 on Windows]] using the KDE Installer for Windows

==Other Web Sites==
*http://kdelibs.com (former KDElibs/windows site, now aimed at ISVs)

[[Category:MS Windows]]

Projects/KDE on Windows/Installation

2007-11-05T08:09:41Z

Skierpage: /* Summary of Steps */ details of editing PATH

== KDE Installer for Windows ==
You can use this installer to download and install the
various binary packages that you need to run KDE applications on MS Windows.
KDE is free and open source so you can build all the applications "from scratch" from their source code;
but as a convenience for others,
volunteers create these precompiled packages and make them available on the Internet.

'''Disclaimer''' These are early days for KDE4 on Windows,
some programs work better than others and some fail to run altogether.

You can also use the KDE Installer for Windows to install source code and the packages that you need to ''build'' KDE4 on Windows
(although if you are building KDE4 on Windows you may prefer to use the emerge system to build KDE and its requirements from latest source);
see [[Getting Started/Build/KDE4/Windows]].

=== Summary of Steps ===
* Visit http://download.cegit.de/kde-windows/installer
* Download and save the latest version to a directory, e.g. <tt>C:\KDE4</tt>
* Run the installer, download what you need (see [[#Download needed packages]] below).
* Add your lib directory, e.g. <tt>C:\KDE4\lib</tt> to your Windows %PATH%. (Start > Control Panel > System > Advanced > Environment Variables, double-click the Path System Variable and this to your path separated by semicolon.)
* Try running a Qt application in the <tt>bin</tt> directory, such as linguist.exe
* If that works, try running a KDE application such as <tt>kruler.exe</tt>.

=== Download needed packages ===
A single program in the The K Desktop Environment depends on many other libraries and packages; that is why each .exe is comparatively small.
The KDE Installer for Windows has some awareness of dependencies,
but not complete.
So, the first few times you try to run an application you may see alerts about missing DLLs.

If you do not intend to build from source, do not click "all" and do not click "src", as you do not need to download the source for each package. ''Unclear whether you need lib for each''.

There are two development systems for KDE on Windows,
Microsoft's Visual C and [http://en.wikipedia.org/wiki/MinGW|MinGW].
Even if you are only running binaries and do not intend to build KDE4 yourself,
you need to choose between these.
As of October 2007, the former is more stable, so when you have a choice of packages in the KDE Installer for Windows, prefer the -msvc version.

The KDE programs themselves are organized into several groups: kdeedu, kdegames, and kdegraphics.

Here are some of the minimal packages you need to run a KDE application:
: dbus-msvc, kdewin32-msvc, qt-msvc, vcredist, ??

The Dependencies tab for a particular package lists some of the additional packages it needs.
[[Getting_Started/Build/KDE4/Windows/3rd-party_libraries]] is a more complete list.

== Testing your installation ==
Navigate to the <tt>bin</tt> directory.

See if you can run the Qt program assistant.exe.
Qt programs have fewer dependencies than a full-blown KDE application.

If that works, try running a simple KDE application, such as kruler.exe from the kdegraphics package.

The first KDE application you run will start a console window in order to run the [http://en.wikipedia.org/wiki/D-Bus D-Bus daemon].

== Status ==

Using the kdewin-installer-gui-0.8.1-2.exe to install packages, dbus-daemon.exe starts up, and many games run.

It seems running kbuildsycoca4.exe by hand helps applications like KStars and Okular to run.

There are problems with the file dialog.

''Perhaps actual developers should summarize status of KDE4 on Windows here, while we encourage users to describe their experiences on the [[Talk:{{PAGENAME}}|Talk page?]]''

[[Category: MS Windows]]