home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / internet / groups / !Groups / !Help < prev    next >
Text File  |  1995-07-13  |  9KB  |  275 lines
  1.                        ---------------------------
  2.                        |  Help file for !Groups  |
  3.                        |  A newsgroups selector  |
  4.                        |                         |
  5.                        |   © David Croft, 1995   |
  6.                        ---------------------------
  7.  
  8.  
  9. This document is divided into 11 sections:
  10.  
  11. 1.  Copyright notice
  12. 2.  Requirements
  13. 3.  Installing Groups
  14. 4.  The main window
  15. 5.  Adding/removing groups
  16. 6.  Searching
  17. 7.  New groups
  18. 8.  Wish-list
  19. 9.  Release history
  20. 10. Acknowledgements
  21. 11. Contact addresses
  22.  
  23. Groups also supports interactive help. Click SELECT on the icon in the bottom
  24. right of the main window and move the pointer around to receive further help.
  25.  
  26.  
  27. 1. Copyright notice
  28. -------------------
  29.  
  30. The !Groups application and most of its contents are Copyright 1995 by David
  31. Croft, whose address may be found at the bottom of this document. The parts
  32. that are not are:
  33.  
  34.  * The Dynamite module, which is © 1994 Straylight
  35.  * The "sort" utility which is © Andy Armstrong
  36.  
  37. You may copy this program freely, so long as:
  38.  
  39.  * You do not charge for it in any way.
  40.  * You distribute it intact, with all original files present and unmodified.
  41.    (this means you must delete your "Config" file before redistribution)
  42.  * You understand that the copyright remains with the author.
  43.  
  44. This program comes with no guarantee, implied or stated. No responsibility
  45. can be accepted by the author for any kind of loss.
  46.  
  47. Permission is granted to Dr. Alan Hassey to include this software in his
  48. Internet Starter Pack.
  49.  
  50.  
  51. 2. Requirements
  52. ---------------
  53.  
  54. Operating System:
  55.  * RISC OS 3.10 or greater
  56.  
  57. Software:
  58.  * Newsbase version 0.54 or greater
  59.  * A transport system (e.g. ka9q or uucp)
  60.  
  61. The latest version of Newsbase can be found in:
  62.   ftp://ftp.demon.co.uk/pub/archimedes/developers/
  63.  
  64.  
  65. 3. Installing !Groups
  66. ---------------------
  67.  
  68. There are currently two ways of running !Groups:
  69.  
  70. (i)  Double click on it directly.
  71. (ii) Use the "New groups..." option in Newsbase.
  72.  
  73. If you are not likely to use method (i) then you should install !Groups inside
  74. the directory !Newsbase.AutoBoot. This will still boot it so that other
  75. programs can run it, but will hide the actual application from view.
  76.  
  77. Groups needs Newsbase to be present before it can begin, and you will be
  78. prompted for it if it is not loaded. Otherwise the main window will appear.
  79. Section 4 details this window.
  80.  
  81. If you have a file containing a full newsgroups listing, you should now tell
  82. Groups about it. Click MENU over the window, and choose "Configure". Drag
  83. the file to this new window and then click on Save.
  84.  
  85. If you are a Demon subscriber, this file can be found as:
  86.   ftp://ftp.demon.co.uk/pub/news/active.dis
  87. or the compressed (zip) version:
  88.   ftp://ftp.demon.co.uk/pub/news/active.zip
  89. which you must unzip before giving it to Groups.
  90.  
  91. If you use Acorn TCP/IP or FreeNet, Groups can grab the list directly from
  92. your news server. To do this, click MENU over the main window, and use the
  93. "Newsgroups list" option. This will open a taskwindow which can grab the list
  94. for you. (** NOTE ** This facility is not implemented in version 0.14)
  95.  
  96. Finally, you should configure the Newsbase "new groups expiry" time to
  97. be longer than the regularity of your new group checks. I would suggest
  98. two or three weeks as a sensible value.
  99.  
  100.  
  101. 4. The main window
  102. ------------------
  103.  
  104. This window contains two subwindows: a source window (on the left) and a
  105. feed window (on the right).
  106.  
  107. The source window shows you the contents of the various source lists. Click
  108. SELECT over the menu icon at the top of the window to choose a different list.
  109.  
  110. "Newsgroups file" shows you the contents of your full newsgroups file, if
  111. you have one. "New groups" shows you new groups created since you last
  112. clicked on "Catch Up". "Search results", when available, shows you the
  113. results of your last search.
  114.  
  115. If you have a suitable WWW browser loaded (e.g. ArcWeb version 0.28 or
  116. greater), you can double-click on a group name to read that group.
  117.  
  118. The feed window on the right hand side shows you the groups you are currently
  119. receiving.
  120.  
  121.  
  122. 5. Adding/removing groups
  123. -------------------------
  124.  
  125. To add a group to your feed, drag it from the source window into the feed
  126. window. It will then be automatically added to your feed.
  127.  
  128. If you drag a group to another application it will be inserted into the text.
  129.  
  130. If you drag to a filer window, a file called "Newsgroup" will be created
  131. containing the name of the group.
  132.  
  133. In both instances, hold down CTRL to insert the group in URL format
  134. (news://group/). (this modifier will be abolished soon)
  135.  
  136. To remove a group from your feed, click on it with ADJUST.
  137.  
  138.  
  139. 6. Searching
  140. ------------
  141.  
  142. There are two methods of searching.
  143.  
  144. a) Start-of-name searching
  145.  
  146. You must be viewing the main list to use this method. Click MENU over the
  147. main window and choose "Find a group", and a small !Zap-style search window
  148. will appear. Type in the first few letters of the group's name, and the window
  149. will scroll to find the group. It will keep searching for your group name as
  150. you type, so you will get closer and closer to it as you type more.
  151.  
  152. There is a little box on the far right of this window which shows a tick if
  153. it has found a match, and a cross if it hasn't. If there is a tick in this
  154. window, you can press RETURN to add the last group found. Press ESCAPE to
  155. close this window when you have finished with it.
  156.  
  157. While this window is open, you can use the following keys to navigate the
  158. main list:
  159.  
  160.   ⇧ / ⇩     Scroll up and down the list by one group
  161.  ^⇧ / ^⇩    Move to top or bottom of the list
  162. PgUp/PgDn   Move up and down by one page.
  163.  
  164. b) Wildcard searching
  165.  
  166. You can use wildcard searching while viewing any source, but note that it will
  167. only search the main list. Click MENU over the main window and go to the
  168. submenu "Wildcard search". Type in the the search string, including wildcards
  169. where necessary, and then press RETURN. The search will then commence.
  170.  
  171. Note that the search is not case-sensitive. If you are looking for a word as
  172. a part of a group name, then search for that group surrounded by wildcards.
  173. See examples below.
  174.  
  175. When the search is complete, the source window will change to display the
  176. results of your search.
  177.  
  178. Examples:
  179.  
  180. demon.*   to search for all Demon newsgroups.
  181. *music*   for all groups with "music" in their name.
  182. *.test    to list all the test newsgroups.
  183.  
  184. If you want to display the contents of the big-8 hierarchies (alt, comp, etc.)
  185. then there is a submenu off the main menu to do this for you.
  186.  
  187.  
  188. 7. New groups
  189. -------------
  190.  
  191. When you have selected the "New groups" source, Groups will display all
  192. the new groups created since you last used the button "Catch up".
  193.  
  194. The "Catch up" button will place a marker at the current date and time so
  195. that next time you select "New groups" you will only be given the most
  196. recent new groups.
  197.  
  198. If you wish to change this time to anything else, you may do so in the
  199. Configure window. Note that the date and time are in the NNTP format of
  200. "yymmdd" and "hhmmss", as mentioned in this window.
  201.  
  202. Click on "Beginning" to list all new newsgroups on record.
  203.  
  204.  
  205. There is an option (in the configure window) to automatically merge the new
  206. groups listing into the main list when you catch up. The procedure followed
  207. is as below:
  208.  
  209. i)   Copy the main list into the scrap directory in case something goes wrong
  210. ii)  Add the new groups to the bottom of the main list
  211. iii) Run the file "PostMerge" inside !Groups, which will normally run a
  212.      suitable re-sorting program.
  213. iv)  Move the new list back into the original list's position.
  214.  
  215. Since version 0.11, Groups will work out whether the re-sorting was
  216. successful and, if not, move the original file back into position. If for
  217. some reason this does not happen, you should be able to find a backup inside
  218. !Scrap.
  219.  
  220.  
  221. 8. Wish-list
  222. ------------
  223.  
  224. Soon:
  225.  
  226.  * Put feed groups in dynamite block. (I suspect this will push the WimpSlot
  227.    of the crunched version down further to 32k!)
  228.  
  229. Later:
  230.  
  231.  * A decent icon.
  232.  * Grabbing newsgroups list from NNTP server using a TCP/IP protocol stack.
  233.  * "Add all" option on search results window
  234.  * Selection of multiple groups in either window.
  235.  
  236.  
  237. 9. Release hist