File: vice_15.html

package info (click to toggle)
vice 3.0.0.dfsg-2
  • links: PTS
  • area: contrib
  • in suites: stretch
  • size: 137,780 kB
  • ctags: 148,758
  • sloc: ansic: 1,389,701; asm: 91,194; sh: 35,211; cpp: 34,595; makefile: 16,586; objc: 12,688; java: 4,250; perl: 3,513; lisp: 1,795; python: 1,095; yacc: 1,056; xml: 779; lex: 551; pascal: 215; sed: 178
file content (251 lines) | stat: -rw-r--r-- 5,860 bytes parent folder | download
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
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
<HTML>
<HEAD>
<!-- This HTML file has been created by texi2html 1.52
     from ../../doc/vice.texi on 15 December 2016 -->

<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link href='http://fonts.googleapis.com/css?family=Lato:400,700' rel='stylesheet' type='text/css'>
<TITLE>VICE Manual - 15  petcat</TITLE>
<style type="text/css">
    @import 'vice.css';
</style>
</HEAD>
<BODY>
Go to the <A HREF="vice_1.html">first</A>, <A HREF="vice_14.html">previous</A>, <A HREF="vice_16.html">next</A>, <A HREF="vice_22.html">last</A> section, <A HREF="vice_toc.html">table of contents</A>.
<P><HR><P>


<H1><A NAME="SEC310" HREF="vice_toc.html#TOC310">15  petcat</A></H1>

<P>
The petcat program is a text conversion utility, it can convert
between ASCII, PETSCII and tokenized BASIC.

</P>


<H2><A NAME="SEC311" HREF="vice_toc.html#TOC311">15.1  petcat command line options</A></H2>

<DL COMPACT>

<DT><CODE>-help</CODE>
<DD>
<A NAME="IDX1875"></A>
 
Output help text
<A NAME="IDX1876"></A>
<DT><CODE>-?</CODE>
<DD>
Same as above
<A NAME="IDX1877"></A>
<DT><CODE>-v</CODE>
<DD>
verbose output
<A NAME="IDX1878"></A>
<DT><CODE>-c</CODE>
<DD>
controls (interpret also control codes) (default if textmode)
<A NAME="IDX1879"></A>
<DT><CODE>-nc</CODE>
<DD>
no controls (suppress control codes in printout) (default if non-textmode)
<A NAME="IDX1880"></A>
<DT><CODE>-ic</CODE>
<DD>
interpret control codes case-insensitive
<A NAME="IDX1881"></A>
<DT><CODE>-d</CODE>
<DD>
output raw codes in decimal
<A NAME="IDX1882"></A>
<DT><CODE>-h</CODE>
<DD>
write header (default if output is stdout)
<A NAME="IDX1883"></A>
<DT><CODE>-nh</CODE>
<DD>
no header (default if output is a file)
<A NAME="IDX1884"></A>
<DT><CODE>-skip &#60;n&#62;</CODE>
<DD>
Skip &#60;n&#62; bytes in the beginning of input file. Ignored on P00.
<A NAME="IDX1885"></A>
<DT><CODE>-text</CODE>
<DD>
Force text mode
<DT><CODE>-&#60;version&#62;</CODE>
<DD>
use keywords for &#60;version&#62; instead of the v7.0 ones
<A NAME="IDX1886"></A>
<DT><CODE>-w&#60;version&#62;</CODE>
<DD>
tokenize using keywords on specified Basic version.
<A NAME="IDX1887"></A>
<DT><CODE>-k&#60;version&#62;</CODE>
<DD>
list all keywords for the specified Basic version
<A NAME="IDX1888"></A>
<DT><CODE>-k</CODE>
<DD>
list all Basic versions available.
<A NAME="IDX1889"></A>
<DT><CODE>-l</CODE>
<DD>
Specify load address for program (in hex, no loading chars!).
<A NAME="IDX1890"></A>
<DT><CODE>-o &#60;name&#62;</CODE>
<DD>
Specify the output file name
<A NAME="IDX1891"></A>
<DT><CODE>-f</CODE>
<DD>
Force overwritten the output file. The default depends on the BASIC version.
</DL>

<P>
BASIC Versions:
<DL COMPACT>

<DT><CODE>10</CODE>
<DD>
Basic v10.0 (C65/C64DX)
<DT><CODE>1p</CODE>
<DD>
Basic v1.0 (PET)
<DT><CODE>2</CODE>
<DD>
Basic v2.0 (C64/VIC20/PET)
<DT><CODE>3</CODE>
<DD>
Basic v3.5 (C16)
<DT><CODE>40</CODE>
<DD>
Basic v4.0 (PET/CBM2)
<DT><CODE>4e</CODE>
<DD>
Basic v2.0 with Basic v4.0 extension (C64)
<DT><CODE>4v</CODE>
<DD>
Basic v2.0 with Basic v4.0 extension (VIC20)
<DT><CODE>5</CODE>
<DD>
Basic v2.0 with Basic v5.0 extension (VIC20)
<DT><CODE>70</CODE>
<DD>
Basic v7.0 (C128)
<DT><CODE>71</CODE>
<DD>
Basic v7.0 with Basic v7.1 extension (C128)
<DT><CODE>a</CODE>
<DD>
Basic v2.0 with AtBasic (C64)
<DT><CODE>bk</CODE>
<DD>
Basic v2.0 with Kipper Basic (C64)
<DT><CODE>blarg</CODE>
<DD>
Basic v2.0 with Blarg (C64)
<DT><CODE>bob</CODE>
<DD>
Basic v2.0 with Basic on Bails (C64)
<DT><CODE>bsx</CODE>
<DD>
Basic v2.0 with Basex (C64)
<DT><CODE>bwarsaw</CODE>
<DD>
Basic v2.0 with Warsaw Basic (C64)
<DT><CODE>bws</CODE>
<DD>
Basic v2.0 with WS Basic (C64)
<DT><CODE>bwsf</CODE>
<DD>
Basic v2.0 with WS Basic final (C64)
<DT><CODE>drago</CODE>
<DD>
Basic v2.0 with Drago basic v2.2 (C64)
<DT><CODE>easy</CODE>
<DD>
Basic v2.0 with Easy Basic (VIC20)
<DT><CODE>eve</CODE>
<DD>
Basic v2.0 with Eve Basic (C64)
<DT><CODE>exp20</CODE>
<DD>
Basic v2.0 with Expanded Basic (VIC20)
<DT><CODE>exp64</CODE>
<DD>
Basic v2.0 with Expanded Basic (C64)
<DT><CODE>f</CODE>
<DD>
Basic v2.0 with Final Cartridge III (C64)
<DT><CODE>game</CODE>
<DD>
Basic v2.0 with Game Basic (C64)
<DT><CODE>graph</CODE>
<DD>
Basic v2.0 with Graphics basic (C64)
<DT><CODE>lightning</CODE>
<DD>
Basic v2.0 with Basic Lightning (C64)
<DT><CODE>magic</CODE>
<DD>
Basic v2.0 with Magic Basic (C64)
<DT><CODE>mighty</CODE>
<DD>
Basic v2.0 with Mighty Basic by Craig Bruce (VIC20)
<DT><CODE>pegasus</CODE>
<DD>
Basic v2.0 with Pegasus Basic v4.0 (C64)
<DT><CODE>reu</CODE>
<DD>
Basic v2.0 with REU-Basic (C64)
<DT><CODE>simon</CODE>
<DD>
Basic v2.0 with Simons' Basic extension (C64)
<DT><CODE>speech</CODE>
<DD>
Basic v2.0 with Speech Basic v2.7 (C64)
<DT><CODE>superbas</CODE>
<DD>
Basic v2.0 with Super Basic (C64)
<DT><CODE>superexp</CODE>
<DD>
Basic v2.0 with Super Expander (VIC20)
<DT><CODE>supergra</CODE>
<DD>
Basic v2.0 with Supergrafik 64 (C64)
<DT><CODE>sxc</CODE>
<DD>
Basic v2.0 with Super Expander Chip (C64)
<DT><CODE>tt64</CODE>
<DD>
Basic v2.0 with The Tool 64 (C64)
<DT><CODE>turtle</CODE>
<DD>
Basic v2.0 with Turtle Basic by Craig Bruce (VIC20)
<DT><CODE>ultra</CODE>
<DD>
Basic v2.0 with Ultrabasic-64 (C64)
<DT><CODE>xbasic</CODE>
<DD>
Basic v2.0 with Xbasic (C64)
</DL>



<H2><A NAME="SEC312" HREF="vice_toc.html#TOC312">15.2  petcat examples</A></H2>

<DL COMPACT>

<DT><CODE>petcat -2 -o outputfile.txt -- inputfile.prg</CODE>
<DD>
Convert inputfile.prg to a text file in outputfile.txt, using BASIC V2 only
<DT><CODE>petcat -wsimon -o outputfile.prg -- inputfile.txt</CODE>
<DD>
Convert inputfile.txt to a PRG file in outputfile.prg, using Simons' BASIC
</DL>

<P><HR><P>
Go to the <A HREF="vice_1.html">first</A>, <A HREF="vice_14.html">previous</A>, <A HREF="vice_16.html">next</A>, <A HREF="vice_22.html">last</A> section, <A HREF="vice_toc.html">table of contents</A>.
</BODY>
</HTML>