tok64: Text <==> C64 Basic Converter
Version 1.4 6/15/96 Basic extensions. More special keywords.
Copyright (c) 1996 Cris Berneburg <crisbbigfoot.com>
http://www.geocities.com/stegos/
This software is FREEWARE and is freely distributable.

This program was originally named TOK64.EXE.

tok64 converts ascii text file representations of Commodore basic
program listings into program images suitable to run on a C64.  It 
also converts basic programs back into ascii text listings.  tok64
does NOT perform syntax checking.

*** Use the "/list" command line argument for a list of valid commands.

You may specify multiple commands and/or file names on the command 
line in the order you want the commands to occur.

Default extensions are ".txt" for ascii text files and ".prg" for 
Commodore Basic program files.  That means you may specify extensions 
but if you don't tok64 will look for files with the defaults.
An input text file may contain multiple program listings.  Use the 
"/mult" command to enable this function.  Mark the start of each 
listing with "start tok64 {file name}" and the end with "stop tok64".  
This feature is only available with the "/toprg" command.

Keywords, variables, and quoted named identifiers are NOT case-
sensitive but quoted strings and comments ARE. So, if you issue a
"POKE 53272,21" command on your C64 the quoted strings will appear as
upper case and graphics.  But if you do a "POKE 53272,23" the strings
will be lower case and upper case.  In other words, ASCII to PETASCII
conversion is performed automatically.  To represent special characters
in quoted strings use named identifiers, like "{clear}", or curly-
bracketed ascii values, between "{001}" and "{255}".  You may also
specify quantities like "{down*10}" or "{001*5}".

You may break up the ascii text lines by appending a "\" continuation
character to the end of a line.  The next line of text will be combined
with the current line to create one numbered Basic command line.  So,
the next line of text should NOT have a line number, and any leading
whitespace characters will be ignored.  Do NOT break up a keyword in
continuing a line -- tok64 will not parse it correctly.  BTW, the
maximum line length is 400 characters.
If you find that much of a listing will require many continuation chars 
and each logical (basic) line is hanging-indented, use the /col command. 
tok64 will start a new basic line when a line number starts in column
one and will continue the line, ignoring the physical end of line (cr/lf), 
until another number appears in column one or the end of the file is 
reached. All but one leading spaces are ignored when continuing a line. 
Any non-numeric chars in the first column are not allowed.
Use TRANS64, Bernhard Schwall <schwallathene.informatik.uni-bonn.de>,
or some other utility program to transfer your basic programs between 
your PC and C64 or emulator disk images.

I would like to give special thanks to the following people. Peter 
Karlsson (Fidonet 2:204/145.42) <Peter.T.Karlssonabc.se> for 
assisting with the keyword/token list and with testing. Also to Phil 
Hoff <phoffecst.csuchico.edu> for heavy-duty testing and pushing 
for more features. Ville Muikkula <vmuikkuyrttis.ratol.fi> for testing 
and suggestions for special char replacement.

OK, now for the scary part.  This software is provided to you "AS-IS".
No other warranties of any kind, express or implied, are made to you
as to the software or any medium it may be on, including but not
limited to warranties of merchantability or fitness for a particular
purpose.  So use at your own risk.  Whew!  Are you still there?

If you like tok64 and/or find it useful please consider sending me
an email or a couple bucks to encourage me to continue improving 
it or write other useful software.  Thanks -- Cris Berneburg.

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[generic]                  395     975  40.5% -lh5- 55f1 Nov  4 10:04 tok64/BASENAME.H
[generic]                  398     783  50.8% -lh5- a959 Nov  4 10:04 tok64/GETLINE.H
[generic]                  202     331  61.0% -lh5- 76fe Nov  4 10:04 tok64/GETPROG.H
[generic]                   63      63 100.0% -lh0- 118e Nov  4 10:11 tok64/Makefile
[generic]                 2685    6593  40.7% -lh5- aad2 Nov  4 10:04 tok64/README
[generic]                 1318    2670  49.4% -lh5- 41d0 Nov  4 10:04 tok64/README.md
[generic]                  115     171  67.3% -lh5- cff7 Nov  4 10:04 tok64/RTC.H
[generic]                  319     479  66.6% -lh5- 2b95 Nov  4 10:04 tok64/srcnote.txt
[generic]                20723   45580  45.5% -lh5- b15c Nov  4 10:13 tok64/tok64
[generic]                19907   39100  50.9% -lh5- 2211 Nov  4 10:12 tok64/tok64.68k
[generic]                10854   37542  28.9% -lh5- 4c3a Nov  4 10:04 tok64/TOK64.C
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        11 files   56979  134287  42.4%            Nov  5 02:45