CP/M/CPM_CDROM.iso/enterprs/c128/util/printili.sda/PREADME

Text File | 1988-01-03 | 9.0 KB | 181 lines

=============================================================================

     ╨RIN╘ILITY ╓3.3                                      ╫RITTEN ┬Y:
     ┴ ╘EXT ╞ILE ╒TILITY           ***********           [├╚╒├╦.╫┴╟╧╬]
     ╞OR THE ├-128                   09-06-87         -=[├ARL ╞ ╚OWARD]=-
                                   ***********

     ═ODIFICATIONS ┬Y: ╥ITA ─ELAUNE                       [╥.─┼╠┴╒╬┼]

=============================================================================

╨RIN╘ILITY IS A COLLECTION OF ╞ILTER AND ─╧╙ ╒TILITY ╥OUTINES WRITTEN FOR USE
WITH THE ├OMMODORE ├-128 ├OMPUTER, 1571 ─ISK ─RIVE (╙ECOND ─RIVE IS ╧PTIONAL)
AND AN 80 ├OLUMN ═ONITOR.

╨RIN╘ILITY WAS CREATED FOR USERS WHO BRING HOME (OR DOWNLOAD) WORK FROM THE
OFFICE AND NEED TO PROCESS TEXT FILES PRODUCED ON NON-├OMMODORE MACHINES ON
THEIR 128.  ╘HE PROGRAMER ASSUMES YOU HAVE TRANSFERRED YOUR FILES TO A ├-128
├OMPATIBLE DISK.

╓ERSION 3.3 CONTAINSS SOME FEATURES NOT FOUND IN THE ORIGINAL VERSIONS. ╔N
BRIEF HERE'S WHAT SHE DOES;

     ╞╔╠╘┼╥:     ╞EATURES FOUR ╞ILTER ╥OUTINES,

             1.  ╫ORDS ╙TAR ╞ILTER - ╙TRIPS ╚IGH ┬ITS FROM ┴╙├╔╔ ╞ILES.
             2.  ╠INE ╞EED ╞ILTER - ╙TRIPS ╠╞ ├HARACTERS FROM ANY FILE.
             3.  ├ARRIAGE ╥ETURN ╞ILTER - ╙TRIPS ├╥ CHARACTERS FROM ANY FILE.
             4.  ╒NIVERSAL ╞ILTER -(┴DDED TO VERSION 2.0) ╙TRIPS ┴╬┘ ╒SER
                 (DECIMAL) DEFINED CHARACTER FROM ANY ┴╙├╔╔ OR ╨┼╘┴╙├╔╔ FILE.
                 ╟REAT FOR STRIPPING PRINTER CONTROL CODES.


     ├╧╬╓┼╥╘:    ├ONVERTS ┴╙├╔╔ TO ╨┼╘┴╙├╔╔ AND ╨┼╘┴╙├╔╔ TO ┴╙├╔╔ FILES.


     ╙╨╠╔╘  :    ├HOPS ╠┴╥╟┼ ╙EQUENTIAL ╞ILES INTO SMALLER FILES.
                 ╓ERSION 2.0 INFORMS USER OF WRITTEN FILES STATUS AS THE
                 ROUTINE PROGRESSES.


     ╥┼┴─   :    ─ISPLAYS OR ╨RINTS ╙EQUENTIAL ╨┼╘┴╙├╔╔ ╞ILES


     ─╧╙    :    ┴ ─UAL ─IRECTORY ─╧╙ WEDGE IS  INCLUDED TO ╥ENAME OR ╙CRATCH
                 FILES WITHOUT LEAVING THE PROGRAM. ╓ERSION 2.0 ADDED A ─ISK
                 FORMATING  ROUTINE WITH A CHOICE OF ╙INGLE OR ─OUBLE SIDED
                 FORMATS AND DISPLAYS A DRIVE STATUS MESSAGE AFTER SCRATCHING
                 FILES. ╓ERSION 3.3 INCLUDES A ╙EQUENTIAL ╞ILE ┴PPENDING
                 ROUTINE TO ├ONCATENATE UP TO 15 ╙EQUENTIAL FILES IN A SINGLE
                 FILE OF YOUR CHOICE.


╘O RUN THE PROGRAM TYPE RUN"╨TILITY". ╘HE FILE WILL LOAD QUICKLY AND YOU WILL
PRESENTED WITH A ═AIN ═ENU SCREEN GIVING YOU A CHOICE OF THE OF THE ABOVE
ROUTINES

╨RIN╘ILITY'S MAIN ADVANTAGE IS THAT IT INCORPORATES ALL OF THE ABOVE BONES
INTO ONE SINGLE PROGRAM SO YOU DON'T HAVE TOO SEARCH ALL OVER FOR THE ╒TILITY
PROGRAM YOU NEED FOR A GIVEN TASK, IT ALSO ALLOWS YOU TO CUSTOM SET SCREEN
COLORS IF YOU ARE SPENDING MANY HOURS AT YOUR *╨UTER* . ╔N A LITTLE MORE
DETAIL HERE IS WHAT IT DOES:

1. ╞ILTER - ╞ILTER IS THE FIRST OPTION PRESENTED TO YOU AND SENDS YOU TO
   ANOTHER MENU SCREEN WHERE YOU CAN CHOOSE FROM THE FOUR FILTER BONES.

   ╘HE FIRST IS A ╫ORD ╙TAR (╘M) FILTER UTILITY PROGRAM DESIGNED TO CONVERT
   ╫ORD ╙TAR FILES TO STRAIGHT ┴╙├╔╔ FILES. THIS OPTION IS SELECTED BY TYPING
   THE LETTER "╚" FOR ╚IGH ┬ITS. ┴S THE PROGRAM WILL INFORM YOU THIS IS THE
   FIRST STEP IN THE PROCESS OF PREPARING YOUR FILES FOR USE ON YOUR 128.  ╔F
   YOUR ╫ORD ╨ROCESSOR WILL ACCOMMODATE ┴╙├╔╔ ╞ILES (┼G.  ╫ORD╫RITER 128 (╘M)
   BY ╘IME ╫ORKS) THEN THIS WILL BE ALL YOU WILL NEED TO DO TOO WORK WITH THE
   FILE.

   ╔F YOUR ╫╨ PROGRAM DOSE NOT USE ┴╙├╔╔ FILES OR YOU WANT TO VIEW AN ┴╙├╔╔
   FILE WITH THE ╙EQUENTIAL ╞ILE ╥EADER IN THIS PROGRAM  YOU ARE GOING TO
   HAVE TO CONVERT YOUR FILE(S) TO ╨┼╘┴╙├╔╔, ├OMMODORE'S ╓ERSION OF ┴╙├╔╔
   (DESIGNED FOR SPECIFIC INCOMPATIBILITY WITH THE REST OF THE COMPUTING
   WORLD). ╙EE THE "├ONVERT" OPTION BELLOW FOR MORE INFO.

   ╘HE NEXT TWO OPTIONS ON THIS MENU ARE "╠" FOR LINE FEED AND "├" FOR
   CARRIAGE RETURN. ╘HESE OPTIONS WILL STRIP ┴LL LINE FEED OR CARRIAGE RETURN
   CODES FOUND IN YOUR FILES. ╘HIS IS NECESSARY AS FILES PRODUCED ON SOME
   OTHER COMPUTERS OR ╫╨ PROGRAMS WILL OFTEN ADD ONE OR BOTH OF THESE
   CHARACTERS.  ╔F YOUR FILES ARE PRINTING OUT WITH EXTRA LINES IN THEM, (AND
   YOU KNOW YOUR PRINTER IS NOT AT FAULT BECAUSE YOU SET YOUR DIPS SWITCHES
   WRONG) TRY RUNNING THEM THROUGH THESE FILTERS TO CLEAN THEM UP.

   ╘HE "╧" OPTION FOR OTHER WILL SEND YOU TO MY INGENIOUSLY CREATED (╚E!╚E!)
   ╒NIVERSAL ╞ILTER. ╫HICH ALLOWS ┘╧╒ TO DEFINE WHAT CHARACTER YOU WANT
   STRIPED AND TO REPLACE IT WITH ANY CHARACTER OF YOUR CHOICE OR NO
   CHARACTER AT ALL IF YOU WISH (USE 0 FOR THE REPLACEMENT CHARACTER CODE).
   ┘OU WILL NEED TO KNOW THE ─ECIMAL NUMBER OF THE CHARACTER'S.  ┘OUR 128
   ╒SERS ═ANUAL HAS A TABLE IN THE BACK IF YOUR CURIOUS AND YOUR PRINTER'S
   USER MANUAL WILL ALSO CONTAIN DECIMAL CODE INFORMATION FOR STRIPPING
   PRINTER CONTROL CODES AS WELL.

2. ├ONVERT - ├ONVERT IS A BONE WHICH WILL CONVERT ┴╙├╔╔ TO
   ╨┼╘┴╙├╔╔ AND ╓ICE ╓ERSA. ┘OU ARE PROMPTED FOR WHICH TASK YOU WANT
   PERFORMED AT THE BEGINNING OF THE ROUTINE.

   ╬OTE: ┴LL OF THE ╞ILTER AND ├ONVERT BONES ─ISPLAY THE ╘EXT BEING
   TRANSLATED IN THE COMMAND LINE WINDOW AT THE BOTTOM OF THE SCREEN, THIS IS
   NORMAL SO JUST SIT BACK AND RELAX TILL THE PROGRAM IS FINISHED WITH YOUR
   FILE. ┴LSO, YOU ARE PROMPTED FOR ╔NPUT AND ╧UTPUT FILE NAMES, MAKE SURE
   THEY ARE DIFFERENT FROM EACH OTHER, THE PROGRAM WILL GIVE YOU A "╞ILE ╬OT
   ╞OUND" ERROR IF IT CAN'T FIND THE INPUT FILE.   ╚OWEVER, SINCE COMMODORE
   ─╧╙ WILL NOT AUTOMATICALLY OVERWRITE EXISTING FILES THE PROGRAM WILL NOT
   ACCEPT AN ╧UTPUT FILE NAME IDENTICAL TO THE ╔NPUT FILE NAME AND IT IS
   PREFERABLE TO LEAVE A COPY OF THE OGIGINAL FILE ON THE SOURCE DISK. ╘HIS
   WON'T HURT THE INPUT FILE BUT ╔ DIDN'T BUILD IN ANY ERROR CHECKING FOR IT
   EITHER. ┘OU ARE HEREBY FOREWARNED.

3. ╙PLIT - ╘HE ╙PLIT OPTION WILL TAKE A LARGE SEQUENTIAL FILE AND SPLIT
   IT INTO AS MANY SMALLER FILES AS YOU MAY REQUIRE. ┘OU ARE PROMPTED FOR
   ╔NPUT AND ╧UTPUT FILE NAMES AND THEN ASKED FOR THE SIZE IN NUMBER OF BYTES
   YOU WANT THE OUTPUT FILES TO BE. ╥EMEMBER THAT 4 ├┬═ ┬LOCKS ARE EQUIVALENT
   TO APPROXIMATELY 1000 BYTES. ╙O USE YOUR HEAD A LITTLE AND DON'T ASK THE
   PROGRAM TO SPLIT A 4 BLOCK FILE INTO 2500 BYTE OUTPUT FILES. ┴LSO THIS
   BONE IS A DISK ROUTINE SO THE FILE SIZE IS LIMITED TO THE AMOUNT OF
   SPACE YOU HAVE ON YOUR DISK (NOT THE ├-128 ═EMORY BUFFER). ┴CCORDINGLY IT
   WILL TAKE SOMETIME TO PROCESS YOUR FILE SO ╔ SUGGEST A LONG COFFEE BREAK
   WHEN RUNNING THIS BONE. ╞INALLY OUTPUT FILES ARE NAMED  AS FOLLOWS
   1╧╠─╬┴═┼, 2╧╠─╬┴═┼, 3╧╠─╬┴═┼, ETC. AND YOU ARE ADVISED OF THE STATUS AS
   FILES ARE FINISHED BEING WRITTEN TO THE DISK AS THIS BOUTINE DOSE NOT
   DISPLAY TEXT TO THE SCREEN AS THE ABOVE BONES.

4. ╥EAD - ╘HIS BONE WILL READ A ╨┼╘┴╙├╔╔ SEQUENTIAL FILE AND EITHER
   ─ISPLAY THE FILE TO THE SCREEN OR SEND THE OUTPUT TO THE PRINTER. ╘HE
   PRINTER BONE WILL EXECUTE A FORM FEED AT THE BEGINNING OF THE FILE AND
   ALSO WILL SKIP OVER PERFORATIONS AUTOMATICALLY IF YOU ARE USING A TRACTOR
   FEED.  ╔F YOUR NOT, YOU'LL HAVE TO OMIT THIS LINE  FROM THE SOURCE PROGRAM
   FOR SINGLE SHEET PRINTERS.

5. ─╧╙ - ╔ HAVE INCLUDED MY 2 DIRECTORY ─OS WEDGE ROUTINE (2─╔╥128) TO HELP
   IN CLEANING UP A ─ISK AFTER YOU HAVE RUN ANY OF THE ABOVE BOUTINES. 2─╔╥
   WILL PROMPT YOU FOR INSTRUCTIONS TO ╥┼╬┴═┼ OR ─┼╠┼╘┼  FILES AND IF YOU
   NEED TO YOU CAN EVEN FORMAT A NEW DISK FROM WITHIN THE PROGRAM AS WELL.
   ╘HE BOUTINE DOES NOT EXIT DIRECTLY BACK TO THE MAIN MENU SO YOU WILL GET A
   LAST CHANCE TO REVIEW THE DIRECTORY OF THE CURRENT DISK PRIOR TO LEAVING
   THE ROUTINE. ╓ERSION 3.3 INCLUDES A ╙EQUENTIAL ╞ILE APPENDING BONE AS
   NOTED ABOVE.

╨ROGRAM ╬OTES:

╔ HAVE PREVIOUSLY UPLOADED A COMPILED VERSION OF THIS PROGAM, ╒NFORTUNATLY
IT DIDN'T EXECUTE CERTAIN CONVERSION AND FILTER BOUTINES WITH OUT ERRORS AND
╔ HAVE WITHDRAWN IT FROM THE PUBLIC DOMAIN. ╔F YOU ARE USING A COMPILED
VERSION FOR OTHER THAN VIEWING OR PRINTING FILES YOU MAY HAVE SOME PROBLEMS
WITH THE PROGRAM. ╔ AM SORY FOR THIS BUT ╔ HAVEN'T BEEN ABLE TO DEBUG THE
THE DARN THING. ╘HE SOURCE ┬ASIC 7.0 FILE WILL EXECUTE ALL BONES WITHOUT
ERRORS AS FAR AS ╔ HAVE BEEN ABLE TO DETERMINE. ╔F YOU FIND ONE LET ME KNOW
AND ╔'LL FIX IT.

╔F ANY KIND SOLE WOULD LIKE TO TAKE A CRACK A COMPILING THE FILE ╔ WOULD
SURE APPRICIEATE THEIR EFFORTS. LEAVE ME SOME ┼-MAIL ON ╟┼NIE OR ├╔╙ IF
YOU ARE SUCCESFUL AT GETTING AN EXECUTABLE ERROR FREE COMPLIATION.

╔F YOU CAN THINK OF SOMETHING ELSE YOU WANT ╨RIN╘ILITY TO DO LET ME KNOW
WHAT YOUR IDEA IS AND ╔'LL SEE IF WE CAN'T BUILD A BETTER MOUSE TRAP.

╞INALLY THIS PROGRAM IS ╞╥┼┼╫┴╥┼ TO BE USED COPIED AND SHARED FOR YOUR
PERSONAL USE AS YOU SEE FIT.  ╬O ├HARGE OF ANY NATURE MAY BE MADE FOR THIS
PROGRAM NOR MAY IT BE USED FOR COMMERCIAL PURPOSES WITHOUT THE EXPRESSED
PERMISSION OF THE AUTHOR. ╔F YOU HAVE ANY QUESTIONS OR REQUIRE ANY HELP
FEEL FREE TO SEND ME YOUR COMMENTS VIA ┼-═AIL OR THE ADDRESS BELLOW.


┼NJOY,

├ARL....

   [├╚╒├╦.╫┴╟╧╬] ON ╟┼NIE                    [774000,3077] ON ├╔╙

   ╙END COMMENTS OR LETTERS TO;

   ├ARL ╞. ╚OWARD
   11321 ╞AIRVIEW ╙T.
   ┼L ═ONTE, ├┴ 91732