home *** CD-ROM | disk | FTP | other *** search
/ BCI NET 2 / BCI NET 2.iso / archives / utilities / misc / splitit.lha / SplitIt! / SplitIt!.doc < prev    next >
Encoding:
Text File  |  1995-03-20  |  5.6 KB  |  143 lines
  1. ---------------------------------------------------------------------------
  2.                                  SplitIt!
  3.  
  4.                    (c) 1995 Laserdance Productions / TSB
  5.  
  6.                            English documentation
  7. ---------------------------------------------------------------------------
  8.  
  9.  
  10. ------------------------------ Introduction -------------------------------
  11. ---------------------------------------------------------------------------
  12.  
  13. This  little utility was born in the need to transfer files via disk from a
  14. UNIX  to  a  Amiga-System.   The  problem  is,  that  you'll  have  to  use
  15. MS-DOS-formatted  disks for this job.  This means also that you are limited
  16. in  space  (1.44  MB)  and  filename  length  (8.3  characters only).  What
  17. SplitIt!   does  for you is to split large files into chunks of a requested
  18. size  with  MS-DOS-compatible names and also creates a batch-file to rejoin
  19. the files on Amigas later.
  20.  
  21. ---------------------------------- Usage ----------------------------------
  22. ---------------------------------------------------------------------------
  23.  
  24. First create the UNIX-executeable with
  25.  
  26.     >gcc SplitIt!.c
  27.  
  28. and a.out rename it to SplitIt! (or any other name you'd like)
  29.  
  30. Synopsis : SplitIt! FILENAME DISKSIZE [OUTPUTNAME]
  31.  
  32. FILENAME  is  the  name  of the file you want to be splitted.  You can also
  33. specify  a  path  here,  but  read  Namecreation  (next  paragraph) before.
  34. DISKSIZE  is the size of the chunks that will be created and outputname (if
  35. specified) will be 8-char part of the chunks' filename.
  36.  
  37.  
  38. ---------------------------- Filename creation ----------------------------
  39. ---------------------------------------------------------------------------
  40.  
  41. Unless  otherwise  specified, SplitIt!  will take the first 8 characters of
  42. the  FILENAME-argument  to  create  the  8-character-part  of  the  chunks'
  43. filename.   The 3-char expansion is used for the numeration of the splitted
  44. files.  Be careful when using paths with FILENAME !  You'll have to specify
  45. a  new  chunkfilename  via  the OUTPUTNAME-option, because the names of the
  46. created files may not contain characters like ~,:,/,..,etc..
  47.  
  48. An example :
  49.  
  50. >l
  51. MonthCD.LHA                23665 ----rwed Today     17:30:44
  52. 1 file - 25 blocks used
  53. >sC:Illusion/SplitIt! MonthCD.LHA 10000
  54. ANSI - C File splitter
  55. Copyright (c) 1995 Laserdance Productions
  56.  
  57. Scanning file...
  58. Found file : MonthCD.LHA - Filesize is : 23665 bytes.
  59. This file requires 3 disk(s) of size 10000.
  60. Allocating buffers ...
  61. Opening logfile : MonthCD..JOI 
  62. Opening output file : MonthCD..0
  63. Opening output file : MonthCD..1
  64. Opening output file : MonthCD..2
  65. >l
  66. MonthCD..2                  3665 ----rw-d Today     18:05:25
  67. MonthCD..1                 10000 ----rw-d Today     18:05:25
  68. MonthCD..0                 10000 ----rw-d Today     18:05:25
  69. MonthCD..JOI                 146 ----rw-d Today     18:05:25
  70. MonthCD.LHA                23665 ----rwed Today     17:30:44
  71. 5 files - 54 blocks used
  72.  
  73.  
  74. ---------------------------------- Bugs -----------------------------------
  75. ---------------------------------------------------------------------------
  76.  
  77. No known bugs
  78.  
  79. --------------------------------- History ---------------------------------
  80. ---------------------------------------------------------------------------
  81.  
  82. V1.0 (8. March 1994)    o First version. Simple but running
  83.  
  84.  
  85. ------------------------------- Disclaimer --------------------------------
  86. ---------------------------------------------------------------------------
  87.  
  88. The  program  is  distributed  'as  is'  and no warranty for the quality or
  89. performance of the program is given.  You use the program on your own risk.
  90. If the patch blows up your cat, I can't be made responsible.
  91.  
  92. The  program and source code is GiftWare, and may be freely distributed, as
  93. long  as  no charge, execept for some reasonable copyfees is taken.  If you
  94. use  the program reguarly you are expected to send some kind of gift to the
  95. author  (e.g.   floppy-  or  harddisks,  CDs,  money, booze, some Star Trek
  96. stuff, or a nice postcard of your cat (?)) The sources and executeables are
  97. still  Copyright  ©  1995 Laserdance Productions.  You are free to copy and
  98. modify  this  stuff  for  your  needs,  but _only_ the _unchanged_ original
  99. release archive may be distributed.
  100.  
  101. Original distribution archive contains :
  102.  
  103.     SplitIt!.c           - Source code
  104.     SplitIt!.doc        - English Documentation
  105.     SplitIt!.dok         - German Documentation
  106.     SplitIt!             - Executeable program (Amiga)
  107.  
  108.  
  109. --------------------------------- Contact ---------------------------------
  110. ---------------------------------------------------------------------------
  111.  
  112. If you want to contact the author for any reason, grap a pen and write some
  113. snail-mail to the following address :
  114.  
  115.                           Laserdance Productions
  116.                               c/o Kai Haseloh
  117.                           Dorotheenstrasse 7/585
  118.                               30419 Hannover
  119.  
  120.                 email : haseloh@informatik.uni-hannover.de
  121.  
  122. --------------------------------- Hellos ----------------------------------
  123. ---------------------------------------------------------------------------
  124.  
  125.                  Hellos go out to the following persons :
  126.  
  127.                      The rest of The Special Brothers
  128.                                Carsten Brühl
  129.                                 Jörg Wabbel
  130.                                Markus Klinge
  131.                               Simon Stelling
  132.                               Michael Schaake
  133.                               Markus Schmall
  134.                               Andreas Weyert
  135.                                   Fornax
  136.  
  137.  
  138.  
  139.                     See you in some bigger productions,
  140.  
  141.                Laserdance Productions / The Special Brothers
  142.  
  143.