===================================
README for PC Eudora for MS Windows
===================================

Version 1.4


This is the free version of PC Eudora.  There is a commercial version of
PC Eudora.  If want any information about the commercial version (such as
what advantages it has over the free version, or what the pricing is for
the commercial version), please send some email to eudora-sales@qualcomm.com,
or call (800) 2-EUDORA (that's 1-800-238-3672).  The commercial version is
offered for a very reasonable price, and has many features that make it a
more valuable tool than the free version.


PC Eudora is an electronic mail tool based on Eudora for the Macintosh.
This version has been completely rewritten by QUALCOMM Incorportated,
San Diego, CA in C++, using the Zinc Interface Library for the Graphical
User Interface.  Those familiar with Eudora should have no problems using
PC Eudora, and even new users will find PC Eudora to be easy to learn and use.



License and Legal Information
-----------------------------

This PC Eudora Software is owned by QUALCOMM Incorporated.  
QUALCOMM grants to the user a nonexclusive license to use this PC Eudora 
Software solely for its internal business purposes.  The user shall not 
commercially distribute, sublicense, resell, or otherwise transfer for any 
consideration, or reproduce for any such purposes, the PC Eudora software 
or any modification or derivation thereof, either alone or in conjunction 
with any other product or program.  Further, the user shall not modify the 
PC Eudora Software, other than for its own internal business use.

THE PC EUDORA SOFTWARE IS PROVIDED TO THE USER ''AS IS.''  QUALCOMM 
MAKES NO WARRANTIES, EITHER EXPRESSED OR IMPLIED, WITH RESPECT TO 
THE PC EUDORA SOFTWARE AND/OR ASSOCIATED MATERIALS PROVIDED TO 
THE USER, INCLUDING BUT NOT LIMITED TO ANY WARRANTY OF MERCHANTABILITY, 
FITNESS FOR A PARTICULAR PURPOSE AND AGAINST INFRINGEMENT. 

LIMITATION OF LIABILITY -- QUALCOMM SHALL NOT BE LIABLE FOR ANY CLAIMS OR
DAMAGES WHATSOEVER, INCLUDING PROPERTY DAMAGE, PERSONAL INJURY,
INTELLECTUAL PROPERTY INFRINGEMENT, LOSS OF PROFITS, OR INTERRUPTION OF
BUSINESS, OR FOR ANY SPECIAL, CONSEQUENTIAL OR INCIDENTAL DAMAGES, 
HOWEVER CAUSED, WHETHER ARISING OUT OF BREACH OF WARRANTY, CONTRACT,
TORT (INCLUDING NEGLIGENCE), STRICT LIABILITY, OR OTHERWISE.



Minimum Requirements
--------------------

PC Eudora for MS Windows requires the following:

    - IBM PC compatible machine
    - MS Windows Version 3.1
    - WinSock v1.1 compliant TCP/IP stack
    - Microsoft (or compatible) mouse (highly recommended)
    - At least 750KB of free disk space (more depending on mailbox sizes)



How to Install
--------------

1.  Create a new directory for the eudora files (C:\EUDORA is a good choice).


2.  Copy the executable file into the directory you created in step #1:

    WEUDORA.EXE


3.  Add the following environment variable to your AUTOEXEC.BAT file:

    SET TMP=C:\TMP                 (or some temp directory)

    Make sure that this directory exists.


4.  PC Eudora makes use several different TCP/IP services, and has default
    port numbers for these services.  Most sites put these services on the
    default ports, but some may not.  Contact your site network adminstrator
    to make sure that the following services listed in this step indeed
    have the default port numbers.  If they don't, you'll have to make
    some changes (usually to a SERVICES file) to some file(s) on your PC.

    Below are a list of the services which PC Eudora uses, and what they
    might look like in a typical services file.  The names of these services
    must be exactly as named here (e.g. the entry for the POP3 service must
    be "pop3" and not "pop-3").  Make sure that you make any changes necessary
    for your TCP/IP package to specifiy the location of the SERVICES file.

    To receive mail:
        pop3    110/tcp

    To send mail:
        smtp    25/tcp

    To use Ph (if your site has a Ph server):
        ns      105/tcp

    To use Finger (if your site supports finger):
        finger  79/tcp

    To use the Change Password... function in PC Eudora (if your site has a
    password changing server, see the directory mac/eudora/1.4/contrib on
    ftp.qualcomm.com for examples of password changing servers):
        epass   106/tcp


5.  Run MS Windows and add PC Eudora as a Program Item to a new or existing
    Program Group.

    If you wish your mail files to reside somewhere other than where the
    executable resides, then you can set the mail directory by specifying
    the directory as the first parameter on the command line of the
    Program Item that you create for PC Eudora.

    This is useful if you want to keep the executable on a server, but each
    user has their own mail heirarchy.  It also works for when you want to
    have multiple users on one PC.  Always keep the help file in the same
    directory as the executable.

    PC Eudora will use the directory on the command line first.  If
    that isn't present the directory where the executable resides will be
    used.


The first time you run PC Eudora for Windows you will have to edit
some of the configuration information in order to be able to send and 
receive mail.  


Select Configurations from the Special Menu.  The fields you need to
review are:

    POP Account:     This should be set to the address where you receive
                     your mail. The entry must be entered in the following
                     form: 
                     	"username@machine_name"
                     This is a required field on this screen.

    SMTP Server:     This should be set to the address of a machine that
                     supports SMTP. If the machine that your POP account is
                     on supports SMTP, you need not fill this in (Eudora will
                     use the machine your POP account is on to deliver mail
                     also).

    Return Address:  This should be set to the address of how you wish your
                     return address to appear in mail that you send.  If your
                     POP account (as shown above) is also your return address
                     then you can leave this field blank also.

    Real Name:	     This is field you can use to fill in your actual name
                     (i.e. John Smith) and it will be appended to the 
                     return address in messages you send, enclosed in 
                     parentheses.



Additional Configuration Notes
------------------------------
There is a file named CHANGES that should come along with the PC Eudora
distribution.  This file has important information about how to use some of
the features in PC Eudora.

If you have the New Mail Notification "Sound" switch on, then when new mail
arrives, you will hear a notification sound.  In order for this to work,
your system must have a properly configured sound board, or you must have
installed the Sound Driver for PC-Speaker (anonymous ftp from 
ftp.cica.indiana.edu, the file /pub/pc/win3/sounds/speak.exe).  Eudora has a
built in sound, but if you wish to supply your own, it must be in .WAV format.
To change the default new mail sound, edit the EUDORA.INI file and add an
entry entry in the [Miscellaneous] section called NewMailSound.  Set the entry
to the name to the filename of the wave file.  If the entry is just a
filename, with no path, then PC Eudora will look for it in the mail directory.
Here's an example of what it may look like in the INI file:

[Miscellaneous]
NewMailSound=NEWMAIL.WAV


If the mail you are sending is bouncing back to you saying that the message
does not have a Date: header, add the following entry to your EUDORA.INI file:

[Miscellaneous]
TimeZone=xxxnnnyyy

where xxx, yyy are timezone abbreviations like PST, PDT, CDT, and nnn is
the offset in hours WEST of GMT (i.e those that are east of GMT should
enter a negative number here).  xxx is the timezone during Standard Time
and yyy is the timezone during Daylight Savings Time.  If you do not
change your clocks during Daylight Savings Time, leave yyy blank.
Here's some samples:
     TimeZone=PST8PDT
     TimeZone=MET-1

If you don't specify a TimeZone entry, then a Date: header will not be
put in outgoing messages, which is fine for most because their mail server
will insert the correct Date: header.  The moral is: if you don't get
messages bounced because of a missing Date: header, then leave the
TimeZone entry alone.



Getting More Information
------------------------

Reporting Bugs
-------------- 

Send any and all bugs to pc-eudora-bugs@qualcomm.com, and we'll try
to respond to you as quickly as possible.  The bug address is to be used for
reporting bugs only.  There is no support for the free version of PC Eudora.
If you would like technical support, please consider purchasing the commercial
version of PC Eudora (email to eudora-sales@qualcomm.com, or 1-800-2-EUDORA).

If the bug involves a GPF, then be sure to include a Dr. Watson log file.
There's an application called Dr. Watson (it's in your Windows directory,
DRWATSON.EXE) that will write some important debugging information to a log
file (DRWATSON.LOG, also in the Windows directory), and will also prompt
you to jot down a few words about what you were doing when the crash
occurred.  This information is extremely helpful for tracking down
problems.  In his spare time, Dr. Watson enjoys sitting as an icon at the
bottom of the screen.

The entries are appended to the end of the log file, so it can grow very
large.  Periodically delete the file to keep its size to a minimum.  When
you include a log file as part of a bug report, PLEASE, PLEASE, PLEASE,
edit the log file so that only the pertinent part(s) are included.  It's
really not fun to wade through months of someone's log file.

You can make a Program Item for Dr. Watson in your StartUp Program Group so
that you don't have to manually start it every time your start Windows.



The PC Eudora Development Team
Jeff Beckley         beckley@qualcomm.com
Jeff Gehlhaar        jbg@qualcomm.com

