Introduction
============

This example shows how to use the makelnk utility to automatically 
create a linker file suitable for 'link-z80' that comes with SDCC.

The version of link-z80 that comes with SDCC v2.4.1 doesn't handle 
command-line parameters properly so it is not possible to define the 
objects and libraries to link on the command line.

So you must use a linker file ('.lnk') with link-z80.

To create a linker file you have two choices:
1. create and make your own linker file.
  
This is problematic if you add additional objects to your makefile, 
because you have to remember to update the linker file.

2. use this utility to automatically create the linker file.

Kevin Thacker, August 2004

Files
=====

makefile
--------

Builds the test program.

main.c
------

The code for the program written in the C language.

main.lnk
--------

Linker script for link-z80.

addhead
-------

Executable file to add an AMSDOS header to the program.

cpcxfs
------

Executable file to manage CPCEMU style disk images (for use with an 
Amstrad emulator)

crt0.s
------

A startup file for creating a CPC binary executable located at &100.

makebin
-------

Executable file to convert .ihx files to binary files.

makelnk
-------

Executable file to generate a .lnk file from object files and parameters 
passed on the command-line.
