home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / utilities / utilst / unpost / !Unpost / !Help < prev    next >
Encoding:
Text File  |  1995-10-17  |  3.4 KB  |  132 lines
  1. UnPost 2.1.2 RISC OS version 0.01
  2. =================================
  3.  
  4. This is a port of John Stevens' excellent unpost for RISCOS as published in
  5. comp.sources.
  6.  
  7. UNPOST is a "smart" uudecoder that is designed to extract binaries from
  8. multi-part USENET or email uuencoded binaries.
  9.  
  10. See !UnPost.Docs directory for the original documentation and more info.
  11.  
  12. This is a Beta test version, with a minimal desktop front end provided by
  13. the DDE FrontEnd module (probably only available with Acorn DeskTop C, but
  14. I'm not sure).
  15.  
  16. I'm your first line of support if it doesn't work!
  17.  
  18. Nick Craig-Wood
  19. ncw@axis.demon.co.uk
  20.  
  21.  
  22. Desktop
  23. -------
  24.  
  25. Double click on !UnPost.  Provided you have the DDEFrontEnd module available
  26. this will put an icon on the icon bar where you can drag files to be
  27. uu-decoded.
  28.  
  29.  
  30. Command line
  31. ------------
  32.  
  33. Use with
  34.  
  35. UnPost <file> <file2>...
  36.  
  37. Make sure the application has been Filer_Boot-ed so the UnPost alias is set
  38. up.
  39.  
  40.  
  41. Using with NewsBase
  42. -------------------
  43.  
  44. If you are feeling cunning you can make UnPost debatch news automatically if
  45. you use NewsBase.
  46.  
  47. 1) Make sure !UnPost has been seen by the filer before debatching news
  48.  
  49. 2) Look at !NewsBase.Transports.XXXX.params (where XXXX is the name of your
  50.    transport, eg KA9Q).  If there is no line starting prefetch... then add one
  51.   
  52.    prefetch 64 prefetch %f
  53.   
  54. 3) If the file !NewsBase.Transports.XXXX.prefetch does not exist, create it
  55.    as an Obey file.
  56.  
  57. 4) Add the line
  58.  
  59.    UnPost -log %*0
  60.  
  61.    To the start
  62.  
  63. 5) Cross your fingers :-)
  64.  
  65. The interface isn't perfect and I am sure many improvements will ocurr to
  66. you!
  67.  
  68. (I'd like to hear comments from Beta testers as to how easy they found this
  69. process.)
  70.  
  71.  
  72. Changes to original code
  73. ------------------------
  74.  
  75. Fixed up some slight Non-ANSI-isms (eg <memory.h>.  This code is very
  76. portable however.
  77.  
  78. Fixed corruption of name on issue of warning
  79.  
  80. Made uudecode check line for only the decoded length number of characters,
  81. not the whole line (this enable it to decode SparkFS binaried with the part
  82. number on the end.  Some other uu-decoders put an incrementing character
  83. here also)
  84.  
  85. Made it auto-try file names if the output file exists already.
  86.  
  87. Made RISCOS filename output mode
  88.  
  89. Created KA9Q configuration file
  90.  
  91. Made it notice binaries of the form Subject:*Part xx
  92.  
  93. Made it recognise +--BEGIN etc lines
  94.  
  95. Fixed tabs in config files.  This is an artifact of its posting of
  96. comp.sources I think.
  97.  
  98. If a segment has not beed identified by Subject: line or by a line in the
  99. body left by a uu-encoder, then it will only mark the segment as having uu
  100. data if it contains a valid begin line.  This is a change from the old
  101. method where only 1 UU line was required which happened a lot in normal text
  102. messages.
  103.  
  104. -o <path> option added.  This specifies the path for the output files.  If
  105. you don't specify a path, the output files will go into the current
  106. directory.
  107.  
  108.  
  109. To Do
  110. -----
  111.  
  112. Loads of things probably!
  113.  
  114. Got a duplicate binary ID when decoding 2 binaries under very nearly the
  115. same subject.  Failed to decode the second one.
  116.  
  117. Doesn't deal with more than one uu file in the same message
  118.  
  119. I'm a little bit unhappy with the segment decection.  The one for e-mail
  120. messages is not very good because in could easily occurr in a news message. 
  121. Also it doesn't work with PoP mail.
  122.  
  123.  
  124. Notes
  125. -----
  126.  
  127. In my news feed I get about 1% of the feed put into the incompletes file
  128. erroneously.
  129.  
  130. Tested with all the news I received in September 95 (35 Mbytes), decoded all
  131. 24 binaries in it and left me with 312k of inclompletes.
  132.