home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / pine421.zip / README.OS2 < prev    next >
Text File  |  1999-12-15  |  11KB  |  270 lines
  1. Pine 4.21 for OS/2
  2. (C) 1989-1999 The University of Washington.
  3. OS/2 Port by Nicholas Sheppard (nps@zeta.org.au)
  4.  
  5.  
  6. INTRODUCTION
  7. ============
  8.  
  9. This is my OS/2 port of Pine 4.21, based on David Nugent's 3.9x port. David
  10. is no longer maintaining Pine for OS/2, so please send all correspondence
  11. to me, as I have taken over the OS/2 port as of version 4.10 (versions 4.00-
  12. 4.05 of Pine have no OS/2 port).
  13.  
  14. I have fixed all the serious bugs discovered in the 4.10 releases (though a
  15. couple of minor ones remain -- see below), so I am hoping that this version
  16. is at least as stable as the old 3.9x port, and as any other port of Pine.
  17. Nonetheless, the usual you-get-what-you-pay-for warranty applies.
  18.  
  19. The latest information about Pine for OS/2 can be found on my web site at:
  20.  
  21.     http://www.zeta.org.au/~nps/software/pine/en/index.html
  22.  
  23. General information about Pine can be found at the University of Washington's
  24. web site at:
  25.  
  26.     http://www.washington.edu/pine
  27.  
  28. General discussion about Pine, and help for configuration problems, can be
  29. found by reading comp.mail.pine on Usenet. There is also a general group for
  30. OS/2 news and e-mail applications, comp.os.os2.mail-news.
  31.  
  32.  
  33.  
  34. INSTALLATION
  35. ============
  36.  
  37. Pine requires the EMX run-time libraries to run. You can find these on Hobbes
  38. as emxrt.zip in the directory /os2/dev/emx/v0.9d (or whatever version is
  39. current). I compiled Pine with EMX version 0.9d, without any fixes. Install
  40. these before doing anything else.
  41.  
  42. Before running Pine, you need to set up some environment variables, either by
  43. adding lines to your CONFIG.SYS or by setting them in a script that runs Pine.
  44. You need to set the environment variable "HOME" to point to the "home directory"
  45. of a user (think Unix). If "HOME" does not exist, the outcome is unpredictable.
  46. If you use Unix-format mailboxes, you may also want to set the "USER" variable
  47. to a "user name"; this is used when writing Unix-format mailboxes. If "USER" is
  48. not set, it defaults to a value of "os2user". One of "TMP" or "TEMP" must be
  49. set the name of a directory to which Pine can write temporary files.
  50.  
  51. For example,
  52.  
  53.     SET HOME=d:\home\sally
  54.     SET USER=sally
  55.     SET TMP=d:\tmp
  56.  
  57. If you aren't using Unix-format mailboxes, the "USER" variable is not used, and
  58. there's a fair chance you can get away without it even if you do (but I am not
  59. promising anything). The other two must be set, however, for Pine to work
  60. properly.
  61.  
  62. You will need to set some of Pine's configuration options before using Pine.
  63. You can do this either by editing the "pinerc" file in the HOME directory
  64. (Pine will create a new one when you run it, if it doesn't exist), or by going
  65. Setup ("S") then Config ("C") from the main menu.
  66.  
  67. The "personal-name" field should be set to the name you want to have attached
  68. to your out-going e-mails. The "user-id" and "user-domain" fields should be
  69. set, respectively, to the first (i.e. before the "@") and second parts of your
  70. e-mail address. The "smtp-server" field should be set to the name of your SMTP
  71. server -- note that OS/2 Pine cannot use sendmail to send e-mail (except, I
  72. suppose, by specifying your own machine as an SMTP server).
  73.  
  74. It appears to be a well-kept secret that Pine can read e-mail over a TCP/IP
  75. link using the POP3 protocol, which is the ubiquitous method for obtaining
  76. mail. Let it be a secret no longer! If you want to get e-mail from your POP3
  77. server, set the "inbox-path" field to something of the form
  78.  
  79.     inbox-path={mail.yourisp.net/pop3}inbox
  80.  
  81. where "mail.yourisp.net" is your POP3 server. Note the "/pop3" at the end -- if
  82. you get a message saying "Cannot connect to mail.yourisp.net,143: Connection
  83. refused" when you try to connect, you have left this off.
  84.  
  85. Alternatively, you can get your mail via the IMAP protocal over a TCP/IP link,
  86. in which case you should set the "inbox-path" field to something of the form
  87.  
  88.     inbox-path={mail.yourisp.net}inbox
  89.  
  90. that is, the same as for POP3 but without the "/pop3" on the end. Finally, you
  91. can also get your mail from a file by specifying the name of the file in the
  92. "inbox-path" field. The file can be in any mailbox format recognised by OS/2
  93. Pine (see below). Note that Pine assumes that all mailboxes have the extension
  94. specified by the "folder-extension" field, which defaults to ".mtx" if nothing
  95. is entered here, and this includes the INBOX. If your mail comes from a Unix
  96. system, for example, you will need to set "folder-extension" to be "" (this is
  97. NOT the same as having it unset), or organise for a link "USER.mtx" to be made,
  98. or something.
  99.  
  100. Putting that all together, for example, we might have
  101.  
  102.     personal-name=Sally J. Pineuser
  103.     user-id=sally
  104.     user-domain=theisp.net.au
  105.     smtp-server=smtp.theisp.net.au
  106.  
  107. Of course, you may want to set any number of other options while you're at it.
  108. Pine has extensive on-line help for all of the options (press "?" on the
  109. configuration screen when the cursor is on the appropriate field) which should
  110. get you through this process.
  111.  
  112.  
  113. USING PINE TO READ USENET
  114. =========================
  115.  
  116. Pine can read Usenet groups by setting the "nntp-server" field to the name of
  117. your NNTP (news) server, for example,
  118.  
  119.     nntp-server=news.theisp.net.au
  120.  
  121. You can then access your newsgroups through the Folders ("L") screen on the
  122. main menu in much the same way mail folders are accessed.
  123.  
  124. Be warned that news access can be extremely slow over a modem link (or any
  125. oher low-bandwidth link), especially when subscribing to new groups. It is
  126. almost certainly worth enabling the "news-post-without-validation" option.
  127.  
  128. On my system, under both OS/2 and Linux, Pine displays a lot of deleted
  129. messages with no body; I am not sure if this is a bug in Pine, in my ISP's
  130. news server, or just odd behaviour. In any case, the most common statement
  131. by those in the know about Pine's newsreader on comp.mail.pine is "Use slrn".
  132.  
  133.  
  134. FOLDER FORMATS
  135. ==============
  136.  
  137. The code for reading local folders is copied directly from the NT port. I have
  138. tested the MTX and Unix formats, and Pine, by default, uses the MTX format.
  139. The MBX and Tenex formats, while (theoretically) supported by OS/2 Pine, have
  140. only been tested under Windows NT and I cannot guarantee that they work properly
  141. under OS/2.
  142.  
  143.  
  144. DIFFERENCES BETWEEN OS/2 AND OTHER PORTS OF PINE
  145. ================================================
  146.  
  147.   * Colour
  148.  
  149.     To use colour with OS/2, set the colour option to "use-termdefs". OS/2 Pine
  150.     does not really "use termdefs" (i.e. the termcap or ncurses library); this
  151.     option actually uses the OS/2 VIO API. The result of using the force-ansi
  152.     options is unpredictable.
  153.  
  154.   * Sendmail
  155.  
  156.     OS/2 Pine cannot send mail using a local version of sendmail (or suchlike),
  157.     except, possibly, by using the local machine as SMTP server.
  158.  
  159.   * FAT drives
  160.  
  161.     Alas, these things are still haunting us. While FAT-compliant file names
  162.     are used in the OS/2 port whenever Pine generates a file name, there is at
  163.     least one place (Unix-format folders) where using long file names is
  164.     unavoidable. I have created compile-time options (FATKLUDGE) which, if
  165.     used, will cause OS/2 Pine to force 8.3 file names at the expense of
  166.     compatability with Unix and NT versions of Pine. By default, this option is
  167.     turned off.
  168.  
  169.   * Password file
  170.  
  171.     The PASSFILE compile-time option is turned on by default for OS/2 Pine.
  172.  
  173.   * Mail servers
  174.  
  175.     The imapd and ipopd daemons distributed with Unix Pine have not been ported
  176.     to OS/2.
  177.     
  178.  
  179.  
  180. USEFUL HINTS
  181. ============
  182.  
  183. Some people are irritated by being constantly asked for passwords. You can save
  184. passwords by creating a file "PINE.PWD" (use "touch", if you have it; otherwise
  185. open it in an editor and save it without typing anything in) in the same
  186. directory as "pinerc". If this file exists, Pine will ask you if you want to
  187. save your password in this file. If you do, Pine will get the password from the
  188. file forevermore. Though the password is encrypted (albeit not very strongly,
  189. according to the documentation), USE OF THIS FEATURE HAS SERIOUS SECURITY
  190. IMPLICATIONS. At best, it gives anyone with access to your machine free access
  191. to your e-mail. At worst, it allows them to gain your password. USE IT WITH
  192. EXTREME CAUTION.
  193.  
  194.  
  195. You can use a configuration file other than "pinerc" by invoking Pine with the
  196. -p option, e.g. if you have multiple e-mail accounts or multiple people using
  197. the same copy of Pine, for example,
  198.  
  199.     pine -p sally\pinerc
  200.     pine -p bruce\pinerc
  201.  
  202. if "Sally" and "Bruce" are both using Pine on the same computer to access their
  203. e-mail accounts. Each has a configuration files in their own directories below
  204. the main Pine directory. If you have multiple accounts for a single person, you
  205. may prefer to use the "incoming-folders" field in pinerc for this purpose.
  206.  
  207.  
  208. Note that some configuration fields, e.g. "incoming-folders", are only
  209. available in the pinerc file and not through Pine's configuration screen. I'm
  210. not sure what the story is with this -- it may be a bug -- but be aware of it,
  211. and if you are a fussy configurer it is worth looking through pinerc for things
  212. you didn't see on the configuration screen.
  213.  
  214.  
  215. When specifying application names, e.g. in the "url-viewers" field, you need to
  216. specify the full path name of the application, for example,
  217.  
  218.     url-viewers=d:\tcpip\bin\explore.exe
  219.  
  220. and not
  221.  
  222.     url-viewers=explore
  223.  
  224. as Pine does not search the path when looking for them.
  225.  
  226.  
  227.  
  228. OS/2-SPECIFIC CHANGES FROM PINE 4.10 BETA 3
  229. ===========================================
  230.  
  231.  * The PINEHOME and PINEUSER environment variables are no longer used
  232.    (use HOME and USER, as Unix).
  233.  
  234.  * Support for Tenex and MBX mailbox formats have been added, but has not
  235.    been tested. The code is copied unchanged from the NT version (where
  236.    it *has* been tested).
  237.  
  238.  * URL-highlighting did not work if the character set was set to anything
  239.    other than US-ASCII.
  240.  
  241.  * Display of some non-ASCII characters did not work. You may need to set
  242.    the "pass-control-characters-as-is" option to get some non-ASCII
  243.    characters to display (not my fault, so far as I can tell); Pine seems
  244.    to think they are control characters.
  245.  
  246.  * Some additions and minor changes to the installation instructions.
  247.  
  248. Changes from older versions of Pine not specific to OS/2 can be found at
  249.  
  250.     http://www.washington.edu/pine/changes
  251.  
  252.  
  253. BUGS
  254. ====
  255.  
  256. If you find any bugs specific to the OS/2 version, please send them to me
  257. (nps@zeta.org.au) so that I can correct them. Please check my web site
  258. first for known bugs (and, where known, work-arounds). Bugs not specific to
  259. the OS/2 version can be reported to the original programmers at
  260. pine-bugs@washington.edu.
  261.  
  262. The known OS/2 bugs in 4.21, at the time of release, are:
  263.  
  264.  * "Command "B" not defined" messages appear occasionally when Pine is left
  265.     idle; this is harmless, so far as I know.
  266.  
  267.  * When inserting a file into the Pine composer (the ^R command), the file
  268.    is taken from the current directory rather than the home directory. The
  269.    similar bug in Pico seems to be common to all ports.
  270.