BERKELEY LOGO FOR THE PC

 *	Copyright (C) 1993 by the Regents of the University of California
 *
 *      This program is free software; you can redistribute it and/or modify
 *      it 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.
 *  
 *      This program is distributed in the hope that it 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 for more details.
 *  
 *      You should have received a copy of the GNU General Public License
 *      along with this program; if not, write to the Free Software
 *      Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

The GNU General Public License is in the file GPL in the same directory
as this README file.  NOTE:  The executable program files in this distribution
contain library code that is part of the Zortech C++ compiler, copyright by
the Symantec Corporation, and distributed with their permission.  The GNU
General Public License does not apply to those libraries.

Berkeley Logo is provided in three executable versions:

	UCBLOGO.EXE	runs on 286-and-up DOS, and uses extended memory
			if you have it, so you can run large Logo programs.

	BL.EXE		runs on any DOS PC, but is limited to 640K.

	UCBWLOGO.EXE	runs on Windows 95 and Windows NT only.

----------------------------------------------------------------------

The following notes are for all three versions:

ctrl-Q means stop, ctrl-W means pause.

USERMAN.UAL is the user manual.

The Logo EDIT command runs a separate editor, starting that editor with
a file containing your selected procedures.  Logo will use whatever
editor you want, if there is an EDITOR variable in your DOS environment.
By default, Logo uses Jove, a version of EMACS, which is provided here.
This version of Jove is set up so that typing ctrl-C will save the file
and return to Logo.  You need to put
	SET JOVERC=C:\UCBLOGO\JOVE\JOVE.RC
	SET DESCRIBE=C:\UCBLOGO\JOVE\CMDS.DOC
in your autoexec.bat or something so that Jove will start up right.
CMDS.DOC is the Jove reference manual, used for its online help.

You may also need
	SET LOGOLIB=C:\UCBLOGO\LOGOLIB
	SET LOGOHELP=C:\UCBLOGO\HELPFILES
in your autoexec.bat so that Logo can find its library and help files,
especially if you installed logo somewhere other than C:\UCBLOGO
(but of course then you use the actual path in the SET lines!).

Finally, if the directory from which you run Logo is not writeable
(for example, because you have installed Logo on a network) then in
order to be able to edit you must tell Logo what directory to use
for temporary files by putting a line such as
	SET TEMP=C:\TEMP
in your autoexec.bat.

The CSLS directory contains the programs from Computer Science Logo Style.

----------------------------------------------------------------------

The following notes are for the Windows version (UCBWLOGO) only
(see below for DOS-only notes):

Normally Logo uses ANSI_FIXED_FONT for text displays.  Two batch files
(double-clickable) are included for alternatives:

   OEMLOGO uses OEM_FIXED_FONT
   DEFLOGO uses whatever your Windows' default font is.

I find it easier in a Windows system to copy JOVE.EXE from the JOVE
subdirectory up to the UCBLOGO directory (or make a shortcut).

----------------------------------------------------------------------

The following notes are for the DOS versions only, not UCBWLOGO:

UCBLOGO and BL also usually figure out correctly what kind of graphics board
you have.  But for some obscure clones with nonstandard graphics you might
have to tell it which graphics mode to use.  This is also done with a DOS
command:
	SET FG_DISPLAY=xxxx
where xxxx is the board type and mode, as follows:
	CGAHIRES, CGAMEDRES, EGACOLOR, EGAECD, EGAMONO, EGALOWRES,
	HERC, ORCHIDPROHIRE, PARADISEHIRES, TOSHIBA, TRIDENTHIRES,
	VEGAVGAHIRES, VESA6A, VESA2, VGA11, VGA12, VGA13, 8514A
I don't know anything about any of these except that TOSHIBA is for a
T3100 and doesn't work on my T1200XE.  I use VGA12 on my generic clone.

There are some graphics modes that will work with BL.EXE but not with
UCBLOGO.EXE, including VESA1 for 256 colors of 640x480.

Finally, note that Logo writes directly to the screen and is therefore
incompatible with "screen accelerator" TSRs.  (For example, my PC comes
with one called PCKSCRN and I had to turn it off before running Logo.)
The file UCL.BAT is a sample batch file that I use to disable the screen
accelerator, run Logo, then re-enable it.  If you have a different
screen accelerator you'll need different commands, of course, but the
idea is the same.

----------------------------------------------------------------------

The remaining notes are for the UCBLOGO version only:

In order to run UCBLOGO.EXE you must have the file ZPM.EXE (which is
provided) in your DOS path.  ZPM has to figure out what kind of extended
memory interface you have, and in some cases it needs help.  You must use
the DOS command
	SET DOS16M=1		for NEC 98-series
	SET DOS16M=5		for Fujitsu FMR-60 or 70
	SET DOS16M=6		for AT&T 6300 Plus
	SET DOS16M=7		for old Phoenix BIOS versions
	SET DOS16M=13		for Zenith Z-24X with old BIOS
	SET DOS16M=INBOARD	for 386 with Intel Inboard
Even if UCBLOGO runs correctly for you without any of these settings (which
will be the case for most machines) you might try
	SET DOS16M=10		for faster performance on some systems
				but slower on others -- experiment.

Fred Gilham reports:  "I couldn't get UCBLOGO.EXE to run unless I
prevented HIMEM.SYS from managing all the extended memory."  So if
you get a cryptic message from ZPM.EXE maybe that's the reason.
