home *** CD-ROM | disk | FTP | other *** search
/ Merciful 1 / Merciful - Disc 1.iso / software / a / archivers_collection / archiverscollection.lha / SploinGui / DOCS < prev    next >
Encoding:
Text File  |  1993-12-22  |  11.8 KB  |  290 lines
  1.    __________   ________   ___       ________   ___   _______  __
  2.   /\   ______\ /\   ___ \ /\  \     /\   __  \ /\  \ /\   __ \/\ \
  3.   \ \  \_____/_\ \  \__\ \\ \  \    \ \  \ \  \\ \  \\ \  \ \ \ \ \
  4.    \ \_______  \\ \   ____\\ \  \    \ \  \ \  \\ \  \\ \  \ \ \_\ \
  5.     \/_______\  \\ \  \___/ \ \  \____\ \  \_\  \\ \  \\ \  \ \     \
  6.       /\_________\\ \__\     \ \______\\ \_______\\ \__\\ \__\ \_____\
  7.       \/_________/ \/__/      \/______/ \/_______/ \/__/ \/__/\/_____/
  8.                       __________   ___    ___   ___
  9.                      /\   ______\ /\  \  /\  \ /\  \
  10.                      \ \  \_____/ \ \  \ \ \  \\ \  \
  11.                       \ \  \  _____\ \  \ \ \  \\ \  \
  12.                        \ \  \/\__  \\ \  \ \ \  \\ \  \
  13.                         \ \  \/__\  \\ \  \_\_\  \\ \  \
  14.                          \ \_________\\ \_________\\ \__\
  15.                           \/_________/ \/_________/ \/__/
  16.      
  17.                      "THE ULTIMATE FILE SPLITTER & JOINER"
  18.                       ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  19.                         * A PROGRAM BY: JOEY MCDONALD *
  20.                   
  21.                        * SPLOIN CLI BY: YVES PERRENOUD *
  22.  
  23.  
  24. INTRODUCTION:
  25.  
  26. What is SPLOIN GUI?
  27.  
  28. The name says it all... It's a full GUI for the SPLOIN CLI program.
  29. It offers easy access to SPLOIN's features and also offers many
  30. options not available from the CLI.
  31.  
  32. Why a GUI?
  33.  
  34. It's easy... fast... and as you'll soon see has great advantages
  35. and extra features not possible from the CLI.
  36.  
  37. Why SPLOIN?
  38.  
  39. I found the SPLOIN CLI program to offer the most features. Great
  40. splitting abilities and a great option to use an input file for
  41. rejoining. It's the best CLI based splitter/joiner I have seen.
  42. SPLOIN was created by Yves Perrenoud, and must be in your C:
  43. directory for SPLOIN GUI to function.
  44.  
  45.  
  46. FEATURES OF SPLOIN GUI:
  47.  
  48. * SPLIT via selectable size or number.
  49. * SPLIT via selectable bytes from selected offset. Option to save rest.
  50. * MEGA-SPLIT >ANY NUMBER OF FILES< via Loaded File Log or easy selector.
  51. * AUTO-JOIN >ANY NUMBER OF SPLIT FILES< via File Log or easy selector.
  52. * MEGA-JOIN >ANY NUMBER OF MULTI-FILE SPLITS< via File Log or selector.
  53. * OPEN/SAVE/LOAD/PRINT/USE file logs for fast easy SPLITS/JOINS.
  54.  
  55. Two versions of SPLOIN-GUI are included. One (the larger file)
  56. is a complete stand-alone program. The second version (the small
  57. file... with a ".deck" extension) is intended for those who have 
  58. DeckBrowser in C:.
  59.  
  60. HOW TO USE IT:
  61.  
  62. Just so you understand what I'm talking about... here's a
  63. small representation of the SPLOIN-GUI interface.
  64.  
  65.  ______________________
  66. | ____  ______  ______ |  #1 is where you browse disks and drawers.
  67. ||    ||      ||      ||     (using the TWO BUTTONS below #1)
  68. || #1 ||  #2  ||  #3  ||  #2 is where you select your files to split
  69. ||____||      ||      ||     or join.
  70. | ____ |______||      ||  #3 shows what files you have selected for
  71. ||    | --#5-- |      ||     splitting or joining.
  72. || #4 | --#6-- |______||  #4 Are where your OPTIONS are located.
  73. ||____| ****** --$$$$--|  #5 Is where you place the DESTINATION of
  74. |______________________|     split or join files.
  75.                           #6 Is only used with the RESTOF OPTION.
  76.                           ***** are the MAIN SPLIT/JOIN/QUIT buttons.
  77.                           $$$$$ are the MAIN FILE LOG BUTTONS.
  78.  
  79.  
  80. A BRIEF GUIDE TO CONTROLS AND QUICK EXAMPLE of BASIC SPLIT & JOIN:
  81. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  82. If you wanted to split a single file into 5 sections into ram...
  83.  
  84. Use #1 and #2 selectors to locate your file. Double click on it's
  85. name when it appears in the #2 selector. You will now see the name
  86. of your file in the #3 MAIN AREA. This means it's selected. If you
  87. selected the wrong file... just double click on it's name in the
  88. #3 MAIN AREA to remove it.
  89.  
  90. In The #4 option area select the NUMBER button or field and type
  91. 5. If you need to erase an amount, simply deselect the button. To
  92. change the amount, simply select the field.
  93.  
  94. In the #6 area (marked DESTINATION) type (or use the >? selector)
  95. the name of the destination DIRECTORY. If you are typing the
  96. destination into the field.. and your file is going into a drawer,
  97. you must include the / sign. (dh0:tools/).
  98.  
  99. Select SPLIT.... you now have 5 small files in ram:
  100.  
  101. To Rejoin them via standard JOIN to an optional new location and
  102. name.
  103.  
  104. Go to ram: using the method described above. Double click on
  105. each of the numbered small files (in NUMBERED ORDER). Enter the
  106. destination DIRECTORY and NAME of the file in the Destination
  107. field (#6).
  108.  
  109. Select JOIN.... You have now re-joined the files.
  110.  
  111. You could have also specified an amount instead of a size for
  112. each of the files when split. typing 10000 would split a
  113. 100000k file into TEN 10k sections.
  114.  
  115. NOTE:
  116. When doing a standard JOIN... a File Log will automatically be
  117. created in ram: ... This file will be called LIST and is used
  118. by SPLOIN GUI durring a JOIN. A list file is not created when
  119. using the Join+ option (mega-joining) or when using "#?" as
  120. input.
  121.  
  122. HOW TO USE MEGA-SPLIT:
  123. ~~~~~~~~~~~~~~~~~~~~~~
  124. ... If you had 5 files and you wanted each split into 3 smaller
  125. files you would simply select the files you wish to split by double 
  126. clicking on there names... selecting 3 in the NUMBER field...
  127. entering a destination directory and hiting split. ALL 5 FILES will 
  128. be split into 3 files each. You can split as many files as you wish 
  129. all at once using this technique. You could also specify a size 
  130. instead of a number for the small files. 
  131.  
  132. HOW TO USE MEGA-JOIN:
  133. ~~~~~~~~~~~~~~~~~~~~~
  134. Mega-Joining is different from joining. A regular join takes
  135. any number of selected files and joins them all into one big
  136. file. Mega-joining will take any number of small files and
  137. re-join them back into the original big files that they were
  138. split from.
  139.  
  140. This is a powerfull feature. To see how it works... USE the
  141. MULTI-SPLIT example above to split 5 files into 3 files each into
  142. RAM. Now locate the files and select the first file of each
  143. different split. (the ones ending in a _1 suffix). Now select
  144. the JOIN+ option button... then hit JOIN. ALL OF THE FILES WILL
  145. BE COLLECTED AND REJOINED INTO THE ORIGINAL 5 FILES!
  146.  
  147. MEGA-JOINING can be used on any number of files... but the
  148. small files to be MegaJoined must all reside in the same
  149. directory... this directory will also be where the jre-joined files
  150. will be created. This is a limitation of the SPLOIN CLI
  151. program.... I am trying to create a work-a-round... but
  152. it still does much more than you could ever do from the CLI!
  153.  
  154. Note:
  155. A future version of SPLOIN-GUI will allow each small file to have
  156. a different location and also allow for a specified destination
  157. for each rejoined file while MegaJoining. You have have full
  158. control of source,destination and name with MULTI-JOINS... but
  159. only one large file can be re-assembled or joined at once.
  160.  
  161. USING FILE LOGS:
  162. ~~~~~~~~~~~~~~~~
  163. After you have split a large file into smaller sections and
  164. placed those sections on different disks or in different directories,
  165. you should create a file log by selecting each section into the
  166. MAIN area and selecting SAVE. You can save the file log to any name
  167. you wish. When you want to rejoin the file all you will need to
  168. do is load this file log and select JOIN. Assuming you have not
  169. moved any of the smaller files since you created the log, all of
  170. the files will be located and joined... you will be asked to insert
  171. any disks when needed. It's that simple!
  172.  
  173. File Logs offer great freedom when rejoining (and splitting).
  174. As if using a file requester wasn't easy enough... this allows
  175. you to just load a file and hit SPLIT or JOIN.
  176.  
  177. Nbytes, Offset and Rest:
  178. ~~~~~~~~~~~~~~~~~~~~~~~~
  179. For a good description of these features you should read the
  180. docs that come with the SPLOIN CLI program. Basically they take
  181. X number of bytes(Nbyte) from location X(offset) and split the
  182. X bytes(Nbytes) into the specified destination... and if REST
  183. is selected will save the rest of the bytes in the file to the
  184. destination specified in the REST OF FILE area (below destination).
  185.  
  186. MISC FEATURES:
  187. ~~~~~~~~~~~~~~
  188. Let's say you want to join all of the files in dh0: that end
  189. with .TXT but don't want to mess around with a file selector.
  190.  
  191. Go to the directory where the files are located (in this case
  192. set the field above the small requestor to DH0:)... Then
  193. Just Type "#?.txt" (without the "") on the first line of of
  194. the MAIN selector, Enter the destination and name in the
  195. DESTINATION field... and Hit JOIN.
  196.  
  197. The #?.txt can be replaced with #?.pic, #?.doc etc.
  198.  
  199. If you wanted to join all .txt with all .pic files from dh1:, just
  200. type "#?.txt Dh1:#?.pic" on the first line. Enter the destination and 
  201. name and hit JOIN. Notice that the first #?.txt does not specify a
  202. directory... this is because the directory for the first file must
  203. be the current directory (just go to it with the small selector
  204. or type the directory name into the top field). All "#?" that
  205. you use after this require the directory to be specified.
  206.  
  207. I didn't really put much effort into emplimenting this feature..
  208. as it is very easy to use from the CLI.... but it's here. I will
  209. work on improving it in the future.
  210.  
  211. Other Buttons:
  212. ~~~~~~~~~~~~~~
  213. The ABOUT button displays program version and shareware info.
  214.  
  215. The I button will ICONIFY the program.
  216.  
  217. The ?> buttons next to the DESTINATION and REST OF fields serve
  218. two purposes. Click it once to clear the corresponding field.
  219. click it twice to bring up a file requestor to help locate and
  220. choose files or directories.
  221.  
  222. FUTURE ENHANCEMENTS:
  223. ~~~~~~~~~~~~~~~~~~~~
  224. Full control over the size, source, and destination of EACH file
  225. DURRING Mega-Joining and Mega-Splitting. You will be able to
  226. AUTO Join or split as many files as you like (memory and disk
  227. space permitting) and have each file come from a specified source,
  228. go to a specified destination, and have each file have it's
  229. own specified size,number and name.... ALL AT ONCE!
  230.  
  231. A very simple requestor to allow those wanting to use the #?
  232. feature to select what types of files to split or join... 
  233. (,pic, .txt, .anim....etc)... so you won't have to type this.
  234.  
  235. Thanks To:
  236. ~~~~~~~~~~
  237. Yves Perrenoud for creating the SPLOIN CLI based program.
  238. M. Joel Guerra, Who's partial code I used/modified for the 
  239. small file requester... (from a P.D. requestor example called 
  240. DirBrowse).
  241. Also:
  242. Thanks to Inovatronics for creating CANDO... the best all around
  243. multimedia program EVER MADE!
  244.  
  245. Known Bugs:
  246. ~~~~~~~~~~~
  247. Well, Since I'm still very new to the "programming thing" and this
  248. is version 1.0...It's quite possible there are a few bugs. As My 
  249. programming skills improve... so will SPLOIN-GUI!
  250.  
  251. I have not added precise error handling to all of the features.
  252. This will change with a future version.
  253.  
  254. You cannot split or join files with empty spaces in the names. 
  255. You also cannot split or join to disks or directories with
  256. spaces in the names. "MY DRIVE:"
  257.                         ^_________The space will cause SPLOIN GUI
  258.                                   To abbondon the split or join.
  259.  
  260.  
  261.                 DISTRIBUTION & SHAREWARE NOTICE:
  262.                 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  263. SPLOIN-GUI is © SHAREWARE. Before you smirk and think... "this
  264. guy isn't getting a penny"... ALL I ASK IS A $1 donation. If you
  265. use SPLOIN-GUI... then you owe me $1. Send the $1 fee to:
  266.  
  267. Joey McDonald
  268. 2627 S. Lamb Blvd. #205
  269. Las Vegas, NV 89121
  270.  
  271. You can net-mail me at 1:209/254 or 1:209/239.
  272.  
  273. SPLOIN-GUI is freely distributable via BBS and PD disk
  274. collections charging no more than $6 per disk. If you
  275. wish to include SPLOIN-GUI on a disk magazine, commercial
  276. software, etc.... you will need my permission. The Archive
  277. must remain in it's original form and all files must remain
  278. unchanged.... with exception to the SPL165.LHA file which
  279. may be removed from this archive if conflictions occur with
  280. the distribution requests of the author (see the docs contained
  281. in SPL165.LHA).
  282.  
  283.                        DISCLAIMER:
  284.                        ~~~~~~~~~~~
  285. You use this software at your own risk. I am not responsible for
  286. anything this program does. 
  287.  
  288. 11/13/93
  289. Joey McDonald
  290.