   System Configuration

   System customisation is performed thanks to the "system.se" file which
   must be in the sub-directory "sys" of the installation directory.

   When  the  system  name  is  correctly  set  in  the file "system.se",
   SmartEiffel  performs  some  automatic customisations. For example, if
   the  "system.se"  file contains the string "DOS", SmartEiffel uses the
   suffix  ".BAT"  for script files and the suffix ".EXE" for executables
   files.

   The  "sys"  directory  contains various files to customise SmartEiffel
   with  the  system,  the  C compiler and the linker used as well as the
   default loadpath used to look for Eiffel source code.

   The SmartEiffel Environment Variable

   Environment variable SmartEiffel must be set with the absolute path of
   the  file  "system.se"  which  is  in  the  sub-directory "sys" of the
   installation directory.
   Under  a  UNIX-like  system,  the value of the SmartEiffel environment
   variable may be for example: /usr/lib/SmartEiffel/sys/system.se
   The  contents  of  the file "system.se" indicate the [1]system you are
   running.

   File system.se

   The  first  word  of  file  "system.se" is used by SmartEiffel to know
   which operating system is running. Currently supported values are:

   UNIX      for all UNIX-like systems, GNU/Linux, HP-UX, Solaris, SunOS,
             Irix, XENIX, etc.
   Windows   for Windows 95 and Windows NT systems (using long filenames).
   DOS       for MS-DOS systems or Windows 3.x (using short filenames, with 8.3
             scheme).
   Macintosh for Macintosh systems (68K and PPC)
   BeOS      for the BeOS system
   Amiga     for the Amiga system
   OS2       for IBM OS/2 systems
   VMS       for the VMS systems

   You  must  choose the appropriate system name in the previous list and
   update  file  "system.se".  To  be  sure  that  the  previous  list is
   up-to-date,  just  put  a  bad system name in the file "system.se" and
   then run for example command compile.

   The   system   name   will  then  be  used  to  access  various  files
   corresponding  to  the  system you chose. For example, if you declared
   "Windows",  only  files  with  extension  "Windows" will be considered
   (e.g.     files     like    "loadpath.Windows",    "compiler.Windows",
   "linker.Windows", etc...).

   File compiler.se

   This  file  is used to select the default C compiler that will be used
   to  compile  the generated C code. Only the first line of this file is
   considered;  it  must  contain  the  name  of  one  of  the  supported
   compilers, which at the current time are:

   gcc The free and open-source GNU C Compiler and its variants (egcs,
   mingw32, etc.) on several platforms (Linux and other UNIXes, Windows).
   cc The standard cc compiler, as provided by vendors of most UNIX and
   VMS systems.
   lcc-win32 The free port of lcc for Windows platforms.
   bcc32 The Borland (now Inprise) C/C++ compiler on Windows platforms.
   bcc32i A variant of the previous one.
   wcl386 The Watcom C/C++ compiler for Windows platforms.
   cl The MicroSoft C/C++ compiler for Windows platforms.
   sas_c The SAS C compiler, sc on Amiga platforms.
   dice The dice C compiler.
   vbcc The vbcc C compiler.
   ccc The Compaq C compiler for AlphaLinux.
   sc ??
   vpcc ??
   OpenVMS_CC ??
   tcc The Tiny C Compiler. Fast and small (Windows or Linux)

   SmartEiffel  will  automatically  generate  the correct system call to
   this C compiler, with the appropriate linker and adequate object files
   suffix.
   In case an unknown compiler name is supplied, SmartEiffel generates an
   error  message  listing  the  supported  compiler  names.  In case the
   compiler  specified  is  a correct one but can't be found, SmartEiffel
   won't  be  able  to detect it, but there will be an error message from
   the  system. In -verbose mode, the systems calls to the C compiler are
   displayed, thus making it easy to find such errors.

   Changing the Default Loading Path

   All  the  commands  use the same algorithm to search for Eiffel source
   files.  The  default global loading path is set using contents of file
   loadpath.<system_name>,  in  the  sys  directory  of  your SmartEiffel
   installation,  where  <system_name>  is  one  of  the  systems symbols
   mentioned [2]above.

   To  change  this  default loading path, you need to add a special file
   which  name  is  "loadpath.se"  in  the  directory in which you type a
   [3]command  of  SmartEiffel  (compile,  finder,  pretty, compile_to_c,
   compile_to_jvm, short, clean).

   Each line of the file "loadpath.se" must be an existing directory path
   or  the  absolute  path  of  another  "loadpath.se"  file  to  include
   recursively. Environment variable may be used in these lines, with the
   syntax ${MY_VAR}.

   Additional  information about the ${SmartEiffelDirectory} variable: If
   not  explicitly  set by the user, the ${SmartEiffelDirectory} variable
   is  automatically  computed  using  the  value  of  the ${SmartEiffel}
   variable.  (Keep  in  mind that the ${SmartEiffel} is mandatory to use
   SmartEiffel.)  The  computed  value  indicates  the  SmartEiffel  main
   directory.    For    example,   if   the   ${SmartEiffel}   value   is
   "/usr/local/lib/SmartEiffel/sys/system.se"   the   computed  value  is
   "/usr/local/lib/SmartEiffel/".  This  automatically  defined  variable
   ${SmartEiffelDirectory}  is  useful  to  indicate  the  place  of  the
   SmartEiffel standard library.

   All directories of the local "loadpath.se" file are added ahead of the
   default  loading  path.  All  directories are searched in the order in
   which they appear. The current directory is not included in the search
   path  unless  it  is explicitly specified in one of the loadpath.se or
   loadpath.system  files.  Also note that an empty line in a loadpath.se
   file may add the current working directory in a place you don't want.

   To  check  that  your loading path is correctly set, just type command
   finder using an unknown class name as argument.

   Sample loadpath.se file under UNIX
   /users/myself/one_dir/
   ../../another_dir/
   ${MY_LIB}/goodies/
   /users/${MY_BUDDY}/common/loadpath.se
   ./
   The first line is an absolute path to some directory.
   The second one is a relative path to some directory.
   The  third  line  shows the use of an environment variable to point to
   some directory.
   The fourth line also features an environment variable, but points to a
   second  loadpath  file,  that  will  be  included  before  the general
   loadpath.UNIX file.
   The fifth line adds the current directory to the loadpath.

   Sample loadpath.se file under Windows
   C:\myself\one_dir\
   ..\..\another_dir\
   ${MY_LIB}\goodies\
   \users\${MY_BUDDY}\common\loadpath.se
   .\
   Same  explanations  as  above,  except  of  course  that  this file is
   prepended in front of the loadpath.Windows file.

                                   [Line]
             Copyright  Dominique COLNET and Suzanne COLLIN -
                         [4]<SmartEiffel@loria.fr>
                Last modified: Tue Feb 11 12:18:27 CET 2003

References

   1. file://localhost/users/miro/colnet/SmartEiffel/man/system.html
   2. file://localhost/users/miro/colnet/SmartEiffel/man/system.html#systems
   3. file://localhost/users/miro/colnet/SmartEiffel/man/commands.html
   4. mailto:SmartEiffel@loria.fr
