Relocate V1.03 User's Guide

                              18th January 1993


Preface

The programs and files in this distribution are freely distributable, but
Copyright © 1993 Nick Lines. They may be copied provided all the
distribution remains intact and that no more than a reasonable copying /
media fee is charged. In the UK, this is £2.

No warranty is given or implied on this distribution. It has been checked
for bugs as far as it is possible to do so and multitasks happily. Having
said that, enjoy the distribution - I certainly think that it's useful. I
accept no responsibility for your use of this program. It is provided AS IS!

No commercial usage is permitted without written permission from the
author. This is generally known as freeware, and thanks to examples from 
Nico François for the wording...

If you have any comments/bugs/suggestions (definately) please let me
know.

Contacting the Author

Please contact me to let me know if it is worth me writing another faster
and improved version. I really have no idea how many people will use this.

EMail:      csznml@scs.leeds.ac.uk
Post :      Nick Lines                      Nick Lines
            49 Cotswold Drive               Devonshire Halls
            Finham                          Cumberland Road
            Coventry                        LEEDS
            CV3 6EZ                         LS6 2EQ

Please use the Coventry address after June 1993.
If at all possible, please use EMail as this guarantees a swift (next day)
reply.

Introduction

The purpose of this utility is to simly relocate an Assembler project from
one place to another. It copies the source code, all binary files and
includes to the specified directory and changes the path names in the 
source code as it progresses. I think that this is so useful, I'm surprised
no-one has written it before!

It will copy the source code file to the destination directory. The binaries
go to a directory called binary in the destination directory and similarly
the includes go to a directory called include. If these do not exist they
are created for you.

Usage

This program is useable under any version of workbench from the CLI/Shell 
only. It has the following syntax

   relocate «sourcefile» «Destination» [-b -c -i -v]

Where «sourcefile» is the name of the file to move, «destination» is the 
name of the destination directory or volume, and -b,-c,-i,-v are options
for the following:
   -b   Do not copy binaries
   -i   Do not copy includes
   -c   Do not change source code paths
   -v   Verbose mode. Inform of all copies and directory changes.

Specifying more than one option must be done with multiple minus signs,eg
-b -i for no includes and no binaries.

Example:
	relocate dh0:Source/Demo1.s df0: -v

Background Info

This is my first attempt at writing C on the Amiga. It was compiled with 
Lattice CV5.04 and can definately be improved. If demand shows that 
people use this a lot, I will change it to make it faster and more
memory-efficient.

History

V1.00      Unreleased version
V1.01      Added changing of Source code
V1.02      Added -b,-i options
V1.03      Fixed bug. Now frees memory properly

Known Bugs

Eats 100 bytes of memory for some reason I cannot work out.