Difference between revisions of "Projects/Marble/NewMarbleMoldules"

Latest revision as of 21:57, 29 June 2011

We want to simplify packaging and maintenance of Marble. And we want to make it easier for KDE application authors to link against the marble library by getting rid of a kde-edu dependency.

So starting with KDE 4.5 the Marble source code is supposed to be reorganized:

[edit] Marble Qt Library

It's Qt Only. No KDE dependencies.
Contains the actual Marble library in the package "libmarble". "libmarble" should contain the essentail graphics which are necessary to display stuff graciously. Therefore Graphics inside "libmarble" should include such as the current directories data/svg, data/mwdbii, data/icons, data/ico, data/bitmaps and dgml file and the level zero tiles of the maps: Atlas, Satellite, OSM and Plain Map. libmarble should contain all base plugins. The package libmarble should recommend installation of the package libmarble-data.
Contains the recommended base data in the package libmarble-data. This includes the data of the most basic maps: Atlas, Satellite, OSM and Plain Map. Specifically "libmarble-data" should contain the current directories data/flags, data/weather and data/stars. libmarble-data should depend on libmarble.
Provides the Marble Qt application (Executable: "marbleqt") as an example application in the package marbleqt (Compilation of this part can be switched off at wish). The package marbleqt is optional. The package marbleqt should depend on libmarble and libmarble-data.
Located in SVN at
```
kdesupport/libmarble
```
.
Provides Qt development documentation, bindings and tools for Marble in the package libmarble-dev. This package is optional.

[edit] Marble KDE application

Depends on Marble Qt library (in kdesupport/libmarble).
Provides the Marble Application (Executable"marble"). Suggested package name: kdeedu-marble. kde-edu-marble depends on libmarble and libmarble-data.
Provides the KPart. Actual location of this part in SVN needs to be evaluated for best reuse.
Provides optional data ( Moon, Historical Map, Precipitation, Temperature, etc.) in the package kdeedu-marble-data. This package is optional.
Located in SVN at
```
kdeedu/marble
```

[edit] Other

What should happen to the worldclock plasmoid? Move it to the other KDE plasmoids (which would depend on libmarble inside kdesupport).

[edit] Migration Plan

1. Jens-Michael ("jmho") starts to get rid of QTONLY in MarbleDirs.

2. Get rid of all the kde specific cmake code below marble/src/lib (no "if (QTONLY)" anymore)

@@ Line 1: / Line 1: @@
-Starting with KDE 4.5 the Marble source code is supposed to be reorganized:
+We want to simplify packaging and maintenance of Marble. And we want to make it easier for KDE application authors to link against the marble library by getting rid of a kde-edu dependency.
+So starting with KDE 4.5 the Marble source code is supposed to be reorganized:
 ==Marble Qt Library==
-* It's Qt-Only.
+* It's <b>Qt Only</b>. No KDE dependencies.
-* Contains the actual Marble library. Suggested package name: "libmarble".
+* Contains the actual Marble library in the package "<b>libmarble</b>". "libmarble" should contain the essentail graphics which are necessary to display stuff graciously. Therefore Graphics inside "libmarble" should include such as the current directories <i>data/svg, data/mwdbii, data/icons, data/ico, data/bitmaps</i> and <i>dgml file</i> and the <i>level zero tiles</i> of the maps: <i>Atlas</i>, <i>Satellite</i>, <i>OSM</i> and <i>Plain Map</i>. <i>libmarble</i> should contain all base <i>plugins</i>. The package <b>libmarble</b> should <b>recommend</b> installation of the package <b>libmarble-data</b>.
-* Contains the base data. This includes the most basic maps: Atlas, Satellite, OSM and Plain Map. Suggested package name: "libmarble-data".
+* Contains the recommended base data in the package <b>libmarble-data</b>. This includes the data of the most basic maps: <i>Atlas</i>, <i>Satellite</i>, <i>OSM</i> and <i>Plain Map</i>. Specifically "libmarble-data" should contain the current directories <i>data/flags, data/weather and data/stars</i>. <i>libmarble-data</i> should <b>depend</b> on <i>libmarble</i>.
-* Provides the Marble Qt application (Executable: "marbleqt") as an example application (Compilation of this part can be switched off at wish).
+* Provides the Marble Qt application (Executable: "<i>marbleqt</i>") as an example application in the package <b>marbleqt</b> (Compilation of this part can be switched off at wish). The package marbleqt is optional. The package <b>marbleqt</b> should <b>depend</b> on <b>libmarble</b> and <b>libmarble-data</b>.
-* Located in SVN at kdesupport/libmarble
+* Located in SVN at <syntaxhighlight lang="text">kdesupport/libmarble</syntaxhighlight>.
-* Provides Qt development documentation, bindings and tools for Marble. Suggested package name: libmarble-dev).
+* Provides Qt development documentation, bindings and tools for Marble in the package <b>libmarble-dev</b>. This package is optional.
 ==Marble KDE application==
-* Provides the Marble Application (Executable"marble"). Suggested package name: kdeedu-marble.
+* Depends on Marble Qt library (in kdesupport/libmarble).
-* Provides KPart. Actual location of this part in SVN needs to be evaluated for best reuse.
+* Provides the Marble Application (Executable"marble"). Suggested package name: <b>kdeedu-marble</b>. <b>kde-edu-marble</b> <b>depends</b> on <b>libmarble</b> and <b>libmarble-data</b>.
-* Provides optional data ( Moon, Historical Map, Precipitation, Temperature, etc.)
+* Provides the KPart. Actual location of this part in SVN needs to be evaluated for best reuse.
-* Located in SVN at kdeedu/marble
+* Provides optional data ( <i>Moon</i>, <i>Historical Map</i>, <i>Precipitation</i>, <i>Temperature</i>, etc.) in the package <b>kdeedu-marble-data</b>. This package is <b>optional</b>.
+* Located in SVN at <syntaxhighlight lang="text">kdeedu/marble</syntaxhighlight>
+==Other==
+* What should happen to the worldclock plasmoid? Move it to the other KDE plasmoids (which would depend on libmarble inside kdesupport).
+==Migration Plan==
+. Jens-Michael ("jmho") starts to get rid of QTONLY in MarbleDirs.
+. Get rid of all the kde specific cmake code below marble/src/lib (no "if (QTONLY)" anymore)