home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 June / SIMTEL_0692.cdr / msdos / filutl / split49.arc / SPLIT49.DOC next >
Encoding:
Text File  |  1989-10-01  |  4.8 KB  |  114 lines
  1.    SPLIT v 4.9x
  2.  
  3.    SPLIT divides a file, at specified points, into smaller files.
  4.    Files may be processed as either binary or text files. Prompts for
  5.    source filename and output file basename are displayed at start.
  6.    Source file size is displayed in bytes. Output files all have the
  7.    same basename and a series of increasing numeric file extensions
  8.    beginning with ".001".
  9.  
  10.    Input and output filenames may be entered on the command line. Bad
  11.    filenames result in a prompt for a new filename.  Command line
  12.    format is:    SPLIT [fnm1] [fnm2] [opt]    where:
  13.  
  14.        "fnm1" is the name of input file to be split, including the
  15.        extension and pathname, where needed.
  16.  
  17.        "fnm2" is the output file basename (no extension), including
  18.        pathname, where needed.
  19.  
  20.        "opt" is the split option.  Choices are: (F)iles, (B)ytes,
  21.        (L)ines, or (M)anual.
  22.  
  23.    Simply entering "SPLIT" on the command line results in prompts for
  24.    the above options. The three "split by" options are:
  25.  
  26.         F: Split source into a number of nearly-equal sized new (F)iles,
  27.         B: Specify the number of (B)ytes in each new file, or
  28.         L: Specify the number of text (L)ines in each new file.
  29.  
  30.    New Feature:
  31.    ------------
  32.         M: Copy blocks of bytes (M)anually from source to output file.
  33.  
  34.    Although not listed in the menu, Version 4.9x now has manual file
  35.    splitting capability.  Manual splitting is activated by choosing option
  36.    "M" at the "split by" prompt or placing it in the command line as
  37.    described above.  Manual splitting copies a specific block of bytes from
  38.    within the source file into the output file.  Starting and ending bytes
  39.    are entered for the block of source file bytes to be copied to the output
  40.    file. Values from zero to source file size are entered as the first and
  41.    last bytes of each new block to be copied to an output file. If the
  42.    second byte number is zero or is lower than the first byte, the program
  43.    aborts. Bytes up to and including the second byte number are copied to
  44.    the new file. The numeric file extension is also entered manually.
  45.  
  46.    After each group of bytes is copied, a new extension number, starting
  47.    point, and ending point are requested for another output file.  A new
  48.    file is created and the next group of bytes is copied to it.  This
  49.    repeats until the end of the source file or the program is ended by entry
  50.    of an ending byte value less than the starting byte.  A blank line
  51.    entered for any requested value results in the default for that value.
  52.    Default for file extension is the previous extension number plus one.
  53.    Default for the starting byte is the next byte after the last file split
  54.    left off. Default for the second byte number is the last byte in the
  55.    source file. Be careful!  Manual file splitting is for advanced users.
  56.  
  57.  
  58.  
  59. To put the file back together, use COPY:
  60.  
  61.    1) For text files, just use the copy command:
  62.  
  63.        >COPY fnm2.* fnm1.all
  64.              or
  65.        >COPY fnm2.001 + fnm2.002 + fnm2.003 fnm1.all
  66.  
  67.    2) For binary files use the /B switch:
  68.  
  69.        >COPY fnm2.*/b fnm1.all/b
  70.              or
  71.        >COPY fnm2.001/b + fnm2.002/b + fnm2.003/b fnm1.all/b
  72.        (see dos manual for other file concatenation conventions)
  73.  
  74. This concatenates the pieces back into a single file.
  75.  
  76.  
  77. USES:  Backing up large files from a hard disk to floppies or from
  78.        high-capacity to low-capacity disks.  Making smaller text files
  79.        out of larger ones for use with limited capacity editors like
  80.        Sidekick's notepad.  The file is split where you want and is
  81.        easily put back together.
  82.  
  83.  
  84.        Other features of version 4.9x SPLIT.EXE :
  85.  
  86. 1. New feature added: Split files manually with v4.9 and later.
  87.  
  88. 2. Self-test at startup for damaged or altered program (v4.9c).
  89.  
  90. 3. Exit to DOS during split operation in order to format a disk,
  91.    change directories, etc.  Type "exit" at any filename prompt.
  92.    (This feature is disabled for TEXT file processing).
  93.  
  94. 4. If the specified input file is not found, SPLIT displays the
  95.    current directory (limited to the first 90 filenames) and
  96.    prompts for a new input filename.
  97.  
  98. 5. If the destination disk is full, SPLIT adjusts the size of the
  99.    current output file to the number of bytes remaining on the
  100.    destination disk and prompts for a new disk in the output drive.
  101.  
  102. 6. Binary file splits are incremented and listed in bytes.
  103.    Text file splits are incremented and listed in lines of text.
  104.  
  105. 7. I/O error handling and vector preservation are improved.
  106.    Current screen colors, text mode, and attributes are preserved.
  107.  
  108.  
  109.    Inspiration for SPLIT was "SPLITTER", a program by Mike Nault.
  110.    Text file splitting is similar to the "CHOP" text file splitter.
  111.    Thanks to Steve Ogden for the file directory and window routines.
  112.  
  113.  - M. Dingacci, 9/17/1989 -
  114.