Read Me

What is it ?
============

This software is a plugin for Xcode, adding native support for the Ada langage in Xcode.

It supports :
- source code highlighting (.adb, .ads and .ada files)
- Xcode look & feel to manage a project
- writing pure ada programs
- calling C code from ada programs
- debug ada code from Xcode

Requirements
============

A PPC or Intel Mac
Mac OS X 10.5.x
Xcode 3.x
The gnat compiler (command line tools for compiling Ada files)

How to install ?
================

Copy "Ada.pbplugin" to "$HOME/Library/Application Support/Developer/Shared/Xcode/Plug-ins/"
Copy "Target Templates/*" to "$HOME/Library/Application Support/Developer/Shared/Xcode/Target Templates/Ada/"
Copy "Project Templates/*" to "$HOME/Library/Application Support/Developer/Shared/Xcode/Project Templates/Ada/"

By default, the plugin will look the gnat executables in /usr/local/ada-4.2/bin. If it's not the case, you may
change this setting by running the following command (if the gnat commands are /opt/local/bin/ for instance) :
defaults write com.apple.Xcode INAdaBasePath /opt/local/

How to use ?
============

Easiest way :
- create a new project, using the template "Ada > Ada Standard Tool".
- the sample code should compile without any modification.

For non standard situations :
- create an empty projet, or open an existing projet.
- add a new target ("Project" menu), using the template "Ada > Ada Shell Tool"
- add your ada source code files (.ads / .adb) to the build phase of this target
- open the build settings of the target and fill the ADA_MAIN_PROGRAM value. It should be set to
  the name of the main procedure, the entry point of the program.

Never add ada source code file to a non Ada target. It may seems to work, but it finally doesn't.

Links
=====

Web site : http://maxao.free.fr/xcode-ada-plugin/
Download : http://sourceforge.net/project/showfiles.php?group_id=184878&package_id=218596
SVN repository : http://xcodeplugins.svn.sourceforge.net/svnroot/xcodeplugins/AdaPlugin
Support mailing list : https://lists.sourceforge.net/lists/listinfo/xcodeplugins-users

Copyright
=========

The source code is published under the GPL v3 licence : you may use it freely as long as you respect
the GPL v3 licence, and mention the initial copyright of its author, Damien Bobillot.

Revision History
================

1.0b4 Oct 2008 : updated for Mac OS X 10.5.5
1.0b3 Jan 2008 : updated for Xcode 3.0
1.0b2 May 2006 : updated for Xcode 2.3
1.0b1 ??       : first version