READ_ME.TXT

QUINE  Version 2.0  Release Notes 
==================================


Gianfranco Boggio-Togna		  gbt@computer.org
C.P.  14021
I-20140 Milano (Italy)


This file contains the following topics:

  1. License
  2. Installation
  3. File list
  4. Running
  5. Version number


1. LICENSE
==========

QUINE is free software, distributed under the terms of the
GNU General Public License.

The 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.

The text of the GNU General Public License is available in file
COPYING; it can also be viewed from within QUINE by selecting the
appropriate entry in the help menu.


2. INSTALLATION
===============

QUINE only requires that the "essential" files (see 3.1) be present in
the current directory.


3. FILE LIST
============


  3.1 Essential files
  -------------------

  	QUINE.EXE		the executable program
	QNEFONT.F14		the font file for EGA
	QNEFONT.F16		the font file for VGA
	QNEHELP.HLP		the help file
	COPYING			the GNU GENERAL PUBLIC LICENSE

	READ_ME.TXT		this file

	QUINE.EXE is compiled with Turbo Pascal 6.0


  3.2 Data files
  --------------

	WNTB*.QNE		

	These files contain solutions for over 90 puzzles from
	Raymond Smullyan's "What is the Name of This Book?".
	

  3.3 Source files
  ----------------

	QUINE.PAS		the program
	TFEVAL.PAS		the evaluation machine
	QNEHELP.TXT		the source for the help file

	TFETEST.PAS		a test program for TFEVAL.PAS

	TFEVAL.PAS is placed in the Public Domain.  It is written in
	Standard Pascal and it should be possible to compile it on any
	system having a Pascal compiler supporting the ISO standard.

	Please note that all files containing Pascal source code have been
	formatted assuming TAB stops to be set at columns 5, 9, 13, ...
	All other source files have been formatted assuming TAB stops to be
	set at columns 9, 17, 25, ...

	The algorithms for formula evaluation and the program structure
	are described in my article:

	"A Scratchpad for Truth-functional Logic"
	Computer Language, volume 8, number 12, December 1991


  3.4 Library files
  -----------------

	MAKE_HLP.EXE		the 'compiler' for help files
	KB_UNIT.TPU		the keyboard unit  
	MS_UNIT.TPU		the mouse unit
	WND_UNIT.TPU		the windows unit
	MN_UNIT.TPU		the menu unit
	FS_UNIT.TPU		the file selection unit
	HLP_UNIT.TPU		the help unit
	HLP_TYPE.TPU		interface between HLP_UNIT.TPU and MAKE_HLP.EXE

	Compiled with Turbo Pascal 6.0

	These files are part of a package which I have released under the
	terms of the GNU Library General Public License	and the	GNU General
	Public License.

	The complete package, including the source files and documentation,
 	is available in file WMFHxx.ZIP, in the	/simtelnet/msdos/turbopas
	directory of the Simtel.Net archives. You should get the file if you
	intend to make significant changes to the source code.


4. RUNNING
==========

QUINE is a DOS program and has modest requirements: it runs quite
satisfactorily on small machines, such a 386SX at 16MHz.

Under Windows 3.1x it should be run in full screen mode.  If you
run the program in a window, you will notice that strange symbols
are displayed in place of Greek letters and operators.  The reason is
that QUINE replaces the standard VGA font with a font containing the
special characters it needs and apparently Windows does not support
such font changes in a window.


5. VERSION NUMBER
==================

Version 2.0 is the first to be made available over the Internet.

Version 1.0 was released in 1991 through the Computer Language
distribution channels and apparently sunk into total oblivion (at
least, I never heard of anybody using it).  Though the evaluation
machine was exactly the same as in version 2.0, the user interface
was very primitive and barely usable.
