Projects/KNS2/Handler - Revision history

Ruphy: /* Proposed API */

2007-03-24T18:05:35Z

‎Proposed API

Ruphy: /* Proposed API */

2007-03-15T09:03:34Z

‎Proposed API

Ruphy: /* Proposed API */

2007-03-15T09:02:51Z

‎Proposed API

Ruphy: /* Proposed API */

2007-03-15T08:39:50Z

‎Proposed API

Ruphy at 08:39, 15 March 2007

2007-03-15T08:39:30Z

Ruphy at 20:29, 14 March 2007

2007-03-14T20:29:43Z

Ruphy: /* The Bundler */

2007-03-14T20:28:17Z

‎The Bundler

Ruphy: Projects/KNS2/Bundler moved to Projects/KNS2/Handler: much more appropriate name

2007-03-14T20:27:58Z

Projects/KNS2/Bundler moved to Projects/KNS2/Handler: much more appropriate name

Ruphy at 11:02, 14 March 2007

2007-03-14T11:02:08Z

Ruphy at 10:53, 14 March 2007

2007-03-14T10:53:08Z

← Older revision		Revision as of 18:05, 24 March 2007
Line 16:		Line 16:
	* '''install()''' Extracts (installs) the package, and puts the .desktop file in $KDEHOME/services/. See [[../Layout\|here]] for more informations.		* '''install()''' Extracts (installs) the package, and puts the .desktop file in $KDEHOME/services/. See [[../Layout\|here]] for more informations.

−	* '''''QString author()''' Returns a pluginInfo object. You can retrive most of the metadata from it.''' <- check with KNS::Entry
−	* similar methods to retrive all the rest of the metadata, icon included.

	* '''initLayout()''' Initializes the layout app-wise. It should be called only once. It will use KStandardDirs::saveLocation() to create needed dirs. See [[../Layout\|the layout section]] for more informations.		* '''initLayout()''' Initializes the layout app-wise. It should be called only once. It will use KStandardDirs::saveLocation() to create needed dirs. See [[../Layout\|the layout section]] for more informations.

@@ Line 19: / Line 19: @@
 * similar methods to retrive all the rest of the metadata, icon included.
-* '''initLayout()''' Initializes the layout. It should be called only once. It will use KStandardDirs::saveLocation() to create needed dirs. See [[../Layout|the layout section]] for more informations.
+* '''initLayout()''' Initializes the layout app-wise. It should be called only once. It will use KStandardDirs::saveLocation() to create needed dirs. See [[../Layout|the layout section]] for more informations.
 * '''installDesktopFile()''' ''Obsoleted by install()?''
 * '''bool isInstalled()''' True if the package is already installed, false otherwise

@@ Line 13: / Line 13: @@
 * '''Handler(QString filename)''' Creates a bundler that operates on the given package. Note that the package needs to be unpacked somewhere first, so operating on a dir is much faster
 * '''Handler(KUrl dir)''' Creates a bundler that operates on the given directory.
-* '''Handler(QString packageName, QString packageVersion)''' Creates a bundler that operates on the given directory.
+* '''Handler(QString packageName, QString packageVersion)''' Creates a bundler that operates on the package already installed in the standard way.
 * '''install()''' Extracts (installs) the package, and puts the .desktop file in $KDEHOME/services/. See [[../Layout|here]] for more informations.
 * '''''QString author()''' Returns a pluginInfo object. You can retrive most of the metadata from it.''' <- check with KNS::Entry
 * '''initLayout()''' Initializes the layout. It should be called only once. It will use KStandardDirs::saveLocation() to create needed dirs. See [[../Layout|the layout section]] for more informations.
-* installDesktopFile() ''Obsoleted by install()?''
+* '''installDesktopFile()''' ''Obsoleted by install()?''
 * ...

@@ Line 15: / Line 15: @@
 * '''Handler(QString packageName, QString packageVersion)''' Creates a bundler that operates on the given directory.
 * '''install()''' Extracts (installs) the package, and puts the .desktop file in $KDEHOME/services/. See [[../Layout|here]] for more informations.
-''* '''QString author()''' Returns a pluginInfo object. You can retrive most of the metadata from it.''' <- check with KNS::Entry
+* '''''QString author()''' Returns a pluginInfo object. You can retrive most of the metadata from it.''' <- check with KNS::Entry
 * '''initLayout()''' Initializes the layout. It should be called only once. It will use KStandardDirs::saveLocation() to create needed dirs. See [[../Layout|the layout section]] for more informations.
 * installDesktopFile() ''Obsoleted by install()?''
 * ...

@@ Line 11: / Line 11: @@
 === Proposed API ===
-* '''Bundler(QString/QFile filename)''' Creates a bundler that operates on the given package. Note that the package needs to be unpacked somewhere first, so operating on a dir is much faster
+* '''Handler(QString filename)''' Creates a bundler that operates on the given package. Note that the package needs to be unpacked somewhere first, so operating on a dir is much faster
-* '''Bundler(KUrl dir)''' Creates a bundler that operates on the given directory.
+* '''Handler(KUrl dir)''' Creates a bundler that operates on the given directory.
-* '''extractTo(KUrl baseDir)''' Extracts (installs) the package into the given baseDir. It's not the directory where the package itself will be extracted, but the one called 'newstuff/' [[../Layout|here]].
+* '''Handler(QString packageName, QString packageVersion)''' Creates a bundler that operates on the given directory.
-* '''KPluginInfo metadata()''' Returns a pluginInfo object. You can retrive most of the metadata from it.
+* '''install()''' Extracts (installs) the package, and puts the .desktop file in $KDEHOME/services/. See [[../Layout|here]] for more informations.
-* '''QFile mapFile(QString filename)'''
+''* '''QString author()''' Returns a pluginInfo object. You can retrive most of the metadata from it.''' <- check with KNS::Entry
-* '''bool initLayout(QString dir = "newstuff")''' Initializes the layout. It should be called only once, when app configuration files are created. It will use KStandardDirs::saveLocation() to create dirs. See [[../Layout|the layout section]] for more informations.
+* '''initLayout()''' Initializes the layout. It should be called only once. It will use KStandardDirs::saveLocation() to create needed dirs. See [[../Layout|the layout section]] for more informations.
-* installDesktopFile()
+* installDesktopFile() ''Obsoleted by install()?''
 * ...

@@ Line 1: / Line 1: @@
 {{warning|Names are just temporary. Infos can be as well. Please don't trust this page as probably most of the things are going to heavily change during this 1 month developement marathone.}}
-= The Bundler =
+= The Handler =
 This class is meant to provide a non-GUI and class to manage KNS packages. It's meant to be used from application themselves.

@@ Line 9: / Line 9: @@
 * more...
-=== API ===
+=== Proposed API ===
 * '''Bundler(QString/QFile filename)''' Creates a bundler that operates on the given package. Note that the package needs to be unpacked somewhere first, so operating on a dir is much faster