home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Shareware Overload
/
ShartewareOverload.cdr
/
educ
/
test.zip
/
TEST.DOC
< prev
next >
Wrap
Text File
|
1987-05-12
|
12KB
|
299 lines
DOCUMENTATION FOR TEST1.COM, TRAIN1.COM, TESTEST1.COM
_____________________________________________________________________________
The described programs, the program names and their documentation are
Copyright 1987 Frank Lendaro P.O.Box 1021, Douglas AK 99824
_____________________________________________________________________________
This software product and manual are being
distributed under the USER SUPPORTED SOFT-
WARE concept. The software and manual are
copyrighted material; they are NOT in the
public domain. However, you are encouraged
to help distribute this product by sharing
it with friends and associates, subject to
the following rules:
1) You may not SELL copies of the diskette
containing the software and manual for
more than your cost of reproduction.
2) Copies of the PRINTED manual may not be
distributed.
3) The software and documentation may not
be altered.
4) The entire contents of the distribution
diskette must be included on any copies.
This includes: TRAIN1.COM,TEST1.COM,
TESTEST1.COM,TEST.DOC,DOC.TST,DEMO.TST.
If you like this product, you can receive an
updated and enhanced version of it by sending
$9.50 + 4% local taxes + $2.00 shipping for
a total of $11.88 to the adress above.
___________________________________________________________________________
THIS SOFTWARE AND MANUAL ARE SOLD "AS IS" AND WITHOUT WAR-
RANTIES AS TO PERFORMANCE OR MERCHANTABILITY. THE SELLER'S
SALESPERSONS MAY HAVE MADE STATEMENTS ABOUT THIS SOFTWARE.
ANY SUCH STATEMENTS DO NOT CONSTITUTE WARRANTIES AND SHALL
NOT BE RELIED ON BY THE BUYER IN DECIDING WHETHER TO PUR-
CHASE THIS PROGRAM
THIS PROGRAM IS SOLD WITHOUT ANY EXPRESS OR IMPLIED WARRAN-
TIES WHATSOEVER. BECAUSE OF THE DIVERSITY OF CONDITIONS AND
HARDWARE UNDER WHICH THIS PROGRAM MAY BE USED, NO WARRANTY
OF FITNESS FOR A PARTICULAR PURPOSE IS OFFERED. THE USER IS
ADVISED TO TEST THE PROGRAM THOROUGHLY BEFORE RELYING ON IT.
THE USER MUST ASSUME THE ENTIRE RISK OF USING THE PROGRAM.
ANY LIABILITY OF SELLER OR MANUFACTURER WILL BE LIMITED EX-
CLUSEVELY TO PRODUCT REPLACEMENT OR REFUND OF THE PURCHASE
PRICE.
GENERAL DESCRIPTION
The three companion programs :
TEST1.COM ( testing program )
TRAIN1.COM ( training program )
TESTEST1.COM ( debugger, an aid in designing tests )
Have a common purpose : to facilitate learning and keep score of
the progress.
TRAIN1.COM
This training engine "runs" training material that you can easily prepare
with any word processor.
The program will display your questions, accept valid answers and reject
inappropriate ones, show the correct answer with an optional comment when
the answer is incorrect, put incorrectly answered questions on hold and
present them again until the correct answer is givern, keep score of points
associated with correct answers as well as the number of times that an
incorrect answer was entered.
TEST1.COM
This testing engine "runs" testing material that you can easily prepare
with any word processor.
Questions can have different formats ( Yes/No, True/False, 1/2/3, A/B/C/D/E
and Notices ) that can be freely mixed within the test file.
All questions can be put on hold an indefinite number of times, and will be
presented again in the same order as they were encountered.
At the end of the test the program will display an optional evaluation,
and store the results in a permanent file on your disk.
TESTEST1.COM
This program is a "debugger" to assist you in preparing correct files for
the other programs.
HOW TO GET STARTED
On your printer, print out the files :
doc.tst
demo.tst
sample.tst
And then call up the TRAIN1.COM program by entering :
TRAIN1
When asked for a file name, enter either DOC ( Try this one first )
or DEMO
or SAMPLE
( do not enter the .TST extension. )
In answering questions give also incorrect answers, to see what happens.
A permanent record of the session will remain on your current disk,
in the form of a file whose name is composed by:
The first 6 letters of your last name,
the initial of your first name,
your middle initial,
plus the extension .RES ( for RESults )
For example,
last name => Lendaro
middle in.=> G
first => Frank
will create a file named LENDARFG.RES in which the results will be stored.
If you last name is shorther than six letters, part of your first name
will be used. If no name is given, the file will be named NONAME.RES.
To see that the file is there, type DIR to see all the files in that
directory, or better yet type DIR *.RES to see only result files.
To see what is in it, you would type :
TYPE LENDARFG.RES
Note : The program will overwrite a file by the same name, so if you wish to
take more than one test and keep a record of each, change something in your
name. For example, instead of entering your middle initial, enter 1 the
first time, 2 the second, etc..( The updated version does this automatically.)
HOW TO PREPARE A TEST
Use any editor or word processor;
Name the file with an extension of .tst ( Example math.tst or hist_01.tst );
Store the file as an ASCII file. ( That means no printer control characters ).
RESERVED CHARACTERS
The following characters cannot be used as the first character of a line
in a test file, except for control purposes :
{ This bracket means that two numbers follow : the limits for the
evaluation. For example, if you want the evaluation to show when the
score is between 10 and 30 (included) than it would look like :
{ 10 30 }
You can have as many evaluation sections as you want, but only one
will show : the first one that matches the score. All others will
be ignored.
= The equal sign means that the evaluation message is over. Use a series
of them to visually separate evaluations.
The evaluation section should be at the very top of the test file.
===================================================================
( Means that the question number, the correct answer and the point value
follow, each separated from the other by a blank space and at the end
by ) . For example, to indicate question 2, a yes or no question whose
correct answer is Yes and that has a point value of 1 when answered
correctly, we would start the line as follows :
( 2 Y 1 )
and the body of the question will begin one line below.
Notice that the blank spaces ( delimiters ) are essential.
. The period as the first character on a line means that the question
is over. A series of periods can make the test file more readeable.
.....................................................................
+ The plus sign means that the optional comment section ( that would show
only if you are using the TRAIN1 program and the answer is incorrect; )
is over. You can use a series of them.
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
- The minus sign means that the test is over with. It has to be present.
----------------------------------------------------------------------
~ This character is used by the program to mark files that contain hold
questions. Do not use as the first character of a line.
TYPES OF QUESTION SUPPORTED
The following types of question are supported, and can be freely mixed
within the same test :
Y(es) or N(o)
T(rue) or F(alse)
1, 2 or 3
A, B, C, D or E
Notices, no score.
The prompt will automatically adjust to accept only the valid answers.
Only ONE ANSWER can be assigned a point value.
HOW TO STOP A PROGRAM
If you are running TRAIN1.COM or TESTEST1.COM you can stop the program
with control-C or Break at any time.
If you are running TEST1, you CANNOT STOP before the test is over,
short of turning off the machine.
This is a security feature to prevent the test taker from stopping the
testing process, calling up and reading the test file, and then resuming
the testing.
The updated version of the program includes much better security, by
encoding the test file to make it unreadeable, and then decoding it at
testing time.
IF YOU HAVE PROBLEMS
If your test does not ran as it should, first run TESTEST1 on them.
Make note of what question is causing the malfunction.
Print out your test, and look at the offending question as well
as the preceeding one.
Compare them with the ones that work..... and you will have found
the problem. If not, please LET ME KNOW.
Again : all reserved characters can be used anywhere EXCEPT
as the first character of a line.
If the program does not seem to work properly, the cause is
very likely to be a unintended reserved character somewhere.
_____________________________________________________________________________
UPDATE NOTICE
_____________________________________________________________________________
The updated version of these programs include :
- Automatic date/time stamp of results;
- Timer that can be optionally enabled/disabled by the test file;
- Check for duplication of the .REC file name and automatic modification;
- A coding facility, that will encode the test file and make it
unreadeable. The test program will decode it at run time.
This will prevent a test taker calling up the test file and reading it,
therefore gaining knowledge of the correct answers.
- A security lock on the result file, to prevent tampering.
And any other modifications based on your suggestions.
For the latest version on 5¼ disk, please send $ 9.50 + 4% local sales tax
and $ 2.00 for shipping, for a total of $ 11.88 to the following adress :
Frank Lendaro
P.O.Box 1021
Douglas, 99824
Your comments and suggestions are appreciated.
Copyright 1987 Frank Lendaro all rights reserved.