home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / fileutil / breakup.arj / BREAKUP.DOC next >
Encoding:
Text File  |  1991-08-16  |  4.2 KB  |  113 lines
  1.                         Breakup.exe
  2.                        By Jem Miller
  3.  
  4.                         Users guide
  5.  
  6.  
  7. What is it?
  8.  
  9.     Well, it's a utility that will take any size text file, formatted or 
  10.     not, and break the file into smaller parts that you can view with your 
  11.     favorite text editor.
  12.  
  13.     Since most text editors now days will only load 64k files at the 
  14.     largest, Breakup.exe will allow you to take those big .DOC files and 
  15.     make several smaller files out of them.
  16.  
  17.  
  18. What will it do?
  19.  
  20.     It will create several (user selectable) files called out1, out2, 
  21.     out3, etc. up to out65535. These files each contain the number of 
  22.     pages that you specified when the program was run. It ALWAYS uses the 
  23.     same filenames, so you will need to rename or copy the out* files to a 
  24.     different filename before you run Breakup again. Otherwise Breakup 
  25.     will over write the existing files each time it runs.
  26.  
  27. What won't it do?
  28.  
  29.     It won't do windows, make coffee, provide hours of fun, or improve 
  30.     mental capacity. It also won't work with .EXE, .COM files, or most 
  31.     data files. It is intended for TEXT files only.
  32.  
  33. Does it have a warranty?
  34.  
  35.     NO! Absolutely NOT! I don't warrant this thing to do anything except 
  36.     eat up disk space on your system. Use it at your own risk. If 
  37.     Breakup.exe blows up ANY files or equipment, remember that you were 
  38.     warned. Breakup.exe was severely tested for about ten minutes before I 
  39.     shipped it out. Don't expect sympathy if it goes south.
  40.  
  41.  
  42. Using Breakup.Exe:
  43.  
  44.     Place Breakup in one of the directories in your path, so that DOS can 
  45. find it from whatever drive or directory you're in. 
  46.  
  47.     Any time you want to break up a big text file just type in breakup at 
  48. the DOS prompt.
  49.  
  50.     You'll be prompted for the filename to break apart. You can type in 
  51. the path and filename, BUT the out* files will be created in the CURRENT 
  52. logged directory, not in the path that you typed. For this reason, I 
  53. suggest that you use Breakup from the same directory as the file is found.
  54.  
  55.     If Breakup can't find the file you typed, it will issue an error 
  56. message and let you re-type the filename.
  57.  
  58.     Next you need to tell Breakup how many pages per file that you want in 
  59. the OUT* files. This is kind of tricky, because of the different line 
  60. lengths in different files. Breakup defaults to 100 pages if you just 
  61. press enter, but that's to big for most editors. A close way to calculate 
  62. the file sizes is listed below.
  63.  
  64. Pages         Average File Size
  65. ===============================
  66. 25              55 - 63k
  67. 50              102 - 130k
  68. 100             230 - 293k
  69.  
  70.     As you can see, the sizes vary greatly depending on the line lengths 
  71. in the text file. Most files have an average line length of about 53 
  72. characters, but that's not a rule to follow.
  73.  
  74.     Breakup will look for Form Feed characters as it works, so if you are 
  75. running it on a formatted ASCII text file, it should work fine. It will 
  76. break each page at line 60 if no form feed is found before that. Since 
  77. most word processors use 55 to 58 lines per page, 60 lines is a pretty 
  78. safe bet. If form feeds come after the 60th line per page, you'll get a 
  79. really strange looking file.
  80.  
  81.     That's all there is to running the thing, no secrets, no magic, and 
  82. no on-line help.
  83.  
  84. System requirements:
  85.  
  86. 1>    You need a computer to use this program.
  87. 2>    It needs to be IBM compatible.
  88. 3>    It needs to be running IBM PCDOS or MsDOS 1.1 or higher.
  89. 4>    It needs at least 14k free.
  90.  
  91.     Breakup is hereby released to the public domain. You may use it, give 
  92. it away, burn it, or throw darts at it. You can NOT sell this software! 
  93. You may charge a copying fee for a diskette, or phone charges for 
  94. distributing this file by electronic means. All reproductions of 
  95. Breakup.Exe should include this .DOC file.
  96.  
  97. Donations are always cheerfuly accepted (as are developement contracts)!
  98.  
  99. Any Comments (or money) should be addressed to:
  100. OCS Software
  101. 4601 N.W. 32st.
  102. Oklahoma City, Ok. 73122
  103.  
  104. ATTN: Jem Miller
  105.  
  106. DATA Phone : 405-946-3675 6 pm. - 7:45 am. Mon-Fri & 24hrs weekends
  107.  
  108. 1:147/33.0      FidoNet
  109. 8:933/2.0       RBBSNet
  110. 9:69/4.0        MaxNet
  111. 99:9002/20.0    EggNet
  112.  
  113.