--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/configurationengine/doc/plugins/thememl-plugin/themelplugin.rst Thu Mar 11 17:04:37 2010 +0200
@@ -0,0 +1,99 @@
+User guide for Theme Plugin usage in ConE
+-----------------------------------------
+
+Introduction
+'''''''''''''
+This page describes how to use ConE Theme plugin. Theme plugin extracts the theme content from the
+.cpf file. It needs a .thememl file in the implml folder
+
+
+The thememl syntax is a extension of Configuration markup language (confml). The term in confml for this extension
+is implementation method language (implml), which in thememl case is a xml file.
+
+
+Theme elements
+''''''''''''''
+
+The root element of the theme file is always thememl, which defines the xml namespace (xmlns)
+to http://www.s60.com/xml/thememl/1 in the current version.
+
+Theme example
+^^^^^^^^^^^^^
+.. literalinclude:: theme.thememl
+ :language: xml
+
+
+
+
+carbideuiPath
+^^^^^^^^^^^^^^
+
+To create a the Theme plugin uses makepackage.bat file which is under the forder described in
+carbideuiPath tag. If none is setted the default is then C:\Program Files\Nokia\Carbide.ui Theme Edition 3.4
+
+
+
+themeDir
+^^^^^^^^
+Theme plugin available themes from this directory setted as confml ref
+
+
+activeTheme
+^^^^^^^^^^^
+
+One may describe a theme in this tag. You may have them as many as you want.
+It may hold one refSetting tag and several platformUID tags
+
+**activeTheme attributes**
+
+Each flag attribute can have unique hexa values.
+
+ * uid
+
+
+refSetting
+^^^^^^^^^^
+A ref confml setting key that describes the name of the .tpf file. Tpf file must always locate in the
+content folder
+
+
+platformUID
+^^^^^^^^^^^
+Is a ref in conml it may contain some value, but it will be replaced in the theme plugin to value
+given by the .pkg file and setted back to configuration. You may have more than one of these
+
+
+Note
+^^^^^
+The current implementation of the theme plugin relays the the .tpf file contain a .project file and
+it contains themepackage.pkg file
+
+
+XSD
+'''
+
+Download: :download:`thememl.xsd </xsd/thememl.xsd>`
+
+
+FAQ
+'''
+
+Makepackage error
+'''''''''''''''''
+
+This problem is related to installation on Carbide.ui you can get it form
+here http://www.forum.nokia.com/info/sw.nokia.com/id/bb173537-4e67-496f-9967-50917d5cfc47/S60_Theme_Studio_for_Symbian_OS.html
+Install it. Goes by default to C:\Program Files\Nokia\Carbide.ui Theme Edition 3.4, but if you install it
+to a different location then you need to set right path to carbideuiPath tag. Chek that your system supports java
+programmin language. OPen command line editor and type java -version should be 1.5 or above
+
+My theme is not created to image
+''''''''''''''''''''''''''''''''
+
+Change the .tpf file extension to zip and extract it to some folder.
+View the contents, there should be .project file and themepackage.pkg file, if not
+then ConE cannot create you a theme to an image.
+
+
+
+