home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / PSION / MISC / SPLITZ / SPLITZ.TXT < prev    next >
Encoding:
Text File  |  1995-02-24  |  9.0 KB  |  225 lines
  1.                            SPLITZ & JOINZ manual
  2.                         version 1.0, February 1995
  3.                             ⌐ 1995 Daniel Pfund
  4.  
  5. 1.  Introduction
  6. ----------------
  7.  
  8. SPLITZ & JOINZ is a program designed to split and join text files.  The
  9. program is written in OPL and will only work on a Psion 3a.
  10.  
  11. 2.  Distribution
  12. ----------------
  13.  
  14. SPLITZ & JOINZ is shareware.  This means you can test it during 30 days and
  15. if you like it and/or still use it after this test period, you are required
  16. to register it.  The registration fee is 10 Swiss Francs or 5 UK Pounds.
  17. You will find my address as well as a simple registration formular at the
  18. end of this file.  See section ``Registration'' for more information.  The
  19. program can be distributed freely by any electronic mean (anonymous FTP
  20. sites, BBSes, packet radio ...) provided the file ``SPLITZ.ZIP'' stays
  21. intact.  Software distributors can freely distribute this program on their
  22. shareware disks, provided that :
  23.  
  24.   ╖ You don't charge more than $5 for the service.
  25.  
  26.   ╖ The file ``SPLITZ.ZIP'' stays intact (see section ``Installation'' for
  27.     the file's contents).
  28.  
  29.   ╖ You don't make any money out of it.
  30.  
  31. If you would like to put this program on a CD-ROM, please contact me first
  32. (see section ``Author'' for my address).
  33.  
  34. 3.  Shareware
  35. -------------
  36.  
  37. This program is distributed under the term of ``shareware''.  This means
  38. you can share it with other people and are even encouraged to distribute it
  39. to the maximum of people.  You can then freely test the program for up to
  40. 30 days.  If after this test period, you like and/or still use the program,
  41. you have to register it.  See section ``Registration'' for more
  42. information.
  43.  
  44. 4.  Uses
  45. --------
  46.  
  47. I originally made it to avoid the 40k limit of the inbuilt applications
  48. like Word and OPL.  It will process text files and split them
  49. ``intelligently'' after a LineFeed (LF) at about the size you specify.  I
  50. used it for big text files I received while I had to use my Psion 3a for
  51. packet radio (a radio transmission mode for radio amateurs) while my
  52. Amiga's serial port was defectuous.  You might also want to use it to
  53. split/join large text files if you are writing big articles on your
  54. Psion...
  55.  
  56. 5.  Installation
  57. ----------------
  58.  
  59. You should unzip the file SPLITZ.ZIP and get the following files :
  60.   ╖ SPLITZ.TXT This file
  61.   ╖ SPLITZ.WRD This file for Psion Word
  62.   ╖ SPLITZ.OPA The program
  63.  
  64. All you have to do is copy the file SPLITZ.OPA to the \APP directory with
  65. whatever program you use to copy/move files from/to your Psion.  You will
  66. then have to install the program with the System menu (Apps/Install) or by
  67. pressing Psion-i.
  68.  
  69. 6.  Memory requirements
  70. -----------------------
  71.  
  72. SPLITZ & JOINZ will need only about 3k of your disk space.  In addition,
  73. SPLITZ & JOINZ will need about 28k of free memory to be able to run.  Also,
  74. don't forget that you need space for the output of the file you want to
  75. split/join.
  76.  
  77. 7.  Running the program
  78. -----------------------
  79.  
  80. You will first get two dialogs with some information which you can pass by
  81. pressing ``Enter'' or ``Esc''.  You then get the main dialog where you are
  82. requested to enter useful information.  The first line asks for the source
  83. filename and it's location (Disk A, Internal, Disk B, event REM :  :).  You
  84. can use Tab or Control-Tab to get the usual Psion file requesters.  The
  85. third line asks for the destination directory.  The default is ``LOC :
  86. :M\'', although it will only show you ``\''.  Once again, you can specify
  87. which drive the destination directory should be on.  The fifth line asks
  88. you for the approximate size of the parts.  This is only used if you split
  89. a file of course.  SPLITZ & JOINZ will automatically detect if you want to
  90. split or join a file by looking at the source file.  If the source file has
  91. an extension of the kind ``P0 ?'', it will attempt to join the files
  92. previously splitted.  Otherwise it will take the source file and attempt to
  93. split it.  Note that the minimal split value is 8k.  When joining, SPLITZ &
  94. JOINZ will automatically ask you for the new filename extension.  When you
  95. enter it, you do not need to write a ``.'' in the dialog, but only the last
  96. three letters.  The last line of the main dialog asks you if you want to
  97. delete the source file after use.  If you answer yes, SPLITZ & JOINZ will
  98. delete the source file, but only if there were no errors during the process
  99. of splitting/joining.  Once you have entered everything, type ``Enter'' to
  100. start splitting/joining.  If everything goes well, you will get a dialog
  101. saying ``No errors'' and eventually another line telling you which files
  102. have been deleted.  If on the other hand, an error appeared during the
  103. process of splitting/joining, you will be informed by a requester and the
  104. program will end without deleting any files.
  105.  
  106. 8.  How the program works
  107. -------------------------
  108.  
  109. 8.1.  Splitting
  110. ---------------
  111.  
  112. The program checks if it can read 8192 bytes (8k) of the source file
  113. without going over the split value (hence the minimal split value of 8k ;
  114. for the sake of speed).  If it can, it reads 8k and writes them out to the
  115. destination file ; otherwise it reads one byte and checks if this character
  116. is a LF.  If it is, it writes it to the destination file and closes it.  It
  117. checks if there are any bytes left in the source file and if yes, creates a
  118. new part.  The process then starts over.
  119.  
  120. 8.2.  Joining
  121. -------------
  122.  
  123. Joining is much simpler in the way that it takes all the files with the
  124. same name and extensions ``P0 ?'', starting at 1 and joins them together.
  125. Note that in the main dialog, you do not necessarily need to choose part1,
  126. as it will recognize any part.
  127.  
  128. 9.  Limitations and bugs
  129. ------------------------
  130.  
  131.   ╖ The minimal split value is set to 8k, otherwise the program would be
  132.     somewhat slow.  However, if you really need to split into smaller
  133.     chuncks, this is possible, see section ``Registration''.
  134.  
  135.   ╖ You cannot split a program into more than 9 parts, since the extensions
  136.     are of the kind ``P0 ?''.
  137.  
  138.   ╖ No bugs have been found during testing, although I have never tried to
  139.     run the program on a binary file.
  140.  
  141. 10.  Legal stuff
  142. ----------------
  143.  
  144. SPLITZ & JOINZ is provided ``as is''.  This means, it does what it does,
  145. and I cannot be held responsable if it crashes your system, or causes any
  146. other dammages.  If however you do have a problem with it, please report it
  147. to me and I will try to help you out to fix it.
  148.  
  149. 11.  Author
  150. -----------
  151.  
  152. Snail mail :
  153. Daniel Pfund
  154. 19, ch. de Tirelonge
  155. CH-1213 Onex
  156. Switzerland
  157.  
  158. You can also reach me via E-Mail (preferred !) :
  159. ``Pfund@uni2a.unige.ch'' or if this address doesn't work any more (in a
  160. couple of years) you can still write to me at :
  161. ``hb9vbc@pccr01.cern.ch''.  (Note the zero, not an o !)
  162.  
  163. 12.  Registration
  164. -----------------
  165.  
  166. The registration fee is 10 Swiss Francs or 5 UK Pounds.  Please stay with
  167. these currencies, because it will make life much easier for me !  ;-) To
  168. register, please send me the formular at the end of this file.  You can
  169. either send it to me via E-Mail or snail ``conventional'' mail.  If you
  170. have an E-Mail address, I'll send you the registered program UUencoded at
  171. that address.
  172.  
  173. 12.1.  Benefits from registering
  174. --------------------------------
  175.  
  176. Why should you want to register ?  There are several reasons to this :
  177.   ╖ You will get a registered version of SPLITZ & JOINZ which will be
  178.     personnalized with your name.
  179.  
  180.   ╖ You will be able to choose which directory the program will default to.
  181.  
  182.   ╖ You will be able to eventually choose a smaller minimum split size.
  183.  
  184.   ╖ You will be able to choose the default split size.
  185.  
  186.   ╖ The beginning and end ``shareware'' dialogs will be removed and thus
  187.     give you a much smaller program.
  188.  
  189.   ╖ You will get a DVI doc file (LaTeX typesetted with professional output).
  190.  
  191.   ╖ Most of all, it will free your conscience and assure that I will make
  192.     other shareware programs in the future.
  193.  
  194. 12.2.  Registration formular
  195. ----------------------------
  196.  
  197. -------------------------------------------------------------------------------
  198. First Name :___________________________________________________________________
  199.  
  200. Last Name : ___________________________________________________________________
  201.  
  202. Address : _____________________________________________________________________
  203.  
  204.           _____________________________________________________________________
  205.  
  206. Country : _____________________________________________________________________
  207.  
  208. E-Mail address if you have one:________________________________________________
  209.  
  210. The directory you want the program to default to :_____________________________
  211.  
  212. Eventually, if you need a smaller minimal split size, write it here
  213.                                                 (in bytes) :___________________
  214.  
  215. Send this formular with your registration fee (eurocheque or paper money
  216. only) to me at the following address :
  217.  
  218.                                 Daniel Pfund
  219.                              19, ch. de Tirelonge
  220.                                 CH-1213 Onex
  221.                                  Switzerland
  222. -------------------------------------------------------------------------------
  223.  
  224. [End of SPLITZ & JOINZ documentation]
  225.