home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / pine396.zip / README < prev   
Text File  |  1998-01-21  |  5KB  |  110 lines
  1.  
  2. *** This file is provided with no support, if you encounter
  3. *** an error please report it to eyerewl@qed.net but I make no 
  4. *** claims to acually fix the reported error.
  5.  
  6. -------------------------------------------------------------
  7. This is Pine for OS/2, a text mode IMAP-capable mail and news
  8. client for 32-bit OS/2, including OS/2 version 2.0 and later.
  9. -------------------------------------------------------------
  10.  
  11. Included: Pine.exe (Standard Window/Fullscreen client)
  12.           Pinefs.exe (Fullscreen ONLY exe)
  13.           Pico.exe (Standard Windows/Fullscreen editor)
  14.  
  15. This version of Pine is a network client, and requires you to
  16. have IBM TCP/IP 2.0 or later installed. The OS/2 Warp IAK is
  17. sufficient to run this program across either a SLIP or PPP
  18. link.
  19.  
  20. Note on mailboxes: The default mailbox type uses the IMAP
  21. v2bis protocol. To use IMAP, you will need to be connecting
  22. to a mail server with an IMAP server that supports IMAP
  23. version 2 or later. Pine may also be used with POP v2 or v3
  24. servers, but is not as functional by a large margin.
  25.  
  26.   ===========================================================
  27.   POP3 NOTE: Some problems have been reported with the POP3
  28.   support in previous versions of the Pine OS/2 port.
  29.   However, these seem to be configuration related and only
  30.   occur with some systems - the porter has been as yet unable
  31.   to either reproduce the problem or track down its source.
  32.   If you can convince your service provider to run an imap
  33.   server rather than having to rely entirely on the somewhat
  34.   archaic pop3 protocol, then do so TODAY. Using Pine over
  35.   IMAP is a far better solution to any existing alternatives,
  36.   and has many MANY useful features above and beyond that
  37.   pop3 can provide.
  38.   ===========================================================
  39.  
  40. To define an IMAP mailbox, you enter the following:
  41.  
  42. {your.mail.server.fdqn}INBOX          for your standard mailbox
  43. {your.mail.server.fdqn}path/folder    for other mail folders
  44.  
  45. [FDQN means "fully qualified domain name", meaning the full
  46.  hostname of your provider, including the domain portion]
  47.  
  48. To define a POP3 style mailbox, you enter:
  49.  
  50. {your.mail.server.fdqn/pop3}INBOX
  51.  
  52. Note that POP only supports one mailbox on your server - that
  53. is the standard mailbox for incoming mail. With IMAP, you can
  54. access other folders on that mailbox, and mailboxes on other
  55. servers as well, all in the same session. If you have IMAP
  56. available, you can also use your provider's system for storage
  57. of folders, and definition of multiple incoming folders (enable
  58. the configuration option if you wish to do this), and use
  59. procmail or some other mail filtering system on your provider's
  60. machine to automatically move incoming mail into the correct
  61. folder.
  62.  
  63. This version of Pine uses smtp delivery only, and is not
  64. suitable for an OS/2 system set up as a mail server. That
  65. would require a great many changes to the c-client system
  66. (for OS/2, at least). Before you can send mail you MUST have
  67. a valid smtp-server entry in your PINERC. Use S)etup C)config
  68. to enter or modify your current smtp server. When running
  69. Pine for the first time on your machine, it will request these
  70. sorts of details, but many people do not enter them correctly
  71. and may have to correct these before pine will become functional.
  72.  
  73. Local mail folders created and maintained by PineOS2 are in
  74. "dawz" format, which is identical to the format used by the
  75. MSDOS and Windows builds of Pine (this is NOT the same format
  76. that most UNIX systems use, and you should not attempt to edit
  77. or modify these files in any way except via Pine). This version 
  78. of Pine is also able to read "Berkeley" style mail folders, but 
  79. only in read-only mode. Since you can copy between folders using
  80. the S)ave command from the mail folder index, you can move mail
  81. freely from Berkeley format mail folders to dawz, but not the
  82. reverse.
  83.  
  84. If you wish to log in automatically to your server without
  85. having to specify a login name or password each time, create
  86. an empty file called "PINE.PWD" in the same directory where
  87. Pine creates its PINERC configuration file. Something similar
  88. to the following will do that:
  89.  
  90.         echo off >PINE.PWD
  91.  
  92. Before running Pine, set either the HOME environment variable
  93. or the PINEHOME variable (if you have other software that
  94. uses HOME but wish to place Pine elsewhere) in your
  95. CONFIG.SYS - and remember to reboot.
  96.  
  97. Files in the "bin" subdirectory should be placed somewhere in
  98. your PATH. Files in the "dll" subdirectory should be placed
  99. in a directory that is specified in your LIBPATH setting in
  100. CONFIG.SYS. Files under the "emx" subdirectory should also 
  101. be placed into a directory in your LIBPATH, but check first 
  102. to ensure that there are no other files of the same name on 
  103. your system. These files come from the EMX runtime version 
  104. 0.9b, and you will need these or the equivalent later versions 
  105. to run Pine without problems.
  106.  
  107.                       -----
  108.  
  109.  
  110.