Building |me_h|
===============

.. highlight:: none

This section is for users who are already familiar with `CMake <https://cmake.org/>`_ and may have
built earlier versions of |me|. The sections following describe the process
in detail and are recommended for everyone building |me|.

This section assumes that the |me| source-bundle has been downloaded and installed,
that `CMake <https://cmake.org/>`_ (version 2.8.4 or higher) has been added to your PATH environment 
variable, and that the ``$RTIMEHOME`` environment variable has been set to the installation directory 
path for |me|.

1. Make sure `CMake <https://cmake.org/>`_ (2.8.4+) is installed and available on your path. 

2. Run the ``rtime-make`` script.

    On UNIX®, Linux®, and macOS® systems:
    
     ::
 
         $RTIMEHOME/resource/scripts/rtime-make --config Debug --target self \
                     --name i86Linux2.6gcc4.4.5 -G "Unix Makefiles" --build
 
    On Windows® systems:

     ::

         $RTIMEHOME\resource\scripts\rtime-make --config Debug --target self \
                 --name i86Win32VS2010 -G "Visual Studio 10 2010" --build

    .. note:: 
    
         ``rti-make`` uses a series of arguments to build |me| for the appropriate
         environment. Please refer to :ref:`building_with_rtimemake` for details.
 
 3. You will find the compiled |me| libraries here: 
 
    On UNIX-based systems: ::
 
     $RTIMEHOME/lib/i86Linux2.6gcc4.4.5
 
    On Windows systems: ::
 
     $RTIMEHOME\lib\i86Win32VS2010
 
    .. note:: 
 
         ``rtime-make`` uses the platform specified with ``--name`` to determine 
         a few settings needed by |me|. Please refer to :ref:`prepare` for details.
 
 
 For help, enter::
 
     $RTIMEHOME\resource\scripts\rtime-make --help
 
 To list available targets, enter::
 
     $RTIMEHOME\resource\scripts\rtime-make --list
 
 For help with a specific target, except self, enter::
 
     $RTIMEHOME\resource\scripts\rtime-make --target <target> --help