225 lines
7.6 KiB
Plaintext
225 lines
7.6 KiB
Plaintext
-------------------------------------
|
|
TEX - Text File Utility
|
|
Copyright (c) 1987 by Floyd Zink, Jr.
|
|
All Rights Reserved.
|
|
-------------------------------------
|
|
|
|
|
|
About TEX
|
|
---------
|
|
|
|
This program is FREEWARE. You can distribute TEX freely, just don't
|
|
sell it. I do ask that you make sure that this doc file is made
|
|
available with the program. You are under no obligation to pay
|
|
anything for TEX.
|
|
|
|
However, if you like this program and want to show your appreciation
|
|
I do accept gratuities. If you send me $10.00 I will send you the
|
|
latest versions of both TEX and BLU - Binary II Library Utility and
|
|
any other FREEWARE programs that I might write. The $10.00 will also
|
|
entitle you to 1 additional free update that will be AUTOMATICALLY
|
|
mailed to you when I update the programs again. This way I make
|
|
a little money and you do not have to spend the money downloading
|
|
the updates. After the first mailing and the free update I will
|
|
continue to mail out updates, but I will include a bill for $3.00
|
|
to cover disk and shipping costs. This way you will always have
|
|
the most current versions. I will do all mail outs before I upload
|
|
them to any source. You will find that in the long run this method
|
|
will be cheaper for you than the connect charges would be for
|
|
downloading this program. My address is:
|
|
|
|
Floyd Zink, Jr.
|
|
P.O. Box 060069
|
|
Palm Bay, FL 32906
|
|
|
|
|
|
I repeat YOU ARE UNDER NO OBLIGATION TO PAY ANYTHING FOR TEX.
|
|
----------
|
|
|
|
|
|
Features
|
|
--------
|
|
|
|
1) Catalogs disks
|
|
|
|
2) Types files
|
|
|
|
3) Appends files together
|
|
|
|
4) Deletes files
|
|
|
|
5) Renames files
|
|
|
|
6) Strips linefeeds and ^Z's from files
|
|
|
|
7) Removes carriage returns from files
|
|
|
|
|
|
Program Selectors
|
|
-----------------
|
|
|
|
TEX supports a start-up pathname. If you enter a start-up pathname
|
|
from a program selector like PROSEL or ECP8 the program will use
|
|
that pathname and strip the linefeeds from it and then exit by the
|
|
quit code. If there is no start-up pathname then TEX will display
|
|
the menu and you can go on from there.
|
|
|
|
|
|
The Menu
|
|
--------
|
|
|
|
You can select a menu item by either the first letter in the item or
|
|
by using the arrow keys to move the inverse bar to your selection and
|
|
then pressing return. You will be returned to the menu after all
|
|
processing is done.
|
|
|
|
|
|
Selecting Files To Be Processed
|
|
-------------------------------
|
|
|
|
After making your menu selection you will be prompted for a source
|
|
directory name and where necessary a destination pathname or target
|
|
directory. You can use the TAB key to skip to the next '/' in the
|
|
pathname shown or OA-TAB to back up to the previous '/'. The DELETE
|
|
key will delete characters and the <-- --> keys will backspace and
|
|
move the cursor forward. When prompted for a destination pathname
|
|
be sure and enter a pathname for a file not a directory.
|
|
|
|
After the directory(s) are selected a catalog of the source directory
|
|
will be displayed. Using the up and down arrows will move the bar
|
|
accordingly. The left arrow will unselect an item if it was selected
|
|
otherwise it will move the bar up. The right arrow will select an
|
|
item if not already selected otherwise it will move the bar down.
|
|
Pressing the space bar will toggle a selection also. In addition a
|
|
OA-space or a control-a (^A) will toggle all the items. Pressing
|
|
return will implement the selected task using the just picked
|
|
filenames.
|
|
|
|
|
|
Filename Queue
|
|
--------------
|
|
|
|
The files selected are put into a linked list. This means you can
|
|
select the files in the order you want them processed. This is
|
|
particularly handy for the APPEND function.
|
|
|
|
|
|
Type Files
|
|
----------
|
|
|
|
When typing files pressing any key will pause the display. Pressing
|
|
any key again will start the typing again. Pressing ESC will jump to
|
|
the end of the current file and pressing ESC again will exit back to
|
|
the main menu. Pressing a 'p' or 'P' will toggle the paging option.
|
|
When paging is on the file will be displayed a screen full at a time
|
|
and will wait for a keypress between each page.
|
|
|
|
|
|
Append Files
|
|
------------
|
|
|
|
This feature merges text files that you have selected into one file.
|
|
After the merge you will be asked if you want to delete the original
|
|
separate files.
|
|
|
|
|
|
Strip Linefeeds
|
|
---------------
|
|
|
|
The linefeed stripper creates a temp file with an '.S' extension.
|
|
When it is done processing it renames the original file with an '.ORG'
|
|
extension and renames the temp file to the original file name.
|
|
|
|
At the five bytes located at $204E-2052 are the additional characters
|
|
that TEX will strip out of a file. They are currently set to $1A for
|
|
control-z and $7F for delete. You can use a block editor to change
|
|
these defaults.
|
|
|
|
|
|
Carriage Return Remover
|
|
-----------------------
|
|
|
|
The carriage return remover creates a temp file with an '.R' extension.
|
|
When it is done processing it renames the original file with an '.ORG'
|
|
extension and renames the temp file to the original file name.
|
|
|
|
Before processing the files you will be prompted for some settings as
|
|
follows:
|
|
|
|
1) From the 'Minimum line length' prompt you can use the up and down
|
|
arrow keys to change the default length. The purpose of the minimum
|
|
line length is to try to maintain formatting in short lines. If you
|
|
use the default of '60' TEX will not remove the carriage returns in
|
|
lines of less than 60 characters.
|
|
DEFAULT = 60
|
|
|
|
2) Removing a space immediately before a CR. If 'Yes' then TEX
|
|
assumes this space is extraneous and removes it. If 'No' then TEX
|
|
leave this space in.
|
|
DEFAULT - Yes
|
|
|
|
3) Removing CR when followed by only ONE space. If 'Yes then TEX
|
|
assumes this space is not for formatting and removes the CR. If 'No'
|
|
then TEX assumes it is for formatting and leaves the CR in.
|
|
DEFAULT - Yes
|
|
|
|
4) If prompting for settings is answered 'Yes' then you will be
|
|
prompted for all the settings between every file. If 'No' then you
|
|
are only prompted the one time.
|
|
DEFAULT - No
|
|
|
|
When you press return to select the files to be processed if you
|
|
hold down the open-apple key then the above defaults will be used
|
|
and you will not be prompted for any of them.
|
|
|
|
|
|
Deleting Files
|
|
--------------
|
|
|
|
TEX will not delete files that are locked. I have to draw the line
|
|
somewhere, TEX can't do everything <grin>!
|
|
|
|
|
|
Renaming Files
|
|
--------------
|
|
|
|
When you choose the rename feature you will be prompted for the files
|
|
as usual and then the files will be displayed one at a time with the
|
|
cursor over them to allow you to rename them. Pressing escape will
|
|
skip that file and go to the next one.
|
|
|
|
|
|
Using The Mouse
|
|
---------------
|
|
|
|
If you have a mouse TEX will find it and allow you to use it instead
|
|
of using the arrow keys and you can use the mouse button to select
|
|
files though you still have to press return to start the process after
|
|
the files are selected.
|
|
|
|
The sensitivity of the mouse is at location $204B when the program
|
|
is in memory. This is the $4B byte after the beginning of the program.
|
|
It is currently set at $08. This means the mouse must move 8 increments
|
|
to move inverse bar. If you want to change this use a block editor or
|
|
from the basic prompt enter:
|
|
|
|
CALL-151 ;enter monitor
|
|
BLOAD BLU,TSYS,A$2000 ;load file
|
|
204B:XX ;XX being the new value. Higher value=lesser sensitivity.
|
|
BSAVE BLU,TSYS,A$2000 ;save file
|
|
^C ;back to basic
|
|
|
|
|
|
Final Words
|
|
-----------
|
|
|
|
If you encounter any bugs or come up with any suggestions for
|
|
improving the program please let me know. I will consider all
|
|
reasonable suggestions for improvements
|
|
|
|
|
|
[ Floyd Zink, Jr. ]
|
|
|
|
Compuserve - 73147,2717
|
|
Genie - F.ZINK
|