📄 How to Install Euphoria on Windows


Download and run the latest Euphoria setup program. It will install Euphoria on any Windows system from Windows 95 up.

After installing, see doc\what2do.doc (or html\what2do.htm) for ideas on how to use this package. You should also read readme.doc (or readme.htm) if you haven't done so already.


Possible problems ...
---------------------

How to manually edit autoexec.bat (WinME/98/95/3.1)
----------------------------------------------------
  1. In the file c:\autoexec.bat add C:\EUPHORIA\BIN to the list of directories in your PATH command. You might use the MS-DOS Edit command, Windows Notepad or any other text editor to do this.

    You can also go to the Start Menu, select Run, type in sysedit and press Enter. autoexec.bat should appear as one of the system files that you can edit and save.

  2. In the same autoexec.bat file add a new line:

        SET EUDIR=C:\EUPHORIA

    The EUDIR environment variable indicates the full path to the main Euphoria directory.

  3. Reboot (restart) your machine. This will define your new PATH and EUDIR environment variables.

On WinNT/2000/XP and higher, if for some reason your EUDIR and PATH variables are not set correctly, then set them in whatever way your system allows. For example on Windows XP select: Start Menu -> Control Panel -> Performance &Maintenance -> System -> Advanced then click the "Environment Variables" button. Click the top "New..." button then enter EUDIR as the Variable Name and c:\euphoria (or whatever is correct) for the value, then click OK. Find PATH in the list of your variables, select it, then click "Edit...". Add ;c:\euphoria\bin at the end and click OK.

Some systems, such as Windows ME, have an autoexec.bat file, but it's a hidden file that might not show up in a directory listing. Nevertheless it's there, and you can view it and edit it if necessary by typing, for example: notepad c:\autoexec.bat in a DOS window.

If you have an autoexec.bat file, but it doesn't contain a PATH command, you will have to create one that includes C:\EUPHORIA\BIN.

There is another, optional, environment variable used by some experienced users of Euphoria. It is called EUINC (see http://www.rapideuphoria.com/cgi-bin/guru.exu?refDoc=on &libDoc=on&otherDoc=on&keywords=euinc ). It determines the search path for included files. You might want to add it, or change it, when you install a new version of Euphoria.


WIN32 + DOS32 Note:
-------------------

The setup program will give you: an interpreter for Windows (Vista/XP/NT/ 2000/ME/98/95), a translator for Windows, an interpreter for DOS, a translator for DOS, the complete Euphoria Reference Manual, the Public Domain source code, and numerous example programs.

Simply download the setup program, e31setup.exe, and double-click it. To complete the installation, you need to re-boot your machine.

After installing Euphoria, you will not find a Euphoria icon on your screen. Instead you should refer to section 1.3 of the manual for the various ways of running Euphoria programs on Windows and DOS. (After re-booting, you should be able to double-click the .ex and .exw files in euphoria\demo, to run them.)

If you are running Euphoria on Windows-10 then you can't use ex.exe interpreter, since Windows-10 don't support 16-bit applications. Instead, you should use exwc.exe or exw.exe. You may need to modify some batch files, such as "search.bat" and "ed.bat" to use exwc.exe instead of ex.exe.


How to Uninstall Euphoria
=========================
  1. If you wish to recover your previous version of Euphoria, or parts of it, the "backup" subdirectory contains a backup copy of each of your previous standard Euphoria subdirectories, plus any files that you may have added. However it does not contain any additional subdirectories that you may have created on your own.
  2. If there are no files that you need, you can delete the EUPHORIA directory that you installed into.
  3. Delete the EUDIR environment variable, and remove the EUPHORIA directory from your PATH, either in C:\AUTOEXEC.BAT, or in Control Panel/System/Advanced.
  4. Delete the references to EUPHORIA in your Start Menu.

📄 How to Install Euphoria on Linux or FreeBSD


Now that you've run tar to create the euphoria directory, you need to:
  1. add euphoria/bin to your PATH
  2. create an environment variable: EUDIR
To view the hidden files in your home directory, type:

  ls -a

One or more of these files is executed when you log in. For instance, if you have a hidden profile file such as ".bash_profile", you can edit the line:

  PATH=...

and add euphoria/bin to it.

For example, a user called rob might do the following:

  PATH=/home/rob/euphoria/bin:$PATH

You must also add a line for the variable EUDIR such as:

  EUDIR=/home/rob/euphoria

And remember to export these variables, by adding this line:

  export PATH EUDIR

euphoria/bin doesn't have to be first on your PATH, but if it isn't you'll have to rename the "ed" shell script in euphoria/bin, and perhaps a few others.

Alternatively, system administrators can put EUDIR and the PATH change into a global file, such as /etc/profile, so many users will be able to access the Euphoria interpreter.


Linux euphor31.tar (really .tgz) + FreeBSD note:
------------------------------------------------

Right-click and choose Save Target As...

Everything you need is contained in euphor31.tar: an interpreter for Linux, a translator for Linux, the Public Domain source code, the complete Euphoria Reference Manual, and numerous example programs.

On Linux type:

    tar -xvz -f euphor31.tar

A euphoria subdirectory will be created in the current directory. See readme.doc and installu.doc located inside the euphoria subdirectory.

Note: the file type should really be .tgz or .tar.gz but these types cause problems with some browsers. If you use WinZip to view or extract the files, you must first rename "euphor31.tar" as "euphor31.tgz", or you'll get an error... On Linux (or FreeBSD), when extracting the files using tar, the z option is essential, unless you first decompress with: gunzip euphor31.tgz


Other Notes:
------------

FreeBSD:
--------

The instructions for FreeBSD are the same as for Linux (above), however to install Euphoria on a FreeBSD system (with Intel CPU), use the FreeBSD compressed tar file. It's a complete tar file for the euphoria directory and all subdirectories.

Most of the files are the same as Linux, except for the executable files: exu, ecu, backendu. There's also a different version of ed.ex, and the euphoria/source files have been tweaked in a couple of places to save you time.

📄 How to run Euphoria 3.1.1 on 64-bit Linux


Problem:

When you try to run Euphoria 3.1.1 on 64-bit Linux you may get the message:

   bash: ./exu: No such file or directory

This is because Euphoria 3.1.1 needs the i386 32-bit libraries for 64-bit Linux system.


Solution:

So you have to install the i386 32-bit libraries...

On a 64-bit Linux Ubuntu/Linux Mint system, type in bash shell:

   sudo apt-get install ia32-libs-multiarch

If the above does not work, type:

   sudo apt-get install ia32-libs

Tip by 'useful':
If you do not wish to install all the packages from multiple architectures, the i386 32-bit libraries above, then a single library is suffice to run only Euphoria 3.1.1 (I've tested it on Linux Mint version 19.2, 30/10/2019, and it works great), type:

   sudo apt-get install libc6-i386

Notes:


For C programmers...

How to compile a c file into a 32-bit shared library,
on a 64-bit Linux (Ubuntu/Linux Mint), for Euphoria 3.1.1 open_dll():
---------------------------------------------------------------------

Problem:

When you try to compile 'euphoria/demo/linux/Mylib.c' into a shared library, on a 64-bit Linux, with:

     gcc -shared Mylib.c -o mylib.so

you may get the following or a similar message:

   /usr/bin/ld: /tmp/cc1RfzVM.o: relocation R_X86_64_PC32 against
   symbol `extra' can not be used when making a shared object;
   recompile with -fPIC
   /usr/bin/ld: final link failed: Bad value
   collect2: error: ld returned 1 exit status

This is because gcc needs the i386 32-bit libraries for 64-bit Linux system.


Solution:

So you have to install the gcc i386 32-bit libraries...

On a 64-bit Linux Ubuntu/Linux Mint system, type in bash shell:


First install gcc libraries (if not already installed):

    sudo apt-get install build-essential

Install gcc 32-bit libraries:

    sudo apt-get install gcc-multilib


Then use the -m32 flag to compile your file into a shared library:

    gcc -m32 -shared Mylib.c -o mylib.so


Now you can run 'euphoria/demo/linux/mylib.exu' using mylib.so.

Shian.