home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / programs / comms_networking / newsscan / !Help
Text File  |  1997-07-17  |  7KB  |  150 lines
  1. Name     : NewsScan
  2. Purpose  : A tool to allow you to edit Voyager's outgoing news postings.
  3. Author   : Richard Goodwin
  4. Status   : Freeware
  5. Version  : 1.00 (July 1997)
  6.  
  7. This application, along with the files contained within, © Richard Goodwin
  8. 1997.  This application may be freely distributed by any means AS LONG AS:
  9. * all files remain intact (the options file may be changed)
  10. * no unreasonable charge is made.
  11.  
  12. Interactive !Help support included.
  13.  
  14. Disclaimer:
  15. ~~~~~~~~~~~
  16. If it goes wrong, tough.
  17. If it goes right and deletes something you really would rather it hadn't, tough.
  18.  
  19. IMPORTANT NOTES:
  20. ~~~~~~~~~~~~~~~~
  21. 1. This software allows you to change news postings.
  22.    a. No line should really be longer than 80 characters.  Most Acorn news
  23.       software can handle lines of longer than 80 characters, but PC people
  24.       might get VERY shirty.  USe !Edit's 'Format' command (press F6) if in
  25.       doubt.
  26.    b. This software should not be used for faking addresses.
  27. 2. If you don't like the abbreviations used in the program, you can bring up a
  28.    menu, click on "Choices..." and change options.  Click "Okay" to set, and
  29.    "Save" to set them perminantly.
  30. 3. No, it doesn't do incoming news, or any email stuff.
  31.    PostScan does outgoing emails though, so get that as well!
  32.  
  33. Using NewsScan:
  34. ~~~~~~~~~~~~~~~
  35. Once loaded NewsScan will immediately scan for mail in Voyager's outgoing news
  36. box (if found), and a window will pop open to display what has been located.
  37. For a healthy message there will be a line looking something like this:
  38.  _______________________________________________________________________
  39. |           Subject:                |      Groups:    |  Date:  | Size: |
  40. |-----------------------------------+-----------------+---------+-------|
  41. | Mars pictures at www.argonet.co.uk/ A.A.Assist       17-07-97     750 |
  42.  
  43. Note that the Groups section has bits missing from the address - this is
  44. supposed to happen!  So that I can get as much information on screen as
  45. I can various abbreviations can be used.  IF you don't like this, press the middle mouse button, select the "Choices..." menu option and a window will
  46. appear which allows you to change the amount of abbreviation that takes place.
  47.  
  48. You can then select a posting from the list by clicking once with the left mouse
  49. button on any part of the display for that message, and de-select it either by
  50. selecting another posting or by clicking on it with the right mouse button.
  51. Double-clicking with the left mouse button will load that message into your
  52. favourite text editor so that you can re-edit it before it gets sent.
  53.  
  54. If you select a message then you can do various things to it using the buttons
  55. on the bar above the list of messages.
  56.  
  57. AutoScan:  With this ticked, NewsScan will look for changed every 2 seconds and
  58. update accordingly.  IF you don't like this, untick it and use the "Update"
  59. button to change the listing manually.
  60.  
  61. The "writing hand" icon will load the currently selected message into your text
  62. editor. This should work for !Edit, !StrongED and !Zap, even if they're not
  63. loaded at the time.  However, if the file is not settyped properly to &FFF (a
  64. plain text file) it won't work - see the section on the Info Window for more
  65. detailed information.
  66.  
  67. The big blue and white "i" button opens up the info window - this gives more
  68. detailed information on the selected email, and allows you to do some more
  69. advanced operations on it.
  70.  
  71. The next icon, which looks like a bin, will delete the selected message.
  72. If the file cannot be removed from the OutGoing directory then no error
  73. will pop up, but the message will still be listed in the main window.
  74. This might be because it wasn't created correctly and is still "open", so
  75. reset your machine and try again.
  76.  
  77. The "post box" will kick the news sender into life IF YOU ARE ONLINE.
  78. Don't do this is news is already sending, or you will send two copies of
  79. everything!
  80.  
  81. The next icon looks like a directory, and opens up the outgoing news
  82. directory for you to examine. 
  83.  
  84. The icon that looks like a magnifying glass will re-scan the outgoing mail
  85. directory.  Handy if you've made some changes and want to update the list.
  86.  
  87. At the right hand side of the tool bar are three icons which control which part
  88. of the news list you're looking at; the main window will only display ten
  89. messages at a time, so you use the "PREV" and "NEXT" buttons to flip between
  90. pages.  The icon in the middle displays which messages are currently being
  91. displayed, and how many there are in total.
  92.  
  93. The Info Window:
  94. ~~~~~~~~~~~~~~~~
  95. This shows a lot more information on the currently selected message, and allows
  96. you to do a few more things with it.
  97.  
  98. From the top, you should get a display which tells you:
  99. * the name of the file containing your message (usually something like 
  100.   "!Voyager....26000298").  At the bottom of the window there's a "View message"
  101.   button, click on this to load it into your text editor.
  102. * the date the message was "sent" (i.e. when you clicked on the "Post" icon in
  103.   the news program)
  104. * The filetype - news postings should be type &FFF, which is the serial number
  105.   given to plain text files.  If not, you can use the "Set filetype" button to
  106.   make it appear as a text file.
  107.  
  108. * the subject you've entered for that message
  109. * which group(s) the message is being sent to, abbreviated (or not, depending
  110.   on your options) as in the main listing.
  111. * the "Followup" section shows where replies are supposed to be sent; if this
  112.   says "Not set" then replies to your message will go to the same group(s) you 
  113.   are sending to, but you can, for instance, send something to
  114.   "argonet.acorn.binaries" and then set he followup so anyone replying to your
  115.   message will be posting to "argonet.acorn.misc" (in fact, postings to
  116.   a.a.binaries /must/ have the followup set to another group!)
  117.  
  118. If this window shows that the file has information missing then the news posting
  119. is probably corrupted.  You should try editing or deleting this file before next
  120. logging on.
  121.  
  122. Underneath the information are a number of buttons:
  123. * View message - load the message into your text editor
  124. * Set filetype - make the selected email appear as a text file, although if
  125.   it's not already then there could be trouble...
  126. * Delete whole message - same as the other delete button, it deletes the news
  127.   posting.
  128. * Cancel - just closes the info window.  It's bigger than that titchy close icon
  129.   though! :)
  130.  
  131. History:
  132. ~~~~~~~~
  133. 1.00 (17 Jul 97) - first release version.
  134.                    With thanks to Vince Hudd (SoftRock) for his code fragments!
  135. Note: this program is, by popular demand, based on version 1.04 of PostScan,
  136. which does the same job but for email postings.
  137.  
  138. Contacting me:
  139. ~~~~~~~~~~~~~~
  140. I've tried to make this program as bomb-proof as possible - it'll even work
  141. with directories and ArtWorks files dumped in the outgoing directory! - but of
  142. course no program is infallible.  You can contact me at the address below.
  143.  
  144. This program is unsupported (i.e. don't go ringing Argo technical if it goes
  145. wrong!), but if you have any suggestions, observations or bug reports you can
  146. email me at:
  147.  
  148. rich.goodwin@argonet.co.uk
  149.  
  150. Richard Goodwin.