home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / p / pop / !POP / !Help < prev    next >
Text File  |  1995-12-03  |  17KB  |  471 lines
  1. !POP Version 0.97
  2. ====
  3.  
  4. !POP is a POP3 mail transport for use with Freenet/Acorn TCP/IP.  It will
  5. fetch EMAIL from one or more POP mailboxes and can also send outgoing
  6. EMAIL (using SMTP).
  7.  
  8. POP is only a transport - unless you are a massochist you will also need
  9. some mail management/reading software.  Newsbase and TTFN are recommended.
  10. !POP stores its mailboxes in standard formats, so other packages may work.
  11.  
  12. Contents
  13. ========
  14. Terms & Conditions
  15. Credits
  16. Features
  17. Requirements
  18. Installation
  19. Configuring from within Newsbase
  20. Use with ANT Internet Suite
  21. POP Users & Mailboxes
  22. POP Settings
  23. In Use - Checking Mail
  24. Sending Mail
  25. BIG DISCLAIMER ON PASSWORD SECURITY!  <<<<<<< READ
  26. Trouble with the TOP command
  27. What are POP and SMTP?
  28. External Interface
  29.  
  30. Terms & Conditions
  31. ==================
  32.  
  33. (c) Daniel Pead, 1995
  34.  
  35. !POP may be used and copied freely under the following conditions:
  36.  
  37. 1. It is supplied with this copyright notice intact.
  38. 2. No charge may made for supplying it. It may NOT, for example, be
  39. distributed on magazine cover discs, PD library discs or bundled with a
  40. commercial product without explicit permission from me.  It may not be
  41. placed on bulletin boards or internet archives which charge a subscription
  42. or use premium rate telephone numbers.
  43. 3. Anybody using this software must accept that it is supplied, free-of-
  44. charge, with no warranty for reliability, accuracy or fitness-for-
  45. purpose.  It is the user's responsibility to satisfy themselves that this
  46. software is sufficiently reliable for their intended purposes. (There -
  47. some firms make you PAY for a waiver like that!)
  48.  
  49. Contact
  50. =======
  51.  
  52. Daniel.Pead@Nottingham.ac.uk
  53.  
  54. This software is NOT a product of the University of Nottingham and is not
  55. supported or endorsed by the University.
  56.  
  57. Credits
  58. =======
  59.  
  60. Andy Mell - for !NetLib
  61. Graham Allan - for Newsbase; the "Sendmail" code and testing.
  62. Stuart Brodie - for socket libraries used in early development
  63. Tom Hughes - for Freenet
  64.  
  65. ... and everybody else who helped out with testing.
  66.  
  67. Features
  68. ========
  69.  
  70. * Almost everything is set up from dialogue boxes
  71. * Can check mail for multiple users & hosts
  72. * Mail can be left on the server (useful for checking
  73.   'work' email from home)
  74. * Messages over a certain length can be trapped and skipped or just the
  75.   message
  76.   header downloaded.  The full message can be fetched or deleted later.
  77. * Runs largely in 'background' mode and doesn't lock up your machine
  78.   while waiting for the server to respond.
  79. * Includes links to Newsbase.
  80.  
  81. Requirements
  82. ============
  83.  
  84. * RISC-OS 3.1 or later
  85. * 4MB RAM and a hard disc (the minimum for using internet, really)
  86. * Acorn TCP/IP or Freenet (NOT !TCPIP/KA9Q)
  87. * Newsbase (V0.54 or later) and !TTFN. See the note below for use with
  88.   Newsbase 0.55.
  89.  
  90. If you are using Acorn TCP/IP then it is a good idea to also install the
  91. 'InetDB' part of Freenet, which handles address lookups.  Otherwise you
  92. must add the internet address of your mail server(s) to !Internet.files.
  93. hosts.
  94.  
  95. Installation
  96. ============
  97.  
  98. Summary:
  99.  
  100. 1. Install Freenet or Acorn !Internet. (Non trivial! Here's one I prepared
  101. earlier...)
  102.  
  103. 2. Copy !POP, !Newsbase, !TTFN etc. to your hard disc.
  104.  
  105. 3. Copy the POP transport definitions into Newsbase - the program
  106. "NBInstall" in the POP distribution will do this for you.  ** Use
  107. NB055Inst if you have Newsbase 0.55 **
  108.  
  109. 4. Either re-start the computer or run the !Boot files within !POP and
  110. !Newsbase so that they can find one another...
  111.  
  112. 5. Configure Newsbase first - Newsbase has extensive on-line help.
  113.  
  114. 6. Run !POP and review the contents of the "Settings" dialogue box. !POP
  115. should have got sensible defaults for most of this from Newsbase.
  116.  
  117. 7. Bring up !POPs "Users" dialogue and add the details of the POP
  118. mailboxes you wish to check. Again - if you added users when you set up
  119. Newsbase this should already be mostly done.
  120.  
  121. 8. Hook up to Internet and choose 'Check Mail' from the !POP menu...
  122.  
  123. Configuring from within Newsbase
  124. ================================
  125.  
  126. !POP has its own setup dialogues, but it can obtain some of its settings
  127. automatically from Newsbase's system variables, so you'll save time if you
  128. set up Newsbase before running !POP.
  129.  
  130. 1. Site settings:
  131.  
  132.    Host/domain: !POP doesn't use these  - best set up manually.
  133.  
  134.    Mailname: The name of your POP server (usually the part of your
  135.              EMAIL address following the '@')
  136.    Remote:   The name of your SMTP gateway machine (often the same
  137.              as above.
  138.  
  139.    If this is incompatible with other transports then leave these as is and
  140.    override the defaults from within !POP.
  141.  
  142. 2. Users
  143.  
  144. !POP maintains its own list of usernames, passwords and POP servers. If
  145. you add or delete users from within Newsbase they will also be added or
  146. deleted from !POP's list. You can't set POP passwords or specify POP
  147. servers other than the one supplied in 'Mailname' above from Newsbase,
  148. though.
  149.  
  150. 3. Transports:
  151.  
  152. *   If you want to send outgoing mail via !POP's SMTP transport then set
  153.     the 'Default mail transport' to 'POP'.
  154.  
  155. *   Select "Transport properties for -> POP" and turn on "Check for
  156.     Arrivals".
  157.  
  158. *   Click on 'Setup' - this should start !POP and bring up the POP settings
  159.     dialogue box.  Or you could just double-click on !POP if you like...
  160.     Unless you have a complex set-up you can probably take the defaults
  161.     here and go on to check the User & Mailbox list.
  162.  
  163. Use with ANT Internet Suite
  164. ===========================
  165.  
  166. If you have the ANT Internet Suite then you can use !POP to fetch the mail
  167. instead of ANT's POP fetcher, gaining the ability to screen out
  168. large/previously read messages and check your mail at regular intervals.  The
  169. mailbox files created by !POP are compatible with Marcel.
  170.  
  171. Currently, !POP won't handle outgoing mail from Marcel - this can be sent as
  172. normal by choosing "Transfer -> Mail Only" from the ANT Internet menu.
  173.  
  174. Set !POPs incoming mail file name (in the settings dialogue) to:
  175.  
  176.     Inet:Spool.mail.default
  177.  
  178. Remove the "GET" line from !InetSuite.Internet.files.!Inetmail so that the ANT
  179. suite won't try to fetch your mail itself.
  180.  
  181. POP Users & Mailboxes 
  182. =====================
  183.  
  184. Choose "Users..." from the !POP iconbar menu.
  185.  
  186. !POP can check a list of mailboxes on several different machines.  Given
  187. that, this dialogue should be pretty obvious...
  188.  
  189. If you are using Newsbase then you should add new users to Newsbase
  190. *first* (this will also add them to !POP) then bring up the !POP dialogue
  191. to fill in missing details.
  192.  
  193. User:
  194.     The username (e.g. "fbloggs" if address is "fbloggs@wibble.co.uk")
  195.  
  196. Host:
  197.     The hostname (e.g. "wibble.co.uk")
  198.  
  199. Password:
  200.     The password for this mailbox.  If you leave this blank then !POP will
  201.     prompt for it when you next 'check mail'. 
  202.  
  203. Keep Password:
  204.     If this is selected, !POP will remember the password for this user
  205.     between checks.  The password is also stored on disc if you click 'Save'.
  206.     See the note on "Security" later.
  207.  
  208. Leave Mail on Server:
  209.     If this is selected, then mail messages will NOT be deleted from the
  210.     POP server after downloading. Useful if you don't quite trust POP or if
  211.     you are reading mail from several different machines.  On servers compatible
  212.     with "Berkeley popper" !POP can recognise old messages and won't download
  213.     them time after time (see "Skip... Previously read" below).
  214.     
  215. Save:
  216.     Saves the settings to disc.
  217.  
  218. Cancel:
  219.     *Only* cancels changes to the currently displayed user.  Any previous
  220.     changes are permanent.
  221.  
  222. NOTE:
  223.     If you add or modify users from within Newsbase, the !Pop.Users file on
  224.     disc is modified. !POP re-loads this if it notices that it has been
  225.     updated - this may cancel any changes which have been made in !POP
  226. since
  227.     the file was last saved.
  228.  
  229.  
  230. POP Settings
  231. ============
  232.  
  233. The !POP settings dialogue box will appear the first time you run !POP.
  234. You can also get this by choosing "Settings" from the !POP iconbar menu or
  235. hitting 'Setup' from the Newsbase transports control.
  236.  
  237. Skip messages:
  238.  
  239.     This allows you to avoid downloading huge files or messages that have
  240.     already been read. For large messages, !POP will get just the header so
  241.     that you can check the sender and subject before downloading the whole
  242.     thing