1 <?xml version="1.0" encoding="utf-8"?>

     2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->

     3 <!-- This component and the accompanying materials are made available under the terms of the License 

     4 "Eclipse Public License v1.0" which accompanies this distribution, 

     5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->

     6 <!-- Initial Contributors:

     7     Nokia Corporation - initial contribution.

     8 Contributors: 

     9 -->

    10 <!DOCTYPE concept

    11   PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">

    12 <concept id="GUID-2DC89F9D-30E8-5260-8850-53E4152EE3CF" xml:lang="en"><title>Finding

    13 your way around</title><shortdesc>Read this page to learn about the contents and structure of the

    14 library.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

    15 <section id="GUID-91A35BDC-92E4-47D6-8A04-C6E0C444C484"><title>The platform structure and APIs</title> <p>The <xref href="GUID-32E29020-1956-461A-B79A-1492E06049E7.dita">Symbian

    16 guide</xref> provides introductory documents to the platform as a whole, and

    17 guides that describe the major areas of the platform in depth. </p><p>The

    18 Symbian platform is a large system, and contains hundreds of C++ classes and

    19 thousands of member functions. Like most complex systems, it is easiest to

    20 divide it into large areas, and gradually to narrow your focus down to the

    21 areas that are most important to your tasks. </p><p>The <xref href="http://developer.symbian.org/wiki/index.php/Symbian_System_Model" scope="external">Symbian System Model</xref> organises the components of the

    22 Symbian platform into a layered software architecture. The guides in this

    23 library are also structured around this architecture. The guides describe

    24 the key technology and architectural concepts of the area, and show the key

    25 ways to use its classes.</p> <p>Note: Before the System Model was introduced,

    26 the Symbian platform used another architectural view based on large divisions

    27 called subsystems. Some documentation has not yet been changed to use the

    28 System Model rather than subsystems. </p> </section>

    29 <section id="GUID-5C4DC90E-DB65-4EB7-B271-D64D5FC5A065"><title>Newcomers to the Symbian platform</title> <p>For those developing

    30 on the Symbian platform for the first time, the <xref href="GUID-35D7EEFC-B2E4-5444-8875-2A24790E08C2.dita">Essential

    31 Idioms</xref> section describes the distinctive programming idioms and conventions

    32 of the Symbian platform. </p> </section>

    33 <section id="GUID-0AA83743-82BC-473B-ABFD-20FFD6AB6485"><title>Examples</title> <p>The <xref href="GUID-270C96B0-4BDF-5A18-A8FE-FA4F78BB34EE.dita">Examples</xref> section

    34 gives instructions for building and using the large set of C++ example projects

    35 that accompany the library. Projects include examples that demonstrate the

    36 use of fundamental Symbian platform classes, and many examples showing how

    37 to use particular Symbian platform C++ APIs. </p> <p>Example code is provided

    38 for illustrative and demonstration purposes, and should not be assumed to

    39 be useable as product code. </p></section>

    40 

    41 <section id="GUID-C5687256-B657-4D29-B280-1837D4F991AE"><title>Tools</title><p>The library does not include documentation

    42 for most tools, which are usually delivered separately from the Symbian platform

    43 code. See the <xref href="http://developer.symbian.org/wiki/index.php/Category:Tools" scope="external">Tools</xref> section of the <xref href="http://developer.symbian.org/" scope="external">Symbian Developer Community</xref> website.</p><p>The <xref href="GUID-A837D8F6-B9D3-5119-8C63-51772B388999.dita">Symbian Tools And Utilities</xref> section

    44 documents the tools that are delivered with the platform. In particular, the <xref href="GUID-B21141D4-3BFE-59C9-8D5F-147A93BE1C95.dita">Build Tools Guide</xref> and

    45 the <xref href="GUID-49397CFD-955A-5DF6-9251-368C44224966.dita">Build Tools Reference</xref> document

    46 the <cmdname>abld</cmdname>/<cmdname>bldmake</cmdname> (SBSv1) command line

    47 build tools, and explain the project file formats. </p></section>

    48 </conbody></concept>