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-D729BD58-D4FE-5D46-ACD4-F78B37BA833A" xml:lang="en"><title>GNU

    13 Assembler Source Format</title><shortdesc>Describes the rules that you must follow if you use GNU assembler

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

    15 <p>The platform-specific source code can be written in GNU assembler

    16 syntax or ARM assembler syntax.</p>

    17 <p>The generic source and header files are all written using the ARM assembler

    18 syntax, as are the source files for the template and example ports. However

    19 the bootstrap can be built using the GNU assembler; in this case, source files

    20 are translated from ARM to GNU assembler syntax automatically. </p>

    21 <p>The rules that you must follow to use GNU assembler syntax in the platform-specific

    22 source are: </p>

    23 <ul>

    24 <li id="GUID-4D2E66B7-D3DE-5877-817B-316E16612AAC"><p>The first non-blank

    25 line of any GNU-syntax source or header file should start with an @ (the GNU

    26 comment delimiter); this acts as a directive to the translation tool that

    27 no translation is required. </p> </li>

    28 <li id="GUID-BDEE2BA7-5FD4-5BC0-B945-8E598388019C"><p>Files included from

    29 GNU source should be included with a <filepath>.ginc</filepath> extension

    30 instead of the normal <filepath>.inc</filepath> extension. However the file

    31 itself should have a <filepath>.inc</filepath> extension. </p> </li>

    32 </ul>

    33 <p>To enable the generic makefile to work correctly, assembler source files

    34 should always be given the extension <filepath>.s</filepath> and assembler

    35 include files <filepath>.inc</filepath>; this is independent of whether these

    36 are ARM or GNU syntax. </p>

    37 </conbody></concept>