THE PASCAL-P6 COMPILER/INTERPRETER

============================== Description =====================================

This is the 6th version of the Pascal-P compiler from Zurich. Pascal-P6 is the
Pascal-P5 compiler upgraded to include the set of extensions defined by the
Pascaline language standard.

Pascal-P was an implementation kit, created between 1972 and 1974, for the
original language Pascal. The source for the original compiler was passed around
and modified quite a bit, but Niklaus Wirth noted that it was very popular, and
represented a good method to popularize the language. He gathered the source
into a clean version called Pascal-P2, which was the basis of UCSD Pascal, which
in turn was the base language for Borland Pascal. The Zurich group then created
an improved version called Pascal-P4. From there a fully ISO 7185 standard
version was created as Pascal-P5. Pascal-P6 is Pascal-P5 extended to accept the
Pascaline language, a highly extended version of ISO 7185 Pascal. It also 
can generate AMD64 binaries in addition to being an interpreter.

The full instructions for running and setting up the Pascal-P6 compiler/interpreter
have all been incorporated into the document:

doc/the_p6_compiler.docx

Which is a Microsoft Word document, 2007 or later.

Please consult this documents for full instructions on how to use Pascal-P6.

============================== Quick start =====================================

Please note that to set up all features of the system, you need to clone
submodules as well:

git clone --recurse-submodules https://github.com/samiam95124/Pascal-P6.git

If you already cloned the repo without submodules, don't worry. Just execute:

git submodule update --init --recursive

And you will get the submodules.

Pascal-p6 uses the standard GNU release layout. You execute:

[linux]

> . ./setpath
> ./configure

And optionally:

> build

(You can avoid "setpath" by placing the ./bin directory on your path)

> ./configure

Will set up your system for the existing host, and place the binaries and other
files you need in the ./bin directory.

> build

This will make the compiler and interpreter set. You don't need to do this step
if you are not changing the compiler. It will be prebuilt for you.

 You can then try a sample program as:

> pc sample_programs/hello
> sample_programs/hello

================================== Problems ====================================

The present  version of Pascal-P6 is limited to Linux, and has been run
extensively on Ubuntu. The Windows and Mac OS/X versions are not runnable at
this time.

You need the "flip" line ending adapation program. If you don't have it, we
include a copy you can compile, or you can simply go find it. It is a widely
available program. You can install it on your Linux via:

sudo apt install flip

================================== Feedback ====================================

The preferred method for feedback is to post in:

https://github.com/samiam95124/Pascal-P6/discussions/categories/general

Because if what you have to say is general to Pascal-P6, everyone can see it
there. There are also several subcatagories for messages at:

https://github.com/samiam95124/Pascal-P6/discussions

Otherwise there is my email:

samiam@moorecad.com

There is also the Pascal web page I run at:

www.standardpascal.org