home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 3 / AACD03.BIN / AACD / Programming / sofa / archive / SmallEiffel.lha / SmallEiffel / man / system.txt < prev   
Text File  |  1999-06-05  |  6KB  |  144 lines
  1.  
  2.                             System configuration
  3.                                       
  4.    System customization is performed thanks to the "system.se" file which
  5.    must be in the sub-directory "sys" of the installation directory.
  6.    
  7.    When the system name is correctly set in the file "system.se",
  8.    SmallEiffel performs some automatic customizations. For example, if
  9.    the "system.se" file contains the string "DOS", SmallEiffel uses the
  10.    suffix ".BAT" for script files and the suffix ".EXE" for executables
  11.    files.
  12.    
  13.    The "sys" directory contains various files to customize SmallEiffel
  14.    with the system, the C compiler and the linker used as well as the
  15.    default loadpath used to look for Eiffel source code.
  16.    
  17.    The SmallEiffel environment variable
  18.    
  19.    Environment variable SmallEiffel must be set with the absolute path of
  20.    the file "system.se" which is in the sub-directory "sys" of the
  21.    installation directory.
  22.    Under a UNIX-like system, the value of the SmallEiffel environment
  23.    variable may be for example: /usr/lib/SmallEiffel/sys/system.se
  24.    The contents of the file "system.se" indicate the [1]system you are
  25.    running.
  26.    
  27.    File system.se
  28.    
  29.    The first word of file "system.se" is used by SmallEiffel to know
  30.    which operating system is running. Currently supported values are:
  31.    
  32.    UNIX for all UNIX-like systems, GNU/Linux, HP-UX, Solaris, SunOS,
  33.    Irix, XENIX, etc.
  34.    Windows for Windows 95 and Windows NT systems (using long filenames).
  35.    DOS for MS-DOS systems or Windows 3.x (using short filenames, with 8.3
  36.    scheme).
  37.    Macintosh for Macintosh systems (68K and PPC)
  38.    BeOS for the BeOS system
  39.    Amiga for the Amiga system
  40.    OS2 for IBM OS/2 systems
  41.    VMS for the VMS systems
  42.    
  43.    You must choose the appropriate system name in the previous list and
  44.    update file "system.se". To be sure that the previous list is
  45.    up-to-date, just put a bad system name in the file "system.se" and
  46.    then run for example command compile.
  47.    
  48.    The system name will then be used to access various files
  49.    corresponding to the system you chose. For example, if you declared
  50.    "Windows", only files with extension "Windows" will be considered
  51.    (e.g. files like "loadpath.Windows", "compiler.Windows",
  52.    "linker.Windows", etc...).
  53.    
  54.    File compiler.se
  55.    
  56.    This file is used to select the default C compiler that will be used
  57.    to compile the generated C code. Only the first line of this file is
  58.    considered; it must contain the name of one of the supported
  59.    compilers, which at the current time are:
  60.    
  61.    gcc The free and open-source GNU C Compiler and its variants (egcs,
  62.    mingw32, etc.) on several platforms (Linux and other UNIXes, Windows).
  63.    cc The standard cc compiler, as provided by vendors of most UNIX and
  64.    VMS systems.
  65.    lcc-win32 The free port of lcc for Windows platforms.
  66.    bcc32 The Borland (now Inprise) C/C++ compiler on Windows platforms.
  67.    bcc32i A variant (?) of the previous one.
  68.    wcl386 The Watcom C/C++ compiler for Windows plaforms.
  69.    cl The MicroSoft C/C++ compiler for Windows platforms.
  70.    sc The SAS C compiler on Amiga platforms.
  71.    
  72.    SmallEiffel will automatically generate the correct system call to
  73.    this C compiler, with the appropriate linker and adequate object files
  74.    suffix.
  75.    In case an unknown compiler name is supplied, SmallEiffel generates an
  76.    error message listing the supported compiler names. In case the
  77.    compiler specified is a correct one but can't be found, SmallEiffel
  78.    won't be able to detect it, but there will be an error message from
  79.    the system. In -verbose mode, the systems calls to the C compiler are
  80.    displayed, thus making it easy to find such errors.
  81.    
  82.    Changing the default loading path
  83.    
  84.    All the commands use the same algorithm to search for Eiffel source
  85.    files. The default global loading path is set using contents of file
  86.    loadpath.< system_name >, in the sys directory of your SmallEifel
  87.    installation, where < system_name > is one of the systems symbols
  88.    mentioned [2]above.
  89.    
  90.    To change this default loading path, you need to add a special file
  91.    which name is "loadpath.se" in the directory in which you type a
  92.    [3]command of SmallEiffel (compile, finder, pretty, compile_to_c,
  93.    compile_to_jvm, short, clean).
  94.    
  95.    Each line of the file "loadpath.se" must be an existing directory path
  96.    or the absolute path of another "loadpath.se" file to include
  97.    recursively. Environment variable may be used in these lines, with the
  98.    syntax ${MY_VAR}.
  99.    
  100.    All directories of the local "loadpath.se" file are added ahead of the
  101.    default loading path. All directories are searched in the order in
  102.    which they appear. The current directory is not included in the search
  103.    path unless it is explicitely specified in one of the loadpath.se or
  104.    loadpath.system files. Also note that an empty line in a loadpath.se
  105.    file may add the current working directory in a place you don't want.
  106.    
  107.    To check that your loading path is correctly set, just type command
  108.    finder using an unknown class name as argument.
  109.    
  110.    Sample loadpath.se file under UNIX
  111.    /users/myself/one_dir/
  112.    ../../another_dir/
  113.    ${MY_LIB}/goodies/
  114.    /users/${MY_BUDDY}/common/loadpath.se
  115.    ./
  116.    The first line is an absolute path to some directory.
  117.    The second one is a relative path to some directory.
  118.    The third line shows the use of an environment variable to point to
  119.    some directory.
  120.    The fourth line also features an environment variable, but points to a
  121.    second loadpath file, that will be included before the general
  122.    loadpath.UNIX file.
  123.    The fifth line adds the current directory to the loadpath.
  124.    
  125.    Sample loadpath.se file under Windows
  126.    C:\myself\one_dir\
  127.    ..\..\another_dir\
  128.    ${MY_LIB}\goodies\
  129.    \users\${MY_BUDDY}\common\loadpath.se
  130.    .\
  131.    Same explanations as above, except of course that this file is
  132.    prepended in front of the loadpath.Windows file.
  133.    
  134.                                    [Line]
  135.    Copyright © Dominique COLNET and Suzanne COLLIN - [4]<colnet@loria.fr>
  136.                   Last update: 05 June 1999, by DC & OZ. 
  137.  
  138. References
  139.  
  140.    1. file://localhost/home/colnet/SmallEiffel/man/man/system.html
  141.    2. file://localhost/home/colnet/SmallEiffel/man/man/system.html#systems
  142.    3. file://localhost/home/colnet/SmallEiffel/man/commands/commands.html
  143.    4. mailto:colnet@loria.fr
  144.