Documentation for the programs in the cbmbasic directory

   These programs are free software; you can redistribute them and/or
   modify them under the terms of the GNU General Public License as
   published by the Free Software Foundation; either version 2 of the
   License, or (at your option) any later version.

   The programs are distributed in the hope that they will be useful,
   but without any warranty; without even the implied warranty of
   merchantability or fitness for a particular purpose.  See the GNU
   General Public License <URL:http://www.fsf.org/copyleft/gpl.html>
   for more details.

   More information is available at
   <URL:http://www.funet.fi/pub/cbm/crossplatform/transfer/C2N232/>.

The cbmbasic directory tree contains executable versions of the
cbmlink server for different interface types and Commodore computer
models.  The source code is in the cbmsrc directory of the cbmlink
source distribution package.

The executables are primarily sorted by the interface:

c2n232
  The C2N232 adapter, a 38400 bps RS-232 interface for the datasette port
  (available on all Commodore models except the SX-64)
c64net
  A 2-bit/4-bit parallel cable for the Commodore user port
  and the IBM printer port
kontros
  An 8-bit parallel interface for the Commodore user port
  and the IBM printer port
pc64
  A 4-bit parallel cable for the Commodore user port
  and the IBM printer port
prlink48 
  An 8-bit/4-bit parallel cable for the Commodore user port
  and the IBM printer port
prlink88
  An 8-bit parallel cable for the Commodore user port
  and the Amiga printer port
serial
  A null modem connection for the 6551 ACIA chip
transnib 
  A 4-bit parallel cable for the Commodore user port
  and the Amiga printer port
x1541
  A serial cable between the Commodore serial bus and the IBM printer port

There is a directory for each type of interface.  These directories
contain a subdirectory for each supported Commodore model:

b128
  Commodore 610, 710 and B-128
b256
  Commodore 620, 720 and B-256
c128
  Commodore 128, 128D, 128DCR and 128CR
c264
  Commodore 16, 116, plus/4 and V364
c64
  Commodore 64, 4064, 64c, SX-64 (no datasette port) and compatibles
pet3001
  Commodore PET with BASIC 2.0: the 3000 series
pet4001
  Commodore PET with BASIC 4.0: the 4000 and 8000 series
p500
  Commodore P500 and 510
vic20
  Commodore VIC-20, VC-20 and VIC-1001

Each of these subdirectories contain one or more program files:

plain.prg
  The default version
port2.prg
  Support for the PET cassette port #2
reu.prg
  Support for the Commodore RAM Expansion Unit on the 64 and 128
pia.prg
  Support for a PIA-based internal memory expansion on the 64 and 128
piareu.prg
  Support for the Commodore RAM Expansion Unit and
  a PIA-based internal memory expansion on the 64 and 128

The program files contain a BASIC header.  On other models than the
Commodore PET II series (b128, b256 and p500), the BASIC area and the
target area of the server program can be relocated in increments of
256 bytes.  The BASIC listing looks like this:

	64 SYS29+256*PEEK(44):NEW
	52224 SYS

The first line number indicates the computer model (64 for the
Commodore 64).  The second line number is the desired start address of
the server program.  The server can be relocated by simply changing the
line number of the second line, like this:

	49152 SYS
	52224
	RUN

The server can be restarted by typing SYS and the number of the second
line, e.g., SYS49152.  Please note that the relocation address must be
an integer multiple of 256.  Also, the server must reside entirely in
a memory area that is RAM in the default memory configuration of the
operating system.
