Re: Eclipse under Windows 98

From: Joachim Schimpf <j.schimpf_at_icparc.ic.ac.uk>
Date: Wed 03 Jan 2001 11:11:07 AM GMT
Message-ID: <3A5308CB.3987A537@icparc.ic.ac.uk>
gemichael@cytanet.com.cy wrote:
> 
> Hello,
> 
> I am trying to install Eclipse on a Windows 98 PC. Although I have all the
> required files and searched the documentation, I can't find the
> installation program, or any installation instructions.
> 
> If it is possible, please send me the installation instructions or some
> relevant information.

Dear Michael,

instructions are in the attached README file
which comes with the distribution.

Best regards,
-- 
 Joachim Schimpf              /             phone: +44 20 7594 8187
 IC-Parc, Imperial College   /            mailto:J.Schimpf@ic.ac.uk
 London SW7 2AZ, UK         /    http://www.icparc.ic.ac.uk/eclipse
----------------------------------------------
ECLiPSe - Constraint Logic Programming System
Copyright 1992-1996 ECRC GmbH
Copyright 1996-2000 IC-Parc, Imperial College
Copyright 2000 Parc Technologies Ltd
----------------------------------------------

----------------------------------------------------
ECLiPSe on Windows (see README_UNIX for Unix/Linux)
----------------------------------------------------

ECLiPSe for Windows is primarily intended and supported only for Windows-NT.
However, it seems to work fine on Windows-9X (with only minor restrictions)
provided you have all the necessary Microsoft-DLLs.  In particular, you
need to have Winsock2 installed and you need MSVCRT.DLL.


Distribution overview
---------------------

You should have gotten the following files for the "i386_nt" architecture:

Base:
    README_WIN.TXT		The file you are reading now
    eclipse_basic.tgz        	Kernel and basic libraries
    eclipse_doc_online.tgz	Documentation (html, txt)
    eclipse_doc_print.tgz	Documentation (pdf)

Optional:
    eclipse_misc.tgz		free/3rd party libraries
    if_cplexXY.tgz		Interface to CPLEX(r)
    if_xpressXY.tgz		Interface to XPRESS-MP

Support:
    tcl831.exe			A matching Tcl/Tk release (8.3)
    				(you may have that already).
				Needed for the tkeclipse
				development GUI.

Patches:
    zpatch.tgz			Patches (unpack last)


The file zpatch.tgz (if it exists) constains bug fixes. It must be
unpacked last because it replaces existing files with newer versions.


Installation
------------

1.  Make a folder for ECLiPSe on your machine and move the
    distribution files there.

    Due to a problem with Tcl/Tk, this folder's path name must not
    contain spaces (in particular, don't install below "Program Files").

    In the following we will refer to this folder as <eclipsedir>. 
    Note that you can have different versions of ECLiPSe installed
    at the same time (in different folders).

    The ECLiPSe installation folder can also be shared between
    machines even with different hardware/operating system
    architectures, e.g. i386_nt and sparc_sunos5.  To do so, just
    unpack the distributions for the different architectures in the
    same installation directory.  All architecture-dependent files
    will go in separate subdirectories.


2.  Unpack the distribution files in this folder

    You can use a tool like WinZip, GNU tar/gzip etc.
    Beware of your download or unpacking tool trying to do clever
    modifications of the file contents!  E.g. with WinZip be sure to
    disable Options->Configurations->Smart Tarfile CR/LF Conversion.

    After unpacking, you should have the ECLiPSe directory structure
    inside the <eclipsedir> folder.

    If you are on  Windows-9X (not NT), you need to make sure you have
    the 3 system DLLs WS2HELP.DLL, WS2_32.DLL (Winsock2) and MSVCRT.DLL.


3.  If you don't have Tcl/Tk 8 on your machine yet, or you have a version
    different from 8.3, install it now by executing tcl831.exe !

    It is not absolutely necessary to have Tcl/Tk in order to
    run ECLiPSe, but it simplifies the installation and allows
    you to use the tkeclipse development environment.


4.  Execute ecl_inst.tcl in <eclipsedir> by double-clicking

    This will create the necessary registry and menu entries.


3.  You should now have a Start->Programs->ECLiPSe menu that lets
    you run the command line version and the Tcl/Tk version of
    ECLiPSe and allows you to browse the documentation.



If you don't have Tcl/Tk
------------------------

After unpaking the distribution files you need to make
a registry entry for ECLiPSe:

   - double-click on <eclipsedir>\lib\i386_nt\eclipse.reg

     This will create the registry key
     HKEY_LOCAL_MACHINE\SOFTWARE\IC-Parc\ECLiPSe\<version>
     with a default value of C:\Eclipse

   - If you have unpacked ECLiPSe in C:\Eclipse, you are done. Otherwise:

   - run regedit (Start->Run...->regedit)

   - change the value of the ECLIPSEDIR entry under
     HKEY_LOCAL_MACHINE\SOFTWARE\IC-Parc\ECLiPSe\<version>
     from "C:\Eclipse" to <eclipsedir>, ie the folder where
     you have unpacked the distribution, e.g. "C:\Eclipse"

You should then make a shortcut or menu entry for the executable
<eclipsedir>/lib/eclipse.exe


Directory structure
-------------------

Directories in the binary distribution:

    lib			supported libraries, object files, executables
    lib_public		third party Prolog libraries
    lib_tcl		tcl files for the graphical interface
    include		include files for C/C++ interface
    doc			online documentation, pdf files and example code


The important files are in <eclipsedir>\lib\i386_nt:

    eclipse.exe		ECLiPSe standalone executable (needs eclipse.dll)
    eclipse.dll		ECLiPSe linkable library
    eclipse.lib		ECLiPSe linkable library stubs
    eclipse.def		Export specification of the dll
    eclipse.reg		Registry file for use with regedit

To compile an application using the eclipse.dll you will need the
include files in <eclipsedir>\include\i386_nt.

The files related to the GUI version are in <eclipsedir>\lib_tcl:

    tkeclipse.tcl	ECLiPSe development GUI (executable)
    eclipse.tcl		eclipse package for Tcl/Tk-embedding
    eclipse_tools.tcl	eclipse_tools package with support tools
    example*.tcl	examples for using eclipse from Tcl/Tk

Code for embedding into Visual Basic is in <eclipsedir>\doc\examples.



Differences between UNIX and Windows versions of ECLiPSe
--------------------------------------------------------

Pathnames: Eclipse internally always works with platform independent
path names using forward slashes, e.g.

Windows pathname:	C:\Software\Eclipse
ECLiPSe form:		//C/Software/Eclipse



Installation hints for the 'eplex' library
----------------------------------------------

The ECLiPSe 'eplex' library is an interface to an external CPLEX or
XPRESS-MP solver. Therefore you will need a CPLEX or XPRESS-MP licence
to be able to use it (note however that XPRESS-MP 12 can be used
without a licence in restricted "student mode").

Once you got a licence, you need a version of 'eplex' that matches the
version of the CPLEX or XPRESS-MP licence that you have (although it
may be possible to run an older version with a newer licence).
For example, if you have CPLEX X.Y you need the package if_cplexXY.tgz
and if you have XPRESS-MP XY you should get if_xpressXY.tgz.

To tell ECLiPSe which licence you have on which machine, add the
necessary lines to the text file <eclipsedir>/lib/eplex_lic_info.ecl,
according to the instruction provided there.

With this setup, you can load the eplex library from ECLiPSe by just
invoking lib(eplex), and you will get the correct version for each machine.


Graphics
--------

Starting with ECLiPSe 4.1, the recommended way of building graphical
user interfaces is to embed your ECLiPSe application into a Tcl/Tk or
Visual Basic main program. This is described in the "Embedding and
Interfacing Manual". Note that the tkeclipse development environment
is implemented in that way.
 
The Embedding Interface and the TkEclipse Development Environment
require Tcl/Tk version 8.3.
This might already be installed on your machine, otherwise install
it by executing tcl831.exe.


Upgrading from ECLiPSe 4.2
---------------------------
The following note applies if you would like to keep your old ECLiPSe 4.2
(or older) installation running in parallel with ECLiPSe 5.0.

ECLiPSe 5.0 requires Tcl/Tk 8.3 while ECLiPSe 4.2 requires Tcl/Tk 8.0.
When you install Tcl/Tk 8.3, don't uninstall Tcl/Tk 8.0. However, your
TkEclipse 4.2 will still stop working since the .tcl extension now
refers to Tcl/Tk 8.3.  You can fix this by modifying the shortcut that
is used to start TkEclipse 4.2.  Use the Find-function to locate
...\Start Menu\Programs\ECLiPSe 4.2\TkEclipse, then edit the 'Target'
field in the shortcut properties.  This contains something like
C:\Eclipse\4.2\lib_tcl\tkeclipse.tcl
Prefix this with the name of the wish80 executable as follows:
"C:\Program Files\Tcl\bin\wish80.exe" C:\Eclipse\4.2\lib_tcl\tkeclipse.tcl
and it should work again.

You should do the same modification for the "Uninstall ECLiPSe 4.2"
shortcut to be able to uninstall that release later.


Emacs ECLiPSe mode
------------------

If you use the GNU emacs editor, an ECLiPSe mode is now provided for it.
**Version 20 (or later) of GNU emacs is required.** This mode is based
on the prolog mode by Umeda, and provides extensive syntax colouring 
for ECLiPSe-specific features. See http://www.gnu.org/ if you need more 
information on GNU and its software. 

In order to use this mode, add the following line to your .emacs file:

(autoload 'eclipse-mode "<eclipsedir>/lib_public/eclipse.el" "ECLIPSE editing mode" t)

where <eclipsedir> is the path to your ECLiPSe installation directory.

You may also need to add these lines so that the .pl and .ecl extensions
are recognised to be ECLiPSe programs:

(setq auto-mode-alist (cons '("\\.pl" . eclipse-mode) auto-mode-alist))
(setq auto-mode-alist (cons '("\\.ecl" . eclipse-mode) auto-mode-alist))


daVinci Interface
-----------------

ECLiPSe can interface to the daVinci graph drawing package. If you want
to use this functionality, you need to get daVinci separately from
http://www.informatik.uni-bremen.de/agbkb/forschung/daVinci.
You will also need to set a DAVINCIHOME enviroment variable.


----------------------------------------------
General Topics
----------------------------------------------

Contact Addresses
-----------------

In case you have supplied us with your electronic mail address, we
will add you automatically to the ECLiPSe announcements mailing list

    eclipse-announce@icparc.ic.ac.uk

to keep you informed about new releases. If you want to participate
in discussions related to the use of ECLiPSe and exchange information
with other users, you should subscribe to the ECLiPSe users mailing list

    eclipse-users@icparc.ic.ac.uk

See the web page http://www.icparc.ic.ac.uk/eclipse/mailinglist.html
for how to subscribe and unsubscribe.

Problem and bug reports should be sent to

    eclipse-bugs@icparc.ic.ac.uk

Please use the bug report form provided in the <eclipsedir>/doc directory.

Other requests directed to the development team can be sent to

    eclipse-request@icparc.ic.ac.uk
Received on Wed Jan 03 11:11:07 2001

This archive was generated by hypermail 2.1.8 : Wed 16 Nov 2005 06:08:02 PM GMT GMT