
                   L3P  README file (version  2.11S, Spring '96)
                   -------------------------------------------

   ***********************************************************
   * L3P is an educational multiparadigm programming language*
   * suitable for high schools and for colleges introducing  *
   * declarative and/or procedural programming. It offers    *
   * and combines the paradigms usually ascribed to PASCAL,  *
   * LISP and PROLOG. An easy-to-use integrated programming  *
   * environment allows you to test procedures, functions    *
   * and predicates in their own interactive environment.    *
   * The untyping option and a rich turtle graphics can also *
   * attract LOGO educators. A free compile-&-go version     *
   * permits you to freely distribute your programs.         *
   ***********************************************************

A few minutes of attention and some useful advices will let you take
full advantage of this shareware package.

DISCLAIMER
Accurate testings have been made. However, under some rare circumstances
or, most probably, when the language is misused, faults could arise.
Neither the company (CEDAM-Padova) nor the authors do not assume
ANY RESPONSIBILITY for ANY CONSEQUENCE or damage caused by running
the software included in this package.

1) CHECK THE HARDWARE REQUIREMENTS
You need a 80286 or higher CPU, a 600 Kb disk space and one of these graphics
cards: CGA, EGA, VGA.
Mouse can be handled by programs but it is not used by the programming
environment.

2) BE SURE YOU HAVE ALL FILES
Afer "unzipping" L3P.ZIP in a proper directory (let us call "the L3P
directory" e.g. C:\L3P), you should have all these files:

README.TXT     : (this file)
INSTALL.BAT    : installation script
TESTINST.BAT   : installation testing script
TOUR.BAT       : a suggested ordering of sample applications


L3P.EXE        : L3P Integrated Programming Environment (evaluation copy)
L3PRUN.EXE     : compile-and-go program (freely distributable copy)
ANQUEENS.EXE   : the EXE version of ANQUEENS.L3P.
CHILDREN.EXE   : the EXE version of CHILDREN.L3P
EXPERTS.EXE    : the EXE version of EXPERTS.L3P
                 (You cannot generate them with this shareware package)

L3P_FAQ.TXT    : L3P Frequently Asked Questions
TUTORIAL.TXT   : introductive brief tutorial on L3P language and environment
MANUAL.TXT     : essential language manual
ORDER.TXT      : registration ASCII form, printable with: PRINT ORDER.TXT
VENDOR.TXT     : notes for BBS SysOps

L3P source files:

ANAGRAMS.L3P   : generating all anagrams of a string
ANQUEENS.L3P   : animating a backtracking process
BSTREES.L3P    : searching on binary search trees
CHILDREN.L3P   : using the libraries to build funny programs
COLORS.L3P     :*color constants
CURVES.L3P     : LOGO-like recursive drawings
ELIZA.L3P      : a reduction of the famous AI program
EXPERTS.L3P    : building and using demo expert systems
HELLO.L3P      : hello program
INTPOWER.L3P   :*integer power function
LISPLIKE.L3P   : how to mimic some higher-order LISP functions
MOUSELIB.L3P   :*mouse handling
MUSICLIB.L3P   :*simple music library for the buzzer
PARADCMP.L3P   : solving the same problem in the three paradigms
PATHS.L3P      : finding and showing all paths in a graph
PERMUTE.L3P    : generating all permutations of a list
PROLOG.L3P     : including prolog sections
QUEENS.L3P     : solving the N-queens problem
TESTINST.L3P   :*used to test the installation
TURTLIB.L3P    :*extending turtle graphics
TUTORIAL.L3P   : file to be used in conjunction with TUTORIAL.TXT


ANIMALS.KDB    :  data file used by EXPERTS.L3P
FORECAST.KDB   :  data file used by EXPERTS.L3P

After installation, files marked with * will be moved to the (newly created)
LIB subdirectory.
REMEMBER: Include files are searched on the LIB directory when they cannot be
found on the current directory.

3) INSTALLATION
Please, be sure to be in the L3P directory and then follow these steps:

a) Execute INSTALL.BAT
b) Update the PATH command in your \AUTOEXEC.BAT by adding the L3P directory.
c) Execute \AUTOEXEC.BAT
d) (Test) Go to the L3P directory and execute the TESTINST.BAT command and
   look at the messages.

If you get the "Bad command or file name" you have probably not correctly
updated the AUTOEXEC.BAT file.

If you read the message "L3P has not much memory: ..." you must be aware
that L3P uses only conventional memory. With less than 450 Kb of free memory
you might not be able to run L3P (maybe L3PRUN).
Some L3P programs are very memory-consuming. So we recommend to leave
conventional memory free as much as possible.
Last part of the test will tell you if you would be able to use mouse in your
programs.

4) ENJOY A QUICK DEMO TOUR
You can get a first idea of the language power by executing the TOUR.BAT
script which will show you some selected and significant demos.
If you like to watch the source code and/or to select the demos by your own
you should use the integrated programming environment (i.e. run L3P).

5) FOLLOW THE TUTORIAL
The better way to run and build programs is to use the integrated programming
environment L3P. You can become aware of its possibilities as well as the
main language features following the short TUTORIAL.TXT course included in
the package.

6) REGISTRATION
You have just an EVALUATION COPY of the IPE (L3P.EXE) subject to the usual
shareware conventions. Shareware is "Try-Before-You-Buy" software, 
it is not free. After a trial period of 30 days, if you intend to use 
the product we ask you to register. By registering you will get:

 a) A registered updated full integrated programming environment (L3P);
 b) The latest version of the comp&go program (L3PRUN);
 c) The .EXE generator for your final applications(L3PCOMP);
 d) A suitable set of demos and useful libraries.
 e) The full Reference manual (plain text).

Registration will encourage futher development to the product.
To register you have to:

- print the ASCII file ORDER.TXT,
- fill it in all its parts,
- mail it to the  following address:

    CEDAM S.p.A, Via Jappelli 5/6, 35121 Padova, ITALY.

    or FAX to: +(39)(0)49-8752900

7) HOW TO CONTACT THE AUTHORS
   
   E-mail: Callegarin and Salvagno <callegar@unive.it>

8) WHERE TO FIND THE LAST VERSION OF THIS PACKAGE

   Look at the SimTel sites, searching for file l3p?????.zip 
   in the  SimTel/dos/misclang  directory. 

9) CREDITS
   Many people have contributed in several ways to this work.
   Let us mention Renato Conte, Massimo Tito and Luca Cardelli.

------------------------------------------------------------------------------
End of README.TXT file

