--- /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. 
+
+ 
+
+