<?xml version="1.0" encoding="utf-8"?>
<!-- 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". -->
<!-- Initial Contributors:
    Nokia Corporation - initial contribution.
Contributors: 
-->
<!DOCTYPE concept
  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
<concept id="GUID-2DC89F9D-30E8-5260-8850-53E4152EE3CF" xml:lang="en"><title>Finding
your way around</title><shortdesc>Read this page to learn about the contents and structure of the
library.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
<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
Guide</xref> provides introductory documents to the platform
as a whole, and guides that describe the major areas of the platform in depth. </p><p>The
Symbian platform is a large system, and contains hundreds of C++ classes and
thousands of member functions. Like most complex systems, it is easiest to
divide it into large areas, and gradually to narrow your focus down to the
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
Symbian platform into a layered software architecture. The guides in this
library are also structured around this architecture. The guides describe
the key technology and architectural concepts of the area, and show the key
ways to use its classes.</p> <p>Note: Before the System Model was introduced,
the Symbian platform used another architectural view based on large divisions
called subsystems. Some documentation has not yet been changed to use the
System Model rather than subsystems. </p> </section>
<section id="GUID-5C4DC90E-DB65-4EB7-B271-D64D5FC5A065"><title>Newcomers to
the Symbian platform</title> <p>For those developing on the Symbian platform
for the first time, the <xref href="GUID-35D7EEFC-B2E4-5444-8875-2A24790E08C2.dita">Essential
Idioms</xref> section describes the distinctive programming idioms and conventions
of the Symbian platform. </p> </section>
<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 gives
instructions for building and using the large set of C++ example projects
that accompany the library. Projects include examples that demonstrate the
use of fundamental Symbian platform classes, and many examples showing how
to use particular Symbian platform C++ APIs. </p> <p>Example code is provided
for illustrative and demonstration purposes, and should not be assumed to
be useable as product code. </p></section>
<section id="GUID-F8410B90-5208-4E73-A4C1-FA951429403A"><title>Hardware
integration</title> <p>The library provides the following guides related to
hardware integration. </p> <p><b> Kernel and Hardware Services guide</b> </p> <p>The <xref href="GUID-E3D2A6ED-8192-563D-8966-DD96B3AF1783.dita">Kernel and Hardware Services
Guide</xref> provides information for device creators and silicon vendors
who port the Symbian platform base to new hardware. The porting process is
explained through a Template port. </p> <p><b> Device Driver guide</b> </p> <p>The <xref href="GUID-0437DB4C-FC4E-51DC-BB4C-95C0B26834F5.dita">Device Driver Guide</xref> contains
information on writing device drivers to run on the Symbian platform. It gives
an overview that explains the device driver model as used in the Symbian platform,
and then goes on to explain what you need to do in order to write a driver. </p> </section>
<section id="GUID-C5687256-B657-4D29-B280-1837D4F991AE"><title>Tools</title><p>The
library does not include documentation for most tools, which are usually delivered
separately from the Symbian platform 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">Tools And Utilities</xref> section
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
the <xref href="GUID-49397CFD-955A-5DF6-9251-368C44224966.dita">Build Tools Reference</xref> document
the <cmdname>abld</cmdname>/<cmdname>bldmake</cmdname> (SBSv1) command line
build tools, and explain the project file formats. </p></section>
</conbody></concept>