Changeset 19200

Show
Ignore:
Timestamp:
08/13/06 09:32:33 (2 years ago)
Author:
patrick
Message:

Regen.

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • juggler/trunk/INSTALL.html

    r18920 r19200  
    33   <title>Building and Installing the Juggler Project (Version 
    44      2.1/2.2)</title><link rel="stylesheet" href="base_style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.70.1"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h1 class="title"><a name="d0e1"></a>Building and Installing the Juggler Project (Version 
    5       2.1/2.2)</h1></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="othername">The Juggler Team</span></h3></div></div></div><div><p class="pubdate">$Date$</p></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#d0e15">Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="#d0e32">Important Notes for IRIX Users</a></span></dt><dt><span class="section"><a href="#d0e116">Important Note for Windows Users</a></span></dt></dl></dd><dt><span class="section"><a href="#source.code.section">Getting the Source Code and the Dependencies</a></span></dt><dd><dl><dt><span class="section"><a href="#section.cvs.access">How to Get the Juggler Suite from CVS</a></span></dt><dt><span class="section"><a href="#d0e218">Downloading Third-Party Dependencies</a></span></dt></dl></dd><dt><span class="section"><a href="#compile.section">Compiling</a></span></dt><dd><dl><dt><span class="section"><a href="#d0e310">Important Note Regarding Compiling</a></span></dt><dt><span class="section"><a href="#d0e321">Compiling the Juggler Suite of Tools</a></span></dt><dt><span class="section"><a href="#compile.individual.section">Tips for Compiling Individual Tools in the Juggler 
     5      2.1/2.2)</h1></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="othername">The Juggler Team</span></h3></div></div></div><div><p class="pubdate">$Date$</p></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#d0e15">Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="#d0e32">Important Notes for IRIX Users</a></span></dt><dt><span class="section"><a href="#d0e116">Important Note for Windows Users</a></span></dt></dl></dd><dt><span class="section"><a href="#d0e124">Build Tools</a></span></dt><dt><span class="section"><a href="#source.code.section">Getting the Source Code and the Dependencies</a></span></dt><dd><dl><dt><span class="section"><a href="#section.cvs.access">How to Get the Juggler Suite from Subversion</a></span></dt><dt><span class="section"><a href="#d0e244">Downloading Third-Party Dependencies</a></span></dt></dl></dd><dt><span class="section"><a href="#compile.section">Compiling</a></span></dt><dd><dl><dt><span class="section"><a href="#d0e336">Important Note Regarding Compiling</a></span></dt><dt><span class="section"><a href="#d0e347">Compiling the Juggler Suite of Tools</a></span></dt><dt><span class="section"><a href="#compile.individual.section">Tips for Compiling Individual Tools in the Juggler 
    66         Suite</a></span></dt></dl></dd></dl></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e15"></a>Introduction</h2></div></div></div><p>You have downloaded the source code for Version 2.1 of the Juggler 
    77      Project. This is the code that will become VR Juggler 2.2, and it is the 
    88      code that is used to create the VR juggler 2.2 pre-releases. Please be 
    99      aware that this code represents a work in progress, and if you acquired 
    10       it directly from CVS rather than using a pre-packaged source code 
     10      it directly from Subversion rather than using a pre-packaged source code 
    1111      snapshot, the code may have bugs affecting compilation and 
    1212      execution.</p><p>This document explains how to build the modules of the Juggler 
    1313      Project from the source code. We begin by explaining some issues related 
    1414      to specific operating systems. We then explain how to get the source 
    15       code from our CVS repository. (Those users who downloaded a pre-packaged 
    16       source release can skip ahead to <a href="#using.configure.pl" title="Using configure.pl">the section called &#8220;Using <span><strong class="command">configure.pl</strong></span>&#8221;</a>). 
    17       We conclude with instructions on how to build VR Juggler and its 
    18       individual components.</p><p>Before reading further, we recommend that readers take a look at 
    19       the Wiki page relating to building from CVS (<a href="http://www.vrjuggler.org/twiki_public/bin/view/Juggler/BuildingFromCvs" target="_top">http://www.vrjuggler.org/twiki_public/bin/view/Juggler/BuildingFromCvs</a>). 
     15      code from our Subversion repository. (Those users who downloaded a 
     16      pre-packaged source release can skip ahead to <a href="#using.configure.pl" title="Using configure.pl">the section called &#8220;Using <span><strong class="command">configure.pl</strong></span>&#8221;</a>). We conclude with instructions on how 
     17      to build VR Juggler and its individual components.</p><p>Before reading further, we recommend that readers take a look at 
     18      the Wiki page relating to building from source (<a href="http://www.vrjuggler.org/twiki_public/bin/view/Juggler/BuildingFromSvn" target="_top">http://www.vrjuggler.org/twiki_public/bin/view/Juggler/BuildingFromSvn</a>). 
    2019      It is a <span class="emphasis"><em>supplement</em></span> to this document containing tips 
    21       and reminders for those users building the CVS version of VR Juggler. It 
     20      and reminders for those users building the SVN version of VR Juggler. It 
    2221      is not a replacement for this document, nor can it stand on its own as 
    2322      build instructions. You are reading the definitive build instructions; 
    …… 
    7372         Studio 6.0, and it appears that they have no plans to fix these 
    7473         problems. Therefore, we require the use of Visual Studio 7.x (.NET 
    75          2002 or 2003) to compile the source code.</p></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="source.code.section"></a>Getting the Source Code and the Dependencies</h2></div></div></div><p>In this section, we explain how to get the Juggler Project source 
     74         2002 or 2003) or newer to compile the source code.</p></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="d0e124"></a>Build Tools</h2></div></div></div><p>When building on non-Windows platforms, the GNU Autotools are 
     75      required. This means that, in addition to a C++ compiler (e.g., GCC), 
     76      the following packages must be installed in order to compile VR 
     77      Juggler:</p><div class="itemizedlist"><ul type="disc"><li><p>GNU Make 3.79 or newer</p></li><li><p>GNU Autoconf 2.53 or newer</p></li><li><p>GNU Automake 1.8 or newer</p></li></ul></div><p>Additionally, VR Juggler 2.1 and beyond require the <a href="https://realityforge.vrsource.org/view/FlagPoll/" target="_top">Flagpoll</a> 
     78      software tool. As of this writing, the minimum required version is 
     79      0.5.0. It is recommended that all of these tools be installed in either 
     80      the <code class="filename">/usr</code> or the <code class="filename">/usr/local</code> 
     81      directory trees so that search paths do not have to be extended.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="source.code.section"></a>Getting the Source Code and the Dependencies</h2></div></div></div><p>In this section, we explain how to get the Juggler Project source 
    7682      code and the dependencies required to build Juggler. There are two ways 
    7783      to get the source code: from a pre-packaged source release archive or 
    78       from the CVS repository on SourceForge. If you got the code from a 
    79       pre-packaged source archive, that code is a complete 
    80       &#8220;<span class="quote">snapshot</span>&#8221; of the CVS repository at the time of release. It 
    81       contains all dependencies that would otherwise have been acquired using 
    82       CVS. It <span class="emphasis"><em>does not</em></span> contain binary dependencies that 
    83       must be downloaded separately (such as NSPR, the Java Developer Kit, a 
    84       C++ compiler, etc.).</p><p>The current list of <span class="emphasis"><em>required</em></span> software 
     84      from the Subversion repository on RealityForge. If you got the code from 
     85      a pre-packaged source archive, that code is a complete 
     86      &#8220;<span class="quote">snapshot</span>&#8221; of the Subversion repository at the time of 
     87      release. It contains all dependencies that would otherwise have been 
     88      acquired using Subversion. It <span class="emphasis"><em>does not</em></span> contain 
     89      binary dependencies that must be downloaded separately (such as NSPR, 
     90      the Java Developer Kit, a C++ compiler, etc.).</p><p>The current list of <span class="emphasis"><em>required</em></span> software 
    8591      packages is as follows:</p><div class="itemizedlist"><ul type="disc"><li><p>CppDOM (<a href="http://www.sourceforge.net/projects/xml-cppdom/" target="_top">http://www.sf.net/projects/xml-cppdom/</a>): 
    8692            A lightweight, easy-to-use XML parser written in C++. CppDOM must 
    …… 
    106112            use of extensions to CppUnit. An extended version of the CppUnit 
    107113            source that includes these extensions can be acquired from the 
    108             Juggler CVS repository in the module <code class="literal">cppunit</code>. 
    109             Refer to <a href="#section.cvs.access" title="How to Get the Juggler Suite from CVS">the section called &#8220;How to Get the Juggler Suite from CVS&#8221;</a> for instructions 
    110             about accessing the Juggler CVS repository.</p></li></ul></div><p>The third-party dependencies must be downloaded from the sites 
     114            Juggler Subversion repository in the module 
     115            <code class="literal">cppunit</code>. Refer to <a href="#section.cvs.access" title="How to Get the Juggler Suite from Subversion">the section called &#8220;How to Get the Juggler Suite from Subversion&#8221;</a> for instructions about accessing 
     116            the Juggler Subversion repository.</p></li></ul></div><p>The third-party dependencies must be downloaded from the sites 
    111117      listed above and installed manually. You may also have to compile one or 
    112118      more of the packages if binary distributions are not available. Which 
    …… 
    114120      carefully which packages are needed based on the software you have 
    115121      installed and what versions of tools (such as the JDK) that you 
    116       download.</p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="section.cvs.access"></a>How to Get the Juggler Suite from CVS</h3></div></div></div><p>You can optionally get the Juggler Project as a source code 
     122      download.</p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="section.cvs.access"></a>How to Get the Juggler Suite from Subversion</h3></div></div></div><p>You can optionally get the Juggler Project as a source code 
    117123         tarball from the website (<a href="http://www.vrjuggler.org/" target="_top">http://www.vrjuggler.org/</a>) or 
    118          you can execute the following commands from a shell to get the code 
    119          from our CVS repository:</p><pre class="screen">cvs -d :pserver:anonymous@cvs.sourceforge.net:/cvsroot/vrjuggler login 
    120 cvs -z3 -d :pserver:anonymous@cvs.sourceforge.net:/cvsroot/vrjuggler co juggler</pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e218"></a>Downloading Third-Party Dependencies</h3></div></div></div><p>In addition to source the dependencies acquired through CVS, 
    121          there are some third-party dependencies that must be installed 
    122          separately. Remember that no Java code in VR Juggler can be used 
    123          without the JDK and a working Java version of CORBA.</p><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e223"></a>Boost</h4></div></div></div><p>The minimum required version of Boost, as of this writing, 
     124         you can execute the following command from a shell to get the code 
     125         from our Subversion repository:</p><pre class="screen">svn co https://realityforge.vrsource.org/svn/vrjuggler/juggler/trunk juggler 
     126</pre></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e244"></a>Downloading Third-Party Dependencies</h3></div></div></div><p>In addition to source the dependencies acquired through 
     127         Subversion, there are some third-party dependencies that must be 
     128         installed separately. Remember that no Java code in VR Juggler can be 
     129         used without the JDK and a working Java version of CORBA.</p><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e249"></a>Boost</h4></div></div></div><p>The minimum required version of Boost, as of this writing, 
    124130            is 1.31.0. The Boost source can be downloaded from <a href="http://www.sf.net/projects/boost/" target="_top">http://www.sf.net/projects/boost/</a>. 
    125131            To compile and install Boost, refer to its installation 
    …… 
    128134            to as &#8220;<span class="quote">boost-jam</span>&#8221; on the Boost download page) to 
    129135            build Boost.</p><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Important</h3><p>Mac OS X users should compile the Boost libraries using 
    130                the &#8220;<span class="quote">darwin</span>&#8221; toolset.</p></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e246"></a>CppDOM</h4></div></div></div><p>For XML processing, we use CppDOM 0.3.2 or newer. The source 
     136               the &#8220;<span class="quote">darwin</span>&#8221; toolset.</p></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e272"></a>CppDOM</h4></div></div></div><p>For XML processing, we use CppDOM 0.3.2 or newer. The source 
    131137            and binary distributions for some platforms can be downloaded from 
    132138            <a href="http://www.sf.net/projects/xml-cppdom/" target="_top">http://www.sf.net/projects/xml-cppdom/</a>. 
    …… 
    134140            must compile and install CppDOM yourself. Note that you need SCons 
    135141            (<a href="http://scons.sourceforge.net/" target="_top">http://scons.sourceforge.net/</a>) 
    136             to build and install CppDOM.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e257"></a>GMTL</h4></div></div></div><p>For high-level mathematical operations, we use GMTL 0.3.2 or 
     142            to build and install CppDOM.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e283"></a>GMTL</h4></div></div></div><p>For high-level mathematical operations, we use GMTL 0.3.2 or 
    137143            newer. The source distribution can be downloaded from <a href="http://www.sf.net/projects/ggt/" target="_top">http://www.sf.net/projects/ggt/</a>. 
    138144            Note that you need SCons (<a href="http://scons.sourceforge.net/" target="_top">http://scons.sourceforge.net/</a>) 
    139             to build and install GMTL.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e268"></a>Netscape Portable Runtime (NSPR)</h4></div></div></div><p>Our operating system abstraction, VPR, can make use of NSPR 
     145            to build and install GMTL.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e294"></a>Netscape Portable Runtime (NSPR)</h4></div></div></div><p>Our operating system abstraction, VPR, can make use of NSPR 
    140146            for operating system primitives. On some platforms (IRIX, FreeBSD, 
    141147            Linux, Mac OS X), the use of NSPR is strictly optional. On others 
    …… 
    143149            system, you should decide whether you need NSPR. Binary versions 
    144150            of NSPR can be downloaded from <a href="ftp://ftp.mozilla.org/pub/mozilla.org/nspr/releases" target="_top">ftp://ftp.mozilla.org/pub/mozilla.org/nspr/releases</a>. 
    145             At this time, we recommend the use of version 4.2 or newer.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e276"></a>Java Developer Kit (also called the J2SE SDK)</h4></div></div></div><p>We make use of the Java programming language in addition to 
     151            At this time, we recommend the use of version 4.2 or newer.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e302"></a>Java Developer Kit (also called the J2SE SDK)</h4></div></div></div><p>We make use of the Java programming language in addition to 
    146152            C++. Java is used exclusively for GUIs such as Tweek and VRJConfig 
    147153            (which is a JavaBean that is loaded into Tweek). To compile the 
    148154            Java code, a JDK is necessary. We currently require version 1.4 or 
    149155            newer. The Java Standard Edition can be downloaded from <a href="http://java.sun.com/j2se/" target="_top">http://java.sun.com/j2se/</a>. 
    150             More information can be found at <a href="http://java.sun.com/" target="_top">http://java.sun.com/</a>.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e287"></a>omniORB</h4></div></div></div><p>omniORB is a C++ implementation of CORBA 2.3. It is required 
     156            More information can be found at <a href="http://java.sun.com/" target="_top">http://java.sun.com/</a>.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e313"></a>omniORB</h4></div></div></div><p>omniORB is a C++ implementation of CORBA 2.3. It is required 
    151157            in order to compile the Tweek C++ API. At this time, the Tweek C++ 
    152158            API is not required for VR Juggler, but this situation will change 
    …… 
    160166            configure script where to find everything. Please refer to <a href="#tweek.build.section" title="Tweek">the section called &#8220;Tweek&#8221;</a> for more details on this.</p></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="compile.section"></a>Compiling</h2></div></div></div><p>In this section, we describe how to compile the Juggler Project. 
    161167      We focus on VR Juggler as a whole, but information about some of the 
    162       individual components is provided later.</p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e310"></a>Important Note Regarding Compiling</h3></div></div></div><p>You have downloaded <span class="emphasis"><em>developmental</em></span> code. It 
     168      individual components is provided later.</p><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e336"></a>Important Note Regarding Compiling</h3></div></div></div><p>You have downloaded <span class="emphasis"><em>developmental</em></span> code. It 
    163169         may not be stable, and it may not even compile. Compiling VR Juggler 
    164170         itself can be a little complicated for anyone who does not have some 
    165          background in using CVS, Autoconf, C++, and <span><strong class="command">make</strong></span> 
    166          or Visual Studio.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e321"></a>Compiling the Juggler Suite of Tools</h3></div></div></div><p>This section explains how to get, configure, and compile all of 
     171         background in using Subversion, Autoconf, C++, and 
     172         <span><strong class="command">make</strong></span> or Visual Studio.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="d0e347"></a>Compiling the Juggler Suite of Tools</h3></div></div></div><p>This section explains how to get, configure, and compile all of 
    167173         the tools that make up VR Juggler. Each tool compiles to its own 
    168174         library and can be installed individually. (Refer to the 
    …… 
    171177         solution. After getting the dependencies needed to compile VR Juggler 
    172178         (see the next section), refer to the <a href="README-WINDOWS.html" target="_top">README-WINDOWS.html</a> file located in 
    173          this directory. Do not bother to the rest of this document.</p><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e334"></a>Per-Module Dependencies</h4></div></div></div><p>Here, we provide per-module dependency information. Given 
     179         this directory. Do not bother to the rest of this document.</p><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="d0e360"></a>Per-Module Dependencies</h4></div></div></div><p>Here, we provide per-module dependency information. Given 
    174180            that the dependencies for any single module are met, the modules 
    175181            may be reused effectively outside the scope of immersive VR 
    …… 
    177183            <span class="emphasis"><em>minimum</em></span> required version for each dependency, 
    178184            and where appropriate, we note which dependencies are 
    179             optional.</p><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e342"></a>VPR</h5></div></div></div><p>VPR provides a cross-platform, object-oriented operating 
     185            optional.</p><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e368"></a>VPR</h5></div></div></div><p>VPR provides a cross-platform, object-oriented operating 
    180186               system abstraction. It is the foundation for all other Juggler 
    181                modules.</p><div class="itemizedlist"><ul type="disc"><li><p>CppDOM 0.3.2</p></li><li><p>Boost headers and Boost.Filesystem 1.31.0</p></li><li><p>NSPR (Windows, Solaris, and HP-UX only) 4.4</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e357"></a>Tweek C++ API</h5></div></div></div><p>Tweek implements a distributed model/view/controller 
     187               modules.</p><div class="itemizedlist"><ul type="disc"><li><p>CppDOM 0.3.2</p></li><li><p>Boost headers and Boost.Filesystem 1.31.0</p></li><li><p>NSPR (Windows, Solaris, and HP-UX only) 4.4</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e383"></a>Tweek C++ API</h5></div></div></div><p>Tweek implements a distributed model/view/controller 
    182188               system on top of CORBA. The Tweek C++ API provides the C++ 
    183189               component of that system. Code written on top of the Tweek C++ 
    184190               API normally acts as the model piece of the distributed 
    185                model/view/controller system.</p><div class="itemizedlist"><ul type="disc"><li><p>VPR</p></li><li><p>omniORB 4.0</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e369"></a>Tweek Java API</h5></div></div></div><p>Tweek implements a distributed model/view/controller 
     191               model/view/controller system.</p><div class="itemizedlist"><ul type="disc"><li><p>VPR</p></li><li><p>omniORB 4.0</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e395"></a>Tweek Java API</h5></div></div></div><p>Tweek implements a distributed model/view/controller 
    186192               system on top of CORBA. The Tweek Java API provides the Java 
    187193               component of that system. The main part of the Tweek Java API 
    …… 
    189195               Tweek Beans that normally function as the view and controller 
    190196               pieces of the distributed module/view/controller system.</p><div class="itemizedlist"><ul type="disc"><li><p>J2SE SDK 1.4</p></li><li><p>JDOM (included with Juggler source)</p></li><li><p>Ant (included with Juggler source)</p></li><li><p>JacORB IDL-to-Java compiler (included with Juggler 
    191                      source)</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e387"></a>Tweek Python API</h5></div></div></div><p>Tweek implements a distributed model/view/controller 
     197                     source)</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e413"></a>Tweek Python API</h5></div></div></div><p>Tweek implements a distributed model/view/controller 
    192198               system on top of CORBA. The Tweek Python API provides the 
    193199               Python component of that system. The main part of the Tweek 
    …… 
    195201               application that loads Python modules that normally function as 
    196202               the view and controller pieces of the distributed 
    197                module/view/controller system.</p><div class="itemizedlist"><ul type="disc"><li><p>Python 2.3</p></li><li><p>omniORBpy 2.0</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e402"></a>JCCL C++ API</h5></div></div></div><p>The JCCL C++ API provides an interface for loading 
     203               module/view/controller system.</p><div class="itemizedlist"><ul type="disc"><li><p>Python 2.3</p></li><li><p>omniORBpy 2.0</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e428"></a>JCCL C++ API</h5></div></div></div><p>The JCCL C++ API provides an interface for loading 
    198204               XML-based configurations. It includes the run-time 
    199                reconfiguration feature of Juggler.</p><div class="itemizedlist"><ul type="disc"><li><p>VPR</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e411"></a>JCCL Java API</h5></div></div></div><p>The JCCL Java API provides a programming interface for 
     205               reconfiguration feature of Juggler.</p><div class="itemizedlist"><ul type="disc"><li><p>VPR</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e437"></a>JCCL Java API</h5></div></div></div><p>The JCCL Java API provides a programming interface for 
    200206               editing Juggler configuration files and config definition files 
    201207               as well as JavaBeans for editing these files using a graphical 
    202208               interface.</p><div class="itemizedlist"><ul type="disc"><li><p>Tweek Java API</p></li><li><p>TableLayout package (included with Juggler 
    203                      source)</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e423"></a>JCCL Remote Run-Time Reconfiguration Plug-in 
     209                     source)</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e449"></a>JCCL Remote Run-Time Reconfiguration Plug-in 
    204210               (C++)</h5></div></div></div><p>The C++ JCCL Remote Run-Time Reconfiguration Plug-in is 
    205211               an optional extension to the JCCL Config Manager for allowing 
    206212               remote manipulation of a Juggler configuration at run time 
    207                based on Tweek.</p><div class="itemizedlist"><ul type="disc"><li><p>Tweek C++ API</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e432"></a>JCCL Remote Run-Time Reconfiguration Plug-in 
     213               based on Tweek.</p><div class="itemizedlist"><ul type="disc"><li><p>Tweek C++ API</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e458"></a>JCCL Remote Run-Time Reconfiguration Plug-in 
    208214               (Java)</h5></div></div></div><p>The Java JCCL Remote Run-Time Reconfiguration Plug-in is 
    209215               an optional extension that provides the features needed for a 
    210216               Java-based editor to communicate with the C++ Remote Run-Time 
    211217               Reconfiguration Plug-in to edit Juggler configurations 
    212                live.</p><div class="itemizedlist"><ul type="disc"><li><p>Tweek Java API</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e441"></a>Sonix</h5></div></div></div><p>Sonix is an abstraction layer for positional sound 
     218               live.</p><div class="itemizedlist"><ul type="disc"><li><p>Tweek Java API</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e467"></a>Sonix</h5></div></div></div><p>Sonix is an abstraction layer for positional sound 
    213219               software. Sonix itself cannot play audio, but it includes 
    214220               plug-ins based on popular interfaces for playing audio. Each 
    215                plug-in depends on a specific audio software library.</p><div class="itemizedlist"><ul type="disc"><li><p>VPR</p></li><li><p>GMTL 0.1.9</p></li></ul></div><div class="section" lang="en"><div class="titlepage"><div><div><h6 class="title"><a name="d0e453"></a>Sonix OpenAL Plug-in</h6></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>Sonix</p></li><li><p>OpenAL</p></li><li><p>Free ALUT</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h6 class="title"><a name="d0e466"></a>Sonix Audiere Plug-in</h6></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>Sonix</p></li><li><p>Audiere</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h6 class="title"><a name="d0e476"></a>Sonix AudioWorks Plug-in</h6></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>Sonix</p></li><li><p>AudioWorks</p></li></ul></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e486"></a>Gadgeteer</h5></div></div></div><p>Gadgeteer handles all input devices that can be used by 
    216                VR Juggler applications.</p><div class="itemizedlist"><ul type="disc"><li><p>VPR</p></li><li><p>JCCL</p></li><li><p>GMTL 0.1.9</p></li><li><p>X Window System (non-Windows platforms)</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e504"></a>Gadgeteer Device Driver Plug-ins</h5></div></div></div><p>The device driver plug-ins for Gadgeteer are independent 
     221               plug-in depends on a specific audio software library.</p><div class="itemizedlist"><ul type="disc"><li><p>VPR</p></li><li><p>GMTL 0.1.9</p></li></ul></div><div class="section" lang="en"><div class="titlepage"><div><div><h6 class="title"><a name="d0e479"></a>Sonix OpenAL Plug-in</h6></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>Sonix</p></li><li><p>OpenAL</p></li><li><p>Free ALUT</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h6 class="title"><a name="d0e492"></a>Sonix Audiere Plug-in</h6></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>Sonix</p></li><li><p>Audiere</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h6 class="title"><a name="d0e502"></a>Sonix AudioWorks Plug-in</h6></div></div></div><div class="itemizedlist"><ul type="disc"><li><p>Sonix</p></li><li><p>AudioWorks</p></li></ul></div></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e512"></a>Gadgeteer</h5></div></div></div><p>Gadgeteer handles all input devices that can be used by 
     222               VR Juggler applications.</p><div class="itemizedlist"><ul type="disc"><li><p>VPR</p></li><li><p>JCCL</p></li><li><p>GMTL 0.1.9</p></li><li><p>X Window System (non-Windows platforms)</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e530"></a>Gadgeteer Device Driver Plug-ins</h5></div></div></div><p>The device driver plug-ins for Gadgeteer are independent 
    217223               components that are discovered and used at run time based on 
    218224               the application configuration. Drivers with dependencies are 
    219225               optional.</p><div class="itemizedlist"><ul type="disc"><li><p>Gadgeteer</p></li><li><p>VRPN 06.06 for the VRPN driver plug-in</p></li><li><p>TrackD API 4 for the TrackD API driver 
    220226                     plug-in</p></li><li><p>Microsoft Speech API for the MS Speech API driver 
    221                      plug-in</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e522"></a>Gadgeteer Cluster Plug-ins</h5></div></div></div><p>The cluster plug-ins extend the functionality of the 
    222                clustering infrastructure built into Gadgeteer.</p><div class="itemizedlist"><ul type="disc"><li><p>Gadgeteer</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e531"></a>VR Juggler</h5></div></div></div><p>The VR Juggler module is the unifying piece that pulls 
     227                     plug-in</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e548"></a>Gadgeteer Cluster Plug-ins</h5></div></div></div><p>The cluster plug-ins extend the functionality of the 
     228               clustering infrastructure built into Gadgeteer.</p><div class="itemizedlist"><ul type="disc"><li><p>Gadgeteer</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e557"></a>VR Juggler</h5></div></div></div><p>The VR Juggler module is the unifying piece that pulls 
    223229               all the other Juggler modules together. It provides a virtual 
    224230               platform for VR application development. Real-time rendering is 
    …… 
    226232               is optional.</p><div class="itemizedlist"><ul type="disc"><li><p>Gadgeteer</p></li><li><p>Sonix</p></li><li><p>OpenGL</p></li><li><p>OpenGL Performer for the 
    227233                     <span class="emphasis"><em>optional</em></span> OpenGL Performer Draw 
    228                      Manager</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e552"></a>VR Juggler Run-Time Performance Monitoring Plug-in 
     234                     Manager</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e578"></a>VR Juggler Run-Time Performance Monitoring Plug-in 
    229235               (C++)</h5></div></div></div><p>The C++ VR Juggler Run-Time Performance Monitoring 
    230236               Plug-in provides an optional extension to VR Juggler for remote 
    231237               visualization of performance metrics that are captured while 
    232238               running a VR Juggler application. Communication is performed 
    233                using the Tweek C++ API on top of CORBA.</p><div class="itemizedlist"><ul type="disc"><li><p>Tweek C++ API</p></li><li><p>VR Juggler</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e564"></a>VR Juggler Run-Time Performance Monitoring Plug-in 
     239               using the Tweek C++ API on top of CORBA.</p><div class="itemizedlist"><ul type="disc"><li><p>Tweek C++ API</p></li><li><p>VR Juggler</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e590"></a>VR Juggler Run-Time Performance Monitoring Plug-in 
    234240               (Java)</h5></div></div></div><p>The Java VR Juggler Run-Time Performance Monitoring 
    235241               Plug-in is an optional extension that provides the features 
    …… 
    238244               another JavaBean handled by the Tweek JavaBean Loader, and it 
    239245               uses CORBA to communicate with the C++ VR Juggler Run-Time 
    240                Performance Monitoring Plug-in.</p><div class="itemizedlist"><ul type="disc"><li><p>JCCL Java API</p></li><li><p>JFreeChart (included with Juggler source)</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e576"></a>VRJConfig</h5></div></div></div><p>VRJConfig is the graphical editor for Juggler 
     246               Performance Monitoring Plug-in.</p><div class="itemizedlist"><ul type="disc"><li><p>JCCL Java API</p></li><li><p>JFreeChart (included with Juggler source)</p></li></ul></div></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e602"></a>VRJConfig</h5></div></div></div><p>VRJConfig is the graphical editor for Juggler 
    241247               configurations. It is a JavaBean loaded by the Tweek JavaBean 
    242248               Loader, and it makes use of the editor Beans provided by the 
    …… 
    310316                        In this case, you must also specify the option 
    311317                        <code class="option">--with-boost-includes=/home/user1/pkgs/boost/include/boost-1_31</code> 
    312                         when running <span><strong class="command">configure.pl</strong></span>.</p></div></li></ol></div><p>By default, the configuration process will configure VR 
     318                        when running <span><strong class="command">configure.pl</strong></span>.</p></div><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Important</h3><p>If Flagpoll is not installed in a place where 
     319                        the <span><strong class="command">aclocal</strong></span> tool searches for 
     320                        <code class="filename">.m4</code> files by default, then it is 
     321                        necessary to extend <span><strong class="command">aclocal</strong></span>'s 
     322                        search path. This is done by setting the environment 
     323                        variable <code class="envar">ACLOCAL_FLAGS</code> to 
     324                        &#8220;<span class="quote"><code class="literal">-I .../share/alocal</code></span>&#8221; 
     325                        where &#8220;<span class="quote"><code class="literal">...</code></span>&#8221; is the 
     326                        path to the directory tree where Flagpoll is 
     327                        installed.</p></div></li></ol></div><p>By default, the configuration process will configure VR 
    313328               Juggler and all of its dependencies. This includes Sonix, which 
    314329               is an interesting special case. Sonix can make use of Aaudiere, 
    …… 
    320335               how to configure Sonix to use Audiere, OpenAL, or 
    321336               AudioWorks.</p><p>For example uses of <span><strong class="command">configure.pl</strong></span>, take 
    322                a look at the Wiki page relating to building from CVS (<a href="http://www.vrjuggler.org/twiki_public/bin/view/Juggler/BuildingFromCvs" target="_top">http://www.vrjuggler.org/twiki_public/bin/view/Juggler/BuildingFromCvs</a>). 
     337               a look at the Wiki page relating to building from source 
     338               (<a href="http://www.vrjuggler.org/twiki_public/bin/view/Juggler/BuildingFromSvn" target="_top">http://www.vrjuggler.org/twiki_public/bin/view/Juggler/BuildingFromSvn</a>). 
    323339               It is not a replacement for this document, but it shows how 
    324340               some members of the Juggler team configure VR Juggler. It also 
    325341               has information on more advanced uses of 
    326342               <span><strong class="command">configure.pl</strong></span> that are beyond the scope of 
    327                this document.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e757"></a>Using Locally Installed Software</h5></div></div></div><p>As noted in <a href="#source.code.section" title="Getting the Source Code and the Dependencies">the section called &#8220;Getting the Source Code and the Dependencies&#8221;</a>, VR 
     343               this document.</p></div><div class="section" lang="en"><div class="titlepage"><div><div><h5 class="title"><a name="d0e806"></a>Using Locally Installed Software</h5></div></div></div><p>As noted in <a href="#source.code.section" title="Getting the Source Code and the Dependencies">the section called &#8220;Getting the Source Code and the Dependencies&#8221;</a>, VR 
    328344               Juggler depends on several external software packages. As an 
    329345               example, consider the case where the GMTL library is installed 
    …… 
    342358         tools in the Juggler Suite are compiled correctly. For the most part, 
    343359         this duplicates information that can be found on the Wiki page 
    344          relating to building from CVS (<a href="http://www.vrjuggler.org/twiki_public/bin/view/Juggler/BuildingFromCvs" target="_top">http://www.vrjuggler.org/twiki_public/bin/view/Juggler/BuildingFromCvs</a>).</p><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="sonix.compile.section"></a>Sonix</h4></div></div></div><p>Sonix wraps other audio subsystems such as OpenAL (<a href="http://www.openal.org/" target="_top">www.openal.org</a>), Audiere 
     360         relating to building from source (<a href="http://www.vrjuggler.org/twiki_public/bin/view/Juggler/BuildingFromSvn" target="_top">http://www.vrjuggler.org/twiki_public/bin/view/Juggler/BuildingFromSvn</a>).</p><div class="section" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="sonix.compile.section"></a>Sonix</h4></div></div></div><p>Sonix wraps other audio subsystems such as OpenAL (<a href="http://www.openal.org/" target="_top">www.openal.org</a>), Audiere 
    345361            (<a href="http://audiere.sf.net/" target="_top">audiere.sf.net</a>), or 
    346362            AudioWorks (<a href="http://www.multigen.com/" target="_top">multigen.com</a>). At least one 

  • juggler/trunk/INSTALL.txt

    r18920 r19200  
    2121 
    2222 
     23  Build Tools 
     24 
    2325  Getting the Source Code and the Dependencies 
    2426 
    2527 
    26         How to Get the Juggler Suite from CVS 
     28        How to Get the Juggler Suite from Subversion 
    2729 
    2830        Downloading Third-Party Dependencies 
    …… 
    4648 is used to create the VR juggler 2.2 pre-releases. Please be aware that 
    4749 this code represents a work in progress, and if you acquired it directly 
    48  from CVS rather than using a pre-packaged source code snapshot, the code 
    49  may have bugs affecting compilation and execution. 
     50 from Subversion rather than using a pre-packaged source code snapshot, the 
     51 code may have bugs affecting compilation and execution. 
    5052 
    5153 This document explains how to build the modules of the Juggler Project from 
    5254 the source code. We begin by explaining some issues related to specific 
    53  operating systems. We then explain how to get the source code from our CVS 
    54  repository. (Those users who downloaded a pre-packaged source release can 
    55  skip ahead to the section called "Using configure.pl"). We 
     55 operating systems. We then explain how to get the source code from our 
     56 Subversion repository. (Those users who downloaded a pre-packaged source 
     57 release can skip ahead to the section called "Using configure.pl"). We 
    5658 conclude with instructions on how to build VR Juggler and its individual 
    5759 components. 
    5860 
    5961 Before reading further, we recommend that readers take a look at the Wiki 
    60  page relating to building from CVS (http://www.vrjuggler.org/twiki_public/ 
    61  bin/view/Juggler/BuildingFromCvs). It is a supplement to this document 
    62  containing tips and reminders for those users building the CVS version of 
    63  VR Juggler. It is not a replacement for this document, nor can it stand on 
    64  its own as build instructions. You are reading the definitive build 
    65  instructions; the Wiki page merely provides informal, extra information. 
     62 page relating to building from source (http://www.vrjuggler.org/ 
     63 twiki_public/bin/view/Juggler/BuildingFromSvn). It is a supplement to this 
     64 document containing tips and reminders for those users building the SVN 
     65 version of VR Juggler. It is not a replacement for this document, nor can 
     66 it stand on its own as build instructions. You are reading the definitive 
     67 build instructions; the Wiki page merely provides informal, extra 
     68 information. 
    6669 
    6770 
    …… 
    142145 the C++ Standard with Visual Studio 6.0, and it appears that they have no 
    143146 plans to fix these problems. Therefore, we require the use of Visual Studio 
    144  7.x (.NET 2002 or 2003) to compile the source code. 
     147 7.x (.NET 2002 or 2003) or newer to compile the source code. 
     148 
     149 
     150Build Tools 
     151 
     152 When building on non-Windows platforms, the GNU Autotools are required. 
     153 This means that, in addition to a C++ compiler (e.g., GCC), the following 
     154 packages must be installed in order to compile VR Juggler: 
     155 
     156 
     157*  GNU Make 3.79 or newer 
     158 
     159*  GNU Autoconf 2.53 or newer 
     160 
     161*  GNU Automake 1.8 or newer 
     162 
     163 
     164 Additionally, VR Juggler 2.1 and beyond require the Flagpoll software tool. 
     165 As of this writing, the minimum required version is 0.5.0. It is 
     166 recommended that all of these tools be installed in either the /usr or the 
     167 /usr/local directory trees so that search paths do not have to be extended. 
    145168 
    146169 
    …… 
    149172 In this section, we explain how to get the Juggler Project source code and 
    150173 the dependencies required to build Juggler. There are two ways to get the 
    151  source code: from a pre-packaged source release archive or from the CVS 
    152  repository on SourceForge. If you got the code from a pre-packaged source 
    153  archive, that code is a complete "snapshot" of the CVS 
    154  repository at the time of release. It contains all dependencies that would 
    155  otherwise have been acquired using CVS. It does not contain binary 
    156  dependencies that must be downloaded separately (such as NSPR, the Java 
    157  Developer Kit, a C++ compiler, etc.). 
     174 source code: from a pre-packaged source release archive or from the 
     175 Subversion repository on RealityForge. If you got the code from a pre- 
     176 packaged source archive, that code is a complete "snapshot" of the 
     177 Subversion repository at the time of release. It contains all dependencies 
     178 that would otherwise have been acquired using Subversion. It does not 
     179 contain binary dependencies that must be downloaded separately (such as 
     180 NSPR, the Java Developer Kit, a C++ compiler, etc.). 
    158181 
    159182 The current list of required software packages is as follows: 
    …… 
    199222   C++. The Juggler C++ test suties make use of extensions to CppUnit. An 
    200223   extended version of the CppUnit source that includes these extensions can 
    201    be acquired from the Juggler CVS repository in the module cppunit. Refer 
    202    to the section called "How to Get the Juggler Suite from CVS" 
    203    for instructions about accessing the Juggler CVS repository. 
     224   be acquired from the Juggler Subversion repository in the module cppunit. 
     225   Refer to the section called "How to Get the Juggler Suite from 
     226   Subversion" for instructions about accessing the Juggler Subversion 
     227   repository. 
    204228 
    205229 
    …… 
    212236 
    213237 
    214 How to Get the Juggler Suite from CVS 
     238How to Get the Juggler Suite from Subversion 
    215239 
    216240 You can optionally get the Juggler Project as a source code tarball from 
    217241 the website (http://www.vrjuggler.org/) or you can execute the following 
    218  commands from a shell to get the code from our CVS repository: 
    219  
    220  
    221   cvs -d :pserver:anonymous@cvs.sourceforge.net:/cvsroot/vrjuggler login 
    222   cvs -z3 -d :pserver:anonymous@cvs.sourceforge.net:/cvsroot/vrjuggler co 
     242 command from a shell to get the code from our Subversion repository: 
     243 
     244 
     245  svn co https://realityforge.vrsource.org/svn/vrjuggler/juggler/trunk 
    223246  juggler 
    224247 
    …… 
    226249Downloading Third-Party Dependencies 
    227250 
    228  In addition to source the dependencies acquired through CVS, there are some 
    229  third-party dependencies that must be installed separately. Remember that 
    230  no Java code in VR Juggler can be used without the JDK and a working Java 
    231  version of CORBA. 
     251 In addition to source the dependencies acquired through Subversion, there 
     252 are some third-party dependencies that must be installed separately. 
     253 Remember that no Java code in VR Juggler can be used without the JDK and a 
     254 working Java version of CORBA. 
    232255 
    233256 
    …… 
    238261 compile and install Boost, refer to its installation documentation (http:// 
    239262 www.boost.org/more/getting_started.html#Build_Install). Note that you need 
    240  the command bjam (referred to as "boost-jam" on the Boost 
    241  download page) to build Boost. 
     263 the command bjam (referred to as "boost-jam" on the Boost download page) to 
     264 build Boost. 
    242265 
    243266 
    244267Important 
    245268 
    246  Mac OS X users should compile the Boost libraries using the 
    247  "darwin" toolset. 
     269 Mac OS X users should compile the Boost libraries using the "darwin" 
     270 toolset. 
    248271 
    249272 
    …… 
    299322 Ports Collection). Because of this, several extra options must be specified 
    300323 in order to tell the Tweek configure script where to find everything. 
    301  Please refer to the section called "Tweek" for more details on 
    302  this. 
     324 Please refer to the section called "Tweek" for more details on this. 
    303325 
    304326 
    …… 
    314336 You have downloaded developmental code. It may not be stable, and it may 
    315337 not even compile. Compiling VR Juggler itself can be a little complicated 
    316  for anyone who does not have some background in using CVS, Autoconf, C++, 
    317  and make or Visual Studio. 
     338 for anyone who does not have some background in using Subversion, Autoconf, 
     339 C++, and make or Visual Studio. 
    318340 
    319341 
    …… 
    624646Using configure.pl 
    625647 
    626  In the base juggler source directory, we have a "global" 
    627  configure script written in Perl called configure.pl. To get the command- 
    628  line options for this script, use one of the following (the second being 
    629  much more detailed): 
     648 In the base juggler source directory, we have a "global" configure script 
     649 written in Perl called configure.pl. To get the command-line options for 
     650 this script, use one of the following (the second being much more 
     651 detailed): 
    630652 
    631653 
    …… 
    655677 various modules, should you need to run one individually. 
    656678 
    657  configure.pl can run in a unique "build" directory or in the 
    658  directory where it resides. Here is how we (the Juggler Team) have been 
    659  using it: 
     679 configure.pl can run in a unique "build" directory or in the directory 
     680 where it resides. Here is how we (the Juggler Team) have been using it: 
    660681 
    661682 
    …… 
    696717 
    697718 
     719     Important 
     720 
     721      If Flagpoll is not installed in a place where the aclocal tool 
     722      searches for .m4 files by default, then it is necessary to extend 
     723      aclocal's search path. This is done by setting the environment 
     724      variable ACLOCAL_FLAGS to "-I .../share/alocal" where "..." is the 
     725      path to the directory tree where Flagpoll is installed. 
     726 
     727 
    698728 By default, the configuration process will configure VR Juggler and all of 
    699729 its dependencies. This includes Sonix, which is an interesting special 
    700730 case. Sonix can make use of Aaudiere, OpenAL, or AudioWorks to add sound to 
    701731 VR Juggler applications. If none of those packages is found, Sonix will 
    702  "stub out" its sound APIs. This means that Sonix and the VR 
    703  Juggler Sound Manager can still be used in applications, but no audio will 
    704  be heard at run time. See the section called "Sonix" for more 
    705  information about how to configure Sonix to use Audiere, OpenAL, or 
    706  AudioWorks. 
     732 "stub out" its sound APIs. This means that Sonix and the VR Juggler Sound 
     733 Manager can still be used in applications, but no audio will be heard at 
     734 run time. See the section called "Sonix" for more information about how to 
     735 configure Sonix to use Audiere, OpenAL, or AudioWorks. 
    707736 
    708737 For example uses of configure.pl, take a look at the Wiki page relating to 
    709  building from CVS (http://www.vrjuggler.org/twiki_public/bin/view/Juggler/ 
    710  BuildingFromCvs). It is not a replacement for this document, but it shows 
    711  how some members of the Juggler team configure VR Juggler. It also has 
    712  information on more advanced uses of configure.pl that are beyond the scope 
    713  of this document. 
     738 building from source (http://www.vrjuggler.org/twiki_public/bin/view/ 
     739 Juggler/BuildingFromSvn). It is not a replacement for this document, but it 
     740 shows how some members of the Juggler team configure VR Juggler. It also 
     741 has information on more advanced uses of configure.pl that are beyond the 
     742 scope of this document. 
    714743 
    715744 
    …… 
    717746 
    718747 As noted in the section called "Getting the Source Code and the 
    719  Dependencies", VR Juggler depends on several external software 
    720  packages. As an example, consider the case where the GMTL library is 
    721  installed in /home/user1/pkgs/GMTL with the headers in /home/user1/pkgs/ 
    722  GMTL/include. To use this installation, run configure.pl as follows: 
     748 Dependencies", VR Juggler depends on several external software packages. As 
     749 an example, consider the case where the GMTL library is installed in 
     750 /home/user1/pkgs/GMTL with the headers in /home/user1/pkgs/ GMTL/include. 
     751 To use this installation, run configure.pl as follows: 
    723752 
    724753 
    …… 
    755784 Juggler Suite are compiled correctly. For the most part, this duplicates 
    756785 information that can be found on the Wiki page relating to building from 
    757  CVS (http://www.vrjuggler.org/twiki_public/bin/view/Juggler/ 
    758  BuildingFromCvs). 
     786 source (http://www.vrjuggler.org/twiki_public/bin/view/Juggler/ 
     787 BuildingFromSvn). 
    759788 
    760789