Changeset 19195

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

Document the need for having Flagpoll installed and how to handle the case
when Flagpoll's .m4 file is not installed somewhere that aclocal searches
by default.

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • juggler/trunk/doc/INSTALL.xml

    r18919 r19195  
    139139         2002 or 2003) to compile the source code.</para> 
    140140      </section> 
     141   </section> 
     142 
     143   <section> 
     144      <title>Build Tools</title> 
     145 
     146      <para>When building on non-Windows platforms, the GNU Autotools are 
     147      required. This means that, in addition to a C++ compiler (e.g., GCC), 
     148      the following packages must be installed in order to compile VR 
     149      Juggler:</para> 
     150 
     151      <itemizedlist> 
     152         <listitem> 
     153            <para>GNU Make 3.79 or newer</para> 
     154         </listitem> 
     155 
     156         <listitem> 
     157            <para>GNU Autoconf 2.53 or newer</para> 
     158         </listitem> 
     159 
     160         <listitem> 
     161            <para>GNU Automake 1.8 or newer</para> 
     162         </listitem> 
     163      </itemizedlist> 
     164 
     165      <para>Additionally, VR Juggler 2.1 and beyond require the <ulink 
     166      url="https://realityforge.vrsource.org/view/FlagPoll/">Flagpoll</ulink> 
     167      software tool. As of this writing, the minimum required version is 
     168      0.5.0. It is recommended that all of these tools be installed in either 
     169      the <filename>/usr</filename> or the <filename>/usr/local</filename> 
     170      directory trees so that search paths do not have to be extended.</para> 
    141171   </section> 
    142172 
    …… 
    907937                        when running <command>configure.pl</command>.</para> 
    908938                     </important> 
     939 
     940                     <important> 
     941                        <para>If Flagpoll is not installed in a place where 
     942                        the <command>aclocal</command> tool searches for 
     943                        <filename>.m4</filename> files by default, then it is 
     944                        necessary to extend <command>aclocal</command>'s 
     945                        search path. This is done by setting the environment 
     946                        variable <envar>ACLOCAL_FLAGS</envar> to 
     947                        <quote><literal>-I .../share/alocal</literal></quote> 
     948                        where <quote><literal>...</literal></quote> is the 
     949                        path to the directory tree where Flagpoll is 
     950                        installed.</para> 
     951                     </important> 
    909952                  </listitem> 
    910953               </orderedlist>