home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / utilities / cli / msplit.lha / msplit.doc < prev    next >
Encoding:
Text File  |  1995-01-31  |  4.4 KB  |  124 lines
  1.  
  2.                                    MSplit V1.1
  3.                             © 1995 by Harald Löffler
  4.  
  5.      PREFACE 
  6.  
  7.      The programs and files in this distribution are freely distributable, 
  8.      but are also Copyright © Harald Löffler. They may be freely distributed
  9.      as long as no more than a nominal fee is charged to cover time and
  10.      copying costs. No commercial usage is permitted without written permission
  11.      from the author. Everything in this distribution must be kept together, in
  12.      original unmodified form. The only thing I ask for is to send me a mail and
  13.      tell me, what you think about MSplit.
  14.      The above is generally known as mailware.  
  15.  
  16.  
  17.  
  18.      1. Introduction 
  19.      --------------- 
  20.  
  21.      For all those that frequently have to split files with a similar basename,
  22.      I´ve written this little tool. It can do this job in a very easy way.
  23.                                Hope ya like it ;-)
  24.  
  25.  
  26.  
  27.      2. Installation
  28.      ---------------
  29.  
  30.      Just copy MSplit to your C: directory and the doc to your favourite DOC-dir.
  31.      That´s all.
  32.  
  33.  
  34.      
  35.      3. How to use it
  36.      ----------------
  37.  
  38.      The easiest way is this one:    Msplit file
  39.      
  40.      This will split file into file0 and file1. The size of the splitted files
  41.      will be half of the original file.
  42.      In other purposes you have to use the various parameters.
  43.  
  44.  
  45.  
  46.      4. The parameters
  47.      -----------------
  48.      
  49.      The general form is:
  50.      
  51.      MSplit <filename> [FROM start] [INTO basename] [SIZE s] [PARTS n]
  52.                        [NULL|QUIET|FORCE]
  53.  
  54.      Filename is the name of the file to be split.
  55.  
  56.      The basename should contain a wildcard at the position where the numbers should
  57.      appear. E.g. if files like abc1def, abc2def, .. should be build, the basename
  58.      should be like this: abc*def
  59.  
  60.      FROM means the number in the first splitted file; the number to start with.
  61.      
  62.      With INTO you can specify a name for the files that will be created. The wildcard
  63.      is described above. If you do not specify this, filename* will be used instead.
  64.      If a basename exists, you will be asked to use parameter FORCE to overwrite it.
  65.  
  66.      The QUIET option forces MSplit to stop all printouts unless there is something
  67.      wrong with the parameters.
  68.  
  69.      The NULL option is something special. If forces MSplit to create files with 00
  70.      instead of a single 0 in the basename. It will do this untill 9 (09). Then it
  71.      proceeds normaly.
  72.  
  73.  
  74.      5. DISCLAIMER
  75.      -------------
  76.      
  77.      This program is released as is. No warranty on any damage or misfunction.
  78.      Use it or kick it.
  79.      
  80.      
  81.      
  82.      6. Author, bugs, to do´s, etc.
  83.      -----------------------------
  84.  
  85.      First of all I want to say that I´m very sorry about uploading the wrong
  86.      doc with the last version.
  87.  
  88.      Stuff I want to do in future: Tell me what you want!
  89.  
  90.      I´ve included the source, so you can easily port it to any platform, that
  91.      supports ANSI-C. The only thing you have to do is delete the following lines
  92.  
  93.        #include <exec/types.h>            /* BOOL etc. Type-Definitions     */
  94.        #include <dos/dos.h>               /* Definition of RETURN_FAIL etc. */
  95.  
  96.      and add this ones
  97.  
  98.        #define BOOL int
  99.        #define TRUE (0 == 0)
  100.        #define FALSE (0 == 1)
  101.        #define RETURN_OK                 0
  102.        #define RETURN_WARN               5
  103.        #define RETURN_ERROR             10
  104.        #define RETURN_FAIL              20
  105.  
  106.      Maybe you have to replace the Umlaut in my name (sorry, but AMIGAs have no
  107.      problems with this ;-)
  108.  
  109.  
  110.      If you have found some of this ugly bugs :( , want to make some suggestions :)
  111.      or tell me :-) something else, write to:
  112.  
  113. ----------------------------------------------------------------------------------
  114. |      _/    _/     _/    |  Harald Loeffler                         |     __o   |    
  115. |     _/    _/     _/     |  Schenkenbergstrasse 12                  |   _`\<;   | If possible,
  116. |    _/_/_/_/     _/      |  73733 Esslingen                         |  (*)/(*)  |  please use
  117. |   _/    _/     _/       |  Tel: (07 11) 32 41 93                   |  MT-BIKE  |   e-mail!
  118. |  _/    _/     _/_/_/_/  |  E-Mail: harry@studbox.uni-stuttgart.de  | forever ! |
  119. ----------------------------------------------------------------------------------
  120.  
  121.              You think MS-WINDOWS ist the longest bug overall?
  122.  
  123.           There will always be an update, so wait for WINDOWS 95!
  124.