Changeset 18808

Show
Ignore:
Timestamp:
05/08/06 18:04:28 (2 years ago)
Author:
patrick
Message:

Renamed buildwin32.py to build_windows.py since it also handles the Win64
version of VR Juggler.

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved
  • juggler/trunk/README-WINDOWS.html

    r18807 r18808  
    1010  <li><a href="#intro">Introduction</a></li> 
    1111  <li><a href="#install_python">Install Python</a></li> 
    12   <li><a href="#run_buildwin32_py">Run <tt>buildwin32.py</tt></a></li> 
     12  <li><a href="#run_build_windows_py">Run <tt>build_windows.py</tt></a></li> 
    1313  <li><a href="#choose_configuration">Choose a Configuration to Build</a></li> 
    1414  <li><a href="#install_vrj">Install VR Juggler</a></li> 
     
    3333  </li> 
    3434  <li> 
    35     Run <tt>buildwin32.py</tt> and fill in at least the paths to the 
     35    Run <tt>build_windows.py</tt> and fill in at least the paths to the 
    3636    required dependencies. 
    3737  </li> 
     
    5151 
    5252<p> 
    53 In order to <a href="#run_buildwin32_py">run the helper script 
    54 <tt>buildwin32.py</tt></a>, you must have 
     53In order to <a href="#run_build_windows_py">run the helper script 
     54<tt>build_windows.py</tt></a>, you must have 
    5555<a href="http://www.python.org/">Python</a> 2.2 or newer installed on your 
    5656system. (To build a 64-bit version of VR Juggler, the 64-bit version of 
     
    6060</p> 
    6161 
    62 <a name="run_buildwin32_py"><h1>3. Run <tt>buildwin32.py</tt></h1></a> 
     62<a name="run_build_windows_py"><h1>3. Run <tt>build_windows.py</tt></h1></a> 
    6363 
    6464<p> 
    6565Once you have Python installed, you can open the folder containing the 
    6666Juggler Project source in Windows Explorer and double-click on the 
    67 icon for the script <tt>buildwin32.py</tt>.  This script simplifies the 
     67icon for the script <tt>build_windows.py</tt>.  This script simplifies the 
    6868process of building VR Juggler on Windows by setting up paths and 
    6969environment variables based on input that you provide.  It then starts 
     
    7575<blockquote> 
    7676<b>NOTE:</b> For the build to work correctly, you must use the 
    77 <tt>buildwin32.py</tt> script.  It does more than just set environment 
     77<tt>build_windows.py</tt> script.  It does more than just set environment 
    7878variables. 
    7979</blockquote> 
     
    8383section describes each of the required and optional environment variables 
    8484used by the Visual Studio build.  You can read through them to get a 
    85 better understanding of what <tt>buildwin32.py</tt> expects from your 
     85better understanding of what <tt>build_windows.py</tt> expects from your 
    8686answers to its questions, or you can 
    8787<a href="#choose_configuration">skip to the next section</a>. 
     
    9292<p> 
    9393Prior to starting the Visual Studio GUI, several environment variables 
    94 must be set.  If you run the Python script <tt>buildwin32.py</tt>, all of 
     94must be set.  If you run the Python script <tt>build_windows.py</tt>, all of 
    9595the necessary environment variables will be set (and cached) based on 
    9696responses you provide to several questions. 
     
    283283    driver. Different versions of the Trackd API have different names for the 
    284284    header file that proides the type declarations needed to use the Trackd 
    285     API driver. The build script <tt>buildwin32.py</tt> attempts to detect 
     285    API driver. The build script <tt>build_windows.py</tt> attempts to detect 
    286286    automatically what value to use, but it has a finite number of choices 
    287287    based on known possible values. The form for the value of this environment 
     
    296296 
    297297<p> 
    298 After you answer the questions asked by <tt>buildwin32.py</tt>, the script 
     298After you answer the questions asked by <tt>build_windows.py</tt>, the script 
    299299will start up the version of Visual Studio that you have in your path (or 
    300300that it detected on your system if your environment does not have the 
     
    309309<a href="#opt_env_vars">optional dependencies</a>, some optional targets 
    310310such as device drivers or Java features may fail to build.  If this is not 
    311 acceptable, you must <a href="#run_buildwin32_py">go back to Step 3</a> 
    312 and run <tt>buildwin32.py</tt> again. 
     311acceptable, you must <a href="#run_build_windows_py">go back to Step 3</a> 
     312and run <tt>build_windows.py</tt> again. 
    313313</p> 
    314314 
     
    316316 
    317317<p> 
    318 After successfully compiling VR Juggler, <tt>buildwin32.py</tt> will ask 
     318After successfully compiling VR Juggler, <tt>build_windows.py</tt> will ask 
    319319if you want to install VR Juggler.  On Windows, you must install VR Juggler 
    320320to be able to build and run applications.  Working out of the development 
    321321tree is not possible the way it is on other platforms.  If you answer 
    322 "yes" to the question of installing VR Juggler, <tt>buildwin32.py</tt> will 
     322"yes" to the question of installing VR Juggler, <tt>build_windows.py</tt> will 
    323323go through the full process of installing everything that was compiled. 
    324324</p>