<?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>