home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / genie-commodore-file-library / C128Toolkit / PRINTILITY-2.SDA / PREADME < prev    next >
Encoding:
Text File  |  2019-04-13  |  9.4 KB  |  192 lines
  1. =============================================================================
  2.  
  3.      ╨RIN╘ILITY ╓2.0                                      ╫RITTEN ┬Y:
  4.      ┴ ╘EXT ╞ILE ╒TILITY           ***********           [├╚╒├╦.╫┴╟╧╬]
  5.      ╞OR THE ├-128                   06-23-87         -=[├ARL ╞ ╚OWARD]=-
  6.  
  7. =============================================================================
  8.  
  9. ╨RIN╘ILITY IS A COLLECTION OF ╞ILTER AND ─╧╙ ╒TILITY ╥OUTINES WRITTEN FOR USE
  10. WITH THE ├OMMODORE ├-128 ├OMPUTER, 1571 ─ISK ─RIVE AND AN 80 ├OLUMN ═ONITOR.
  11. ╨RIN╘ILITY WAS CREATED FOR USERS WHO BRING HOME (OR DOWNLOAD) WORK FROM THE
  12. OFFICE AND NEED TO PROCESS TEXT FILES PRODUCED ON NON-├OMMODORE MACHINES ON
  13. THEIR 128.  ╘HE PROGRAMER ASSUMES YOU HAVE TRANSFERRED YOUR FILES TO A ├-128
  14. ├OMPATIBLE DISK.
  15.  
  16. ╓ERSION 2.0 IS RELEASED IN ├OMPILED FORM (SOURCE INCLUDED) FOR QUICKER
  17. EXECUTION OF THE PRINT ROUTINES AND INCLUDES SOME FEATURES NOT FOUND IN THE
  18. ORIGINAL VERSION. ╔N BRIEF HERE'S WHAT SHE DOES;
  19.  
  20.      ╞╔╠╘┼╥:     ╞EATURES FOUR ╞ILTER ╥OUTINES,
  21.  
  22.              1.  ╫ORDS ╙TAR ╞ILTER - ╙TRIPS ╚IGH ┬ITS FROM ┴╙├╔╔ ╞ILES.
  23.              2.  ╠INE ╞EED ╞ILTER - ╙TRIPS ╠╞ ├HARACTERS FROM ANY FILE.
  24.              3.  ├ARRIAGE ╥ETURN ╞ILTER - ╙TRIPS ├╥ CHARACTERS FROM ANY FILE.
  25.              4.  ╒NIVERSAL ╞ILTER -(┴DDED TO VERSION 2.0) ╙TRIPS ┴╬┘ ╒SER
  26.                  (DECIMAL) DEFINED CHARACTER FROM ANY ┴╙├╔╔ OR ╨┼╘┴╙├╔╔ FILE.
  27.                  ╟REAT FOR STRIPPING PRINTER CONTROL CODES.
  28.  
  29.  
  30.      ├╧╬╓┼╥╘:    ├ONVERTS ┴╙├╔╔ TO ╨┼╘┴╙├╔╔ AND ╨┼╘┴╙├╔╔ TO ┴╙├╔╔ FILES.
  31.  
  32.  
  33.      ╙╨╠╔╘  :    ├HOPS ╠┴╥╟┼ ╙EQUENTIAL ╞ILES INTO SMALLER FILES.
  34.                  ╓ERSION 2.0 INFORMS USER OF WRITTEN FILES STATUS AS THE
  35.                  ROUTINE PROGRESSES.
  36.  
  37.  
  38.      ╥┼┴─   :    ─ISPLAYS OR ╨RINTS ╙EQUENTIAL ╨┼╘┴╙├╔╔ ╞ILES
  39.  
  40.  
  41.      ─╧╙    :    ─╧╙ WEDGE TO ╥ENAME OR ╙CRATCH FILES WITHOUT LEAVING
  42.                  THE PROGRAM. ╓ERSION 2.0 ALSO INCLUDES A FORMAT ROUTINE
  43.                  WITH A CHOICE OF ╙INGLE OR ─OUBLE SIDED FORMATS AND DISPLAYS
  44.                  DRIVE STATUS MESSAGE AFTER SCRATCHING FILES.
  45.  
  46. ╘O USE THE COMPILED VERSION OF ╨RIN╘ILITY YOU MUST HAVE THE FOLLOWING FILES
  47. ON YOUR DISK:
  48.  
  49.                     ╨┬╧╧╘
  50.  
  51.                     ╨╠╧┴─┼╥
  52.  
  53.                     AND ╨╥╔╬╘╔╠╔╘┘.
  54.  
  55. ╘O RUN THE PROGRAM TYPE RUN"╨┬╧╧╘". ╘HE FILES WILL LOAD QUICKLY AND YOU WILL
  56. PRESENTED WITH A ═AIN ═ENU SCREEN GIVING YOU A CHOICE OF THE OF THE ABOVE
  57. ROUTINES
  58.  
  59. ╨RIN╘ILITY'S MAIN ADVANTAGE IS THAT IT INCORPORATES ALL OF THE ABOVE ROUTINES
  60. INTO ONE SINGLE PROGRAM SO YOU DON'T HAVE TOO SEARCH ALL OVER FOR THE ╒TILITY
  61. PROGRAM YOU NEED FOR A GIVEN TASK, IN A LITTLE MORE DETAIL HERE IS WHAT IT
  62. DOES:
  63.  
  64. 1. ╞ILTER - ╞ILTER IS THE FIRST OPTION PRESENTED TO YOU AND SENDS YOU TO
  65.    ANOTHER MENU SCREEN WHERE YOU CAN CHOOSE FROM THE FOUR FILTER ROUTINES.
  66.  
  67.    ╘HE FIRST IS A ╫ORD ╙TAR (╘M) FILTER UTILITY PROGRAM DESIGNED TO CONVERT
  68.    ╫ORD ╙TAR FILES TO STRAIGHT ┴╙├╔╔ FILES. THIS OPTION IS SELECTED BY TYPING
  69.    THE LETTER "╚" FOR ╚IGH ┬ITS. ┴S THE PROGRAM WILL INFORM YOU THIS IS THE
  70.    FIRST STEP IN THE PROCESS OF PREPARING YOUR FILES FOR USE ON YOUR 128.  ╔F
  71.    YOUR ╫ORD ╨ROCESSOR WILL ACCOMMODATE ┴╙├╔╔ ╞ILES (┼G.  ╫ORD╫RITER 128 (╘M)
  72.    BY ╘IME ╫ORKS) THEN THIS WILL BE ALL YOU WILL NEED TO DO TOO WORK WITH THE
  73.    FILE.
  74.  
  75.    ╔F YOUR ╫╨ PROGRAM DOSE NOT USE ┴╙├╔╔ FILES OR YOU WANT TO VIEW AN ┴╙├╔╔
  76.    FILE WITH THE ╙EQUENTIAL ╞ILE ╥EADER IN THIS PROGRAM  YOU ARE GOING TO
  77.    HAVE TO CONVERT YOUR FILE(S) TO ╨┼╘┴╙├╔╔, ├OMMODORE'S ╓ERSION OF ┴╙├╔╔
  78.    (DESIGNED FOR SPECIFIC INCOMPATIBILITY WITH THE REST OF THE COMPUTING
  79.    WORLD). ╙EE THE "├ONVERT" OPTION BELLOW FOR MORE INFO.
  80.  
  81.    ╘HE NEXT TWO OPTIONS ON THIS MENU ARE "╠" FOR LINE FEED AND "├" FOR
  82.    CARRIAGE RETURN. ╘HESE OPTIONS WILL STRIP ┴LL LINE FEED OR CARRIAGE RETURN
  83.    CODES FOUND IN YOUR FILES. ╘HIS IS NECESSARY AS FILES PRODUCED ON SOME
  84.    OTHER COMPUTERS OR ╫╨ PROGRAMS WILL OFTEN ADD ONE OR BOTH OF THESE
  85.    CHARACTERS.  ╔F YOUR FILES ARE PRINTING OUT WITH EXTRA LINES IN THEM, (AND
  86.    YOU KNOW YOUR PRINTER IS NOT AT FAULT BECAUSE YOU SET YOU DIPS SWITCHES
  87.    WRONG) TRY RUNNING THEM THROUGH THESE FILTERS TO CLEAN THEM UP.
  88.  
  89.    ╘HE "╧" OPTION FOR OTHER WILL SEND YOU TO MY INGENIOUSLY CREATED (╚E!╚E!)
  90.    ╒NIVERSAL ╞ILTER. ╫HICH ALLOWS ┘╧╒ TO DEFINE WHAT CHARACTER YOU WANT
  91.    STRIPED AND TO REPLACE IT WITH ANY CHARACTER OF YOUR CHOICE OR NO
  92.    CHARACTER AT ALL IF YOU WISH (USE 0 FOR THE REPLACEMENT CHARACTER CODE).
  93.    ┘OU WILL NEED TO KNOW THE ─ECIMAL NUMBER OF THE CHARACTER'S.  ┘OUR 128
  94.    ╒SERS ═ANUAL HAS A TABLE IN THE BACK IF YOUR CURIOUS AND YOUR PRINTER'S
  95.    USER MANUAL WILL ALSO CONTAIN DECIMAL CODE INFORMATION FOR STRIPPING
  96.    PRINTER CONTROL CODES AS WELL.
  97.  
  98. 2. ├ONVERT - ┘OU ╟UESSED IT, ├ONVERT IS A ROUTINE WHICH WILL CONVERT ┴╙├╔╔ TO
  99.    ╨┼╘┴╙├╔╔ AND ╓ICE ╓ERSA. ┘OU ARE PROMPTED FOR WHICH TASK YOU WANT
  100.    PERFORMED AT THE BEGINNING OF THE ROUTINE.
  101.  
  102.    ╬OTE: ┴LL OF THE ╞ILTER AND ├ONVERT ROUTINES ─ISPLAY THE ╘EXT BEING
  103.    TRANSLATED IN THE COMMAND LINE WINDOW AT THE BOTTOM OF THE SCREEN, THIS IS
  104.    NORMAL SO JUST SIT BACK AND RELAX TILL THE PROGRAM IS FINISHED WITH YOUR
  105.    FILE. ┴LSO, YOU ARE PROMPTED FOR ╔NPUT AND ╧UTPUT FILE NAMES, MAKE SURE
  106.    THEY ARE DIFFERENT FROM EACH OTHER, THE PROGRAM WILL GIVE YOU A "╞ILE ╬OT
  107.    ╞OUND" ERROR IF IT CAN'T FIND THE INPUT FILE.   ╚OWEVER, SINCE COMMODORE
  108.    ─╧╙ WILL NOT AUTOMATICALLY OVERWRITE EXISTING FILES THE PROGRAM WILL NOT
  109.    ACCEPT AN ╧UTPUT FILE NAME IDENTICAL TO THE ╔NPUT FILE NAME. ╘HIS WON'T
  110.    HURT THE INPUT FILE BUT ╔ DIDN'T BUILD IN ANY ERROR CHECKING FOR IT
  111.    EITHER. ┘OU ARE HEREBY FOREWARNED.
  112.  
  113. 3. ╙PLIT - ╘HE ╙PLIT OPTION WILL TAKE A LARGE SEQUENTIAL FILE AND SPLIT
  114.    IT INTO AS MANY SMALLER FILES AS YOU MAY REQUIRE. ┘OU ARE PROMPTED FOR
  115.    ╔NPUT AND ╧UTPUT FILE NAMES AND THEN ASKED FOR THE SIZE IN NUMBER OF BYTES
  116.    YOU WANT THE OUTPUT FILES TO BE. ╥EMEMBER THAT 4 ├┬═ ┬LOCKS ARE EQUIVALENT
  117.    TO APPROXIMATELY 1000 BYTES. ╙O USE YOUR HEAD A LITTLE AND DON'T ASK THE
  118.    PROGRAM TO SPLIT A 4 BLOCK FILE INTO 2500 BYTE OUTPUT FILES. ┴LSO THIS
  119.    ROUTINE IS A DISK ROUTINE SO THE FILE SIZE IS LIMITED TO THE AMOUNT OF
  120.    SPACE YOU HAVE ON YOUR DISK (NOT THE ├-128 ═EMORY BUFFER). ┴CCORDINGLY IT
  121.    WILL TAKE SOMETIME TO PROCESS YOUR FILE SO ╔ SUGGEST A LONG COFFEE BREAK
  122.    WHEN RUNNING THIS ROUTINE. ╞INALLY OUTPUT FILES ARE NAMED  AS FOLLOWS
  123.    1╧╠─╬┴═┼, 2╧╠─╬┴═┼, 3╧╠─╬┴═┼, ETC. AND YOU ARE ADVISED OF THE STATUS AS
  124.    FILES ARE FINISHED BEING WRITTEN TO THE DISK AS THIS ROUTINE DOSE NOT
  125.    DISPLAY TEXT TO THE SCREEN AS THE ABOVE ROUTINES.
  126.  
  127. 4. ╥EAD - ┘UP, THIS ROUTINE WILL READ A ╨┼╘┴╙├╔╔ SEQUENTIAL FILE AND EITHER
  128.    ─ISPLAY THE FILE TO THE SCREEN OR SEND THE OUTPUT TO THE PRINTER. ╘HE
  129.    PRINTER ROUTINE WILL EXECUTE A FORM FEED AT THE BEGINNING OF THE FILE AND
  130.    ALSO WILL SKIP OVER PERFORATIONS AUTOMATICALLY IF YOU ARE USING A TRACTOR
  131.    FEED.  ╔F YOUR NOT, YOU'LL HAVE TO OMIT THIS LINE (320) FROM THE PROGRAM
  132.    FOR SINGLE SHEET PRINTERS.
  133.  
  134. 5. ─╧╙ - ╔ HAVE INCLUDED MY 2 DIRECTORY ─OS WEDGE ROUTINE (2─╔╥128) TO HELP
  135.    IN CLEANING UP A ─ISK AFTER YOU HAVE RUN ANY OF THE ABOVE ROUTINES. 2─╔╥
  136.    WILL PROMPT YOU FOR INSTRUCTIONS TO ╥┼╬┴═┼ OR ─┼╠┼╘┼  FILES AND IF YOU
  137.    NEED TO YOU CAN EVEN FORMAT A NEW DISK FROM WITHIN THE PROGRAM AS WELL.
  138.    ╘HE ROUTINE DOES NOT EXIT DIRECTLY BACK TO THE MAIN MENU SO YOU WILL GET A
  139.    LAST CHANCE TO REVIEW THE DIRECTORY OF THE CURRENT DISK PRIOR TO LEAVING
  140.    THE ROUTINE.
  141.  
  142. ╨ROGRAM ╬OTES:
  143.  
  144. ╥EGARDING THE COMPILED VERSION. ╔F YOU ARE EXECUTING MANY OF THE ROUTINES IN
  145. ONE SESSION AND YOU FIND THAT A CONVERT OR FILTER ROUTINE WILL NOT WRITE TO A
  146. FILE YOU MAY HAVE TO EXIT THE PROGRAM AN RE-ENTER DUE TO A BUG WHICH RESULTS
  147. FROM USING THE COMPILER. ╔ DON'T QUITE KNOW WHAT CAUSES IT AND IT DIDN'T
  148. HAPPEN IN THE SOURCE VERSION BUT ╔ HAVE A HUNCH IT HAS SOMETHING TO DO WITH
  149. THE COMPILERS MANIPULATION OF VARIABLES. ╔N ANY CASE RESETTING THE PROGRAM
  150. SEEMS TO CLEAR THE PROBLEM UP.
  151.  
  152. ┴LSO THE ORIGINAL UNCOMPILED ╓ERSION USED THE BASIC ╞┴╙╘ COMMAND TOO SPEED
  153. THE INTERNAL PROCESSING OF THE ROUTINES (YES ╔ ╦NOW IT WON'T SPEED UP ╔/╧
  154. ROUTINES). ╘HE SOURCE CODE FOR THE COMPILED VERSION HAD TO BE EDITED TO SLOW
  155. THINGS DOWN BECAUSE THE ╞┴╙╘ COMMAND CRASHED THE COMPILED VERSION. ╙EEMS
  156. THINGS WENT TOO FAST FOR THE DISK ╔/╧ WITH THE COMPILED CODE.  ╘HIS
  157. ELIMINATED THE PROBLEM HOWEVER, ╔ HAVE INCLUDED A ╞┴╙╘ ┬ASIC VERSION FOR
  158. TINKERING WITH.
  159.  
  160. ╔ HAVE NOTICED THAT SOME LARGER FILES DON'T ALWAYS CLOSE PROPERLY WITH THE
  161. COMPILED VERSION, IF FOR ANY REASON YOU FIND THAT THE PROGRAM HAS STOPED AND
  162. YOU GET A READY MESSAGE WITH THE GREEN LIGHT STILL ON, ON THE DISKDRIVE BE
  163. SURE TO TYPE"─├╠╧╙┼" TO CLOSE YOUR FILE BEFORE YOU RESET THE *PUTER* OR ISSUE
  164. THE THE ╥╒╬ COMMAND SO YOU DON'T GET A SPLAT FILE ON YOUR DISK.
  165.  
  166. ╫ELL THAT'S ALL SHE WROTE FOLKS, ═OST OF THE BUGS HAVE BEEN FIXED BUT  ╔F YOU
  167. FIND ANY (╔'M NOT PERFECT) OR CAN THINK OF SOMETHING ELSE YOU WANT ╨RIN╘ILITY
  168. TO DO LET ME KNOW WHAT YOUR IDEA IS AND ╔'LL SEE IF WE CAN'T BUILD A BETTER
  169. MOUSE TRAP.
  170.  
  171. ╞INALLY THIS PROGRAM IS ╞╥┼┼╫┴╥┼ TO BE USED COPIED AND SHARED FOR YOUR
  172. PERSONAL USE AS YOU SEE FIT.  ╬O ├HARGE OF ANY NATURE MAY BE MADE FOR THIS
  173. PROGRAM NOR MAY IT BE USED FOR COMMERCIAL PURPOSES WITHOUT THE EXPRESSED
  174. PERMISSION OF THE AUTHOR. ╔F YOU USE THIS PROGRAM AND FEEL SO INCLINED
  175. YOU CAN SEND ME A DONATION FOR MY TIME AND EFFORT. (FIVE BUCKS, A SIX PACK OR
  176. BOTTLE OF YOUR BEVERAGE OF CHOICE. ╚E! ╚E!). ╧R MAYBE EVEN JUST A SHORT NOTE
  177. WITH YOUR COMMENTS.
  178.  
  179.  
  180. ┼NJOY,
  181.  
  182. ├ARL....
  183.  
  184.    [├╚╒├╦.╫┴╟╧╬] ON ╟┼NIE                     [├╚╒├╦╫┴╟╧╬] ON ╤-╠INK
  185.  
  186.    ╙END COMMENTS OR LETTERS TO;
  187.  
  188.    ├ARL ╞. ╚OWARD
  189.    11321 ╞AIRVIEW ╙T.
  190.    ┼L ═ONTE, ├┴ 91732
  191.  
  192.