License
=======
Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved.
This component and the accompanying materials are made available under the terms of the License 
"Eclipse Public License v1.0" which accompanies this distribution, 
and is available at the URL "http://www.eclipse.org/legal/epl-v10.html".

Introduction
============
This is the cxxapiref plugin for DITA Open Toolkit. This plugin allows you to build html from DITA specialised cxx XML. 
After this plugin is installed you can use DITA Open Toolkit as normal or you can use the provided MPDOT tool, which is recommended.

Setup
=====
Download the DITA Open Toolkit 1.5.1 and the plugin apiref from sourceforge http://sourceforge.net/projects/dita-ot/files/ 

Uncompress the current package and copy the cxxapiref plugin directory into the %DOT_DIR%\plugins directory and put the python directory at the root of %DOT_DIR%.  

The file structure should look like this:

DITA_OT_1.5.1
+---...
+---dtd
+---lib
+---plugins
	\---apiref
	\---cxxapiref   <-- added 
+---python		    <-- added
..etc


Registration of the Specialisations into DITA-OT
================================================

Open a DITA-OT command prompt
-----------------------------
Run the startcmd.bat file from the %DOT_DIR%

This gives you a shell with the enviroment set up. 
Try running the DOT demos from this shell:

ant all -f build_demo.xml

A good build will end with:

BUILD SUCCESSFUL
Total time: 42 seconds

This will populate the %DOT_DIR%\temp and %DOT_DIR%\out directories 


Run the registration script
---------------------------
From the DITA-OT root directory run:
ant -f integrator.xml

This installs all of the addons plugins in the generic DITA-OT plugins folder.

Testing
=======
Build the cxx sample:

ant -f plugins\cxxapiref\run-ant.xml all

Check the output in %DOT_DIR%\plugins\apiref\out\sample 

Next steps
==========
Now that the DITA Open Toolkit is set up, you can run it on your specialised cxx content. Either run DITA Open Toolkit as usual or use the MPDOT tool.
Follow the %DOT_DIR%python\doc\Using_MPDOT_to_build_html.txt guide.