--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/tools/servicedbgen/README	Wed Aug 25 15:49:42 2010 +0300
@@ -0,0 +1,118 @@
+*) Intended readers:
+
+The servicedbgen tool is intended to be used during Symbian rom
+creation for prepopulating  Qt Serviceframework databases. It is not a
+tool for normal runtime or application usage,  although it may be
+useful also for development or testing purposes.
+
+*) Overview:
+
+The servicedbgen tool is a command line application to populate Qt
+Serviceframework databases.  The tool takes XML files describing the
+service, and produces SQLite databases.  Services can  be added and
+removed.
+
+Servicedbgen runs on the cross-compiling machine (i.e. Windows or
+Linux) and is delivered as a prebuilt  application along with the SDK,
+or must compiled with host tools. It can be invoked  from the command
+line or by directives in your project's .pro-file. Qmake and make can
+then run the tool automatically. The latter approach is used at Symbian
+rom creation time.
+
+*) Design:
+
+The tool uses the same servicedatabase creation components as the Qt 
+Serviceframework. Therefore whenever the tool is rebuilt, it reflects
+the latest changes in database components.
+
+There are two operating modes, individual and batch mode. In individual
+mode, the tool is given individual XML files as input. In batch mode,
+the tool reads XML files from a given directory, or from a default
+directory if none given. The tool uses Nokia Vendor ID as the security
+token when adding the services. If an application needs to change the
+preinstalled services during runtime, it needs to be  equipped with
+Nokia Vendor ID.
+
+Services that require initialization prior to their first usage (e.g.
+to initialize databases etc.)  can set a parameter.  QServiceManager
+will call QServicePluginInterface::installService() when the service is
+loaded first time when QServiceManager::loadInterface() is called.
+
+The tool supports WINSCW emulator and hardware targets. The resulting
+databases are identical, but the locations differ (see Appendix). 
+
+*) Command line use
+
+The usage of the tool is as follows:
+
+servicedbgen [options] <command> [command parameters]
+
+To see the list of all available options,  type 'servicedbgen --help'.
+
+Basic usage examples:
+ - registering service1 and service2 for winscw target:
+        servicedbgen -twinscw add service1.xml service2.xml
+ - registering service1 for all targets, service requesting initialization:
+        servicedbgen -tall -i add service1.xml
+ - unregistering service1 from all targets:
+        servicedbgen -tall remove service1.xml
+ - registering all services for armv5 from default descriptor path:
+        servicedbgen -tall -b -c add
+ - registering services for all targets from specific descriptor path:
+        servicedbgen -tall -b add ./mypath/services
+ - removing services for all targets from default descriptor path:
+        servicedbgen -tall -b remove
+
+The default target, if unspecified, is '-tall'.
+
+*) Project file use
+
+Add following lines to your project's .pro file (inside a
+symbian-block):
+
+CONFIG += qtservice                  # qmake magic, causes processing of qtservice.prf
+QTSERVICE.DESCRIPTOR = <XML files>   # the list of service descriptor XML files
+QTSERVICE.INITIALIZE = yes           # add  this if given descriptors need initialization
+
+----------- Appendix
+
+*) Database locations
+
+Paths to the db. They can not be changed since Qt Serviceframework is
+hardcoded to these paths.
+
+"/epoc32/winscw/c/data/temp/QtServiceFW" // Emulator without WDS
+"/epoc32/winscw/c/private/2002AC7F/Nokia" // Emulator with WDS
+"/epoc32/data/c/private/2002AC7F/Nokia"  // HW
+
+*) Default XML lookup paths
+
+These are the paths where the tool looks for XML files (.xml) if  batch
+option was given and no path was specified.
+
+"/epoc32/winscw/c/private/2002AC7F/Nokia/des" // Emulator
+"/epoc32/data/z/private/2002AC7F/Nokia/des"   // HW
+
+
+*) Notes For Symbian ROM images
+
+In the initialization phase, typically first boot, if the database is
+not found on the C drive, it is copied from the Z drive.
+
+qtmobility.iby must contain:
+
+data=\epoc32\data\z\private\2002ac7f\QtServiceFramework_4.6_system.db  private\2002ac7f\QtServiceFramework_4.6_system.db
+
+To use servicedbgen when it's not provided as part of SDK these files
+should be deployed to:
+
+features\qtservice.meta -> $EPOCROOT\epoc32\tools\makefile_templates\qt
+features\qtservice.mk 	-> $EPOCROOT\epoc32\tools\makefile_templates\qt
+features\qtservice.prf 	-> $EPOCROOT\epoc32\tools\qt\mkspecs\features\symbian
+servicedbgen.exe      	-> $EPOCROOT\epoc32\tools
+QtCore4.dll and 	-> $EPOCROOT\epoc32\tools
+QtSql4.dll.exe 		-> $EPOCROOT\epoc32\tools
+qsqlite4.dll		-> $EPOCROOT\epoc32\tools\sqldrivers
+
+
+