home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 3 / AACD03.BIN / AACD / Programming / sofa / archive / SmallEiffel.lha / SmallEiffel / man / compile_to_jvm.txt < prev    next >
Text File  |  1999-06-05  |  4KB  |  108 lines
  1.  
  2.                          The compile_to_jvm command
  3.                                       
  4.    Usage
  5.    
  6.    compile_to_jvm [options] <Root-Class> [<Root-Procedure>]
  7.    
  8.    Command compile_to_jvm is the SmallEiffel Java byte code generator for
  9.    the Java Virtual Machine.
  10.    
  11.    Command compile_to_jvm must have at least one argument to indicate the
  12.    starting execution point of the system.
  13.    
  14.    Thus, execution will start in <Root-Procedure> of <Root-Class>. The
  15.    default <Root-Procedure> is make.
  16.    
  17.    Loading path for Eiffel source files
  18.    
  19.    compile_to_jvm uses the technique described in the documentation for
  20.    command [1]finder to locate the Eiffel source files it tries to
  21.    compile.
  22.    
  23.    Options to select Eiffel compilation modes
  24.    
  25.    As for command compile_to_c there are 8 different compilation modes :
  26.    -boost, -no_check, -require_check, -ensure_check, -invariant_check,
  27.    -loop_check and -all_check.
  28.    Options have the same meaning as for compile_to_c. See [2]compile_to_c
  29.    documentation for details.
  30.    
  31.    Other options
  32.    
  33.    -o <output_name>:
  34.           Place the main output in file <output_name>.class and other
  35.           class files in directory <output_name>. When this option is not
  36.           present, the default is <Root-Class>.
  37.    -verbose:
  38.           to have information during the compilation (the full path of
  39.           loaded files is printed, type inference score, created class
  40.           files, etc).
  41.    -version:
  42.           Show the number of the [3]version of SmallEiffel you're using.
  43.    -no_style_warning:
  44.           Suppress output for warning messages related to non respect of
  45.           standard Eiffel style guidelines (for example ItEm will not
  46.           trigger a warning).
  47.    -case_insensitive:
  48.           Switch case insensitive mode on.
  49.           For example, when this mode is selected, the Eiffel parser
  50.           considers that the following identifiers refer to the same
  51.           feature: item, ITEM, ItEm, ...
  52.    -no_warning:
  53.           Suppress output for all warning messages (error messages are
  54.           still printed).
  55.           
  56.    The SmallEiffelRuntime.java class
  57.    
  58.    The SmallEiffelRuntime.java class implements some low level external
  59.    features. This file is in the directory SmallEiffel/sys/runtime. The
  60.    file SmallEiffelRuntime.class must be present to execute the Java
  61.    byte-code generated by command compile_to_jvm. Do not forget to add
  62.    this class in your Java CLASSPATH system environment variable. You can
  63.    also copy the file SmallEiffelRuntime.class in some appropriate
  64.    directory.
  65.    
  66.    Examples
  67.    
  68.    Example 1
  69.    When SmallEiffel is correctly installed, you can simply type the
  70.    following command to test the hello world program :
  71.    compile_to_jvm hello_world
  72.           
  73.    Then, in order to execute the produced Java byte code, you can use
  74.    command :
  75.    java hello_world
  76.           
  77.    Example 2
  78.    As for command compile_to_c you can add the option -boost to avoid all
  79.    assertions checks :
  80.    compile_to_jvm -boost hello_world
  81.           
  82.    Example 3
  83.    To change the name of the output main class, you have to add the
  84.    option -o :
  85.    compile_to_jvm -boost -o out hello_world
  86.           
  87.    Then, you can run the Java byte code with :
  88.    java out
  89.           
  90.    Note that the name used for the class files directory is also changed
  91.    (this directory is also named out).
  92.    
  93.    Example 4
  94.    Finally, the -verbose option may be useful to check what files are
  95.    loaded, what files are created, or to fix some installation problem :
  96.    compile_to_jvm -verbose hello_world
  97.           
  98.                                    [Line]
  99.    Copyright © Dominique COLNET and Suzanne COLLIN - [4]<colnet@loria.fr>
  100.                   Last update: 05 June 1999, by DC & OZ. 
  101.  
  102. References
  103.  
  104.    1. file://localhost/home/colnet/SmallEiffel/man/man/finder.html
  105.    2. file://localhost/home/colnet/SmallEiffel/man/man/compile_to_c.html
  106.    3. file://localhost/home/colnet/SmallEiffel/man/man/SmallEiffelFAQ.html#Q02
  107.    4. mailto:colnet@loria.fr
  108.