PBT Quiz version 1.1
(C) 2004 PEERSOFT


1. Introduction

PBT Quiz is a simple game developed for PBT. It uses data files to read
questions and evaluate your answers. As PBT is *not* primarily used to play
games, PBT Quiz has these limitations:
- you must answer all questions contained in the data file
- questions are asked in the same order you placed them in the data file,
  no randomness is possible


2. File list

PBT Quiz is comprised of the following files:
PQ_ADD .PAT - patch script used to add questions to your question data file
PQ_PLAY .SC? - script files allowing to interpret question data files
             and thus play the game (written in both PLL and PBT's native
             script language)
PQ     .DAT - sample question data file containing questions about PBT
PQ     .TXT - this file


3. Usage

If you want to just play the sample question file, type:
PP PQ.DAT PQ_PLAY.SCP

If you would like to create your own question data file or add questions to
existing data files, enter:
PBT P +<datafile> @PQ_ADD.PAT
where <datafile> must be replaced with the name of your data file. One plus
sign preceding the file name informs PBT that it should try to create the
requested file or just open it if already created.
First, you will be asked to enter your question text. It can be no longer
than 75 characters and should not end with a question mark as PBT displays
one when playing the file.
Then, you will be asked to enter four possible answers to be displayed as
possible choices. You should type just text, no bullets, graphics or
letters preceding the actual text, PBT automatically displays them.
As the last step, you will have to enter the letter of the correct answer.
Be sure to enter A, B, C or D as PBT performs no checks and entering other
characters would surely make the game unplayable. However, letter case is
not significant, PBT Quiz can cope with it.

You can add just one question at a time, further question entries require
PQ_ADD be launched repeatedly.


4. Closing words

PBT Quiz was developed to demonstrate extreme cases of PBT's usage. PQ_PLAY
is a hybrid script containing several shorter and longer pieces of assembly
language code. This is because PBT includes support for scripting, not a
whole programming language. Its scripting language is sufficient for accessing
binary files and assembly language support has been incorporated into it to
aid advanced programmers. As a general rule, when using the assembly
language with PBT, your scripts should look like assembly-aided PBT
scripts, not PBT-aided assembly programs. For these purposes, write your
programs entirely in the assembly language or using a high-level
programming language such as C or Pascal. PBT Quiz is rather PBT-aided
assembly language program. As stated above, this is just an example of
extreme cases with excessive assembly code usage. Consider it as a joke
program only. Advanced users are welcome to study it thoroughly,
beginners or intermediate computer users should *NOT* consider it as a
good example for learning PBT!

