home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ftp.wwiv.com
/
ftp.wwiv.com.zip
/
ftp.wwiv.com
/
pub
/
BBS
/
RTRIM52.ZIP
/
RTRIM.DOC
< prev
next >
Wrap
Text File
|
1992-02-10
|
29KB
|
526 lines
RTRIM - VERSION 5.2
Author - Bob Keber
TypeRight
336 Swain Blvd.
Lake Worth, FL 33463
(407) 969-3643
DISCLAIMER
Use This Software At Your Own Risk
The author of this software makes or offers no warranty, either
expressed or implied, regarding any of the software programs included
with this package. There is no warranty for this software's usefulness,
or for it's fitness for any particular purpose. The author will not be
liable for any damages arising from the use of (or from the inability
to use) this software. The author will not be liable for lost profits,
lost savings, lost income, lost time, lost or damaged files, claims by
other parties, or for other incidental or consequential damages arising
from the use of (or from the inability to use) this software. Use (or
misuse) of this software is entirely at the user's own risk.
NO CHARGE - FREE USE
NO CHARGE: This program has been released for the free use of anyone who
finds it useful. However, this does NOT allow or give permission to any
other person or organization to "Sell" copies of this program to others.
If you wish to obtain the latest, debugged and improved version directly
from the author, then print out and mail in the Registration Form contained
in the enclosed file called "Register.Doc". There is a small fee for this
service, which will help cover our time, materials and shipping costs.
GETTING STARTED
FOR "QUICK" RTRIM OPERATION: Enter one of the following commands
from any DOS or MS/DOS Screen Prompt......
RTRIM (Runs RTRIM with full screen menus & help)
RTRIM FileName.Ext (Will Strip BLANKS from RIGHT END of text lines)
RTRIM FileName.Ext/H (Trims RIGHT-BLANKS & Converts HI-BIT Characters)
RTRIM FileName.Ext/L (Removes Excessive "Blank" Lines from a file)
RTRIM FileName.Ext/J (Will "Un-Justify" a file - Removes 2-3 spacebars)
RTRIM FileName.Ext/E (Trims RIGHT-BLANKS & Removes "Escape Codes" such
as FORM FEEDS & END OF PAGE)
RTRIM FileName.Ext/H/E/L/J (Does all of the above)
"FileName.Ext" represents the name of your TEXT file that you wish
to have RTRIM.EXE work on. For instance, if you wanted to use
"RTRIM.DOC" as your input file, you would enter "RTRIM RTRIM.DOC".
You may use some of the DOS "WildCard" names to select more than
one file in the same directory. Entries such as "*.DOC" or
"????????.TXT" will "trim" ALL the files who's names end with "DOC" or
"TXT".
The "OUTPUT" file's name will be the same as the "INPUT" file,
except for the last character in the name, which will be changed to
"@". In other words, "TEST.DOC" would have an "R-Trimmed" output file
called "TEST.DO@". If an output file already exists with the same "@" name,
the program will warn you, and offer the options of "Over-write" or "Quit".
RTRIM will NOT check for "Free Disk Space" before it starts to
create all the output files. It's up to YOU to make sure that there is
about the same amount of free space available that your DOC files use.
The output file(s) will contain a copy of your original file(s),
but with all of the changes you elected to perform. Your original
file(s) will be left unchanged.
Always check over your Output File(s) VERY carefully BEFORE you
replace your Original with it. Make sure that "Charts", "Boxes",
"Graphs", and so on, are as they should be, and that any "Page Offset"
insertion or removal has not effected the text in a negative manner.
If your Input File has ANY GRAPHIC CHARACTERS which you wish to
have left alone (Boxes, Pictures, Drawings or Source Code containing
any Command Line Graphics), DO NOT tell RTRIM to convert HIGH-BITS.
RTRIM will happily convert ANY graphic character it finds, because
Graphics are HIGH-BIT characters too. This would leave you with Boxes
shaped with M's, D's, and a host of other alphabet characters.
FOR THE OTHER RTRIM OPTIONS: Enter the following command from any
DOS or MS/DOS Screen Prompt....
RTRIM <...and hit Enter>
RTRIM.EXE will then load and proceed to guide you through all of
the various options with "on-screen" instructions and questions.
WHAT IS RTRIM.EXE ?
It's a simple little utility for "Adjusting" and "Changing"
different kinds of "TEXT" files to suit YOUR OWN needs.
RTRIM will "Trim" all of the Spacebars, Nulls, and Blank Spaces
that may be invisibly attached to the RIGHT end of each line of
text, or which may be invisibly hiding on many of the "Blank" lines
within your text (also in any ASCII Source Code).
This feature will produce a copy of the original file which (in
many cases) is much smaller than the the original file. And yet, it
does this without moving the original text's positions in the file.
There are NO apparent, VISIBLE differences between the two files
except for the difference in sizes.
ADDITIONAL "OPTIONAL" FEATURES
OPTION #1 - INSTALL PAGE OFFSET - Has the ability to create up to a
nine space "Left Margin" or "Page Offset" in the new output file.
This allows you to punch holes for the use of binders and report
covers without covering up (or punching out) any of the text.
OPTION #2 - REMOVE PAGE OFFSET - Has the ability to "Remove" a "Page
Offset" from any ASCII Text file. But be cautious, as this routine
will ask you "How many Spaces" it should remove from the left side
(beginning) of each line of text. If you tell it to remove too
many spaces (more than any existing offset), it will quickly remove
the beginning characters from each line of text too (in the output
file only - originals are never changed at all).
OPTION #3 - REMOVE EXCESSIVE BLANK LINES - Has the ability to
"Remove" excessive "Blank Lines" from any ASCII Text file.
I'm sure that many of us have had the misfortune to innocently
begin printing someone's "DOC" file for some program, only to
sit and impatiently watch as our printer spits out page after page
with little or no text printed on them (eg: "JOE'S PROGRAM" [65
linespaces]..., "VERSION 1" [65 linespaces]..., "A SHAREWARE
PROGRAM" [65 linespaces]..., etc.). I swear, some of these authors
must own stock in either a Paper Mill or a Garbage Dump.
This option eliminates this problem by removing all successive
"Blank Lines" when there are three (3) or more in a row. It will
allow a maximum of two (2) blank lines together, and then start
chopping them out of the text, thereby shortening the file (and the
paper required to print it out).
If the file contains "PAGE #s", then this option will make them
useless. The same is true for page "Headers" and "Footers". But, they
can usually be easily removed with most Word Processor's "Find &
Replace" features.
OPTION #4 - CONVERT HI-BIT WORDSTAR FILES - A feature that will auto-
matically reset the "High Bits" on any character that has the "High
Bit" set.
The above statement may sound "very scary, technical and
complicated" to a novice operator, so let me make it simpler by
explaining what this routine is most often used for.
If you use a Word Processing program (like Wordstar for example),
you may find that the text files look something like an "Arab's
Alphabet" if you try to read (or print) those files WITHOUT
using the Word Processor which created the files in the first place.
This kind of problem is especially tough if the file you are
trying to read or print originally came from someone else, and YOU
DON'T HAVE their brand of Word Processor (which happens on many
downloaded files).
Those kind of TEXT files will appear a bit scrambled because the
"High Bits" are set on the majority of the characters within the file.
Why? Who Knows? But we assume that the folks who wrote the Word
Processing program (hopefully) had a good reason for doing things like
this.
All that RTRIM.EXE does is "Reset" the "Bits" back to normal
again. It will NOT mess-around with any character who's bit is NOT set
to high, so it's safe to run any ASCII Text (NO GRAPHICS) file through
this routine. When RTRIM.EXE is done the copy of those files will then
look (and print) much the way the Author originally intended them to.
OPTION #5: "UN-JUSTIFY" A TEXT FILE -
This option will automatically remove all those "double" and
"triple" spacebars that many word processors insert into lines of
text to make each and every line the exact same length, and have every
line end on the exact same column.
Originally (when printed from inside of the word processor which
created them - with a printer capable of printing variable sized
spacebars), those extra spacebars are divided evenly between all the
other "normal" spacebars, each of which becomes slightly and equally
larger to "justify" the line without all those obvious extra spaces.
However, when the same file is converted to a "plain vanilla"
ASCII Text file, those extra spaces become "locked" into the text as
if they had been put there on purpose. At that point, unless you want
to go to an awful lot of work eliminating them one by one by hand,
you're stuck with them.
But not anymore. "RTRIM" will now "Un-Justify" any text file
(eliminate all those extra spacebars), and do it in a pretty
intelligent manner at the same time.
It won't remove the leading spacebars from ANY line of text. This
means that "1st Line Paragraph Indenting" is NOT eliminated. Page
offsets and Left Margins are NOT eliminated. "Centered" lines of text
will stay "Centered".
Beyond that, if there is a double spacebar after a Period,
Exclamation or Question Mark ( ! ? . ), it will be left unchanged.
About the only places where "RTRIM" will change the text in an
"unfavorable" manner is in those places where the text has been
purposely separated by only TWO or THREE spacebars...,
Quantity Description Part Number Price
___________________________________________________
1 GOLDFARKLE 1078988 $25.65
...... would wind up as....,
Quantity Description Part Number Price
_________________________________________________________
1 GOLDFARKLE 1078988 $25.65
THE RULE: (By Executive Order!)
Any place in the text where RTRIM finds 2 or 3 spacebars in a row,
it will trim them down to only ONE space!
EXCEPTIONS TO THE RULE: (oops...)
When TWO spacebars are located after certain punctuation marks
(Period, Question & Exclamation) they will be left alone.
When TWO or THREE spacebars are located at the "beginning" of a
line of text (like a margin would be), they will also be left alone.
When any Text is separated by FOUR (4) or more spacebars, they
will also be left alone.
(So much for "Iron Clad" rules...)
OPTION #6 - REMOVAL OF ESCAPE CODES FROM TEXT
What's an Escape Code? While it may sound like something a
criminal would use in a "getaway", it's really nothing all that
exciting.
Escape Codes are simply special codes that are embedded into many
text files to tell the printer what to do (Form Feed, New Page, Change
Type Style, Change Pitch, Bold On, Bold Off, and so on).
IN CLOSING
I've done my best to make "RTRIM" behave itself and do this job
without causing problems for anyone. But because of the unlimited
kinds and types of files that will be run through RTRIM, it's simply
not possible (in this day and age) to make it "adjust itself" and
perform perfectly to every conceivable situation (which constantly
changes, line by line).
But bear in mind that all these changes are ONLY done to the
OUTPUT file, and NEVER to the ORIGINAL file. As a result, if YOU use a
little caution BEFORE erasing your original files, "RTRIM" should
never cause you any problems.
While you sometimes "might" have to make some manual corrections
or adjustments to the output files to make them perfect, it's a good
bet that "This" small amount of manual work will be a LOT LESS effort
than trying to do the whole job that RTRIM did, by hand.
We put together this little utility for our own use, and then
found that we used it a lot. So much, that we decided to donate it's
use to anyone else who may have a need for it.
If you have a situation where you send long text files from one
of your offices to another by modem, then use this program to strip
out all unnecessary Spaces, Page Offsets, and Extra Blank Lines before
you send it via modem. Then use this same program at the receiving end
to put the Page Offset back into the Text file again. It can be a
real time saver (even if you use "Data Compression").
Program authors can produce smaller "DOC" files by using this
routine, which will cut down on modem transmission time and file
sizes. The Users can then use RTRIM to "adjust" the Text files for
printing after they've downloaded the files and have read them on
their monitors.
It just seems like a big waste of time, effort, money and disk
space to send, transmit and store thousands of empty spaces hiding
inside most Text files.
We suggest that you run RTRIM and use "this" file (RTRIM.DOC) for
your "Input File" (...use the command RTRIM RTRIM.DOC/E/H/J/L).
We have "Stacked The Deck" a little with "RTRIM.DOC", but it will
help you to see what a BIG difference RTRIMMING a file can make.
We would be most interested in hearing about any suggestions
for improvements (or complaints) which you may have about RTRIM.
Heck, we'd even be glad to just know that you are using it. Enjoy!
Bob Keber
SAMPLE OF WHAT A FILE LOOKS LIKE WITH "HIGH-BITS" SET
----------------------------------------------------------------------
Thi≤ áprograφ i≤ presenteΣ a⌠ "N∩ Chargeó t∩ thσ P├ Use≥ a≤ ß áwa∙ áoµ ì
sayinτ á"Thanksó áfo≥ al∞ oµ thσ suppor⌠ anΣ encouragemen⌠ á"weó áhavσ ì
beeε giveε b∙ ou≥ "Use≥s ª Distributorsó durinτ thσ pas⌠ fe≈ years.
Therσ arσ man∙ dedicateΣ peoplσ anΣ organization≤ betweeε "usó anΣ ou≥ ì
Users¼ wh∩ havσ helpeΣ u≤ t∩ Sel∞ anΣ Distributσ man∙ oµ ou≥ programs« ì
Thσ áSysops¼ áLibrarians¼ Use≥ Groups¼ SIG≤ áanΣ á"Sharewarσ áCatalogó ì
peoplσ havσ donσ ß gooΣ joΓ fo≥ us¼ anΣ wσ offe≥ ou≥ thank≤ t∩ you.
----------------------------------------------------------------------
<<<<<<<<<<**************************************************>>>>>>>>>>
|||||||||| ADDITIONAL TypeRight SOFTWARE PRODUCTS ||||||||||
<<<<<<<<<<**************************************************>>>>>>>>>>
ADDRESS CONTROLLER: Powerful yet Simple Address & Phone List Manager:
Handles Multiple Address Files. Does Multiple Label Outputs. Prints 2
Phone Book Directories & 3 Address Book Directories. Prints Index &
Rolodex Cards. Find records by ID# or SEARCH & FIND on ANY field.
Address Records have fields for 2 Telephone Numbers & 2 Extension
Numbers. Also has a 67 Character COMMENT field and an Address CATEGORY
field. BROWSE through Address Lists with Arrow Keys. Pick/Choose "Who"
to print Labels for. LOCK-IN repetitious field entries when entering
records from "City Directories". Sends ANY "Printed Output" (even
Labels) to the printer OR to a "Disk File". Maximum size of address
files is 9,350 records, with an unlimited number of files. Can MERGE,
EXTRACT & SORT address files. CONVERTS address files To/From RANDOM,
SEQUENTIAL & DBASE formats. By: BOB KEBER - Shareware $42
"KEBER's NICE ADDRESS PROGRAM" ("K.N.A.P."):
HEAVY DUTY ADDRESS & TELEPHONE program. Has most of the same features
as Address Controller, but handles up to 725,000 Records per Address
File. NO LIMIT on Files. Files never need Sorting, as new records are
sorted as they are entered. Finds records by Partial NAME or ID#. Mail
Labels are printed according to the Oct-90 Post Office Address Layout
suggestions. Does International Addresses. Many Other Features. Super
Fast & Feature Packed. By: BOB KEBER - Shareware: $42
GENERAL INVOICE SALES TRACKER - ORIGINAL ("GIST-ORIG"):
INCOME & BILLING program for firms who produce a majority of their
Invoices from "OUTSIDE" of their own office (such as Service Firms).
Provides all of the "Gross Income Tracking Information" required by
most Accountants. Knowledge of BOOKKEEPING IS NOT NECESSARY! Prints
Invoices, Statements, Labels, Reports, & Invoice/Customer Directories.
Does Acc/Rec Customer Statements automatically. Holds about 1.5
million records. Quickly find any record by ID# or CUSTOMER NAME.
Compact data files, good for smaller disk drives. Very Fast Data
entry. Numbers only - placed into any of 13 Sales Categories (NO
Descriptions). Eleven of the 13 Sales Categories can be "Renamed" to
suit your type of business. Ready to use! No Inventory to type in, no
special forms to purchase. Almost NO program preparation at all. Just
set up "Your" Name/Address/Phone, Sales Tax Rate, etc., and it's ready
to go to work for you. By: BOB KEBER - Shareware - $69
GENERAL INVOICE SALES TRACKER PLUS ("G.P."):
INCOME & BILLING program for firms who produce most Invoices from
"Inside" of their own offices, and who need "Descriptive - Computer
Generated Invoices" which contain more than just "Numbers". Provides
all Gross Income information required by most Accountants. BOOKKEEPING
knowledge IS NOT NECESSARY! Prints Invoices, Statements, Labels,
Reports, Invoice Directories & Customer Telephone/Address Books. Does
Acc/Rec Customer Statements (with matching Mailing Labels, or set up
for use with Window Envelopes). Holds about 1.5 million records. Find
any record by PARTIAL NAME or NUMBER. Creates much larger Data files
than "GIST-ORIG", so a Hard Drive is recommended. Saves BOTH the
Numbers & Product/Part/Labor Descriptions. Many Adjustable features
can set up "GP" to fit different business needs and local laws. Like
"GIST-ORIG", "GP" is pretty much "Ready To Go To Work" for you, and
very little program "Set-Up" is required. There are NO extra purchases
required or needed. Package Includes a Pop-Up Inventory, Packing List,
and Currency Conversion programs. By: BOB KEBER - Shareware - $89
TypeRight SOFTWARE SALES TRACKER ("S.S.T."):
A Sales Tracking program for Software Authors who distribute and sell
their own software products. Handles multiple Product Files, changing
files quickly through "Pop-Up Windows". Provides "Gross Income"
information, displaying a wide variety of totals, sub totals and
averages for an entire file, or for any range of dates you select.
Issues Program Serial Numbers. File records store Customer Address &
Phone, Serial #'s, Program Name & Version, Quantity, Price, Shipping,
Sales Tax, Dates Sold & Paid, Purchase Orders & Check #'s (and has a
67 space COMMENT field). Printing routines include Mailing Labels,
Customer Address & Phone Books, Invoices, Customer Statements
(Acc/Rec), Index & Rolodex Cards, Shipping Labels, "Print To Disk
Files", and much more.
Software Sales Tracker - PATCH ("SSTPATCH"):
A separate program (but part of.., and included with "SST") for easily
"Patching" a Customer's Name, Date Of Sale, and Registered Product
Serial Number into any of YOUR "EXE" programs. Includes an "Automatic
Bulk Disk Preparation" feature. When on "Full Automatic" SSTPATCH will
read data from your "SST" product files, patch your "EXE" files with
your customer information, and then print a mailing label and a disk
contents label. It then follows a list of commands which YOU provide
for final disk preparation (FORMAT, REDATE, ARC-IT, COPY, etc.). This
"automates" the task of sending out hundreds of disks to Customers and
Distributors. The only thing you need to do is keep blank disks in the
drives, stick on the labels, and mail the finished product. Both the
"SST" & "SSTPATCH" programs are part of the same software package, and
are shipped accordingly. By: BOB KEBER - Shareware - $42
"POP-LABEL" ("P.L."):
A small, fast, "Pop-Up-Window" that will allow you to quickly Type Up,
Save and Print a "Label" (or multiple copies of a Label) for most any
purpose (contents labels, address labels, report cover labels, etc.).
Each Label can hold up to five lines (70 characters per line) of data.
Printed output is straight ASCII Text (Plain Vanilla - without any
"Printer Escape Codes") and should work with most parallel printers.
This program can eliminate many of those label typing sessions still
done on your old typewriter. By BOB KEBER - Shareware - $18
TAKE ONE OF THESE PROGRAMS ABOVE FOR A TEST DRIVE?
If you would like to "Try" one or more of the above programs, and are
unable to obtain them from your normal software supplier, we will be
glad to send "UnRegistered Evaluation" versions directly to you for a
small fee to cover Shipping & Handling expenses.
ANY 1 PROGRAM = $5
ANY 2 PROGRAMS = $7
ANY 3 PROGRAMS = $9
ANY 4 PROGRAMS = $10
ANY 5 PROGRAMS = $10 (no extra charge)
Send us a note stating which program(s) you would like to try.
Please specify the programs by NAME (not just "Send All Programs"). As
time goes by, new programs will be added to this list. That's why we
will need Program Names to properly fill your order. Be sure to include
your Name, Return Address, Telephone and Check. Orders are are usually
shipped within 24 hours of receipt. Make Checks Payable To: "R. KEBER"
ROBERT F. KEBER JR.
336 Swain Blvd.
Greenacres, Florida 33463-3342
(407) 969-3643
If you wish to purchase a "REGISTERED" version of any of the above
programs, send a check for the amount shown at the bottom corner of
each program's description. There is NO Shipping & Handling Charge on
any Registered Version. Florida residents, ADD Sales Tax.
After January, 1993 we suggest that you call us for an updated
price quote BEFORE you send in your order. All prices and features are
subject to periodic changes without notice.