home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / pine430.zip / README.OS2 < prev    next >
Text File  |  2000-11-04  |  11KB  |  260 lines
  1. Pine 4.30 for OS/2
  2. (C) 1989-2000 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.30, 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 bugs discovered in the 4.10 and 4.21 releases, so I am
  15. hoping that this version is at least as stable as the old 3.9x port, and as
  16. any other port of Pine. Nonetheless, the usual you-get-what-you-pay-for
  17. 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. I follow both of
  31. these newsgroups.
  32.  
  33.  
  34.  
  35. INSTALLATION
  36. ============
  37.  
  38. Pine requires the EMX run-time libraries to run. You can find these on Hobbes
  39. as emxrt.zip in the directory /os2/dev/emx/v0.9d (or whatever version is
  40. current). I compiled Pine with EMX version 0.9d, with fix 03. Install these
  41. before doing anything else.
  42.  
  43. Before running Pine, you need to set up some environment variables, either by
  44. adding lines to your CONFIG.SYS or by setting them in a script that runs Pine.
  45. You need to set the environment variable "HOME" to point to the "home directory"
  46. of a user (think Unix). If "HOME" does not exist, the outcome is unpredictable.
  47. If you use Unix-format mailboxes, you may also want to set the "USER" variable
  48. to a "user name"; this is used when writing Unix-format mailboxes. If "USER" is
  49. not set, it defaults to a value of "os2user". One of "TMP" or "TEMP" must be
  50. set the name of a directory to which Pine can write temporary files.
  51.  
  52. For example,
  53.  
  54.     SET HOME=d:\home\sally
  55.     SET USER=sally
  56.     SET TMP=d:\tmp
  57.  
  58. If you aren't using Unix-format mailboxes, the "USER" variable is not used, and
  59. there's a fair chance you can get away without it even if you do (but I am not
  60. promising anything). The other two must be set, however, for Pine to work
  61. properly.
  62.  
  63. You will need to set some of Pine's configuration options before using Pine.
  64. You can do this either by editing the "pinerc" file in the HOME directory
  65. (Pine will create a new one when you run it, if it doesn't exist), or by going
  66. Setup ("S") then Config ("C") from the main menu.
  67.  
  68. The "personal-name" field should be set to the name you want to have attached
  69. to your out-going e-mails. The "user-id" and "user-domain" fields should be
  70. set, respectively, to the first (i.e. before the "@") and second parts of your
  71. e-mail address. The "smtp-server" field should be set to the name of your SMTP
  72. server -- note that OS/2 Pine cannot use sendmail to send e-mail (except, I
  73. suppose, by specifying your own machine as an SMTP server).
  74.  
  75. It appears to be a well-kept secret that Pine can read e-mail over a TCP/IP
  76. link using the POP3 protocol, which is the ubiquitous method for obtaining
  77. mail. Let it be a secret no longer! If you want to get e-mail from your POP3
  78. server, set the "inbox-path" field to something of the form
  79.  
  80.     inbox-path={mail.yourisp.net/pop3}inbox
  81.  
  82. where "mail.yourisp.net" is your POP3 server. Note the "/pop3" at the end -- if
  83. you get a message saying "Cannot connect to mail.yourisp.net,143: Connection
  84. refused" when you try to connect, you have left this off.
  85.  
  86. Alternatively, you can get your mail via the IMAP protocal over a TCP/IP link,
  87. in which case you should set the "inbox-path" field to something of the form
  88.  
  89.     inbox-path={mail.yourisp.net}inbox
  90.  
  91. that is, the same as for POP3 but without the "/pop3" on the end. Finally, you
  92. can also get your mail from a file by specifying the name of the file in the
  93. "inbox-path" field. The file can be in any mailbox format recognised by OS/2
  94. Pine (see below).
  95.  
  96. Putting that all together, for example, we might have
  97.  
  98.     personal-name=Sally J. Pineuser
  99.     user-id=sally
  100.     user-domain=theisp.net.au
  101.     smtp-server=smtp.theisp.net.au
  102.  
  103. Of course, you may want to set any number of other options while you're at it.
  104. Pine has extensive on-line help for all of the options (press "?" on the
  105. configuration screen when the cursor is on the appropriate field) which should
  106. get you through this process.
  107.  
  108.  
  109. USING PINE TO READ USENET
  110. =========================
  111.  
  112. Pine can read Usenet groups by setting the "nntp-server" field to the name of
  113. your NNTP (news) server, for example,
  114.  
  115.     nntp-server=news.theisp.net.au
  116.  
  117. You can then access your newsgroups through the Folders ("L") screen on the
  118. main menu in much the same way mail folders are accessed.
  119.  
  120. Be warned that news access can be extremely slow over a modem link (or any
  121. oher low-bandwidth link), especially when subscribing to new groups. It is
  122. almost certainly worth enabling the "news-post-without-validation" option.
  123.  
  124.  
  125. FOLDER FORMATS
  126. ==============
  127.  
  128. The code for reading local folders is copied directly from the NT port. I have
  129. tested the MTX and Unix formats, and Pine, by default, uses the MTX format.
  130. The MBX and Tenex formats, while (theoretically) supported by OS/2 Pine, have
  131. only been tested under Windows NT and I cannot guarantee that they work properly
  132. under OS/2.
  133.  
  134.  
  135. DIFFERENCES BETWEEN OS/2 AND OTHER PORTS OF PINE
  136. ================================================
  137.  
  138.   * Colour
  139.  
  140.     To use colour with OS/2, set the colour option to "use-termdefs". OS/2 Pine
  141.     does not really "use termdefs" (i.e. the termcap or ncurses library); this
  142.     option actually uses the OS/2 VIO API. The result of using the force-ansi
  143.     options is unpredictable.
  144.  
  145.   * Sendmail
  146.  
  147.     OS/2 Pine cannot send mail using a local version of sendmail (or suchlike),
  148.     except, possibly, by using the local machine as SMTP server.
  149.  
  150.   * FAT drives
  151.  
  152.     Alas, these things are still haunting us. While FAT-compliant file names
  153.     are used in the OS/2 port whenever Pine generates a file name, there is at
  154.     least one place (Unix-format folders) where using long file names is
  155.     unavoidable. I have created compile-time options (FATKLUDGE) which, if
  156.     used, will cause OS/2 Pine to force 8.3 file names at the expense of
  157.     compatability with Unix and NT versions of Pine. By default, this option is
  158.     turned off.
  159.  
  160.   * Password file
  161.  
  162.     The PASSFILE compile-time option is turned on by default for OS/2 Pine.
  163.  
  164.   * Mail servers
  165.  
  166.     The imapd and ipopd daemons distributed with Unix Pine have not been ported
  167.     to OS/2.
  168.  
  169. I may sometimes find time to port features from the Unix versions of Pine if
  170. said features are requested, but I probably won't bother unless there's demand
  171. or someone else wants to send me the patches. I don't have the time or interest
  172. to add special OS/2 features, and I can't do much with Windows features since
  173. the Windows version is closed-source.
  174.  
  175.  
  176. USEFUL HINTS
  177. ============
  178.  
  179. Some people are irritated by being constantly asked for passwords. You can save
  180. passwords by creating a file "PINE.PWD" (use "touch", if you have it; otherwise
  181. open it in an editor and save it without typing anything in) in the same
  182. directory as "pinerc". If this file exists, Pine will ask you if you want to
  183. save your password in this file. If you do, Pine will get the password from the
  184. file forevermore. Though the password is encrypted (albeit not very strongly,
  185. according to the documentation), USE OF THIS FEATURE HAS SERIOUS SECURITY
  186. IMPLICATIONS. At best, it gives anyone with access to your machine free access
  187. to your e-mail. At worst, it allows them to gain your password. USE IT WITH
  188. EXTREME CAUTION.
  189.  
  190.  
  191. When specifying application names, e.g. in the "url-viewers" field, you need to
  192. specify the full path name of the application, for example,
  193.  
  194.     url-viewers=d:\tcpip\bin\explore.exe
  195.  
  196. and not
  197.  
  198.     url-viewers=explore
  199.  
  200. as Pine does not search the path when looking for them.
  201.  
  202.  
  203.  
  204. OS/2-SPECIFIC CHANGES FROM PINE 4.21
  205. ====================================
  206.  
  207.  * The "folder-extension" option has been made obsolete by the Pine
  208.    Development Team; the OS/2 version used to set this to ".mtx" by default.
  209.    You will probably want to rename all of your 4.21 folders to be without
  210.    extensions.
  211.  
  212.  * Pico's default colours are now white-on-black.
  213.  
  214.  * Pico's -c command-line option has been abolished.
  215.  
  216.  * Folder names are no longer case-sensitive, fixing some problems
  217.    especially effecting FAT drives (and also HPFS in rare instances).
  218.  
  219.  * HTML text did not undergo character-set-to-codepage translation before
  220.    display. This caused (among other things) some help sceens to display
  221.    a-acutes instead of (non-breakable) spaces.
  222.  
  223.  * Displays of dimensions other than 80x25 are now supported.
  224.  
  225.  * The alternate editor command can now call any type of executable.
  226.  
  227.  * Pine sometimes tries to create temporary file names with a leading
  228.    '.', which causes problems on FAT drives. The OS/2 version now strips
  229.    any leading '.' from temporary file names.
  230.  
  231.  * Pine used to periodically report `Command "B" undefined for this screen'
  232.    when idling.
  233.  
  234.  * Inserting a file (^R) from the home directory was inserting files
  235.    from the current directory.
  236.  
  237.  * Some additions and minor changes to the installation instructions.
  238.  
  239. Changes from older versions of Pine not specific to OS/2 can be found at
  240.  
  241.     http://www.washington.edu/pine/changes
  242.  
  243.  
  244. BUGS
  245. ====
  246.  
  247. If you find any bugs specific to the OS/2 version, please send them to me
  248. (nps@zeta.org.au) so that I can correct them. Please check my web site
  249. first for known bugs (and, where known, work-arounds). Bugs not specific to
  250. the OS/2 version can be reported to the Pine Development Team at
  251. pine-bugs@washington.edu.
  252.  
  253. I had a collection of e-mails describing various apparent peculiarities in
  254. Pine for OS/2. Some of these were passed on to the Pine Development Team,
  255. some I tried to fix "blind" because I didn't have access to a configuration
  256. that allowed me to reproduce the error, some referred to the 4.10 betas and
  257. the problem seemed to made irrelevent by changes for 4.21. I may have also
  258. overlooked a few I couldn't pin down. If any of these problems re-occur in
  259. 4.30, please re-report them so that I know they're still around.
  260.