                         Using PASFLOW.

Say you have a file called popup.pas. Maybe it is not working
quite to your liking or specifications. Maybe you just want to
smarten up the file so you can read it yourself or demonstrate
your masterpiece to others.

Your tool is PASFLOW. Proceed as follows:

Type PASFLOW

A Menu will appear.

Type in the name of the file under investigation on the first
line.
Call the other file NEW (no extension needed or wanted).
PASFLOW normally checks for unbalanced parentheses, double
inverted commas and single inverted commas.
If these checks are a nuisance and interfere with your
program, you may have to switch them off with the switches
provided. Use the space-bar to switch. You may switch any or
all the switches.

PASFLOW will quickly produce 3 files which in this case will
be called :

NEW.GRA
NEW.EXP
NEW.STR

and you still have the original file by the name of popup.pas

Both NEW.EXP and NEW.STR can be used as input to the compiler
as ordinary 'PAS' files. NEW.STR the STRipped file has no
leading spaces. You will find that this file is the most
compact of the three. NEW.EXP is the smartest and is EXPpanded
(indented) as you would have done were you to be really tidy.

When you are correcting logic errors, you input the new.gra to
your text editor.
You may now edit, insert, move, import other files or whatever
else you need to do when editing. Totally disregard the
flowlines and angles, they are there only as a help to you and
you can reproduce them easily in the next file with the
help of PASFLOW. When you think you are finished call PASFLOW
again.

This time use NEW.GRA (the altered file) as the source code.
Use the name TEST as the second name (no extension).

PASFLOW now realises that it has an altered file NEW.GRA as
the input and strips the graphics out. It will also ask you if
you want to overwrite the old file.
If you answer 'Y' or 'y' you will need to input the file name
again. Until you get familiar with the program - use any name
of your own chosing, later you will overwrite your original
source code, as you surely have the original saved on a
different drive or disk. (Have you ?).

Whatever your answer you will have 3 files, the first two are
:
TEST.STR and
TEST.GRA and
either TEST.EXP or the altered file as say POPUP.PAS
Naturally you may alter TEST.GRA any number of times and put
the altered file through PASFLOW again. This time make the
second filename NEW.

The idea of using NEW and TEST is to keep overwriting the same
area and so save disk space. The names are otherwise up to you
and as the program is Australian you could call the files
Bruce & Sheila and do no harm at all.

You will shortly find yourself using PASFLOW for all files
larger than 24 lines.
Remember we have similar programs for 'C' and dBASE.

Due to the different styles used to write PASCAL programs we
have had to edit your program slightly. If you are the
programmer taught by Kerningham and Plauger - you should be
OK. Their programs are passed with little or no alteration. If
you like to write (style not logic) as the following :

IF THE CAT FALLS OFF THE CHIMNEY
     THEN
          BEGIN

We are sorry, it will be converted to a one liner as

IF THE CAT FALLS OFF THE CHIMNEY THEN BEGIN.

This process makes sure that the Graphics writer can make
sense of the program. When you are finished and the program is
working, you can convert it to whatever form you like - we had
to pick a way for the graphics writer and were sure that the
way of the aforementioned gents should be useful.


While the program is working for you, think of the author who
would appreciate $ 35.00 (Australian) + $ 5.00 post and
handling for the idea and work involved in a program that any
programmer who is seriously working in PASCAL is going to use
5 to 10 times per day .

The Name and Address for registration is as follows:

Apotek Software,
2 Acton Rise,
Kingsley,
Perth,
Australia 6026.
Phone Number is (09) 409 9662.
Please remember we are 8 hours ahead of GMT (London time)


Copyright (c) 1989 Apotek Software.  All rights reserved.

LICENSE

You are granted a limited license to use and examine  on a
trial basis to determine if PASFLOW is suitable for your
needs.  If you find PASFLOW useful and use it on a regular
basis, you are requested to register with APOTEK as a user.

Once you have registered, you are granted a license to use the
PASFLOW program for you own personal or business use.

You may not distribute PASFLOW with any other product or
service without written permission of the copyright holder.

WARRANTY
PASFLOW AND ALL ACCOMPANYING MATERIALS ARE PROVIDED "AS IS"
WITHOUT WARRANTY OF ANY KIND.  THE ENTIRE RISK OF USING
PASFLOW IS ASSUMED BY YOU.
Apotek Software  makes no warranty of any kind, express or
implied, including but not limited to any warranties of
merchantability and fitness for a particular purpose.

IN NO EVENT WILL APOTEK SOFTWARE BE LIABLE FOR ANY DAMAGES
WHATSOEVER (INCLUDING BUT NOT LIMITED TO DAMAGES FOR LOSS OF
BUSINESS PROFITS, LOSS OF SAVINGS, BUSINESS INTERRUPTION, AND
THE LIKE) ARISING OUT OF YOUR USE OR INABILITY TO USE THE
PROGRAM.

BY USING PASFLOW, YOU AGREE TO THE ABOVE LIMITATIONS.
Registration is necessary only once - registration allows you
licensed use of all upgrades to the product.

There are three types of licenses available;

    1) individual  (registration only),
    2) individual (registration with disk), and
    3) commercial.

Registration is required if PASFLOW is used in a commercial
environment.

The individual (registration with disk) license fee of $35.00
establishes you as a registered user of PASFLOW and upon
receipt of your license fee, you will be mailed a diskette
containing the  most recent full version of PASFLOW.


P.S. Some editors need an extra kick to display the
characters. Sidekick needs the cntl QG. If the *.GRA shows 3'
where there should have been a graphics character, please
refer to your instruction for the Editor.


APOTEK SOFTWARE,
2 Acton Rise,
Kingsley,
PERTH 6026.
Australia (09) 409-9662.
P.S. Remember we are 8 hours ahead of G.M.T.

