--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/DITA-OT_CXX_Plugin/doc_pub/INSTALL.txt Thu Mar 18 18:26:18 2010 +0000
@@ -0,0 +1,71 @@
+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.
+