home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
World of Shareware - Software Farm 2
/
wosw_2.zip
/
wosw_2
/
PASCAL
/
SWAG9308.ZIP
/
READER.DOC
< prev
next >
Wrap
Text File
|
1993-07-11
|
11KB
|
241 lines
READER.EXE v2.0
(SWAG packet READER)
(c) GDSOFT
June 1993
INTRODUCTION
------------
SWAG (SourceWare Archival Group) is a collection of source code and program
examples for the PASCAL programming language. The material has been donated
by various PASCAL programmers from around the world, who desire to
contribute to the advancement of one of the greatest programming languages
there is. MANY THANKS to all who have contributed. As such, NO CHARGE OF
ANY KIND IS PERMITTED FOR THIS WORK.
The material has been collected from various network conferences worldwide,
and organized according to subject. New material is added quarterly, and
new SWAG packets are available from various BBS sources on a FIRST call
basis. See BBS.TXT for current support sites and how your BBS can join.
GETTING STARTED
----------------
The program READER.EXE is a executable program that will allow you to read,
extract or print the contents of SWAG packets. These packets are organized
according to subject, with each one containing a number of PASCAL "snipets"
on that subject. In the rest of this document, I'll refer to the program as
"READER".
The SWAG packets should be placed ALL together in a directory on your disk.
It is recommended that you create a single directory named '\SWAG'. You can
use the DOS command :
mkdir c:\swag
Unpack the distribution archives and place all of the files with the
extension of "*.SWG" in this directory along with READER.EXE.
USING THE READER
----------------
Using the reader is really very simple. Just execute it, and you will be
presented with a directory of all of the .SWG files in the directory that
READER is located in. If you have .SWG files elsewhere on your disk, you
can move around the disk to find them by selecting the ".." file which will
take you to the PARENT directory. Use the HOME, END and the arrow keys to
maneuver around.
ALSO,
The directory window is search key sensitive. This means that if you have
.SWG files or directories listed in the directory box, you can just type
the name of the file you want. For example, pressing 'A' will place you at
the first entry starting with 'A'. Press 'N', and you will jump the the
entry with 'AN...' if you have one. If NOT, you will jump the first file
starting with the letter 'N'.
At the bottom of the screen you will notice a menu indicating some cursor
and function keys :
F2 - GREP
F5 - Toggle STATS
<ENTER> - GO
ESC - QUIT
F2 calls the GREP (search) function. This is a VERY POWERFUL and useful
function, but in order to use this function, you MUST have at least ONE
.SWG file in the directory box, and it MUST be highlighted !! Place the
cursor any one of the .SWG files, and press F2. You will be presented with
a prompt window :
SWAG Message Base Viewer
▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
▓╒ D:\SWAG\FILES\╕▓▓▓▓┌──────────── SOURCEWARE ARCHIVAL GROUP ───────────┐▓
▓│ ..\ │▓▓▓▓│ │▓
▓│ ANSI.SWG │▓▓▓▓│ Your SWAG Support Team : │▓
▓│ ARCHIVES.SWG │▓▓▓▓│ │▓
▓│ CHARS.SWG │▓▓▓▓│ Gayle Davis Goshen, Indiana 46526 │▓
▓│ CMDLINE.SWG │▓▓▓▓│ Kerry Sokalsky North York, Ontario M2P 1L2 │▓
▓│ COLOR.SWG │▓▓▓▓│ │▓
▓│ COMM.SWG │▓▓▓▓│ About SWAG : │▓
▓│ COPYMOVE.SWG │▓▓▓▓│ │▓
▓│ CRC.SWG │▓▓▓▓│ SWAG is a collection of source code and program │▓
▓│ CRT.SWG │▓▓▓▓│ examples for the PASCAL program language. The │▓
▓│ CUR┌─────────────────────── GREP SWAG Files ───────────────────────┐L │▓
▓│ DAT│ Search For : CURSOR;ANSI;CRT │n │▓
▓│ DAT└───────────────────────────────────────────────────────────────┘t │▓
▓│ DESQVIEW.SWG │▓▓▓▓│ programming platforms available today. │▓
▓│ DIRS.SWG │▓▓▓▓│ │▓
▓│ DOS.SWG │▓▓▓▓│ MUCH THANKS AND GRATITUDE TO ALL CONTRIBUTORS !! │▓
▓╘═ for more ═╛▓▓▓▓│ NO Charge of ANY kind is permitted for this work │▓
▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓│ │▓
▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓└──────────────────────────────────────────────────┘▓
▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
Enter a string to search for. You may enter MULTIPLE items separated by a
semicolon (;). Additionally, you can also include a date in the format
MM/DD/YY, and ONLY records AFTER this date will be included. If you enter
JUST the date, ALL SWAG snipets AFTER this date will be included. For
example, entering CURSOR;ANSI;CRT;05/08/93 would search the SWAG packets
for matches for CURSOR, ANSI and CRT occurring AFTER 05/08/93. Entering
JUST 05/08/93 at the prompt would bring back ALL snipets AFTER 05/08/93
REGARDLESS of the subject.
READER will search ALL of the SWAG packets in the CURRENT directory for
matches based on your criteria. A processing box will appear, and all
occurrences of your search string(s) or date matches will be written to a
NEW SWAG file. Initially, this file is named GREPSWAG.SWG, and will be in
the current directory. Upon completion of this GREP process, you will be
asked for the file name. Enter any name AND directory you choose, and the
file will be RENAMED and moved to that directory. This process allows you
to create SWAG files containing ANY combination of material that you
please.
F5 toggles the STATS function. In order for this to work, you MUST have at
least ONE .SWG file in the directory box, and it MUST be highlighted !!
Place the cursor any one of the .SWG files, and press F5. You will be
presented with an EXPANDED directory list showing the description of each
.SWG file and the number of snipets in each.
VIEWING, EXTRACTING, PRINTING SWAG SNIPETS
------------------------------------------
Once you have some .SWG files in the directory box, press <ENTER> and the
package will be read and you be able to manage the SWAG snipets.
You will be presented with a list of all of the snipets contained in the
package with descriptions for each.
At the bottom of the screen, will be the following menu.
│ │
│ F1-Help ▀ F3-Options ▀ ┘- Read ▀ F4-Write ▀ ESC-Quit ▀ │
│ ▄▄▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄▄▄▄ │
F1 - provides some "quick" ALT keys.
┌──────────── READER : HELP ───────────┐
│ Alt F Find Text │
│ Alt S Sort Index │
│ Alt T Tag ALL │
│ Alt U UnTag ALL │
│ Spacebar Tag Current │
│ <ENTER> Read Item │
│ │
│ F1 Help │
│ F3 Program Options │
│ F4 Write Tagged Items │
│ ESC Quit Program │
└──────────────────────────────────────┘
F3 - brings up the OPTIONS menu.
┌──────────────────────┐
│ About │
│ Sort - (ALT S) │
│ Spacebar Tag - ON │
│ Colors │
│ Screen Lines - 25 │
└──────────────────────┘
<CR> - read the snipet
F4 - Write TAGGED items
ESC - Quit
43/50 LINE VIDEO
----------------
You will have the capability of using 43/50 line screens if you have EGA or
better. The option can be found in the OPTIONS menu (F3). It is
automatically disabled if the user doesn't have the capability. Select
SCREENLINES, and if you have an EGA/VGA, you'll get 43/50 line mode.
COLORS
------
To be quite honest, the whole business of allowing users to change colors
is quite a problem. It adds a lot of code to the program, and more often
than not, it is used only once by the user. Therefore, the color selection
if VERY limited.
There are four color group choices available. LIGHTGRAY, BLUE, CYAN, and
RED. Select one that you find pleasing. This will be disabled on monochrome
monitors.
SORTING
-------
ALT S brings up the SORT box. The snipets can be sorted by :
┌────────────────────────────┐
│ │
│ Select Sort Field : │
│ │
│ C - CONFERENCE │
│ N - NUMBER │
│ T - TO │
│ F - FROM │
│ S - SUBJECT │
│ │
└────────────────────────────┘
TAGGING ITEMS
-------------
Snipets can be tagged by using the SPACEBAR. SPACEBAR tag can be turned OFF
in the OPTIONS menu. ALL items can be tagged with ALT T and untagged with
ALT U. Tagged items can be written to a file with F4.
EXTRACTING SNIPETS
------------------
Snipets can be extract to an ASCII file by selecting and pressing the 'E'
key. Enter the filename, and the data with be written out. If the file
selected is already on your disk, you will be asked if you want to APPEND
or OVERWRITE.
WRITING TAGGED SNIPETS
----------------------
Once you have tagged a group of snipets, you can write them to an ASCII
file using F4. Enter the filename, and if it exists, you will be asked if
you want to APPEND or OVERWRITE. All of the tagged items will be written
sequentially.
We hope that you find the READER easy to use, and the SWAG material
valuable in development of your PASCAL programs.
ENJOY !!!!! and GOOD PROGRAMMING !!!
Gayle Davis AND Kerry Sokalsky
SWAG Support Team