home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 2: PC / frozenfish_august_1995.bin / bbs / d07xx / d0764.lha / CLI-Tools / Split.doc < prev    next >
Text File  |  1992-11-21  |  2KB  |  89 lines
  1.  
  2.                                    Split
  3.                                    *****
  4.  
  5.                        Documentation by Thies Wellpott
  6.                        (excuse my bad English, please)
  7.  
  8.  
  9. 1. Copyright
  10. ************
  11.  
  12. Split is public domain, do with it what you want but be fair and include
  13. "Split", "Split.doc" and "Split.c" with your distribution.
  14.  
  15.  
  16. 2. Warrenty
  17. ***********
  18.  
  19. YOU USE THIS PROGRAM COMPLETELY ON YOUR OWN RISK! If you destroy any file,
  20. your computer, your car or even the whole universe or any part of it while
  21. using it, do not blame me, it is not my fault!
  22.  
  23.  
  24. 3. Introduction
  25. ***************
  26.  
  27. Do you now the Join command in C: ? Did you ever search for the opposite? I
  28. did and found some programs which managed to split a file into parts, but
  29. they all where slow (why?). Split is a short and fast solution.
  30.  
  31.  
  32. 4. Usage
  33. ********
  34.  
  35. Split is runnable only from the CLI/Shell. It runs with Kickstart 1.2/1.3
  36. and OS 2.0. If you start Split with no or wrong arguments or with a ? as
  37. the first argument you will get a usage info:
  38.  
  39. ¢4mSplit V1.00 (28.06.92)¢0m by Thies Wellpott
  40.  
  41. Usage: Split <infile> <outfile> size1 [size2 [size3] ...]
  42.  
  43.  
  44. infile   is the name of the file you want to split
  45. outfile   is the base name the destination files will have
  46. size(1|2|3)   are the sizes of the parts either as a decimal number which
  47.    means bytes or as a decimal number ending with a "k" (or a "K") which
  48.    means kbytes (1024 bytes).
  49.  
  50.  
  51. Examples:
  52.  
  53. 1> Split c:ed ram:spled 123 3K 2K 456 1000
  54.  
  55. produces (if c:ed has 25044 bytes) the following six files in "ram:" :
  56. spled.0     123  \
  57. spled.1    3072   \
  58. spled.2    2048    )- the defined sizes
  59. spled.3     456   /
  60. spled.4    1000  /
  61. spled.5   18345  - the rest of the file
  62.  
  63.  
  64. 1> Split exec.doc exec.doc 10K 10K 10K 100K 20K
  65.  
  66. produces (exec.doc has 128682 bytes) in the current directory:
  67. exec.doc.0  10240
  68. exec.doc.1  10240
  69. exec.doc.2  10240
  70. exec.doc.3  97962
  71.  
  72. and outputs "outfile 3 truncated!" because exec.doc has too less bytes to
  73. be split into six files (five specified plus the rest), so there are
  74. produced as many files as possible and then the operation is aborted (I
  75. hope you understand).
  76.  
  77.  
  78.  
  79. Send bug reports, hints, and ideas to:
  80.  
  81.         Thies Wellpott
  82.         Moorhauser Weg 14
  83.         2948 Schortens 1
  84.  
  85.         Germany
  86.  
  87.         (sorry, no e-mail)
  88.  
  89.