int2tap.1


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75

.TH int2tap 1 "$Date: 2004-08-22 20:49:39 $"
.SH NAME
hex2tap \- Converts an Intel format segment dump to a Spectrum emulator
TAP file.
.SH SYNOPSIS
.B int2tap
[
.B \-b
] 
[
.B \-s
] 
[
.B \-a address
] 
[
.B \-c address
] 
.I output-file
.I input-file ...
.SH DESCRIPTION
.B hex2tap
takes one or more Intel format segment files \- as produced by an assembler like
.B tpasm(1)
\- and produces a Spectrum compatible tape file (TAP file).
.P
The tape file will also optionally include a BASIC loader (see OPTIONS).
This loader will load in the binary file(s) in the same order they were on
the command line.  It will then run the code from execute address (see
.B \-a
in OPTIONS).
.SH OPTIONS
.B int2tap
accepts these switches
.TP
.B \-b
Just produce the binary file(s).  By default
.B int2tap
will generate a TAP file with two files in - a BASIC loader and then the
code itself.  This switch disables the generation of the BASIC loader portion.
.TP
.B \-s
By default
.B int2tap
will generate a single CODE file in the tape file.  Using this switch means
that each input file will generate a seperate CODE file.
.TP
.B \-a address
By default
.B int2tap
assumes that the base address of the first input file is the start address.
This switch allows that to be overridden.  Note this switch will have no
effect if the
.B \-b
switch is used.  The address can be passed either in decimal, octal (starting
with a 0), or hex (starting with 0x).
.TP
.B \-c address
Add a CLEAR
.I address
command to the generated BASIC loader.  Note this switch will have no
effect if the
.B \-b
switch is used.  The address can be passed either in decimal, octal (starting
with a 0), or hex (starting with 0x).
.SH SEE ALSO
.BR tpasm (1)
.SH DIAGNOSTICS
The diagnostics produced by
.B int2tap
are intended to be self-explanatory.
.SH NOTES 
This is the initial version of int2tap.
.SH BUGS
Please report any bugs to ianc@noddybox.demon.co.uk