home *** CD-ROM | disk | FTP | other *** search
/ The Best of Windows 95.com 1996 September / WIN95_09964.iso / unix / pcp_w32.zip / INSTALL.TXT next >
Text File  |  1996-07-15  |  16KB  |  385 lines
  1.                        Pine 3.95 RELEASE NOTES
  2.                          Specific To PC-PINE
  3.                              July 1996
  4.  
  5. Copyright 1989-1996 University of Washington.
  6. Pine and Pico are trademarks of the University of Washington.
  7.  
  8. INTRODUCTION
  9.  
  10. The general release notes for this version of Pine are available via
  11. the "R" command on the Main Menu.  This file contains information that
  12. is particular to PC-Pine.  We assume that you are generally familiar
  13. with Pine; if not, additional information resources include:
  14.  
  15.   o The builtin context-sensitive Help screens in Pine.
  16.   o The comp.mail.pine newsgroup.
  17.   o The World-Wide-Web page at http://www.cac.washington.edu/pine
  18.   o The anonymous FTP archives at ftp://ftp.cac.washington.edu/pine
  19.  
  20. PC-Pine is available for the following environments:
  21.  
  22.   o Windows: Windows95, NT 3.51
  23.   o Windows: version 3.X
  24.   o DOS: FTP Inc's PC-TCP
  25.   o DOS: Novell's LAN Workplace for DOS
  26.   o DOS: Sun's PC-NFS
  27.   o DOS: WATTCP/Packet Driver
  28.  
  29. The Winsock versions are not full Windows GUI applications; they have
  30. basically the same user interface as the Unix and DOS versions of Pine
  31. though modest GUI interaction is supported.
  32.  
  33. KNOWN BUGS
  34.  
  35. There are several bugs that we already know about:
  36.  
  37.   o Under DOS, memory is tight.  If you have run version 3.91, this
  38.     version requires about 15K more free memory to run (around 500K free).
  39.     Note, there are no memory restrictions under Windows 3.X, Windows95
  40.     or Windows NT.
  41.  
  42.   o The Pipe command does not work properly under Windows95 and Windows NT.
  43.  
  44.   o You cannot (yet) mount a Unix directory (via NFS or SMB) and successfully
  45.     share the same .newsrc file between your Unix and PC versions of Pine.
  46.  
  47.   o The Winsock version is preliminary; we know that there are a number
  48.     of things that need to be done, however, your comments pro or con are
  49.     most welcome.
  50.  
  51. INSTALLATION INSTRUCTIONS
  52.  
  53. If you've made it this far, then you have already picked up a copy of
  54. PC-Pine that is appropriate for your networking software and "unzipped"
  55. the files in a directory (probably C:\Pine) on your PC's disk drive.  In
  56. the case of PC-Pine for Winsock, assuming you have Winsock/TCP/IP
  57. networking software already installed, you can now use the Windows file
  58. manager to create a new program item, or just use the "Run" option in the
  59. program manager to start out.  For the DOS versions, there are only a few
  60. more things you have to do to get Pine rolling:
  61.  
  62. ----------------------------------
  63. Setting up the Networking Software
  64. ----------------------------------
  65.  
  66.    We assume that your DOS networking software has been installed and
  67.    configured for regular use.  If it has not, you must do that before
  68.    using Pine.
  69.  
  70.    There are some additional steps that must be taken by users of
  71.    packet drivers, or older versions of FTP, Inc.'s PC/TCP. Those steps
  72.    are explained below.
  73.  
  74.     PCs with a Packet Driver:
  75.     -------------------------
  76.  
  77.        A) Edit the file WATTCP.CFG in the PC-Pine distribution to set
  78.           the PC's TCP/IP configuration.  Simply edit the file to do this.
  79.  
  80.        B) Every time Pine runs, it needs to be able to "see" the
  81.           WATTCP.CFG file you just configured above.  To do that, you
  82.           must add an environment variable "WATTCP.CFG" to the file
  83.           AUTOEXEC.BAT.  Here are the step-by-step instructions:
  84.  
  85.             1) Edit the file C:\AUTOEXEC.BAT to add the following line -
  86.                         set WATTCP.CFG=C:\PINE
  87.  
  88.             2) Save the file and reboot your computer.
  89.  
  90.           You will only have to do this packet driver specific configura-
  91.           tion work once.
  92.  
  93.        X) ADDITIONAL NOTE: If you have a running version of NCSA telnet,
  94.       already installed on you PC, its "CONFIG.TEL" file can be used
  95.       instead of the WATTCP.CFG file.  PC-Pine has a basic understanding
  96.       of the CONFIG.TEL format, and will recognize the "CONFIGTEL"
  97.       environment variable in the absence of a "WATTCP.CFG" environment
  98.       variable.
  99.  
  100.     PCs with a PC/TCP Version Less than 2.2
  101.     ---------------------------------------
  102.  
  103.        A) You need a configuration file called "PCTCP.INI" in the Pine
  104.           directory.  This can be created in one of two ways:
  105.  
  106.             - If you have the program "Trans.exe" provided by FTP, Inc.,
  107.               then you can run this command:
  108.                   trans ifcust0.sys > C:\Pine\pctcp.ini
  109.  
  110.             - If you don't have "Trans.exe" or if that command does not
  111.               work for you, then create the file by hand.  It needs to
  112.               contain just these two lines:
  113.  
  114.                   [pctcp ifcust 0]
  115.                   ip-address=<your_pc's_ip_address>
  116.  
  117.               Replace <your_pc's_ip_address> with the 4-section number
  118.               appropriate for your computer.
  119.  
  120.        B) Every time Pine runs, it needs to be able to "see" the
  121.           PCTCP.INI file you just configured above.  To do that, you
  122.           must add an environment variable "PCTCP.INI" to the file
  123.           AUTOEXEC.BAT.  Here are the step-by-step instructions:
  124.  
  125.             1) Edit the file C:\AUTOEXEC.BAT to add the following line -
  126.                    set PCTCP=C:\PINE\PCTCP.INI
  127.  
  128.             2) Save the file and reboot your computer.
  129.  
  130.           You will only have to do this PC/TCP specific configuration
  131.           work once.
  132.  
  133. -----------------------------------
  134. Essential Configuration Information
  135. -----------------------------------
  136.  
  137.    When you start PC-Pine for the first time, the program will prompt
  138.    you for certain information.  That configuration data is written to
  139.    PC-Pine's configuration file (named PINERC in the directory you
  140.    unpacked pine in), so you will not have to enter it every time. 
  141.  
  142.    You should be prepared for the questions as PC-Pine can't really
  143.    proceed without the answers.  If you make an error in any of these
  144.    entries, you can correct it in Pine's SETUP CONFIGURATION screen
  145.    (type "S" then "C" from the Main Menu).
  146.  
  147.    Inbox
  148.    -----
  149.       When you read mail with PC-Pine, your mail is not delivered to your
  150.       PC directly.  Rather, email is delivered to an IMAP server which
  151.       has been previously set up by your department/university/institution.
  152.       When you first start Pine, you need to specify where your INBOX
  153.       is.  The syntax is this:   {imap-server.domain}INBOX
  154.  
  155.    User-id
  156.    -------
  157.       This is the user-id part of your email address.
  158.  
  159.    Personal name
  160.    -------------
  161.       Your name as you want it to appear on outgoing email.  You may have
  162.       spaces and punctuation in the name.
  163.  
  164.    Host/domain
  165.    -----------
  166.       The "host" portion of your email address.  This may be the full name
  167.       of the computer where your inbox resides or your departmental/
  168.       institutional domain if mail forwarding is set up.  NOTE: You should
  169.       not put the name of your PC as the answer to this question -- your
  170.       PC is not where your INBOX resides.
  171.  
  172.    SMTP server
  173.    -----------
  174.       Your PC does not have the software to interact with Internet email
  175.       directly.  It must rely on an SMTP server to actually send your
  176.       message.  You need to set this to the full name of the computer at
  177.       your site which provides SMTP service.
  178.  
  179.  
  180.    Example:  Suppose the PC-Pine user is named "Joe User" and has
  181.    the login/email address of "juser".  The individual is at the
  182.    University of Examples and takes advantage of the general
  183.    domain of "u.example.edu".  He has set up his email so that
  184.    email is delivered to his inbox on the machine "imap.example.edu".
  185.    The University has set up an SMTP server on the machine named
  186.    "smtp-relay.example.edu".  The PC running PC-Pine is on the campus
  187.    network and is called "pc-joe".
  188.  
  189.    That person would answer PC Pine's configuration questions like this:
  190.  
  191.            INBOX             {imap.example.edu}INBOX
  192.            User-id           juser
  193.            Personal Name     Joe User
  194.            Host/domain       u.example.edu
  195.            SMTP Server       smtp-relay.example.edu
  196.  
  197.    Email coming from the account would look like this:
  198.  
  199.          --------------  Sample Email -----------------
  200.          Date: Mon, 16 July 1993 08:45:43 -0700
  201.          From: Joe User <juser@u.example.edu>
  202.          To: Pine Development Team <pine-bugs@cac.washington.edu>
  203.          Subject: My First Message
  204.  
  205. -------------------
  206. Local Support Files
  207. -------------------
  208.  
  209. The Release Notes (Press "R" on the Main Menu) contain a section on 
  210. Configuration, including default file names and environment variables.
  211. In brief, PC-Pine uses the following rules for finding config and support
  212. files:
  213.  
  214.  1. The location of the PINERC is searched for in the following order of
  215.    precedence:
  216.     1. File pointed to by PINERC environment variable
  217.     2. $HOME\PINE\PINERC
  218.     3. A file named PINERC in the same directory as PINE.EXE
  219.  
  220.  2. The HOME environment variable, if not set, defaults to root of the
  221.     current working drive.
  222.  
  223.  3. The default for most support files (e.g. PINE.SIG and ADDRBOOK) is
  224.     the same directory as the PINERC file.
  225.  
  226.  4. The support files (PINE.HLP and PINE.NDX) must be in the
  227.     same directory as PINE.EXE.
  228.  
  229. Descriptions of these files follows:
  230.  
  231.    PINERC
  232.    ------
  233.         The Pine configuration file.  It contains all of Pine's config-
  234.         uration information -- much more than just the essentials listed
  235.         above.  There are comments in the PINERC to help you out.  Also,
  236.         PC-Pine comes with a sample PINERC you can use as a model.  See
  237.         the release notes for this version (they are compiled into the
  238.         program) for more details.
  239.  
  240.    ADDRBOOK
  241.    --------
  242.         Your Pine address book.  All the tools you need to manage the
  243.         address book are in Pine itself, so you shouldn't need to worry
  244.         about this.
  245.  
  246.    PINE.SIG
  247.    --------
  248.         Your signature file.  If this file exists, Pine will automatically
  249.         insert it into every outgoing message.  You can specify a
  250.         different name for this file in the PINERC if you like.
  251.  
  252.    NEWSRC
  253.    ------
  254.         The NEWSRC is your subscription list for newsgroups.  By default
  255.         Pine will create this file in the same directory as your PINERC,
  256.         but will recognize it in your $HOME directory as well.  You can
  257.         specify a different name for this file in the PINERC if you like.
  258.  
  259.    MAILCAP
  260.    -------
  261.         The MAILCAP file is not required by PC-Pine for normal operation,
  262.         but is the configuration file that can be used to help PC-Pine
  263.         deal with types and subtypes of MIME attachments it doesn't
  264.         have builtin knowledge of.  The MAILCAP file is automatically
  265.         recognized in either the same directory as your PINERC or the
  266.         same directory as PINE.EXE.  You can specify a different MAILCAP
  267.         file (or files) using the MAILCAPS environment variable which
  268.         takes a semicolon delimited list of locations.  A sample MAILCAP,
  269.         MAILCAP.SAM, is included in the distribution to help get started.
  270.  
  271.    MIMETYPE
  272.    --------
  273.     The MIMETYPE file is not required by PC-Pine for normal operation,
  274.         but is the configuration file that can be used to help PC-Pine
  275.         apply the proper MIME type and subtype information to attachments
  276.         it sends.  The MIMETYPE file's location is the same as that
  277.         described for MAILCAP above.  A sample MIMETYPE, MIMETYPE.SAM, is
  278.         included in the distribution to help get started.
  279.  
  280. ---------------------------
  281. Local Directory for Folders
  282. ---------------------------
  283.  
  284. Another important directory to PC-Pine is the location for local mail
  285. folders.  By default, PC-Pine will create the directory $HOME\MAIL to use
  286. as the directory to store mail you save to the local disk.  If the $HOME
  287. environment variable is not defined, PC-Pine will assume the root of the
  288. current working drive.  This location can be overridden by changing or
  289. adding "folder-collections" definitions in PC-Pine's SETUP CONFIGURATION
  290. screen.
  291.  
  292. ---------------------------------------------------
  293. Using PC-Pine to get more information about PC-Pine
  294. ---------------------------------------------------
  295.  
  296. If you see bugs in PC-Pine and want to find out if you have the most
  297. current version or are interested in learning more than Pine's built
  298. in help text has to offer, Pine's Update command will connect you to
  299. the Pine update server.  It holds the most current information on Pine
  300. including technical notes and FAQ's.  You will find "Update" as one of
  301. your options in the "Setup" section from Pine's main menu.
  302.  
  303. 96.03.18 mss
  304.  
  305. APPENDIX A
  306.  
  307.              Spell Checker for Windows Version of PC-Pine
  308.  
  309.    Installing the Spell Checker for Windows developed by Brian Quinion
  310.                  For Spell Checking From Within PC-Pine
  311.  
  312. These installation instructions have been tested on Windows for
  313. Workgroups, Windows NT and Windows95 with the 16-bit version of PC-Pine. 
  314. Spell Checker for Windows requires Windows version 3.1 or higher.  A
  315. 32-bit version of the spell checker is not available yet and the 16-bit
  316. version of the Spell Checker for Windows does not work with the 32-bit
  317. version of PC-Pine. 
  318.  
  319. This installation assumes that the 16-bit version of PC-Pine is already
  320. installed.  You can obtain the PC-Pine distribution from: 
  321.  
  322.   ftp://ftp.cac.washington.edu/pine/pcpine/
  323.  
  324. o Create a subdirectory called pcpspell on your local hard drive (e.g. c:\ 
  325.   - all examples in these instructions assume the installation is on c:\).  
  326.  
  327. o To obtain a copy of the Spell Checker for Windows, connect to
  328.   http://clever.net/quinion/spell/where.htm 
  329.  
  330.   - From the above URL, click on the FTP site nearest you (or if the URL
  331.     is not reachable, connect to ftp://oak.oakland.edu/SimTel/win3/wp/) 
  332.     and download the following two files to the subdirectory called
  333.     pcpspell on your local hard drive. 
  334.  
  335.     spel300e.zip - contains the program files
  336.     useng.zip    - contains the US English dictionary
  337.  
  338.     If you do not wish to use the US English dictionary then download the 
  339.     dictionary for the language that you'd like to use.
  340.  
  341. o Use pkunzip.exe to expand both of the .zip files above, beginning with
  342.   spel300e.zip. During the expansion of the second file called useng.zip,
  343.   you'll get a message that README.1ST already exits. Choose R to rename
  344.   the second README.1ST file to README.  Make certain that you read both
  345.   README files at the end of the installation. 
  346.  
  347.   If you do not have pkunzip, it can be obtained by copying pkunzip.exe
  348.   from ftp://ftp.cac.washington.edu/world/pine/pcpine/, this is where the
  349.   PC-Pine distribution is located.
  350.  
  351. o From Windows, execute c:\pcpspell\spell.exe. The installation may take a
  352.   couple of minutes to complete. 
  353.  
  354.   - When the Options dialog box appears, ensure that the language in the
  355.     dictionary box is the one you intend to use.  The file called
  356.     c:\pcpspell\spell.hlp provides additional information on how to make
  357.     the correct language appear.  
  358.  
  359.   - Once the correct language appears in the dialog box, you are ready to
  360.     try the spell checker from within PC-Pine.  The dictionary file called
  361.     useng.scd is for the US English Language. Close the Options dialog
  362.     box (and the README file, if it is open). 
  363.  
  364. o After closing the Options dialog box, run PC-Pine, compose a message,
  365.   and enter control-t to invoke the spell checker from within the message 
  366.   window. 
  367.  
  368. o For Spell Checker for Windows to work automatically with each reboot, 
  369.   do the following:
  370.  
  371.    -  copy spellch3.dll and useng.scd to c:\windows\system
  372.  
  373.   If the spell checker still does not work automatically, try running
  374.   c:\pcpspell\spell.exe after each reboot, close spell's window and try
  375.   again. 
  376.  
  377. o You can remove the spell checker by executing c:\pcpspell\spell.exe and
  378.   clicking on "uninstall".  After restarting Windows, you can then remove
  379.   all files in the c:\pcpspell directory on your local hard drive. Also,
  380.   delete the files called c:\windows\system\spellch3.dll and  
  381.   c:\windows\system\useng.scd  
  382.  
  383.  
  384.  
  385.