*************************************************
* NOTE: The following is a description of the   *
* public domain programs created by Franklin    *
* Veaux for the Radio Shack TRS-80 Model 4      *
* computer, running under TRSDOS version 6.x.   *
* These programs are not copyrighted; you may   *
* make as many duplicate copies of this disk as *
* you please, provided you include this file on *
* all the copies. Enjoy!                        *
*************************************************


COOKIE/CMD: This program will produce a random
"fortune cookie" message each time it is run.
The fortune it produces is drawn from
a user-created file called "BYE/LNS." Note that BYE/LNS is
a text file supplied by the user, which must adhere to a
certain format (see FIDX below). COOKIE will generate a
header message, such as "Good evening," based on the time of day
(as indicated by the system clock); specifying COOKIE * will
suppress this message

FIDX/CMD: The purpose of this program is to place certain
necessary indexing information in the file BYE/LNS in order
to make it usable by COOKIE. Any given BYE/LNS file need only
be indexed once; afterward, however, the file is no longer a
readable text file.
The file BYE/LNS which FIDX indexes is simply a collection of
sayings to be chosen at random by COOKIE. Each "fortune" can
be as long as desired; lines are separated by a single carriage
return (0DH), and fortunes are separated from one another by
two CR's. Note that two carriage returns must end the file. Once
it is produced (by a word processor which will generate ASCII
files, for example), it is indexed by FIDX and thereafter each
time the program COOKIE is run, it will select one of the fortunes
at random and display it. The file BYE/LNS can contain AT MOST 255
fortunes. Attempting to FIDX a file with more than 255 fortunes
will cause the indexing to fail. Likewise, COOKIE will generate
an error message if the file BYE/LNS has not been indexed or
does not exist.

TERTEL/CMD: This is a terminal program which emulates
a TELEVIDEO model 920C terminal. Versions 3.0 and later
have provisions for uploading and downloading files,
which are explained in the opening menu.

CIPHER/CMD: This program will prompt for an input file
and an output file, which may be the same file. If no
output file is given, it defaults to the input file
with the extension /CIP; if no extension is given on the
output filespec, it defaults to /CIP. You may then
enter from two to fifteen encryption keys, each a
string of alphanumerics or special characters  up to 25
characters long. The program will then cipher the input
file, using a mathematical system based on the keys you
enter, and write the result to the output file.
To recover the original file, run the ciphered file through
CIPHER again with the same keys. Any type of file (CMD, BAS,
Text or word processing documents, etc) can be ciphered.
Note that an irritating, but harmless, misfeature in CIPHER will
occasionally cause it to place a few random characters at the
end of an unciphered text file. Note too that each key should be
different from every other key.

NOTE/CMD: This program prompts for a subject (up to 30
characters long), then allows the user to type any
short message--up to 16 lines of 80 characters. A short
beep will sound on the 14th line and on each line thereafter,
to remind the user that he is almost out of note space. The
message, which is ended with an ESC (shift-up arrow) or
Control-Z, is then placed in a file called NOTES/TXT.
If NOTES/TXT already exists, the new message is placed
at its end. All messages are inexed by system date and time.

NP/CMD: This file will print, one at a time, all the notes
produced with NOTE/CMD. These notes will then be appended
to a file called OLDNOTES/TXT, and the file NOTES/TXT will
be cleared. Optionally, specifying "NP *" will read the
current note file without clearing the notes or appending
them to OLDNOTES. The user may, by typing a "P" after any
given note, send that note to the system line printer.
If NOTES/TXT does not exist, NP will produce
the message "No current notes exist."

ALERT/CMD: This reminder program is invoked by typing
ALERT (parameters).
The accepted parameters are:
T=nn:nn:nn,short message
R=nn:nn:nn
LIST
CLEAR
T=nn:nn:nn will load the ALERT server into high memory, where
it will continually monitor the system time. At time nn:nn:nn,
the short message will be printed, regardless of what the user
is doing at the time.
R=nn:nn:nn will remove an alert set for time nn:nn:nn.
LIST will list all alerts which have not yet sounded.
CLEAR will clear all alerts and remove the ALERT routine from
high memory.
Note that the ALERT program occupies about 300 bytes of high memory.
If all LOW PRIORITY interrupt task slots are in use, ALERT
cannot be installed. Note also that any active alerts can be
SYSGENed and thereafter do not need to be re-installed when
the computer is reset.

ATTN/CMD: This program is very similar to NOTE.
It can be invoked in one of two ways: by simply
typing ATTN (which does a READ operation), or by
specifying ATTN (POST).
ATTN specified without parameters will look for a file called
ATTN/TXT; if it exists, ATTN will print its contents as a PRIORITY
MESSAGE. Should the file not exist, ATTN produces the
message "No current PRIORITY messages." If there is more than
one current priority message, ATTN will print each one singly,
and prompt you to press ENTER to see the next message.
ATTN (POST) allows you to post a priority message of up
to 16 lines of 79 characters. This message will then be displayed
every time ATTN is invoked with no parameter. In addition,
you may specify ATTN (POST,APPEND),
which will append the priority message you type to any already
existing messages. POST without APPEND replaces any current
priority message.
ATTN is useful primarily to remind you of important events;
it is intended to be placed in a power-on routine (such as
AUTO ATTN) to remind you of the priority message each time you
reset the computer.

FCOMP/CMD: This utility will compare two files, and display any points
at which they do not match. Specifying FCOMP * will also cause a list
of all non-matches to be printed on the system line printer. If the
list is not printed, the compare will abort if more than 10 mis-
compares are detected. FCOMP will also notify the user if the files to
be compared are not the same length.

IDIR/CMD: This program will display a directory of INVISIBLE files
on a disk. Its format is IDIR [:d].

FDUMP/CMD: This is a simple file editing program. It may be invoked
with FDUMP filename, where filename is the file to dump, or simply
by typing FDUMP. FDUMP will display the file's contents one sector
at a time. FDUMP's commands are:
<Break> Prompt for another file to dump or return to TRSDOS.
M: Hex modify current sector.
A: ASCII modify current sector. When modifying a sector, use ENTER
   to write the modifications to disk or BREAK to abort.
G: Toggle display of graphics characters (ASCII 128 to 191) on/off.
F: FIND occurances of a one-byte value in the sector. (Example: F00)
;: Display next sector.
-: Display previous sector.
+: Display last sector
=: Display first sector.

DAY/CMD: This program prints the current system date
(in MM/DD/YY format) and time (in 12-hour AM/PM format).

MOD/CMD: This program will remove all the modification flags
(visible as "+" marks on a DIR command) from the target drive's
directory. If specified with no drive, MOD assumes drive 0. A
different drive can be specified by using MOD :d.

RPW/CMD: This program removes all the passwords from all the
files on the target drive. Its format is:
RPW [:d] [(Parameters)]
:d is the target drive. Accepted parameters are I (to remove
passwords on invisible files) and S (to remove passwords from
system files). This program will remove the USER password and set
the user protection level to FULL; the OWNER password is not
changed.

REPEAT/CMD: This program will repeat any TRSDOS command or run
a program from 1-256 times. Its syntax is:
REPEAT command\nnn,
where command is the command to be repeated and nnn is the number
of times to repeat it. nnn can be any number from 1-255; specifying
0 for nnn causes the command to repeat 256 times.
Note that this program occupies about 160 bytes of high memory while
it is operating.

M/CMD: This program allows you to type multiple TRSDOS commands on
a single line. Its format is:
M command1;command2;command3...
This program occupies about 180 bytes of high memory while it is
operating.
Note that neither M nor REPEAT should be used with any command or
program which alters TRSDOS's HIGH$ pointer, since on exit both
programs reset HIGH$ to whatever it was before the program was
invoked.

PHOTO/CMD: Photo allows the user to take a "photo" of a work
session on the computer--all output sent to the screen also
goes to a file the user specifies, or the file PHOTO/TXT if
no file is specified. It is invoked by typing PHOTO filename,
or PHOTO to use the default output file PHOTO/TXT. To end the
photo session, type PHOTO *. Note that PHOTO must be used with
care, and the user should observe the following guidelines:
The SYSGEN library command is not allowed during PHOTO sessions.
The output file is held in an "open" state throughout the PHOTO
session. Therefore, DO NOT remove or reset this file before ending
PHOTO, and do not boot or reset the machine while PHOTO is active.
PHOTO uses a small amount of high memory and one device--*PH--during
a photo session. Therefore, it is generally a good idea not to
load any high memory modules or alter the TRSDOS HIGH$ pointer
during a PHOTO session. Likewise, the user should avoid using the
SYSGEN command after a PHOTO session--reboot the comuter first.
Note that all output sent to the screen also is sent to the PHOTO
file. This includes control and graphic characters. Generally
speaking, PHOTO should not be used to record sessions where graphics
are used. Likewise, to obtain a printed copy of a PHOTO file, it may
be necessary to remove any unwanted control characters from the file
and/or perform some character translations. For example, linefeeds
(character code 10) should be translated to carriage returns
(character code 13) with the TRSDOS FORMS filter in order to obtain
proper printing.

 
 
 
               ...................................
               .                                 .
               .    Downloaded in 1989 from:     .
               .                                 .
               .      ********************       .
               .      *     8/N/1 #1     *       .
               .      *   904/377-1200   *       .
               .      * Gainesville, FL  *       .
               .      * Guy Omer - SYSOP *       .
               .      ********************       .
               .                                 .
               . Software support for the TRS-80 .
               ...................................
