@database 01606758-0 @master GUIs:HJSplit/HJSplit_GUI.guide @$VER: 1.0 @author "Mario Sarno" @(c) "© 2000 Mario Sarno" @width 76 @remark Created with Heddley v1.20ß © Edd Dumbill 1994-5 @node "Main" "HJSplit for Amiga GUI - Main Menu" @{b} HJSplit for Amiga GUI V1.0@{ub} By Mario Sarno © 2000 Mario Sarno. All Rights Reserved @{u}MAIN MENU@{uu} @{" Overview " link "Overview" 0} - What does this program do? @{" System Requirements " link "SystemRequirements" 0} - What you need to run it @{" Installation " link "Installation" 0} - Installation instructions @{" Distribution " link "Distribution" 0} - Distribution allowances @{" Usage " link "Usage" 0} - How to use the program @{" History " link "History.txt/main" 0} - Details of previous versions @{" Future " link "Future" 0} - Plans for future versions @{" About the Author " link "AboutAuthor" 0} - A little bit about me @{" About Gui4Cli " link "AboutGui4Cli" 0} - Information Gui4Cli @{" About HJSplit " link "AboutHJSplit" 0} - Information on HJSplit @{" Copyrights " link "Copyrights" 0} - Copyright details @endnode @node "Overview" "HJSplit for Amiga GUI - Overview" @{b}OVERVIEW@{ub} HJSplit is a CLI-based file splitter. Sometimes, it can be annoying to type in a long list of parameters, especially when the PC version of the program contains a nice, easy-to-use GUI. This little program provides a Graphical User Interface (GUI) for HJSplit, making it as easy, if not, better to use than the PC version of HJSplit. It provides all the functionality of it's PC counterpart, within the comfort of the Amiga OS. The GUI has been written using the excellent @{"Gui4Cli" link "AboutGui4Cli" 0} package by D. Keletsekis. This language made the production of this GUI extremely painless, and enjoyable! @endnode @node "SystemRequirements" "HJSplit for Amiga GUI - System Requirements" @{b}SYSTEM REQUIREMENTS@{ub} An Amiga with Hard drive (it's pointless without one) Gui4Cli (included) HJSplit (included) The program has been tested on an A1200, OS3.5, with Apollo 1240/28 and 32Mb Fast Ram, without any problems. @endnode @node "Installation" "HJSplit for Amiga GUI - Installation" @{b}INSTALLATION@{ub} @{u}Automatic Installation@{uu} Simply double click in the Install icon, and follow all on-screen instructions. The Install program uses the standard Installer interface. @{u}Manual Installation@{uu} 1. Create a directory on your hard disk called HJSplit, and copy the following files into it:- HJSplit.gc HJSplit.gc.info HJSplit_Checksum.gc HJSplit_Join.gc HJSplit_Split.gc HJSplit_GUI.guide HJSplit_GUI.guide.info 2. Copy the Gui4Cli file into C: You could leave Gui4Cli in the HJSplit directory, but copying it into the C: directory allows access to it from other programs. 3. Copy the contents of the Fonts directory into FONTS: 4. Download and copy the HJSplit program into the C: directory, or into the HJSplit GUI directory. It can be found at: http://www.freebyte.com @endnode @node "Distribution" "HJSplit for Amiga GUI - Distribution" @{b}DISTRIBUTION@{ub} This program is EmailWare, which means you're free to use and distribute it, as long as you send me an Email saying you use the program! This is so I can keep check on how many people use it. If you distribute it, you MUST distribute the following files together in one archive, in their original unchanged state, as a minimum :- HJSplit.gc HJSplit.gc.info HJSplit_Checksum.gc HJSplit_Join.gc HJSplit_Split.gc HJSplit_GUI.guide HJSplit_GUI.guide.info Install Install.info Optional files to distribute are:- Gui4Cli HJSplit @endnode @node "Usage" "HJSplit for Amiga GUI - Usage" @{b}USAGE@{ub} When you first start the GUI, you will be presented with the main menu, which contains the following options... @{" Split " link "Usage_Split" 0} - Allows you to split a file. @{" Join " link "Usage_Join" 0} - Allows you to join a previously split file. @{" Checksum " link "Usage_Checksum" 0} - Allows you to calculate a checksum of a file. @{" About " link "Usage_About" 0} - Displays information about the program. @{" Quit " link "Usage_Quit" 0} - Quits the program. @endnode @node "Usage_Split" "HJSplit for Amiga GUI - Usage - Split" @toc "Usage" @{b}SPLIT@{ub} Clicking on the Split button opens the "File Splitter" window, and this provides you with the functions needed to split a file. Split files take the name of the file, with a .001, .002, .003, ... extension. The first text item ("Size of splitfiles") allows you to enter, in kB, the size of each splitfile. This can be anything you like! The default is 1400 kB The second text item ("File to split") allows you to type in the name of the file you want to split. Alternatively, you can click on the "F" button to the right of it, to open a file requester, in which to select the file. The third text item ("Destination Path") allows you to select where the split files go. It defaults to the path of the original file. Again, you can click on the "F" button to open a file requester, where you can move to the required directory. Clicking on the "Start" button starts the file splitting process. If the file was split sucessfully, a "File split sucessfully!" message will be displayed. However, if there was an error, for instance the file could not be found, or if the splitfiles couldn't be saved, then an error message will pop up. Clicking on the "Back" button will return you to the main menu. @endnode @node "Usage_Join" "HJSplit for Amiga GUI - Usage - Join" @toc "Usage" @{b}JOIN@{ub} Clicking on the Join button opens the "File Joiner" window, and this provides you with the functions needed to join a file together. The first text item ("First splitfile") allows you to type in the name of the first splitfile, for the file you wish to join together. Alternatively, you can click on the "F" button to the right of it, to open a file requester, in which to select the file. The second item ("Joined file") displays the name of the file that is to be joined together. The third text item ("Destination Path") allows you to select where the split files go. It defaults to the path of the .001 file. Again, you can click on the "F" button to open a file requester, where you can move to the required directory. Clicking on the "Start" button starts the file joining process. If the files were joined sucessfully, a "Files joined sucessfully!" message will be displayed. However, if there was an error, for instance the .001 file could not be found, or if the joined file couldn't be saved, then an error message will pop up. Clicking on the "Back" button will return you to the main menu. @endnode @node "Usage_Checksum" "HJSplit for Amiga GUI - Usage - Checksum" @toc "Usage" @{b}CHECKSUM@{ub} Clicking on the Checksum button opens the "Calculate Checksum" window, and this provides you with the functions needed to calculate a checksum of a file. The first text item ("File") allows you to type in the name of the file for which you want to calculate the checksum for. Alternatively, you can click on the "F" button to the right of it, to open a file requester, in which to select the file. The second item ("Checksum") displays the checksum of the file, once the "Start" button has been clicked. Clicking on the "Start" button starts the checksum calculation process. If the files were joined sucessfully, a "Checksum calculated sucessfully!" message will be displayed. However, if there was an error, for instance the file could not be found, then an error message will pop up. Clicking on the "Back" button will return you to the main menu. @endnode @node "Usage_About" "HJSplit for Amiga GUI - Usage - About" @toc "Usage" @{b}ABOUT@{ub} Clicking on the About button opens the About window, which displays various pieces of information on the program, and also the Gui4Cli and HJSPlit packages. Click "OK" to close the window. @endnode @node "Usage_Quit" "HJSplit for Amiga GUI - Usage - Quit" @toc "Usage" @{b}QUIT@{ub} Clicking on the Quit button quits the HJSplit GUI. @endnode @node "Future" "HJSplit for Amiga GUI - Future" @{b}FUTURE@{ub} * I'm planning for a little feature that will copy the splitfiles from the floppies onto the hard disk, ready for joining. * Similar as above, another feature will copy splitfiles from Hard Disk to floppies. * A bit more error checking. * Anything else you suggest?? Email me! @endnode @node "AboutAuthor" "HJSplit for Amiga GUI - About the Author" @{b}ABOUT THE AUTHOR@{ub} I am 19 years old, and I am currently studying for a degree in Computing from the University of Sunderland, in the UK. I have just finished my second year, so I have one more year to go before graduation. I am British, but my father is from Italy, and my mother is from Spain. I also own the following Amiga system... Commodore Amiga A1200 Rev 2b (housed in a Power Tower) Kickstart 3.1 Workbench 3.5 Apollo 1240/28 Accelerator card (68040 processor) 2Mb Chip Ram, 32Mb Fast Ram 2.1Gb Samsung IDE HDD Samsung 24-speed IDE CD-ROM ATAPI LS-120 drive You can contact me at the following address... Mario Sarno 26 Carnoustie, Amington, Tamworth, Staffordshire B77 4NN UK or you can Email me at:- mario.sarno@england.com You'll find the latest version of this GUI, as well as my other programs on my website, which can be found at:- http://mariosarno.freeservers.com If you visit it, please leave a message on my guestbook! @endnode @node "AboutGui4Cli" "HJSplit for Amiga GUI - About Gui4Cli" @{b} ABOUT GUI4CLI@{ub} Gui4Cli is an excellent and powerful script-based GUI creation program, which allows you to create GUIs for any number of CLI based programs. You can also create complete programs, with full functionality contained within the scripts. For instance, a full file manager has been created using just the Gui4Cli package, as well as a program for reading and displaying text files. You may think that a program of this complexity is hard to pick up. However, the opposite is true. It is one of the easiest programming languages to learn that I have ever come across! I managed to grasp the language to a competent level within a couple of hours!! If you wish to try the program out for yourself, you'll find the latest version on Aminet, or even better, on the authors website, at:- http://users.hol.gr/~dck/gcmain.htm The author's name is D. Keletsekis. @endnode @node "AboutHJSplit" "HJSplit for Amiga GUI - About HJSplit" @{b}ABOUT HJSPLIT@{ub} HJSplit is a user-friendly, multi-platform file-splitter. It can be very handy for instance, when you want to transfer very large files between two computers that don't have a network link. If the file doesn't fit onto a floppy disk, then you would be in trouble. So HJSplit splits them into smaller chunks, which can then be copied onto several floppies, and transferred to the other computer, and joined back together. Now you may say that there are plenty of file splitters around, what makes HJSplit so special? Well, the answer is that, as I said before, HJSplit is a multi-platform file splitter. There are versions for the PC, Mac, Amiga and UNIX. There's even a version written in Java! Because of this, you can guarantee that if you split the file on one platform using HJSplit, they will joined back correctly, and with the minimum of fuss, on another platform using HJSplit. You can find the latest version of HJSplit, for all platforms, at:- http://www.freebyte.com @endnode @node "Copyrights" "HJSplit for Amiga GUI - Copyrights" @{b}COPYRIGHTS@{ub} @{u}HJSplit for Amiga GUI@{uu} · The PROGRAM ("HJSplit.gc"), it's AUXILLARY FILES ("HJSplit_Checksum.gc", "HJSplit_Split.gc", "HJSplit_Join.gc), and its DOCUMENTATION ("HJSplit_GUI.guide") are copyright © 2000 Mario Sarno · The PROGRAM is @{fg shine}EmailWare@{fg text}. It may be copied and distributed as long as these rules, and the distribution details as laid out in the @{"Distribution" link "Distribution" 0} section of this DOCUMENTATION are adhered to. · The PROGRAM, it's AUXILLARY FILES, and the DOCUMENTATION is used at the owner's risk. No responsibilty is taken by the author if the PROGRAM, it's AUXILLARY FILES or its DOCUMENTATION causes any malfunction in any hardware or software program. @{u}HJSplit@{uu} · The PROGRAM ("HJSplit"), is copyright © 1997 Henk Hagedoorn and Rhesa Rozendaal. · The PROGRAM is used at the owner's risk. No responsibilty is taken by the author if the PROGRAM causes any malfunction in any hardware or software program. @{u}Gui4Cli@{uu} · The PROGRAM ("Gui4Cli"), is copyright © 1995-1999 D.C. Keletsekis. · The PROGRAM is used at the owner's risk. No responsibilty is taken by the author if the PROGRAM causes any malfunction in any hardware or software program. @endnode