mirrors/eiffel-org
1
0
Fork 0
mirror of https://github.com/EiffelSoftware/eiffel-org.git synced 2025-12-06 23:02:28 +01:00
Code Issues Packages Projects Releases Wiki Activity

Created 18.01 branch of the documentation.

Browse Source 
git-svn-id: https://svn.eiffel.com/eiffel-org/trunk@1942 abb3cda0-5349-4a8f-a601-0c33ac3a8c38
This commit is contained in:
eiffel-org
2018-02-08 15:00:31 +00:00
parent 265a446dab
commit b5d5c80911
2923 changed files with 61520 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
documentation/18.01/eiffelstudio/getting_started/index.wiki Normal file
View File

@@ -0,0 +1,5 @@
[[Property:title|Getting started]]
[[Property:description|Getting started with EiffelStudio]]
[[Property:weight|1]]
[[Property:uuid|ebcde1cb-df4a-44d0-aa9a-0df2d2fc0eb5]]

88
documentation/18.01/eiffelstudio/getting_started/introducing_eiffelstudio.wiki Normal file
View File

@@ -0,0 +1,88 @@
[[Property:title|Introducing EiffelStudio]]
[[Property:weight|2]]
[[Property:uuid|acf5433b-14e9-1d21-c8cf-997db7821550]]
EiffelStudio is the central tool of Eiffel Software's implementation of Eiffel, letting you design, develop, debug, document, measure, maintain, test, revise and expand systems using the full power of object technology and Design by Contract™.
This guided tour introduces the essential properties of EiffelStudio. It will take you through a tour of the environment, using a pre-existing example system.
==What will I achieve?==
Although it skips many specific or advanced facilities, this Tour will help you quickly become familiar with the way you can use the environment for your work. After reading it you will know the basics of working with EiffelStudio:
* '''Starting a project''' and '''retrieving an existing project'''.
* '''Entering new software elements''' -- clusters, classes and features.
* '''Compiling''' your software.
* '''Making changes''' and '''recompiling''' them immediately using the Melting Ice Technology™.
* Displaying a '''graphical representation''' of your software elements, and '''modifying''' the software through the graphical views (as well as through its text).
* Producing extensive '''documentation''' of your system, textual or graphical, under many different formats such as HTML, RTF, Postscript, XMI (for example Rational Rose) and others.
* '''Browsing''' through simple or complex software systems, to find out their various components, properties and relationships.
* '''Measuring''' quantitative properties of the software, by applying metrics predefined in EiffelStudio as well as new ones that you define.
* '''Executing''' a compiled system.
* Controlling execution through the '''debugging''' mechanisms of EiffelStudio.
* Creating an effective '''test suite''', with the automated assistance of '''AutoTest'''
* Add '''licensing''' text to your classes automatically.
==About the scope of EiffelStudio==
The most important property to keep in mind as you are discovering EiffelStudio is that it is neither just a "programming environment" nor just a "CASE tool" (Computer-Aided Software Engineering) for analysis and design. It encompasses both of these functions and many others. Most system builders today are used to a dichotomy between the high end and the low end:
* At the analysis and design levels, graphical tools help you clarify your thinking about the system, interacting with customers and end users, and devise high-level system architectures, usually in diagrammatic form.
* At the low end, programming tools help you edit, compile and debug your programs.
Keeping these tools separate is, however, detrimental to the quality of the software process and the resulting products. If they are in the hands of different teams, communication problems may arise, leading to discrepancies between need and realization; this can be a source of bugs or even project failure. If it's the same people using tools of both kinds, they have to keep switching notations, tools and modes of thinking. The use of different frameworks at both ends makes it difficult to keep the high-level model and the implementation consistent; too often, a change decided at the implementation level is not reflected back in the higher model. After a while, the system gets into the state of disorder and inconsistency that good tools are precisely meant to avoid.
EiffelStudio, in line with the principles of <span>seamless development</span> and <span>reversibility</span> of the Eiffel method, removes the gap by providing a single set of tools that accompany you throughout a project, from the most high-level initial stages to the most low-level aspects of implementation and maintenance.
This generality is reflected throughout the environment by, for example, the dual use of text and graphics. As another example, you should think of the EiffelStudio <span>compiler</span>, not just as a tool for executing Eiffel software in its final form, but also, thanks to its extensive <span>validity checking</span> facilities, as a design consistency tool that performs many verifications commonly associated with CASE tools.
Depending on your project needs, you may take advantage of EiffelStudio's versatility to address specific purposes:
* You may use EiffelStudio as a programming environment, with advanced tools for compiling, browsing and debugging.
* Some people use EiffelStudio as a <span>modeling</span> tool only, building system descriptions consisting only of <span>deferred</span> (abstract) classes with no implementation, and relying on the Diagram Tool to build, present and discuss these descriptions through graphical views.
* You may use EiffelStudio in both capacities, taking advantage of the seamlessness between all the affected phases.
==Learning by doing==
If you have access to EiffelStudio as you read this Tour, the most effective technique is to execute all the suggested operations as you read about them.
Please execute user actions, such as clicking, only when asked to do so.
==What should I already know?==
This Tour assumes very little about what you know and what you don't.
It does assume that you can do simple manipulations on your platform of choice, such as: on Windows, finding and drag-and-dropping folders and files in the Windows Explorer; on Unix, changing to a certain directory ( <code>cd</code> ) and listing the files of a directory ( <code>ls</code> ).
The more you already know about object technology and object-oriented environments, the better. But remember, if you have used other environments before, keep a fresh outlook; EiffelStudio <span>is</span> different, and it may take a while before you fully understand why it does some things in a certain way.
==A note on platform differences==
EiffelStudio is one of the most portable environments in the industry, running in an almost identical fashion on Windows, on the new Microsoft .NET environment, on many variants of Unix, on Linux, on OpenVMS.
Once an EiffelStudio session has been started, you can largely forget about the operating system. But a few operations -- mostly at the beginning, to launch EiffelStudio -- require platform-dependent mechanisms: starting a program, traversing the file structure, selecting a file. These cases will be marked accordingly below.
Windows users should particularly note the following two conventions of terminology:
* Operating systems store files into hierarchically nested structures called <span>folders</span> or <span>directories</span>. Although "folder" is the more common term for Windows, we will mostly speak of "directories". It's exactly the same thing.
* A file has a full <span>path name</span>, used to describe how to reach it from the root of its file system, as in <code>c:\d1\d2\f</code> . This example uses the Windows notation, which separates successive components of a path name by a backward slash character <code>\</code> . On Unix and Linux, the separator is a forward slash <code>/</code> , as in <code>/d1/d2/f</code> ; this is also the convention on the Internet for denoting addresses (URLs). Most file names in this manual appear in this Unix/Internet style. On Windows you will normally have to use the backslash convention, although EiffelStudio also accepts forward slashes. In any case you must be consistent: don't mix backward and forward slashes in the same path name. Also note that some names, such as those of object files to be linked with your system, will be passed to outside tools -- C compilers, loaders -- that may not accept the forward slash.
OpenVMS users may similarly use either the Unix convention or the specific OpenVMS path naming convention.
If you are a one-platform person, just ignore, for the next few pages, all references to any platform other than your heart's favorite. They will quickly go away.
==What should I have done first?==
To run the example you must have installed EiffelStudio and set up the environment. Check in particular the following:
* On Windows, you must have run the installation procedure; it will have put EiffelStudio in the Programs section of the start menu, subsection "EiffelStudio version", where version is the version number, e.g. 6.0.
* The environment variable <code> ISE_EIFFEL </code> must be set to the installation directory, and the environment variable <code>ISE_PLATFORM</code> to the platform. On Windows this is taken care of automatically by the installation procedure, but on Unix/Linux and OpenVMS you must update your path and environment manually. Throughout this discussion the notations <code>$ISE_EIFFEL</code> and <code>$ISE_PLATFORM</code> will refer to the values of these variables -- the installation directory, and the platform. (The Windows notation would be <code>%ISE_EIFFEL%</code> and <code>%ISE_PLATFORM%</code>.)
* On Unix/Linux and OpenVMS, your "path" must include the place where EiffelStudio executables reside. (On Windows the installation procedure takes care of this.)
* Also, the discussion assumes that as part of the installation you have included the EiffelBase library, in precompiled form. EiffelBase is automatically included if you have installed another precompiled library, such as WEL, the Windows Eiffel Library. The installation procedure takes care of precompiling EiffelBase.
==Locating the example==
Please take a moment to locate the example files on your installation. They all appear in the following directory, part of the Eiffel delivery:
<code>$ISE_EIFFEL/examples/studio/tour</code>
(Windows users: remember that instead of the slash <code>/</code> your platform uses a backslash <code>\</code> . OpenVMS users: this is to be replaced by the OpenVMS path naming conventions.)
{{seealso|For a quick introduction to EiffelStudio, see the online EiffelStudio presentation available on the Eiffel Software [http://www.eiffel.com/developers/presentations/ developers' presentations web page].}}

5
documentation/18.01/eiffelstudio/getting_started/setup-and-installation/index.wiki Normal file
View File

@@ -0,0 +1,5 @@
[[Property:title|Setup and installation]]
[[Property:weight|1]]
[[Property:uuid|90bc1970-bd1d-9707-3030-a4a9f613524a]]
For detailed installation instructions please follow the link for the product your are installing.

117
documentation/18.01/eiffelstudio/getting_started/setup-and-installation/software-installation-eiffelstudio/OpenBSD.wiki Normal file
View File

@@ -0,0 +1,117 @@
[[Property:uuid|A98B98AA-B61C-464E-BD49-6E63C3249341]]
[[Property:weight|6]]
[[Property:title|OpenBSD]]
[[Property:link_title|OpenBSD]]
==Requirements==
{| class="doctable"
|-
| '''Computer/Processor'''
| x86 or x86-64
|-
| '''Operating System'''
| OpenBSD 6 with GTK+ 2.4 or greater
|-
| '''C compiler'''
| gcc
|-
| '''Memory'''
| 4GB of RAM
|-
| '''Hard Disk'''
| 1GB of free space
|-
| '''ISE_PLATFORM'''
| '''openbsd-x86''' for x86 based CPU and '''openbsd-x86-64''' for x64 based CPU.
|}
==Checking your environment==
EiffelStudio requires GTK+ 2.4.0 or above to function properly. You can check that you have this installed correctly by typing the following command:
<code>pkg-config --modversion gtk+-2.0</code>
The command should succeed and the version number of GTK+ should appear. If it is not 2.4.0 or above then you cannot continue the installation of EiffelStudio. You first need to install GTK+ 2.4.0.
==Installing EiffelStudio from the Web==
After downloading the installation package, you should manually extract its contents to your hard drive. For example, you can extract it into /usr/local using the following commands (assuming that you have permission to /usr/local and that the installation package was saved in /tmp/EiffelXX.tar.bz2, where XX corresponds to the EiffelStudio version number):
<code>
cd /usr/local
tar xvfj /tmp/EiffelXX.tar.bz2</code>
This will install EiffelStudio files into /usr/local/EiffelXX. Once this is done, jump to the [[#Setting up EiffelStudio|Setting up EiffelStudio]] section in order to complete the installation of EiffelStudio.
==Installing EiffelStudio from a CD-ROM==
Insert the CD into your CD-ROM drive. You should manually extract its contents to your hard drive. For example you can extract it in /usr/local using the following commands (assuming that you have permission to /usr/local and that the CD is mounted on /mnt/cdrom):
<code>cd /usr/local
cp -r /mnt/cdrom/EiffelXX .</code>
This will install the EiffelStudio files into /usr/local/EiffelXX. To complete the installation of EiffelStudio, jump to the next section, [[#Setting up EiffelStudio|Setting up EiffelStudio]].
<span id="setting_up"></span>
==Setting up EiffelStudio==
Once the files have been installed, you should define the following environment variables in order to run EiffelStudio:
* '''ISE_EIFFEL''' to /usr/local/EiffelXX
* '''ISE_PLATFORM''' to openbsd-x86-64.
and add $'''ISE_EIFFEL'''/studio/spec/$'''ISE_PLATFORM'''/bin to your '''PATH''' environment variable.
Using sh or bash as a shell, it suffices to type the following commands:
<code>
export ISE_EIFFEL=/usr/local/EiffelXX
export ISE_PLATFORM=openbsd-x86-64
export PATH=$PATH:$ISE_EIFFEL/studio/spec/$ISE_PLATFORM/bin</code>
Using csh or tcsh as a shell, it suffices to type the following commands:
<code>
setenv ISE_EIFFEL /usr/local/EiffelXX
setenv ISE_PLATFORM openbsd-x86-64
set path = ($path $ISE_EIFFEL/studio/spec/$ISE_PLATFORM/bin)</code>
If you are using the Enterprise edition, please follow the instructions of the next section, [[#Registering the Enterprise Edition|Registering the Enterprise Edition]], otherwise jump to the [[#Using EiffelStudio|Using EiffelStudio]] section at the end of this document.
<span id="registering"></span>
==Registering the Enterprise Edition==
This step assumes you have followed the instructions in the [[#Setting up EiffelStudio|Setting up EiffelStudio]] section. Perform the following commands to start the registration process:
<code>cd $ISE_EIFFEL
./register</code>
A dialog asking for your '''Username''' and '''CD Key''' should appear as it does below:
<center> [[Image:56--unix-setup|Setup dialog]] </center>
Enter the information located inside the box that contains your copy of the EiffelStudio Enterprise Edition. Once the information is correct, the '''Register''' button will be enabled. Click '''Register''' to actually register EiffelStudio.
The first time you launch EiffelStudio, you will be asked for an activation key through the following dialog:
<center> [[Image:56--unix-registration|Registration dialog]] </center>
By clicking on the [http://activate.eiffel.com http://activate.eiffel.com] URL, a new web browser will appear with the requested fields automatically filled in with the appropriate information. Simply click '''Activate''' and a new page with an activation code will appear. Copy and paste the activation code in the first field and the '''Activate''' button should be enabled to let you activate your copy.
You can activate your copy up to three times. Once you have reached this threshold and need to reinstall your copy, contact Eiffel Software to request one more activation.
If no web browser appears, it is most likely because firefox is not installed on your machine or is not in your path. Instead you should manually launch a new web browser, go to the page [http://activate.eiffel.com http://activate.eiffel.com] , and enter the information manually. Then follow the above instructions as if the browser had been properly launched.
You may receive the following dialog when launching EiffelStudio:
<center> [[Image:56--unix-registration-error|Registration incomplete]] </center>
This probably means that the '''register''' program was not launched or did not succeed in storing data to the following file $'''ISE_EIFFEL'''/install/limand/.ec_license. To solve this, rerun the '''register''' program with a user account that has permissions to write at $'''ISE_EIFFEL'''/install/limand and enter your '''Username''' and '''CD Key'''.
Once this is done, you can jump to the next section, [[#Using EiffelStudio|Using EiffelStudio]].
<span id="using"></span>
==Using EiffelStudio==
===Starting EiffelStudio===
Now everything should be properly installed and you should be able to run the compiler. Launch '''estudio''' for the interactive graphical user interface of the compiler, or launch '''ec''' for the command line interface. If you are a new user to EiffelStudio, we recommend that you follow [[Introducing EiffelStudio|the EiffelStudio guided tour]].
===EiffelStudio Appearance===
EiffelStudio for Unix uses the GTK+ theme engine to allow for custom appearance such as changing the default font size and color of windows, etc. If you do not have a theme manager (such as that provided with Gnome) you can copy the .gtkrc-2.0 file from $'''ISE_EIFFEL'''/eifinit/studio/spec/gtk directory to your $'''HOME''' directory.

116
documentation/18.01/eiffelstudio/getting_started/setup-and-installation/software-installation-eiffelstudio/eiffelstudio-freebsd.wiki Normal file
View File

@@ -0,0 +1,116 @@
[[Property:title|FreeBSD]]
[[Property:weight|0]]
[[Property:uuid|b26ddd99-521b-6a10-79e6-e2a5d30f907c]]
==Requirements==
{| class="doctable"
|-
| '''Computer/Processor'''
| x86 or x86-64
|-
| '''Operating System'''
| FreeBSD 11 with GTK+ 2.4 or greater
|-
| '''C compiler'''
| gcc
|-
| '''Memory'''
| 4GB of RAM
|-
| '''Hard Disk'''
| 1GB of free space
|-
| '''ISE_PLATFORM'''
| '''freebsd-x86''' for x86 based CPU and '''freebsd-x86-64''' for x64 based CPU.
|}
==Checking your environment==
EiffelStudio requires GTK+ 2.4.0 or above to function properly. You can check that you have this installed correctly by typing the following command:
<code>pkg-config --modversion gtk+-2.0</code>
The command should succeed and the version number of GTK+ should appear. If it is not 2.4.0 or above then you cannot continue the installation of EiffelStudio. You first need to install GTK+ 2.4.0.
==Installing EiffelStudio from the Web==
After downloading the installation package, you should manually extract its contents to your hard drive. For example, you can extract it into /usr/local using the following commands (assuming that you have permission to /usr/local and that the installation package was saved in /tmp/EiffelXX.tar.bz2, where XX corresponds to the EiffelStudio version number):
<code>
cd /usr/local
tar xvfj /tmp/EiffelXX.tar.bz2</code>
This will install EiffelStudio files into /usr/local/EiffelXX. Once this is done, jump to the [[#Setting up EiffelStudio|Setting up EiffelStudio]] section in order to complete the installation of EiffelStudio.
==Installing EiffelStudio from a CD-ROM==
Insert the CD into your CD-ROM drive. You should manually extract its contents to your hard drive. For example you can extract it in /usr/local using the following commands (assuming that you have permission to /usr/local and that the CD is mounted on /mnt/cdrom):
<code>cd /usr/local
cp -r /mnt/cdrom/EiffelXX .</code>
This will install the EiffelStudio files into /usr/local/EiffelXX. To complete the installation of EiffelStudio, jump to the next section, [[#Setting up EiffelStudio|Setting up EiffelStudio]].
<span id="setting_up"></span>
==Setting up EiffelStudio==
Once the files have been installed, you should define the following environment variables in order to run EiffelStudio:
* '''ISE_EIFFEL''' to /usr/local/EiffelXX
* '''ISE_PLATFORM''' to freebsd-x86.
and add $'''ISE_EIFFEL'''/studio/spec/$'''ISE_PLATFORM'''/bin to your '''PATH''' environment variable.
Using sh or bash as a shell, it suffices to type the following commands:
<code>
export ISE_EIFFEL=/usr/local/EiffelXX
export ISE_PLATFORM=freebsd-x86
export PATH=$PATH:$ISE_EIFFEL/studio/spec/$ISE_PLATFORM/bin</code>
Using csh or tcsh as a shell, it suffices to type the following commands:
<code>
setenv ISE_EIFFEL /usr/local/EiffelXX
setenv ISE_PLATFORM freebsd-x86
set path = ($path $ISE_EIFFEL/studio/spec/$ISE_PLATFORM/bin)</code>
If you are using the Enterprise edition, please follow the instructions of the next section, [[#Registering the Enterprise Edition|Registering the Enterprise Edition]], otherwise jump to the [[#Using EiffelStudio|Using EiffelStudio]] section at the end of this document.
<span id="registering"></span>
==Registering the Enterprise Edition==
This step assumes you have followed the instructions in the [[#Setting up EiffelStudio|Setting up EiffelStudio]] section. Perform the following commands to start the registration process:
<code>cd $ISE_EIFFEL
./register</code>
A dialog asking for your '''Username''' and '''CD Key''' should appear as it does below:
<center> [[Image:56--unix-setup|Setup dialog]] </center>
Enter the information located inside the box that contains your copy of the EiffelStudio Enterprise Edition. Once the information is correct, the '''Register''' button will be enabled. Click '''Register''' to actually register EiffelStudio.
The first time you launch EiffelStudio, you will be asked for an activation key through the following dialog:
<center> [[Image:56--unix-registration|Registration dialog]] </center>
By clicking on the [http://activate.eiffel.com http://activate.eiffel.com] URL, a new web browser will appear with the requested fields automatically filled in with the appropriate information. Simply click '''Activate''' and a new page with an activation code will appear. Copy and paste the activation code in the first field and the '''Activate''' button should be enabled to let you activate your copy.
You can activate your copy up to three times. Once you have reached this threshold and need to reinstall your copy, contact Eiffel Software to request one more activation.
If no web browser appears, it is most likely because firefox is not installed on your machine or is not in your path. Instead you should manually launch a new web browser, go to the page [http://activate.eiffel.com http://activate.eiffel.com] , and enter the information manually. Then follow the above instructions as if the browser had been properly launched.
You may receive the following dialog when launching EiffelStudio:
<center> [[Image:56--unix-registration-error|Registration incomplete]] </center>
This probably means that the '''register''' program was not launched or did not succeed in storing data to the following file $'''ISE_EIFFEL'''/install/limand/.ec_license. To solve this, rerun the '''register''' program with a user account that has permissions to write at $'''ISE_EIFFEL'''/install/limand and enter your '''Username''' and '''CD Key'''.
Once this is done, you can jump to the next section, [[#Using EiffelStudio|Using EiffelStudio]].
<span id="using"></span>
==Using EiffelStudio==
===Starting EiffelStudio===
Now everything should be properly installed and you should be able to run the compiler. Launch '''estudio''' for the interactive graphical user interface of the compiler, or launch '''ec''' for the command line interface. If you are a new user to EiffelStudio, we recommend that you follow [[Introducing EiffelStudio|the EiffelStudio guided tour]].
===EiffelStudio Appearance===
EiffelStudio for Unix uses the GTK+ theme engine to allow for custom appearance such as changing the default font size and color of windows, etc. If you do not have a theme manager (such as that provided with Gnome) you can copy the .gtkrc-2.0 file from $'''ISE_EIFFEL'''/eifinit/studio/spec/gtk directory to your $'''HOME''' directory.

88
documentation/18.01/eiffelstudio/getting_started/setup-and-installation/software-installation-eiffelstudio/eiffelstudio-hp-openvms.wiki Normal file
View File

@@ -0,0 +1,88 @@
[[Property:title|HP OpenVMS]]
[[Property:weight|1]]
[[Property:uuid|cccbd8cf-3bd6-8acb-e62d-7fb1ce0ef4c2]]
==Requirements==
{| class="doctable"
|-
| '''Computer/Processor'''
| AlphaServer.
|-
| '''Operating System'''
| HP OpenVMS/Alpha version 7.3.2 with DECWindows and GTK+ 1.2.10.
|-
| '''C compiler'''
| Compaq C compiler V6 or later.
|-
| '''Memory'''
| 4GB of RAM
|-
| '''Hard Disk'''
| 1GB free disk space on an ODS-5 formatted volume, plus an additional 1GB of free space while performing the software installation.
|}
==Checking your environment==
EiffelStudio requires GTK+ 1.2.10 or above to function properly. You can check that you have this installed correctly by typing the following command:
<code>gtk-config --version</code>
The command should succeed and the version number of GTK+ should appear. If it is not 1.2.10 or above then you cannot continue the installation of EiffelStudio. You first need to install GTK+ 1.2.10.
==Installing the Enterprise Edition==
===From the Web===
After downloading the '''eifXXvms.zip''' installation package (where XX stands for the EiffelStudio version number), unzip the distribution into temp:[dir] where where temp:[dir] is the location of a temporary directory:
<code>unzip eifXXvms.zip temp:[dir]</code>
And use the following commands to install the files into eiffel_installation_path where eiffel_installation_path is a device:[directory] on an ODS-5 volume:
<code>set file/attrib=(org:seq,rfm:fix,lrl:9216) temp:[dir]eifXXvms.save
backup temp:[dir]eifXXvms.save/save eiffel_installation_path</code>
===From a CD===
You must mount the installation CD-ROM volume with the following qualifier:
<code>mount cd_dev:/media_format=cdrom/undefined_fat=fixed:cr:9216</code>
where cd_dev: is the CD-ROM device. And use the following commands to install the files into eiffel_installation_path where eiffel_installation_path is a device:[directory] on an ODS-5 volume:
<code>backup cd_dev:[000000]eifXXvms.save/save eiffel_installation_path</code>
===Completing the installation===
You must define a system-wide rooted logical name to reference the installation directory, for instance:
<code>define/system EIFFELXX eiffel_installation_path:[directory.] /trans=conceal</code>
To use EiffelStudio for OpenVMS, run the setup procedure to define the environment:
<code>@eiffel_installation_path:[000000]setup</code>
This will define the logical names and DCL symbols required to run Eiffel.
Once the files are copied and once the environment is setup up set, you need to register EiffelStudio. To do so type the following command:
<code>RUN ISE_EIFFEL:[000000]register</code>
A dialog asking for your '''Username''' and '''CD Key''' should appear as it does below:
<center> [[Image:56--unix-setup|Setup dialog]] </center>
Enter the information located inside the box that contains your copy of the EiffelStudio Enterprise Edition. Once the information is correct, the '''Register''' button will be enabled. Click '''Register''' to actually register EiffelStudio.
The first time you launch EiffelStudio, you will be asked for an activation key through the following dialog:
<center> [[Image:56--unix-registration|Registration dialog]] </center>
By clicking on the [http://activate.eiffel.com http://activate.eiffel.com] URL, a new web browser will appear with the requested fields automatically filled in with the appropriate information. Simply click '''Activate''' and a new page with an activation code will appear. Copy and paste the activation code in the first field and the '''Activate''' button should be enabled to let you activate your copy.
You can activate your copy up to three times. Once you have reached this threshold and need to reinstall your copy, contact Eiffel Software to request one more activation.
If no web broswer appears, it is most likely because netscape is not installed on your machine or is not in your path. Instead you should manually launch a new web browser and go to the page [http://activate.eiffel.com http://activate.eiffel.com] and enter the information manually. Then follow the above instructions as if the browser had been properly launched.
You may receive the following dialog when launching EiffelStudio:
<center> [[Image:56--unix-registration-error|Registration incomplete]] </center>
This probably means that the '''register''' program was not launched or did not succeed in storing data to the following file ISE_EIFFEL:[install.limand].ec_license. To solve this, rerun the '''register''' program with a user account that has permissions to write at ISE_EIFFEL:[install.limand] and enter your '''Username''' and '''CD Key'''.
Once this is done you can jump to the next section "Using EiffelStudio."

115
documentation/18.01/eiffelstudio/getting_started/setup-and-installation/software-installation-eiffelstudio/eiffelstudio-hp-tru64-unix.wiki Normal file
View File

@@ -0,0 +1,115 @@
[[Property:title|HP Tru64 UNIX]]
[[Property:weight|2]]
[[Property:uuid|f9ef1897-fa95-1c62-d905-54111ad234f1]]
==Requirements==
{| class="doctable"
|-
| '''Computer/Processor'''
| AlphaServer.
|-
| '''Operating System'''
| HP Tru64 UNIX 5.1B with GTK+ 2.4.
|-
| '''C compiler'''
| HP C compiler
|-
| '''Memory'''
| 4GB of RAM
|-
| '''Hard Disk'''
| 1GB of free space
|-
| '''ISE_PLATFORM'''
| '''alpha'''.
|}
==Checking your environment==
EiffelStudio requires GTK+ 2.4.0 or above to function properly. You can check that you have this installed correctly by typing the following command:
<code>pkg-config --modversion gtk+-2.0</code>
The command should succeed and the version number of GTK+ should appear. If it is not 2.4.0 or above then you cannot continue the installation of EiffelStudio. You first need to install GTK+ 2.4.0.
==Installing EiffelStudio from the Web==
After downloading the installation package, you should manually extract its contents to your hard drive. For example, you can extract it into /usr/local using the following commands (assuming that you have permission to /usr/local and that the installation package was saved in /tmp/EiffelXX.tar.bz2, where XX stands for the EiffelStudio version):
<code>
cd /usr/local
tar xvfj /tmp/EiffelXX.tar.bz2</code>
This will install EiffelStudio files into /usr/local/EiffelXX. Once this is done, jump to the [[#Setting up EiffelStudio|Setting up EiffelStudio]] section in order to complete the installation of EiffelStudio.
==Installing EiffelStudio from a CD-ROM==
Insert the CD into your CD-ROM drive. You should manually extract its contents to your hard drive. For example you can extract it in /usr/local using the following commands (assuming that you have permission to /usr/local and that the CD is mounted on /mnt/cdrom):
<code>cd /usr/local
cp -r /mnt/cdrom/EiffelXX .</code>
This will install the EiffelStudio files into /usr/local/EiffelXX. To complete the installation of EiffelStudio, jump to the next section, [[#Setting up EiffelStudio|Setting up EiffelStudio]].
<span id="setting_up"></span>
==Setting up EiffelStudio==
Once the files have been installed, you should define the following environment variables in order to run EiffelStudio:
* '''ISE_EIFFEL''' to /usr/local/EiffelXX
* '''ISE_PLATFORM''' to alpha.
and add $'''ISE_EIFFEL'''/studio/spec/$'''ISE_PLATFORM'''/bin to your '''PATH''' environment variable.
Using sh or bash as a shell, it suffices to type the following commands:
<code>
export ISE_EIFFEL=/usr/local/EiffelXX
export ISE_PLATFORM=alpha
export PATH=$PATH:$ISE_EIFFEL/studio/spec/$ISE_PLATFORM/bin</code>
Using csh or tcsh as a shell, it suffices to type the following commands:
<code>
setenv ISE_EIFFEL /usr/local/EiffelXX
setenv ISE_PLATFORM alpha
set path = ($path $ISE_EIFFEL/studio/spec/$ISE_PLATFORM/bin)</code>
If you are using the Enterprise edition, please follow the instructions of the next section, [[#Registering the Enterprise Edition|Registering the Enterprise Edition]], otherwise jump to the [[#Using EiffelStudio|Using EiffelStudio]] section at the end of this document.
<span id="registering"></span>
==Registering the Enterprise Edition==
This step assumes you have followed the instructions in the [[#Setting up EiffelStudio|Setting up EiffelStudio]] section. Perform the following commands to start the registration process:
<code>cd $ISE_EIFFEL
./register</code>
A dialog asking for your '''Username''' and '''CD Key''' should appear as it does below:
<center> [[Image:56--unix-setup|Setup dialog]] </center>
Enter the information located inside the box that contains your copy of the EiffelStudio Enterprise Edition. Once the information is correct, the '''Register''' button will be enabled. Click '''Register''' to actually register EiffelStudio.
The first time you launch EiffelStudio, you will be asked for an activation key through the following dialog:
<center> [[Image:56--unix-registration|Registration dialog]] </center>
By clicking on the [http://activate.eiffel.com http://activate.eiffel.com] URL, a new web browser will appear with the requested fields automatically filled in with the appropriate information. Simply click '''Activate''' and a new page with an activation code will appear. Copy and paste the activation code in the first field and the '''Activate''' button should be enabled to let you activate your copy.
You can activate your copy up to three times. Once you have reached this threshold and need to reinstall your copy, contact Eiffel Software to request one more activation.
If no web browser appears, it is most likely because firefox is not installed on your machine or is not in your path. Instead you should manually launch a new web browser, go to the page [http://activate.eiffel.com http://activate.eiffel.com] , and enter the information manually. Then follow the above instructions as if the browser had been properly launched.
You may receive the following dialog when launching EiffelStudio:
<center> [[Image:56--unix-registration-error|Registration incomplete]] </center>
This probably means that the '''register''' program was not launched or did not succeed in storing data to the following file $'''ISE_EIFFEL'''/install/limand/.ec_license. To solve this, rerun the '''register''' program with a user account that has permissions to write at $'''ISE_EIFFEL'''/install/limand and enter your '''Username''' and '''CD Key'''.
Once this is done, you can jump to the next section, [[#Using EiffelStudio|Using EiffelStudio]].
<span id="using"></span>
==Using EiffelStudio==
===Starting EiffelStudio===
Now everything should be properly installed and you should be able to run the compiler. Launch '''estudio''' for the interactive graphical user interface of the compiler, or launch '''ec''' for the command line interface. If you are a new user to EiffelStudio, we recommend that you follow [[Introducing EiffelStudio|the EiffelStudio guided tour]].
===EiffelStudio Appearance===
EiffelStudio for Unix uses the GTK+ theme engine to allow for custom appearance such as changing the default font size and color of windows, etc. If you do not have a theme manager (such as that provided with Gnome) you can copy the .gtkrc-2.0 file from $'''ISE_EIFFEL'''/eifinit/studio/spec/gtk directory to your $'''HOME''' directory.

118
documentation/18.01/eiffelstudio/getting_started/setup-and-installation/software-installation-eiffelstudio/eiffelstudio-hp-ux.wiki Normal file
View File

@@ -0,0 +1,118 @@
[[Property:title|HP-UX]]
[[Property:weight|3]]
[[Property:uuid|c1982828-16bf-8984-bd8a-18df4b48cf27]]
==Requirements==
{| class="doctable"
|-
| '''Computer/Processor'''
| HP-PA.
|-
| '''Operating System'''
| HP-UX 11 with GTK+ 2.4.
|-
| '''C compiler'''
| HP C compiler
|-
| '''Memory'''
| 4GB of RAM
|-
| '''Hard Disk'''
| 1GB of free space
|-
| '''ISE_PLATFORM'''
| '''hpux-11'''.
|}
==Checking your environment==
EiffelStudio requires GTK+ 2.4.0 or above to function properly. You can check that you have this installed correctly by typing the following command:
<code>pkg-config --modversion gtk+-2.0</code>
The command should succeed and the version number of GTK+ should appear. If it is not 2.4.0 or above then you cannot continue the installation of EiffelStudio. You first need to install GTK+ 2.4.0.
==Installing EiffelStudio from the Web==
After downloading the installation package, you should manually extract its contents to your hard drive. For example, you can extract it into /usr/local using the following commands (assuming that you have permission to /usr/local and that the installation package was saved in /tmp/EiffelXX.tar.bz2, where XX stands for the EiffelStudio version number):
<code>
cd /usr/local
tar xvfj /tmp/EiffelXX.tar.bz2</code>
This will install EiffelStudio files into /usr/local/EiffelXX. Once this is done, jump to the [[#Setting up EiffelStudio|Setting up EiffelStudio]] section in order to complete the installation of EiffelStudio.
==Installing EiffelStudio from a CD-ROM==
Insert the CD into your CD-ROM drive. You should manually extract its contents to your hard drive. For example you can extract it in /usr/local using the following commands (assuming that you have permission to /usr/local and that the CD is mounted on /mnt/cdrom):
<code>cd /usr/local
cp -r /mnt/cdrom/EiffelXX .</code>
This will install the EiffelStudio files into /usr/local/EiffelXX. To complete the installation of EiffelStudio, jump to the next section, [[#Setting up EiffelStudio|Setting up EiffelStudio]].
<span id="setting_up"></span>
==Setting up EiffelStudio==
Once the files have been installed, you should define the following environment variables in order to run EiffelStudio:
* '''ISE_EIFFEL''' to /usr/local/EiffelXX
* '''ISE_PLATFORM''' to hpux-11.
and add $'''ISE_EIFFEL'''/studio/spec/$'''ISE_PLATFORM'''/bin to your '''PATH''' environment variable.
Using sh or bash as a shell, it suffices to type the following commands:
<code>
export ISE_EIFFEL=/usr/local/EiffelXX
export ISE_PLATFORM=hpux-11
export PATH=$PATH:$ISE_EIFFEL/studio/spec/$ISE_PLATFORM/bin</code>
Using csh or tcsh as a shell, it suffices to type the following commands:
<code>
setenv ISE_EIFFEL /usr/local/EiffelXX
setenv ISE_PLATFORM hpux-11
set path = ($path $ISE_EIFFEL/studio/spec/$ISE_PLATFORM/bin)</code>
If you are using the Enterprise edition, please follow the instructions of the next section, [[#Registering the Enterprise Edition|Registering the Enterprise Edition]] , otherwise jump to the [[#Using EiffelStudio|Using EiffelStudio]] section at the end of this document.
<span id="registering"></span>
==Registering the Enterprise Edition==
This step assumes you have followed the instructions in the [[#Setting up EiffelStudio|Setting up EiffelStudio]] section. Perform the following commands to start the registration process:
<code>cd $ISE_EIFFEL
./register</code>
A dialog asking for your '''Username''' and '''CD Key''' should appear as it does below:
<center> [[Image:56--unix-setup|Setup dialog]] </center>
Enter the information located inside the box that contains your copy of the EiffelStudio Enterprise Edition. Once the information is correct, the '''Register''' button will be enabled. Click '''Register''' to actually register EiffelStudio.
The first time you launch EiffelStudio, you will be asked for an activation key through the following dialog:
<center> [[Image:56--unix-registration|Registration dialog]] </center>
By clicking on the [http://activate.eiffel.com http://activate.eiffel.com] URL, a new web browser will appear with the requested fields automatically filled in with the appropriate information. Simply click '''Activate''' and a new page with an activation code will appear. Copy and paste the activation code in the first field and the '''Activate''' button should be enabled to let you activate your copy.
You can activate your copy up to three times. Once you have reached this threshold and need to reinstall your copy, contact Eiffel Software to request one more activation.
If no web browser appears, it is most likely because firefox is not installed on your machine or is not in your path. Instead you should manually launch a new web browser, go to the page [http://activate.eiffel.com http://activate.eiffel.com] , and enter the information manually. Then follow the above instructions as if the browser had been properly launched.
You may receive the following dialog when launching EiffelStudio:
<center> [[Image:56--unix-registration-error|Registration incomplete]] </center>
This probably means that the '''register''' program was not launched or did not succeed in storing data to the following file $'''ISE_EIFFEL'''/install/limand/.ec_license. To solve this, rerun the '''register''' program with a user account that has permissions to write at $'''ISE_EIFFEL'''/install/limand and enter your '''Username''' and '''CD Key'''.
Once this is done, you can jump to the next section, [[#Using EiffelStudio|Using EiffelStudio]] .
<span id="using"></span>
==Using EiffelStudio==
===Starting EiffelStudio===
Now everything should be properly installed and you should be able to run the compiler. Launch '''estudio''' for the interactive graphical user interface of the compiler, or launch '''ec''' for the command line interface. If you are a new user to EiffelStudio, we recommend that you follow [[Introducing EiffelStudio|the EiffelStudio guided tour]].
===EiffelStudio Appearance===
EiffelStudio for Unix uses the GTK+ theme engine to allow for custom appearance such as changing the default font size and color of windows, etc. If you do not have a theme manager (such as that provided with Gnome) you can copy the .gtkrc-2.0 file from $'''ISE_EIFFEL'''/eifinit/studio/spec/gtk directory to your $'''HOME''' directory.

122
documentation/18.01/eiffelstudio/getting_started/setup-and-installation/software-installation-eiffelstudio/eiffelstudio-linux.wiki Normal file
View File

@@ -0,0 +1,122 @@
[[Property:title|Linux]]
[[Property:weight|4]]
[[Property:uuid|db132d4c-7c65-59c0-6f9f-731b81c37373]]
==Requirements==
{| class="doctable"
|-
| '''Computer/Processor'''
| x86 or x86-64, armv6
|-
| '''Operating System'''
| Ubuntu 8.04 or any Linux system with glibc 2.7 and GTK+ 2.4.
|-
| '''C compiler'''
| gcc or SunStudio 12 Linux compiler
|-
| '''Memory'''
| 4GB of RAM
|-
| '''Hard Disk'''
| 1GB of free space
|-
| '''ISE_PLATFORM'''
| '''linux-x86''' for x86 based CPU, '''linux-x86-64''' for x64 based CPU.
|}
==Checking your environment==
EiffelStudio requires GTK+ 2.4.0 or above to function properly. You can check that you have this installed correctly by typing the following command:
<code>pkg-config --modversion gtk+-2.0</code>
The command should succeed and the version number of GTK+ should appear. If it is not 2.4.0 or above then you cannot continue the installation of EiffelStudio. You first need to install GTK+ 2.4.0.
On some Linux distribution the Xtst library is required but not installed by default. You have to make sure it is installed by using the instruction of your Linux distribution.
For example, on Debian based distribution you need to do:
<code>
sudo apt-get install libgtk2.0-dev
sudo apt-get install libxtst-dev
</code>
==Installing EiffelStudio from the Web==
After downloading the installation package, you should manually extract its contents to your hard drive. For example, you can extract it into /usr/local using the following commands (assuming that you have permission to /usr/local and that the installation package was saved in /tmp/EiffelXX.tar.bz2, where XX stands for the EiffelStudio version):
<code>
cd /usr/local
tar xvfj /tmp/EiffelXX.tar.bz2</code>
This will install EiffelStudio files into /usr/local/EiffelXX. Once this is done, jump to the [[#Setting up EiffelStudio|Setting up EiffelStudio]] section in order to complete the installation of EiffelStudio.
==Installing EiffelStudio from a CD-ROM==
Insert the CD into your CD-ROM drive. You should manually extract its contents to your hard drive. For example you can extract it in /usr/local using the following commands (assuming that you have permission to /usr/local and that the CD is mounted on /mnt/cdrom):
<code>cd /usr/local
cp -r /mnt/cdrom/EiffelXX .</code>
This will install the EiffelStudio files into /usr/local/EiffelXX. To complete the installation of EiffelStudio, jump to the next section, [[#Setting up EiffelStudio|Setting up EiffelStudio]].
<span id="setting_up"></span>
==Setting up EiffelStudio==
Once the files have been installed, you should define the following environment variables in order to run EiffelStudio:
* '''ISE_EIFFEL''' to /usr/local/EiffelXX
* '''ISE_PLATFORM''' to linux-x86 for the 32 bits version or linux-x86-64 for the 64 bits version. We will be using '''linux-x86''' in the examples below.
and add $'''ISE_EIFFEL'''/studio/spec/$'''ISE_PLATFORM'''/bin to your '''PATH''' environment variable.
Using sh or bash as a shell, it suffices to type the following commands:
<code>
export ISE_EIFFEL=/usr/local/EiffelXX
export ISE_PLATFORM=linux-x86
export PATH=$PATH:$ISE_EIFFEL/studio/spec/$ISE_PLATFORM/bin</code>
Using csh or tcsh as a shell, it suffices to type the following commands:
<code>
setenv ISE_EIFFEL /usr/local/EiffelXX
setenv ISE_PLATFORM linux-x86
set path = ($path $ISE_EIFFEL/studio/spec/$ISE_PLATFORM/bin)</code>
If you are using the Enterprise edition, please follow the instructions of the next section, [[#Registering the Enterprise Edition|Registering the Enterprise Edition]], otherwise jump to the [[#Using EiffelStudio|Using EiffelStudio]] section at the end of this document.
<span id="registering"></span>
==Registering the Enterprise Edition==
This step assumes you have followed the instructions in the [[#Setting up EiffelStudio|Setting up EiffelStudio]] section. Perform the following commands to start the registration process:
<code>cd $ISE_EIFFEL
./register</code>
A dialog asking for your '''Username''' and '''CD Key''' should appear as it does below:
<center> [[Image:56--unix-setup|Setup dialog]] </center>
Enter the information located inside the box that contains your copy of the EiffelStudio Enterprise Edition. Once the information is correct, the '''Register''' button will be enabled. Click '''Register''' to actually register EiffelStudio.
The first time you launch EiffelStudio, you will be asked for an activation key through the following dialog:
<center> [[Image:56--unix-registration|Registration dialog]] </center>
By clicking on the [http://activate.eiffel.com http://activate.eiffel.com] URL, a new web browser will appear with the requested fields automatically filled in with the appropriate information. Simply click '''Activate''' and a new page with an activation code will appear. Copy and paste the activation code in the first field and the '''Activate''' button should be enabled to let you activate your copy.
You can activate your copy up to three times. Once you have reached this threshold and need to reinstall your copy, contact Eiffel Software to request one more activation.
If no web browser appears, it is most likely because firefox is not installed on your machine or is not in your path. Instead you should manually launch a new web browser, go to the page [http://activate.eiffel.com http://activate.eiffel.com] , and enter the information manually. Then follow the above instructions as if the browser had been properly launched.
You may receive the following dialog when launching EiffelStudio:
<center> [[Image:56--unix-registration-error|Registration incomplete]] </center>
This probably means that the '''register''' program was not launched or did not succeed in storing data to the following file $'''ISE_EIFFEL'''/install/limand/.ec_license. To solve this, rerun the '''register''' program with a user account that has permissions to write at $'''ISE_EIFFEL'''/install/limand and enter your '''Username''' and '''CD Key'''.
Once this is done, you can jump to the next section, [[#Using EiffelStudio|Using EiffelStudio]] .
<span id="using"></span>
==Using EiffelStudio==
===Starting EiffelStudio===
Now everything should be properly installed and you should be able to run the compiler. Launch '''estudio''' for the interactive graphical user interface of the compiler, or launch '''ec''' for the command line interface. If you are a new user to EiffelStudio, we recommend that you follow [[Introducing EiffelStudio|the EiffelStudio guided tour]].
===EiffelStudio Appearance===
EiffelStudio for Unix uses the GTK+ theme engine to allow for custom appearance such as changing the default font size and color of windows, etc. If you do not have a theme manager (such as that provided with Gnome) you can copy the .gtkrc-2.0 file from $'''ISE_EIFFEL'''/eifinit/studio/spec/gtk directory to your $'''HOME''' directory.

82
documentation/18.01/eiffelstudio/getting_started/setup-and-installation/software-installation-eiffelstudio/eiffelstudio-mac-os-x.wiki Normal file
View File

@@ -0,0 +1,82 @@
[[Property:title|Mac OS X]]
[[Property:weight|5]]
[[Property:uuid|7cf4e0e5-0858-58bb-351e-52becea59ede]]
==Requirements==
{| class="doctable"
|-
| '''Computer/Processor'''
| x86-64
|-
| '''Operating System'''
| Mac OS X 10.12 or above
|-
| '''C compiler'''
| Xcode 8.2 or greater
|-
| '''Memory'''
| 4GB of RAM
|-
| '''Hard Disk'''
| 1GB of free space
|-
| '''ISE_PLATFORM'''
| '''macosx-x86''' for x86 based CPU and '''macosx-x86-64''' for x64 based CPU.
|}
==Prerequisites==
*You will need to install '''Xcode''' from the App Store.After installing Xcode, make sure to install the command line tools by going to the Xcode preferences and under '''Downloads''' install the '''Command Line Tools''' components.
*You also need to install X11 from http://xquartz.macosforge.org.
==Installing the GPL Edition==
MacPorts is a tool that allows you to use many Unix applications on the Mac. We have created a package in the MacPorts repository that allows you to to install Eiffel Studio with all dependencies in a convenient way. First, install [http://guide.macports.org/#installing MacPorts].
Now simply type (from a bash [http://guides.macrumors.com/Terminal terminal]):
<pre>
sudo port install eiffelstudio
</pre>
When a new release of the same version EiffelStudio becomes available, you can upgrade like so:
<pre>
sudo port selfupdate
sudo port upgrade outdated
</pre>
==Installing EiffelStudio from a compressed package==
This section only applies if you have installed all the required prerequisites. If you are not sure, use the installation from MacPorts as described in the previous section.
After downloading the compressed package, you should manually extract its contents to your hard drive. For example, you can extract it into /usr/local using the following commands (assuming that you have permission to /usr/local and that the installation package was saved in /tmp/Eiffel_X.Y.tar.bz2, where X.Y stands for the EiffelStudio version):
<code>
cd /usr/local
tar xvfj /tmp/Eiffel_X.Y.tar.bz2</code>
This will install EiffelStudio files into `/usr/local/Eiffel_X.Y` . Once this is done, jump to the [[#Setting up EiffelStudio|Setting up EiffelStudio]] section in order to complete the installation of EiffelStudio.
== Setting up EiffelStudio ==
Once the files have been installed, you should define the following environment variables in order to run EiffelStudio:
* ISE_EIFFEL to `/usr/local/Eiffel_X.Y`
* ISE_PLATFORM to `macosx-x86` for the 32 bits version or `macosx-x86-64` for the 64 bits version. We will be using `macosx-x86-64` in the examples below.
and add `$ISE_EIFFEL/studio/spec/$ISE_PLATFORM/bin` to your PATH environment variable.
Using sh or bash as a shell, it suffices to type the following commands:
```shell
export ISE_EIFFEL=/usr/local/Eiffel_X.Y
export ISE_PLATFORM=macosx-x86-64
export PATH=$PATH:$ISE_EIFFEL/studio/spec/$ISE_PLATFORM/bin
```
(Note: you can write this into your .profile file).
== Starting EiffelStudio ==
Now everything should be properly installed and you should be able to run the compiler. Simply navigate to /Applications/MacPorts/Eiffel''XX'' and double click the EiffelStudio icon.
Alternatively, you can also start EiffelStudio from the command line by entering the command '''estudio''' or use the command-line eiffel compiler '''ec'''.
If you are a new user to EiffelStudio, we recommend that you follow [[Introducing EiffelStudio|the EiffelStudio guided tour]].

113
documentation/18.01/eiffelstudio/getting_started/setup-and-installation/software-installation-eiffelstudio/eiffelstudio-sgi-irix.wiki Normal file
View File

@@ -0,0 +1,113 @@
[[Property:title|SGI Irix]]
[[Property:weight|7]]
[[Property:uuid|f8de85e3-0786-071c-3ece-bbde6656dc20]]
==Requirements==
{| class="doctable"
|-
| '''Computer/Processor'''
| MIPS.
|-
| '''Operating System'''
| Irix 6.5 with either Gnome 2.6 or GTK+ 2.4.
|-
| '''C compiler'''
| MIPSPro C compiler V2.4 or later.
|-
| '''Memory'''
| 4GB of RAM
|-
| '''Hard Disk'''
| 1GB of free space
|-
| '''ISE_PLATFORM'''
| '''irix-mips''' for 32 bits, '''irix-mips-64''' for 64 bits.
|}
==Checking your environment==
EiffelStudio requires GTK+ 2.4.0 or above to function properly. You can check that you have this installed correctly by typing the following command:
<code>pkg-config --modversion gtk+-2.0</code>
The command should succeed and the version number of GTK+ should appear. If it is not 2.4.0 or above then you cannot continue the installation of EiffelStudio. You first need to install GTK+ 2.4.0.
==Installing EiffelStudio from the Web==
After downloading the installation package, you should manually extract its contents to your hard drive. For example, you can extract it into /usr/local using the following commands (assuming that you have permission to /usr/local and that the installation package was saved in /tmp/EiffelXX.tar.bz2, where XX stands for the EiffelStudio version):
<code>
cd /usr/local
tar xvfj /tmp/EiffelXX.tar.bz2</code>
This will install EiffelStudio files into /usr/local/EiffelXX. Once this is done, jump to the [[#Setting up EiffelStudio|Setting up EiffelStudio]] section in order to complete the installation of EiffelStudio.
==Installing EiffelStudio from a CD-ROM==
Insert the CD into your CD-ROM drive. You should manually extract its contents to your hard drive. For example you can extract it in /usr/local using the following commands (assuming that you have permission to /usr/local and that the CD is mounted on /mnt/cdrom):
<code>cd /usr/local
cp -r /mnt/cdrom/EiffelXX .</code>
This will install the EiffelStudio files into /usr/local/EiffelXX. To complete the installation of EiffelStudio, jump to the next section, [[#Setting up EiffelStudio|Setting up EiffelStudio]].
<span id="setting_up"></span>
==Setting up EiffelStudio==
Once the files have been installed, you should define the following environment variables in order to run EiffelStudio:
* '''ISE_EIFFEL''' to /usr/local/EiffelXX
* '''ISE_PLATFORM''' to irix-mips for the 32 bits version or irix-mips-64 for the 64 bits version. We will be using '''irix-mips''' in the examples below.
and add $'''ISE_EIFFEL'''/studio/spec/$'''ISE_PLATFORM'''/bin to your '''PATH''' environment variable.
Using sh or bash as a shell, it suffices to type the following commands:
<code>
export ISE_EIFFEL=/usr/local/EiffelXX
export ISE_PLATFORM=irix-mips
export PATH=$PATH:$ISE_EIFFEL/studio/spec/$ISE_PLATFORM/bin</code>
Using csh or tcsh as a shell, it suffices to type the following commands:
<code>
setenv ISE_EIFFEL /usr/local/EiffelXX
setenv ISE_PLATFORM irix-mips
set path = ($path $ISE_EIFFEL/studio/spec/$ISE_PLATFORM/bin)</code>
If you are using the Enterprise edition, please follow the instructions of the next section, [[#Registering the Enterprise Edition|Registering the Enterprise Edition]], otherwise jump to the [[#Using EiffelStudio|Using EiffelStudio]] section at the end of this document.
<span id="registering"></span>
==Registering the Enterprise Edition==
This step assumes you have followed the instructions in the [[#Setting up EiffelStudio|Setting up EiffelStudio]] section. Perform the following commands to start the registration process:
<code>cd $ISE_EIFFEL
./register</code>
A dialog asking for your '''Username''' and '''CD Key''' should appear as it does below:
<center> [[Image:56--unix-setup|Setup dialog]] </center>
Enter the information located inside the box that contains your copy of the EiffelStudio Enterprise Edition. Once the information is correct, the '''Register''' button will be enabled. Click '''Register''' to actually register EiffelStudio.
The first time you launch EiffelStudio, you will be asked for an activation key through the following dialog:
<center> [[Image:56--unix-registration|Registration dialog]] </center>
By clicking on the [http://activate.eiffel.com http://activate.eiffel.com] URL, a new web browser will appear with the requested fields automatically filled in with the appropriate information. Simply click '''Activate''' and a new page with an activation code will appear. Copy and paste the activation code in the first field and the '''Activate''' button should be enabled to let you activate your copy.
You can activate your copy up to three times. Once you have reached this threshold and need to reinstall your copy, contact Eiffel Software to request one more activation.
If no web browser appears, it is most likely because firefox is not installed on your machine or is not in your path. Instead you should manually launch a new web browser, go to the page [http://activate.eiffel.com http://activate.eiffel.com] , and enter the information manually. Then follow the above instructions as if the browser had been properly launched.
You may receive the following dialog when launching EiffelStudio:
<center> [[Image:56--unix-registration-error|Registration incomplete]] </center>
This probably means that the '''register''' program was not launched or did not succeed in storing data to the following file $'''ISE_EIFFEL'''/install/limand/.ec_license. To solve this, rerun the '''register''' program with a user account that has permissions to write at $'''ISE_EIFFEL'''/install/limand and enter your '''Username''' and '''CD Key'''.
Once this is done, you can jump to the next section, [[#Using EiffelStudio|Using EiffelStudio]].
<span id="using"></span>
==Using EiffelStudio==
===Starting EiffelStudio===
Now everything should be properly installed and you should be able to run the compiler. Launch '''estudio''' for the interactive graphical user interface of the compiler, or launch '''ec''' for the command line interface. If you are a new user to EiffelStudio, we recommend that you follow [[Introducing EiffelStudio|the EiffelStudio guided tour]].
===EiffelStudio Appearance===
EiffelStudio for Unix uses the GTK+ theme engine to allow for custom appearance such as changing the default font size and color of windows, etc. If you do not have a theme manager (such as that provided with Gnome) you can copy the .gtkrc-2.0 file from $'''ISE_EIFFEL'''/eifinit/studio/spec/gtk directory to your $'''HOME''' directory.

116
documentation/18.01/eiffelstudio/getting_started/setup-and-installation/software-installation-eiffelstudio/eiffelstudio-solaris.wiki Normal file
View File

@@ -0,0 +1,116 @@
[[Property:title|Solaris]]
[[Property:weight|8]]
[[Property:uuid|3b85b8dc-c2b8-021a-f4bc-a8d19ad63b81]]
==Requirements==
{| class="doctable"
|-
| '''Computer/Processor'''
| UltraSparc, x86 or x86-64
|-
| '''Operating System'''
| Solaris 9.0 or greater for UltraSparc, Solaris 10 or greater for x86 and x86-64 with either Gnome 2.6 or GTK+ 2.4.
|-
| '''C compiler'''
| Sun Studio 12 C compiler
|-
| '''Memory'''
| 4GB of RAM
|-
| '''Hard Disk'''
| 1GB of free space
|-
| '''ISE_PLATFORM'''
| '''solaris-sparc''' for 32 bits version of Solaris on Sparc processor, '''solaris-sparc-64''' for 64 bits versions, '''solaris-x86''' and '''solaris-x86-64''' for the Intel processor on 32 and 64 bits.
|}
==Checking your environment==
EiffelStudio requires GTK+ 2.4.0 or above to function properly. You can check that you have this installed correctly by typing the following command:
<code>pkg-config --modversion gtk+-2.0</code>
The command should succeed and the version number of GTK+ should appear. If it is not 2.4.0 or above then you cannot continue the installation of EiffelStudio. You first need to install GTK+ 2.4.0.
EiffelStudio requires the library file <code>libmlib.so.2</code>. If this file is missing from your Solaris installation, you can install it by installing <code>medialib</code>.
==Installing EiffelStudio from the Web==
After downloading the installation package, you should manually extract its contents to your hard drive. For example, you can extract it into /usr/local using the following commands (assuming that you have permission to /usr/local and that the installation package was saved in /tmp/EiffelXX.tar.bz2, where XX stands for the EiffelStudio version):
<code>
cd /usr/local
tar xvfj /tmp/EiffelXX.tar.bz2</code>
This will install EiffelStudio files into /usr/local/EiffelXX. Once this is done, jump to the [[#Setting up EiffelStudio|Setting up EiffelStudio]] section in order to complete the installation of EiffelStudio.
==Installing EiffelStudio from a CD-ROM==
Insert the CD into your CD-ROM drive. You should manually extract its contents to your hard drive. For example you can extract it in /usr/local using the following commands (assuming that you have permission to /usr/local and that the CD is mounted on /mnt/cdrom):
<code>cd /usr/local
cp -r /mnt/cdrom/EiffelXX .</code>
This will install the EiffelStudio files into /usr/local/EiffelXX. To complete the installation of EiffelStudio, jump to the next section, [[#Setting up EiffelStudio|Setting up EiffelStudio]] .
<span id="setting_up"></span>
==Setting up EiffelStudio==
Once the files have been installed, you should define the following environment variables in order to run EiffelStudio:
* '''ISE_EIFFEL''' to /usr/local/EiffelXX
* '''ISE_PLATFORM''' to solaris-sparc for the 32 bits version or solaris-sparc-64 for the 64 bits version, respectively solaris-x86 and solaris-x86-64 for Solaris on Intel processors. We will be using '''solaris-sparc''' in the examples below.
and add $'''ISE_EIFFEL'''/studio/spec/$'''ISE_PLATFORM'''/bin to your '''PATH''' environment variable.
Using sh or bash as a shell, it suffices to type the following commands:
<code>
export ISE_EIFFEL=/usr/local/EiffelXX
export ISE_PLATFORM=solaris-sparc
export PATH=$PATH:$ISE_EIFFEL/studio/spec/$ISE_PLATFORM/bin</code>
Using csh or tcsh as a shell, it suffices to type the following commands:
<code>
setenv ISE_EIFFEL /usr/local/EiffelXX
setenv ISE_PLATFORM solaris-sparc
set path = ($path $ISE_EIFFEL/studio/spec/$ISE_PLATFORM/bin)</code>
If you are using the Enterprise edition, please follow the instructions of the next section, [[#Registering the Enterprise Edition|Registering the Enterprise Edition]] , otherwise jump to the [[#Using EiffelStudio|Using EiffelStudio]] section at the end of this document.
<span id="registering"></span>
==Registering the Enterprise Edition==
This step assumes you have followed the instructions in the [[#Setting up EiffelStudio|Setting up EiffelStudio]] section. Perform the following commands to start the registration process:
<code>cd $ISE_EIFFEL
./register</code>
A dialog asking for your '''Username''' and '''CD Key''' should appear as it does below:
<center> [[Image:56--unix-setup|Setup dialog]] </center>
Enter the information located inside the box that contains your copy of the EiffelStudio Enterprise Edition. Once the information is correct, the '''Register''' button will be enabled. Click '''Register''' to actually register EiffelStudio.
The first time you launch EiffelStudio, you will be asked for an activation key through the following dialog:
<center> [[Image:56--unix-registration|Registration dialog]] </center>
By clicking on the [http://activate.eiffel.com http://activate.eiffel.com] URL, a new web browser will appear with the requested fields automatically filled in with the appropriate information. Simply click '''Activate''' and a new page with an activation code will appear. Copy and paste the activation code in the first field and the '''Activate''' button should be enabled to let you activate your copy.
You can activate your copy up to three times. Once you have reached this threshold and need to reinstall your copy, contact Eiffel Software to request one more activation.
If no web browser appears, it is most likely because firefox is not installed on your machine or is not in your path. Instead you should manually launch a new web browser, go to the page [http://activate.eiffel.com http://activate.eiffel.com] , and enter the information manually. Then follow the above instructions as if the browser had been properly launched.
You may receive the following dialog when launching EiffelStudio:
<center> [[Image:56--unix-registration-error|Registration incomplete]] </center>
This probably means that the '''register''' program was not launched or did not succeed in storing data to the following file $'''ISE_EIFFEL'''/install/limand/.ec_license. To solve this, rerun the '''register''' program with a user account that has permissions to write at $'''ISE_EIFFEL'''/install/limand and enter your '''Username''' and '''CD Key'''.
Once this is done, you can jump to the next section, [[#Using EiffelStudio|Using EiffelStudio]] .
<span id="using"></span>
==Using EiffelStudio==
===Starting EiffelStudio===
Now everything should be properly installed and you should be able to run the compiler. Launch '''estudio''' for the interactive graphical user interface of the compiler, or launch '''ec''' for the command line interface. If you are a new user to EiffelStudio, we recommend that you follow [[Introducing EiffelStudio|the EiffelStudio guided tour]].
===EiffelStudio Appearance===
EiffelStudio for Unix uses the GTK+ theme engine to allow for custom appearance such as changing the default font size and color of windows, etc. If you do not have a theme manager (such as that provided with Gnome) you can copy the .gtkrc-2.0 file from $'''ISE_EIFFEL'''/eifinit/studio/spec/gtk directory to your $'''HOME''' directory.

5
documentation/18.01/eiffelstudio/getting_started/setup-and-installation/software-installation-eiffelstudio/index.wiki Normal file
View File

@@ -0,0 +1,5 @@
[[Property:title|Software Installation for EiffelStudio]]
[[Property:weight|0]]
[[Property:uuid|b92cecd4-4a0c-e2f5-b63e-5d01d39ba990]]
Select the operating system you are using for detailed installation instructions:

63
documentation/18.01/eiffelstudio/getting_started/setup-and-installation/software-installation-eiffelstudio/windows.wiki Normal file
View File

@@ -0,0 +1,63 @@
[[Property:title|Windows]]
[[Property:weight|9]]
[[Property:uuid|d177e0bc-63e6-63b3-7fdb-5e7136945e21]]
==Requirements==
{| class="doctable"
|-
| '''Computer/Processor'''
| x86 or x86-64
|-
| '''Operating System'''
| Windows 7, Windows 8, Windows 8.1 and Windows 10
|-
| '''C compiler'''
| Microsoft Visual Studio 2010 or greater, or using MinGW (gcc) included in the EiffelStudio delivery
|-
| '''Memory'''
| 4GB of RAM
|-
| '''Hard Disk'''
| 1GB of free space.
|-
| '''ISE_PLATFORM'''
| '''windows''' for 32 bits version of Windows, '''win64''' for 64 bits version of Windows.
|}
==Installing EiffelStudio from the Web==
After downloading the '''EiffelXX.msi''' installation package, right click on it and select '''Install'''. This will launch the installation procedure. Follow the steps indicated in the dialogs to complete the installation.
==Installing the Enterprise Edition.==
Insert the CD into your CD-ROM drive. If you have the autorun facility enabled, the installation process will automatically be launched. Otherwise you can launch it by executing '''EiffelXX.msi''' located at the root of the CD. During the installation you will be asked for your '''Username''' and '''CD Key'''
Enter the information located inside the box that contains your copy of the EiffelStudio Enterprise Edition, or that you will have received via email. Once the information is correct, the '''Next''' button will be enabled. Click '''Next''' and follow the steps indicated in the dialogs to complete the installation.
Once installed, the first time you launch EiffelStudio, you will be asked for an activation key through the following dialog:
<center> [[Image:56--windows-registration|Registration dialog]] </center>
By clicking on the [http://activate.eiffel.com http://activate.eiffel.com] URL, a new web browser will appear with the requested fields automatically filled in with the appropriate information. Simply click '''Activate''' and a new page with an activation code will appear. Copy and paste the activation code in the first field and the '''Activate''' button should be enabled to let you activate your copy.
You can activate your copy up to three times. Once you have reached this threshold and need to reinstall your copy, contact Eiffel Software to request one more activation.
You may receive the following dialog when launching EiffelStudio:
<center> [[Image:56--windows-registration-error|Registration incomplete]] </center>
This probably means that EiffelStudio was not properly installed using the '''setup.exe''' program. Uninstall EiffelStudio and rerun the installation procedure by making sure to launch '''setup.exe''' and enter your '''Username''' and '''CD Key'''.
==.NET Support==
To enable .NET support in EiffelStudio, it is necessary to install the Microsoft .NET Framework prior to starting the installation of EiffelStudio. EiffelStudio currently supports all the versions of the .NET Framework up to 4.0.
==What about Windows 95, 98 and Me?==
EiffelStudio will not run on Windows 95, 98 and Me. Contact Eiffel Software directly if you need support for those OSes. EiffelStudio generated code could run on 95, 98 and Me if no UI is being used. If the UI is used it could run but it requires installing the Microsoft Layer for Unicode.
==Starting EiffelStudio==
Now everything should be properly installed and you should be able to run the compiler. You can now launch EiffelStudio from the Start menu or from the EiffelStudio shortcut on your desktop. If you are a new user to EiffelStudio, we recommend that you follow [[Introducing EiffelStudio|the EiffelStudio guided tour]].

11
documentation/18.01/eiffelstudio/getting_started/setup-and-installation/third-party-tools-installation-help.wiki Normal file
View File

@@ -0,0 +1,11 @@
[[Property:title|Third Party Tools Installation Help]]
[[Property:weight|1]]
[[Property:uuid|5896dc5f-a3dd-2535-e2c3-81593363d8e9]]
Here you can find help for installing third party tools and programs which may be necessary for your Eiffel programming needs.
==[http://dev.eiffel.com/Installing_Microsoft_C_compiler Free Microsoft C Compiler ]==