====== ARM User's Guide ======


----

This document covers the following topics:

  * The components of the ARM Software Development Toolkit;
  * A brief overview of each of the ARM software tools and how to invoke them;
  * An introduction to the runtime libraries;
  * ARM assembly language;

This manual is intended to be used in conjunction with the other ARM toolkit documentation included in this release. Examples of how to use the tools, and many issues which arise when using them are not covered in this manual, but in [[:documentation:development:opera:pf25:tktfldr:acbfldr:0acbfrst#xref40578|The ARM Cookbook]].

Detailed technical explanations of the tools and the underlying specifications behind them are also not covered in this manual-see the [[:documentation:development:opera:pf25:tktfldr:arrfldr:0arrfrst#xref21713|ARM Reference Manual]] and [[:documentation:development:opera:pf25:tktfldr:atsfldr:0atsfrst#xref33752|ARM Technical Specifications]] respectively.

It is likely to be useful to have a copy of the ARM Datasheet for whatever device is being used, as the manuals do not cover device specific issues.

====== How this book is organized ======

  * [[:documentation:development:opera:pf25:tktfldr:augfldr:aug1frst#xref20531|The ARM C Compiler]] gives an overview of the compiler, followed by information on invoking armcc, keyword options, and flag options.
  * [[:documentation:development:opera:pf25:tktfldr:augfldr:aug2frst#xref22713|The ARM Assembler (armasm)]] discusses all command line options for the ARM Assembler.
  * [[:documentation:development:opera:pf25:tktfldr:augfldr:aug3frst#xref21025|The ARM Linker (armlink)]] discussed all command line options, includeing general options, output format options, and special options, and the input file list.
  * [[:documentation:development:opera:pf25:tktfldr:augfldr:aug4frst#xref15841|The ARM Librarian (armlib)]] discusses all command line options for the ARM librarian.
  * [[:documentation:development:opera:pf25:tktfldr:augfldr:aug5frst#xref39634|The ARM Object Format Decoder (decaof)]] lists all command line options for the ARM object format decoder.

  * [[:documentation:development:opera:pf25:tktfldr:augfldr:aug6frst#xref20727|An Introduction to the Run-Time Libraries]] gives an overview of the minimal stand alone run time library and the ANSI C library.

  * [[:documentation:development:opera:pf25:tktfldr:augfldr:aug7frst#xref15616|ARM Assembly Language]] details ARM Assembly Language.

====== How this document differs from the ARM documentation ======

This book is based on the documentation released with the ARM tools. A few additions have been made, and chapters that were not relevant to 3DO\xaa developers have been omitted, including the following:

  * ARM window debugger (armwd)
  * ANSI C to PCC Translator (topcc)
  * ARM Tool Reconfiguration utility (reconfig)
  * ARM Make utility (armmake) for PC
  * ARM symbolic debugger (armsd) command language.
  * The ARMulator

====== For more information ======

Click on one of the following topics for related information:

  * [[:documentation:development:opera:pf25:tktfldr:augfldr:0augfrsta#xref16886|ARM tool release components]]
  * [[:documentation:development:opera:pf25:tktfldr:augfldr:0augfrsta#xref20147|Programming and modelling tools]]
  * [[:documentation:development:opera:pf25:tktfldr:augfldr:0augfrsta#xref38915|Retargetable libraries]]