buildframework/helium/doc/src/index.rst.ftl
author Shabe Razvi <shaber@symbian.org>
Tue, 13 Jul 2010 18:31:50 +0100
branchhelium-7.0.x
changeset 614 e08bbc2db635
parent 179 d8ac696cc51f
child 217 0f5e3a7fb6af
permissions -rw-r--r--
Implement enhancement Bug 3222 - Enable Helium to set diamonds status other than "succeeded" or "failed"

<#--
============================================================================ 
Name        : 
Part of     : Helium 

Copyright (c) 2009 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".

Initial Contributors:
Nokia Corporation - initial contribution.

Contributors:

Description:

============================================================================
-->
.. Helium Documentation documentation master file, created by sphinx-quickstart on Fri May 09 09:49:44 2008.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

.. index::
  module:  Helium Documentation

====================
Helium documentation
====================

.. toctree::
   :maxdepth: 1

.. raw:: html

   <table border="0" cellspacing="0" cellpadding="10">
   <tr valign="top">
   <td width="50%" style="border-right: 1px solid black">
 
.. index::
  single: Getting Started
   
Getting Started
================

This section contains instructions on how to get started with Helium including where to get it from and how to use it at the very simplest level. 
<#if !(ant?keys?seq_contains("sf"))>
This section also has a link to an elearning that goes through Helium at a very high level.
</#if>

.. toctree::
   :maxdepth: 1
   
   introduction
   quick_start_guide
   feature_list
   user-graph

<#if !(ant?keys?seq_contains("sf"))>
* Elearning_

.. _Elearning: http://lmp.nokia.com/lms/lang-en/taxonomy/TAX_Search.asp?UserMode=0&SearchStr=helium
</#if>

.. raw:: html

   </td><td width="50%">


Tutorials and HOWTOs
=====================
This section lists all the available tutorials on Helium and how to configure and use it.

.. toctree::
   :maxdepth: 1
   
   tutorials/configuration/SimplestConfiguration
   tutorials/configuration/UseHlmTasksInConfiguration
   tutorials/rom_image
   tutorials/variant
   tutorials/qt_build
<#if !ant?keys?seq_contains("sf")>
   nokia/blacktusk/howto-setup-blacktusk-with-helium
</#if>

.. raw:: html

   </td></tr>
   <tr valign="top">
   <td width="50%" style="border-right: 1px solid black" rowspan="2">

.. index::  single: Helium Manual
  
Helium Manual
==============

This section contains the details of the various activities that can be performed by Helium, you should look
here for specific information about a task or action.

.. toctree::
   :maxdepth: 1

<#if !ant?keys?seq_contains("sf")>   
   nokia/support
   nokia/nokia
   nokia/retrieving
</#if>
   sf
   manual/running
   manual/configuring
   
.. raw:: html

   <script type="text/javascript" language="JavaScript"><!--
   function HideContent(d) {
   if(d.length < 1) { return; }
   document.getElementById(d).style.display = "none";
   }
   function ShowContent(d) {
   if(d.length < 1) { return; }
   document.getElementById(d).style.display = "block";
   }
   function ReverseContentDisplay(d) {
   if(d.length < 1) { return; }
   if(document.getElementById(d).style.display == "none") { document.getElementById(d).style.display = "block"; }
   else { document.getElementById(d).style.display = "none"; }
   }
   //--></script>
   <ul><li class="toctree-l1"><a href="javascript:ReverseContentDisplay('stages')">Stages</a></li></ul>
   <div id="stages" style="display:none; position:absolute; border-style: solid; background-color: white; padding: 5px;">
   
.. toctree::
   :maxdepth: 2
   
   manual/stages
   
.. raw:: html

   </div>
<#if !ant?keys?seq_contains("sf")>
   <ul><li class="toctree-l1"><a href="javascript:ReverseContentDisplay('nokiastages')">Nokia Stages</a></li></ul>
   <div id="nokiastages" style="display:none; position:absolute; border-style: solid; background-color: white; padding: 5px;">

.. toctree::
   :maxdepth: 2
   
   nokia/nokiastages
   
.. raw:: html

   </div>
</#if>
.. toctree::
   :maxdepth: 1
   
<#if !ant?keys?seq_contains("sf")>
   nokia/rndsdk_user_manual
   nokia/quality
</#if>
   manual/debugging
   metrics
   
.. raw:: html

   <ul><li class="toctree-l1"><a href="javascript:ReverseContentDisplay('api')">API</a></li></ul>
   <div id="api" style="display:none; position:absolute; border-style: solid; background-color: white; padding: 5px;">
   
* `Helium API`_
* `Helium Antlib`_
* `Ant Tasks`_

.. _`Ant Tasks`: api/ant/index.html
.. _`Helium API`: api/helium/index.html
.. _`Helium Antlib`: helium-antlib/index.html

<#if !(ant?keys?seq_contains("sf"))>
* `Python API`_
* `Java API`_
* `IDO API`_
* `DFS70501 API`_

.. _`Python API`: api/python/index.html
.. _`Java API`: api/java/index.html
.. _`IDO API`: <#if ant['helium.version']?matches("^\\d+\\.0(?:\\.\\d+)?$")>../</#if>ido/api/helium/index.html
.. _`DFS70501 API`: dfs70501/api/helium/index.html
</#if>

.. raw:: html

   </div>
   
<#if !ant?keys?seq_contains("sf")>
.. toctree::
   :maxdepth: 1
   
   api_changes
   nokia/releasenotes
</#if>

.. raw:: html

   </td><td>

Helium Framework configuration
==============================

.. toctree::
   :maxdepth: 1
   
   tutorials/configuration/HowtoCreateANewSignal
   manual/signaling
   manual/configuringdiamonds
   manual/cruisecontrol
   manual/antlogging
* helium-antlib_

.. _helium-antlib: helium-antlib

<#if !ant?keys?seq_contains("sf")>
Customer docs
=============

* IDO_

.. _IDO: <#if ant['helium.version']?matches("^\\d+\\.0(?:\\.\\d+)?$")>../</#if>ido

* TeamCI_

.. _TeamCI: <#if ant['helium.version']?matches("^\\d+\\.0(?:\\.\\d+)?$")>../</#if>teamci

</#if>

Helium Architecture
===================

This section describes the architecture of Helium. It also contains a link to the style guide to be used for 
coding conventions.


.. toctree::
   :maxdepth: 1
 
   architecture
  
.. raw:: html

   </td></tr>
   <tr valign="top"><td>

Developer Guide
==================
This section contains information on how to make changes to Helium either as a tools team developer or an external 
developer. The 'developer guide' link contains information on the structure of the directories and some important
information on how to add libraries and other miscellaneous information.
It also contains details on how to test the changes made.

.. toctree::
   :maxdepth: 1

<#if !ant?keys?seq_contains("sf")>
   nokia/howto-contribute
   nokia/legal
   nokia/testing
</#if>
   developer_guide
   coding_conventions

.. raw:: html

   </td></tr>
   </table>
   
Indices and Tables
==================

* :ref:`genindex`
* :ref:`search`