home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / utilities / utilst / uucoder / !UUcoder / !Help < prev    next >
Text File  |  1995-05-17  |  8KB  |  215 lines
  1. UUcoder 1.10
  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 !Scrap so will run much 
  31. better on a machine with a hard disc, but then Internet (or at least 
  32. 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: Messages, Sprites, Sprites22, Templates
  44.  
  45. Use 
  46. ===
  47.  
  48. Double click on the !UUcoder icon in the Filer window.  This installs 
  49. !UUcoder on the iconbar and opens the main coding and decoding window.
  50.  
  51. Clicking on the !UUcoder icon on the iconbar will re-open the main 
  52. coding and decoding window if it has been closed.  If the window is 
  53. already open it will bring it to the top of any other windows that are 
  54. open.
  55.  
  56. To encode a file:
  57.  
  58. 1. Use the Choices window (opens from the menu) to set up the way that 
  59. !UUcoder should code the file.  Select the split file option if you 
  60. think that the resulting file will be longer than the maximum length of 
  61. an e-mail message (it can be as low as 60k on some parts of the 
  62. Internet).  With this option set you should set the maximum file length 
  63. that your system allows.  These options can be saved to use as defaults 
  64. on future sessions with !UUcoder by selecting 'Save' or used just this 
  65. time by selecting 'Use'.  This dialogue box also allows you to set 
  66. default file names for the resulting encoded file.  These can be full 
  67. filepaths if you wish.
  68.  
  69. 2. Drag the file you wish to encode to the code icon at the top right 
  70. of the main window.  If the file is being sent to someone with a PC 
  71. rather than an Arc it should be named with the appropriate file PC file 
  72. extension, using a "/" instead of a ".".  This ensures that the PC user 
  73. gets a correctly typed file when it is decoded.  For example a gif file 
  74. "mum" should be called "mum/gif" before dragging it to !UUcoder.  It 
  75. will be uuencoded with the PC file name of "mum.gif".  If there is not 
  76. a PC style file extension !UUcoder will save the RISC OS filetype with 
  77. the file so that it will be filetyped correctly if later decoded by 
  78. !UUcoder.
  79.  
  80. 3. !UUcoder will encode the file.
  81.  
  82. 4. Edit the file name supplied by !UUcoder to the name you wish to save 
  83. the file under, and drag the file icon to a Filer directory display or 
  84. to another application.  Alternatively enter the full pathname and 
  85. click select on the 'OK' icon.  If you have the split option set, and 
  86. the file is longer than the maximum length, !UUcoder will split the 
  87. file and keep presenting new part-files for you to save until the whole 
  88. file has been saved.
  89.  
  90.  
  91. To decode a file or series of files:
  92.  
  93. 1. Drag a uuencoded file to the decode icon at the bottom right of the 
  94. main window.  !UUcoder will detect whether it is a complete uuencoded 
  95. file or give a prompt for the next file in a series.  Continue dragging 
  96. the series of files to the decode icon until !UUcoder detects the end 
  97. of the uuencoded data.  The files must be dragged in order.
  98.  
  99. 2. !UUcoder decodes the complete uuencoded file.
  100.  
  101. 3. Edit the supplied name as appropriate, then drag the file icon to a 
  102. Filer directory display or to another application.  Alternatively enter 
  103. the full pathname of the file and click select on the 'OK' icon.  
  104. Additionally you can double-click select over the file icon to load it 
  105. into an appropriate application. 
  106.  
  107.  
  108. Features
  109. ========
  110.  
  111. * !UUcoder will accept files direct from other applications so, for 
  112. example, you can use the 'Save File' option of !TTFN to decode files by 
  113. dragging them to the !UUcoder decode icon rather than saving them on 
  114. disc first.
  115.  
  116. * !UUcoder will save coded files to other applications so, for example, 
  117. you can insert an encoded file (or section of file) into a message 
  118. being composed by !TTFN.
  119.  
  120. * !UUcoder uses solid sprite dragging if you have it enabled on your 
  121. machine.
  122.  
  123. * !UUcoder will put the RISC OS filetype at the end of any file it 
  124. codes (except files which already have PC file extensions).  When 
  125. decoding files !UUcoder will check whether there is a RISC OS filetype 
  126. given after the file and will use it to filetype the decoded file.
  127.  
  128. * !UUcoder will translate PC-type file extensions to RISC OS filetypes 
  129. as follows:
  130.  
  131.           PC-type       RISC OS
  132.  
  133.          .arc           &DDC
  134.          .arj           &DDC
  135.          .bmp           &69C
  136.          .csv           &DFE
  137.          .doc           &FFF
  138.          .dxf           &DEA
  139.          .gif           &695
  140.          .gz            &DDC
  141.          .iff           &693
  142.          .img           &692
  143.          .jpg           &C85
  144.          .lzh           &DDC
  145.          .lha           &DDC
  146.          .mod           &CB6
  147.          .med           &CB6
  148.          .mmd           &CB6
  149.          .mpg           &BF8
  150.          .pc1           &691
  151.          .pc2           &691
  152.          .pc3           &691
  153.          .pcx           &697
  154.          .pi1           &691
  155.          .pi2           &691
  156.          .pi3           &691
  157.          .ps            &FF5
  158.          .tar           &C46
  159.          .tif           &FF0
  160.          .txt           &FFF
  161.          .uue           &FFF
  162.          .wav           &FB1
  163.          .zip           &DDC
  164.  
  165. This means that the output files can be double clicked to load them 
  166. into image translators such as !ChangeFSI, !Translatr or !FYEO2 (.jpg, 
  167. .gif and tif), an MPEG viewer (.mpg) or a de-archiver such as !Spark 
  168. (.arc .tar and .zip).
  169.  
  170. I would welcome suggests of other file extensions which could be 
  171. translated to RISC OS filetypes (and appropriate sprites) in this way.
  172.  
  173. * !UUcoder will also transfer directly to and from other applications 
  174. which accept direct transfer.  Note that there is a bug in !Translatr 
  175. which means it will not accept .jpg files unless you edit one line in 
  176. !Translatr's !Run file.  The line that reads: 
  177.  
  178.           Set Translator$Scrap <Wimp$Scrap>
  179.  
  180. should be changed to point to a different file such as: 
  181.  
  182.           Set Translator$Scrap <Wimp$Scrap>2
  183.  
  184. * Closing the main window part way through any operation will destroy 
  185. the unsaved data (as per Acorn's guidelines).  To keep the data while 
  186. closing the !UUcoder main window, hold the shift key down when closing 
  187. it.  This will iconise the window on the pinboard allowing it to be 
  188. reopened by clicking select on the window icon.
  189.  
  190. * Interactive Help is supported for the main window, dialogue boxes and 
  191. menus.
  192.  
  193.  
  194. Background
  195. ==========
  196.  
  197. UUcoded files are put on the Internet in a wide range of forms.  This 
  198. means that it is not always easy to detect the start and end of 
  199. sections of code which need to be combined before decoding.  !UUcoder 
  200. makes intelligent guesses but I would welcome examples of files where 
  201. it does not produce a valid output file.  In cases of doubt you can 
  202. edit 'END' as the line after the last coded line of a file, this 
  203. clearly signifies to !UUcoder that it has reached the end of a section 
  204. and to request anothe