week 10 bug fix submission (SF PDK version): Bug 1892, Bug 1897, Bug 1319. Also 3 or 4 documents were found to contain code blocks with SFL, which has been fixed. Partial fix for broken links, links to Forum Nokia, and the 'Symbian platform' terminology issues.
<?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-D729BD58-D4FE-5D46-ACD4-F78B37BA833A" xml:lang="en"><title>GNU
Assembler Source Format</title><shortdesc>Describes the rules that you must follow if you use GNU assembler
syntax.</shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
<p>The platform-specific source code can be written in GNU assembler
syntax or ARM assembler syntax.</p>
<p>The generic source and header files are all written using the ARM assembler
syntax, as are the source files for the template and example ports. However
the bootstrap can be built using the GNU assembler; in this case, source files
are translated from ARM to GNU assembler syntax automatically. </p>
<p>The rules that you must follow to use GNU assembler syntax in the platform-specific
source are: </p>
<ul>
<li id="GUID-4D2E66B7-D3DE-5877-817B-316E16612AAC"><p>The first non-blank
line of any GNU-syntax source or header file should start with an @ (the GNU
comment delimiter); this acts as a directive to the translation tool that
no translation is required. </p> </li>
<li id="GUID-BDEE2BA7-5FD4-5BC0-B945-8E598388019C"><p>Files included from
GNU source should be included with a <filepath>.ginc</filepath> extension
instead of the normal <filepath>.inc</filepath> extension. However the file
itself should have a <filepath>.inc</filepath> extension. </p> </li>
</ul>
<p>To enable the generic makefile to work correctly, assembler source files
should always be given the extension <filepath>.s</filepath> and assembler
include files <filepath>.inc</filepath>; this is independent of whether these
are ARM or GNU syntax. </p>
</conbody></concept>