home *** CD-ROM | disk | FTP | other *** search
/ RISC DISC 2 / RISC_DISC_2.iso / pd_share / comms / encoders / uucoder / !UUcoder / !Help < prev    next >
Encoding:
Text File  |  1995-09-18  |  8.5 KB  |  204 lines
  1. UUcoder 1.12a
  2. =============
  3.  
  4.  
  5. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  6. + © John Allen 1994, 1995.  This application is Freeware and is     +
  7. + supplied on the understanding that:                               +
  8. +                                                                   +
  9. + 1. The source code is not altered in any way                      + 
  10. + 2. Any copies made contain all of the files in the directory      + 
  11. + 3. It is not sold for a profit                                    + 
  12. +                                                                   + 
  13. + Please contact me before adding it to a PD library so that I can  + 
  14. + supply an up to date version.                                     + 
  15. +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  16.  
  17.  
  18. !UUcoder codes and decodes uuencoded files such as might be sent and 
  19. received via Usenet newsgroups on the Internet.  It works totally on 
  20. the RISC OS desktop and is designed to work only under RISC OS 3.10 and 
  21. later versions.
  22.  
  23. As well as decoding single files it will also turn a series of messages 
  24. containing sections of a uu encoded file (such as might be found in 
  25. newsgroups with'binaries' in the title) into a single decoded file.  
  26.  
  27. Likewise it will split long coded files into short sections to send in 
  28. separate messages.
  29.  
  30. !UUcoder saves and loads files to and from the !Scrap directory so will 
  31. run much better on a machine with a hard disc, but then Internet (or at 
  32. least Demon) would be a pain on a machine which only had floppy drives.
  33.  
  34. The following files should be included in the !UUcoder directory:
  35.  
  36. !Boot
  37. !Help
  38. !History
  39. !Run
  40. !RunImage
  41. !Sprites
  42. !Sprites22
  43. Resources directory containing: Mapping, Messages, Sprites, Sprites22, 
  44.                                 Templates
  45.  
  46. Use 
  47. ===
  48.  
  49. Double click on the !UUcoder icon in the Filer window.  This installs 
  50. !UUcoder on the iconbar and opens the main coding and decoding window.
  51.  
  52. Clicking on the !UUcoder icon on the iconbar will re-open the main 
  53. coding and decoding window if it has been closed.  If the window is 
  54. already open it will bring it to the top of any other windows that are 
  55. open.
  56.  
  57. !UUcoder is designed to be simple to use.  To decode drop a file on the 
  58. decode icon and to code drop it on the code icon.  The resulting file 
  59. can then be dragged where ever it is required.  The instructions below 
  60. are more detailed an explain the more advanced features:
  61.  
  62.  
  63. To decode a file or series of files:
  64.  
  65. 1. Use the Choices window (opens from the menu) to set whether any 
  66. PC-style file extension should be preserved on decoding.  This is 
  67. useful if the decoded file will eventually be used on a PC or the Risc 
  68. PC 486 card.  This option can be saved to use as default on future 
  69. sessions with !UUcoder by selecting 'Save' or used just this time by 
  70. selecting 'Use'.  
  71.  
  72. 2. Drag a file containing uuencoded data to the decode icon at the 
  73. bottom right of the main window.  There's no need to edit the header 
  74. off the file, just use the whole file.  !UUcoder will detect whether it 
  75. is a complete uuencoded file or give a prompt for the next file in a 
  76. series.  Continue dragging the series of coded files to the decode icon 
  77. until !UUcoder detects the end of the uuencoded data.  The files must 
  78. be dragged in order.
  79.  
  80. 3. !UUcoder decodes the complete uuencoded file.
  81.  
  82. 3. Edit the supplied name as appropriate, then drag the file icon to a 
  83. Filer directory display or to another application.  Alternatively enter 
  84. the full pathname of the file and click select on the 'OK' icon.  
  85. Additionally you can double-click select over the file icon to load it 
  86. into an appropriate application (if known to RISC OS at the time of 
  87. clicking). 
  88.  
  89.  
  90. To encode a file:
  91.  
  92. 1. Use the Choices window (opens from the menu) to set up the way that 
  93. !UUcoder should code the file.  Select the split file option if you 
  94. think that the resulting file will be longer than the maximum length of 
  95. an e-mail message (it can be as low as 60k on some parts of the 
  96. Internet).  With this option set you should set the maximum file length 
  97. that your system allows.  These options can be saved to use as defaults 
  98. on future sessions with !UUcoder by selecting 'Save' or used just this 
  99. time by selecting 'Use'.  This dialogue box also allows you to set 
  100. default file names for the resulting encoded file.  These can be full 
  101. filepaths if you wish.
  102.  
  103. 2. Drag the file you wish to encode to the code icon at the top right 
  104. of the main window.  If the file is being sent to someone with a PC 
  105. rather than an Arc it should be named with the appropriate file PC file 
  106. extension, using a "/" instead of a ".".  This ensures that the PC user 
  107. gets a correctly typed file when it is decoded.  For example a gif file 
  108. "mum" should be called "mum/gif" before dragging it to !UUcoder.  It 
  109. will be uuencoded with the PC file name of "mum.gif".  If there is not 
  110. a PC style file extension !UUcoder will save the RISC OS filetype with 
  111. the file so that it will be filetyped correctly when decoded by 
  112. !UUcoder.
  113.  
  114. 3. !UUcoder will encode the file.
  115.  
  116. 4. Edit the file name supplied by !UUcoder to the name you wish to save 
  117. the file under, and drag the file icon to a Filer directory display or 
  118. to another application.  Alternatively enter the full pathname and 
  119. click select on the 'OK' icon.  If you have the split option set, and 
  120. the file is longer than the maximum length, !UUcoder will split the 
  121. file and keep presenting new part-files for you to save until the whole 
  122. file has been saved.
  123.  
  124.  
  125. Features
  126. ========
  127.  
  128. * !UUcoder will accept coded files direct from other applications so, 
  129. for example, you can use the 'Save File' option of !TTFN to decode 
  130. files by dragging them to the !UUcoder decode icon rather than saving 
  131. them on disc first.
  132.  
  133. * !UUcoder will save coded files to other applications so, for example, 
  134. you can insert an encoded file (or section of file) into a message 
  135. being composed by !TTFN.
  136.  
  137. * !UUcoder will also transfer decoded directly to and from other 
  138. applications which accept direct transfer.  Note that there is a bug in 
  139. !Translatr which means it will not accept .jpg files unless you edit 
  140. one line in !Translatr's !Run file.  The line that reads: 
  141.  
  142.           Set Translator$Scrap <Wimp$Scrap>
  143.  
  144. should be changed to point to a different file such as: 
  145.  
  146.           Set Translator$Scrap <Wimp$Scrap>2
  147.  
  148. * Double clicking a decoded file will attempt to load it into an 
  149. application that accepts that filetype.  Note that some applications 
  150. (e.g. !Spark) do not take possession of files loaded this way so it is 
  151. vital that the file is processed and saved elsewhere before !UUcoder is 
  152. closed down - as all !UUcoder working files in the !Scrap directory are 
  153. deleted on closedown.
  154.  
  155. * Closing the main window part way through any operation will destroy 
  156. the unsaved data (as per Acorn's guidelines).  To keep the data while 
  157. closing the !UUcoder main window, hold the shift key down when closing 
  158. it.  This will iconise the window on the pinboard allowing it to be 
  159. reopened by double clicking select on the window icon.
  160.  
  161. * !UUcoder uses solid sprite dragging if you have it enabled on your 
  162. machine.
  163.  
  164. * !UUcoder will put the RISC OS filetype at the end of any file it 
  165. codes (except files which already have PC file extensions).  When 
  166. decoding files !UUcoder will check whether there is a RISC OS filetype 
  167. given after the file and will use it to filetype the decoded file.
  168.  
  169. * !UUcoder will translate PC-type file extensions to RISC OS filetypes 
  170. according to the host machines DOSMap settings and with supplied 
  171. translations in the file Resources.Mapping.  This means that the output 
  172. files can be double clicked to load them into image translators such as 
  173. !ChangeFSI, !Translatr or !FYEO2 (.jpg, .gif and tif), an MPEG viewer 
  174. (.mpg) or a de-archiver such as !Spark (.arc .tar and .zip).
  175.  
  176. * Interactive Help is supported for the main window, dialogue boxes and 
  177. menus.
  178.  
  179. * Combines and decodes files which have been downloaded on a PC where 
  180. lines end <CR><LF> rather than <LF> in RISC OS.
  181.  
  182.  
  183. Background
  184. ==========
  185.  
  186. UUcoded files are put on the Internet in a wide range of forms.  This 
  187. means that it is not always easy to detect the start and end of 
  188. sections of code which need to be combined before decoding.  !UUcoder 
  189. makes intelligent guesses but I would welcome examples of files where 
  190. !UUcoder does not produce a valid output file.  In cases of doubt you 
  191. can edit 'END' as the line after the last coded line of a file, this 
  192. clearly signifies to !UUcoder that it has reached the end of a section 
  193. and to request another file.
  194.  
  195.  
  196.  
  197. Any comments, queries, donations or bug reports to:
  198.  
  199. John Allen.
  200.  
  201. E-mail: john@bramber.demon.co.uk
  202. Arcade: #917
  203. Silicon Village: 819991215
  204.