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".

Orb Files

=========

Directory tree          Description

--------------          -----------

+---ant                 Ant scripts to transform cxxApiRef dtd xml to dita reference xml.

+---bin                 Preexisisting symbian build system directory. doxygen.exe is copied here and the batch script to transform output to dita reference and produce ditamaps.

|   \---MapCreator      A tool for creating ditamaps from system definition files.

+---CxxApiRef2Dita      xslt and ant scripts to perform the cxxApiRef to dita reference conversion.

+---documentation       Additional documentation about converting output to dita reference dtd and how to generate and use a system definition file with Orb.

+---lib                 Preexisisting symbian build system directory. Orb adds a doxygen configuration to the Symbian Build System so that it can run Doxygen.

\---python              Preexisisting symbian build system directory.

    \---doxygen         Python scripts that are used by the map creation and transform scripts

Installation

============

For installation instructions please read INSTALL.txt

Running Orb on my project

=========================

Once Orb is installed, open a console, change directory to the folder containing the bld.inf and mrp file for your project and run

sbs -c doxygen

You can also run it with a .dox extension to your existing configuration. e.g.

sbs -c arm.v7.rvct4_0.dox

sbs -c rvct3_0.dox

sbs -c armv5_urel.dox

The documentation for your project will be created in the \epoc32\build\release on your system. 

The documentation will conform to the cxx DITA dtd specialisation and will need to be converted to 

to xml that conforms to standard DITA reference xml to be processed by the Dita Open Toolkit.

For more information on performing this conversion please see documentation\converting_to_reference.txt.

Output

======

Orb builds output to the epoc32 directory under the location indicated by the EPOCROOT environment variable.

The two locations are epoc32\builds and epoc32\release\dita. The builds directory contains the temporary output

that doxygen produces as it runs on all the targets of the Symbian OS. There is one directory per component

and each component directory contains the doxygen output for the documentation for each dll or executable 

target being built. The release directory contains the output of every target copied to a single directory

to remove duplicates.

The script that converts the cxx dita output from doxygen to dita reference requires the release\dita directory.

Its outputs files to epoc32\release\ditareference and epoc32\release\maps.

Additional documentation

========================

Some additional documents have been included in the directory named documentation

For a guide on converting doxygen dita output to dita reference and producing dita maps please see 

converting_to_reference.txt 

For a guide on generating and using a system definition version 3 with Orb please see

sysdefv3_guide.txt

For doxygen documentation please see DoxygenDITAEditionUserGuide.chm