From: John L. <jr...@us...> - 2008-01-11 23:39:10
|
Update of /cvsroot/wxlua/wxLua/docs In directory sc8-pr-cvs9.sourceforge.net:/tmp/cvs-serv13009/wxLua/docs Modified Files: install.html Log Message: Make configure even more verbose. Add more install docs Index: install.html =================================================================== RCS file: /cvsroot/wxlua/wxLua/docs/install.html,v retrieving revision 1.12 retrieving revision 1.13 diff -C2 -d -r1.12 -r1.13 *** install.html 11 Jan 2008 22:20:47 -0000 1.12 --- install.html 11 Jan 2008 23:39:05 -0000 1.13 *************** *** 6,10 **** <meta content="Info about building wxLua" name="description"> </head> - <body> <u><b><big><big>wxLua - installation guide</big></big></b></u><br> --- 6,9 ---- *************** *** 12,16 **** This document describes how to build wxLua for use as an interpreter of lua scripts and for embedding wxLua in a C++ project. ! You can build wxLua in many ways:<br> <ol> <li> --- 11,17 ---- This document describes how to build wxLua for use as an interpreter of lua scripts and for embedding wxLua in a C++ project. ! You can build wxLua on many platforms with a variety of compilers. All ! the build settings and platforms that are supported by wxWidgets are ! supported by wxLua. <br> <ol> <li> *************** *** 129,137 **** </span>(version 1.2.4 or higher) if you want to compile the <span style="font-family: monospace;">wxluaedit</span> application.</p> ! <p style="text-align: justify;"><span style="font-weight: bold;">VERY IMPORTANT: ! all instructions below suppose that you already compiled and installed ! wxWidgets (refer to wxWidgets documentation for this). If you want to ! use a precompiled package you must install the development ! package as well as the runtime package.</span></p> <p style="text-align: justify;"><span style="font-weight: bold;">wxSTC</span> is the wxWidgets wrapper around the Scintilla text control and can be --- 130,148 ---- </span>(version 1.2.4 or higher) if you want to compile the <span style="font-family: monospace;">wxluaedit</span> application.</p> ! <p style="text-align: justify;"><span style="font-weight: bold;">VERY IMPORTANT: </span></p> ! <ul> ! <li><span style="font-weight: bold;">All ! instructions below suppose that you already compiled ! or installed a working development version of ! wxWidgets. Please refer to wxWidgets documentation for this.</span></li> ! <li><span style="font-weight: bold;">If you want ! to ! use a precompiled package of wxWidgets you must install the ! development as well as the runtime package. </span></li> ! <li><span style="font-weight: bold;">You should be ! able to compile and successfully run the wxWidgets samples, please try ! at least one before attempting to compile wxLua to verify that ! wxWidgets is correctly installed before continuing.</span></li> ! </ul> <p style="text-align: justify;"><span style="font-weight: bold;">wxSTC</span> is the wxWidgets wrapper around the Scintilla text control and can be *************** *** 334,337 **** --- 345,352 ---- directory to the wxStEdit library is specified by $(WXSTEDIT).</li> </ul> + You can set these environment variables in MS Windows either at the DOS + prompt using "set WXWIN=\path\to\wxWidgets" or by right clicking on "My + Computer" -> "System" -> "Environment + Variables" and add it for yourself or for everyone. </div> <p style="text-align: justify;">Note that the <span style="font-family: monospace;">USE_WXLUAEDITAPP </span>option *************** *** 355,359 **** Open the <span style="font-family: monospace;">wxLua/build/msw/wxLua.dsw</span> project file and select the same configuration you used to ! build wxWidgets from the <span style="font-family: monospace;">"Build->Set Active Project"</span> menu.</div> <p> --- 370,375 ---- Open the <span style="font-family: monospace;">wxLua/build/msw/wxLua.dsw</span> project file and select the same configuration you used to ! build wxWidgets from the <span style="font-family: monospace;">"Build->Set ! Active Project"</span> menu.</div> <p> *************** *** 367,377 **** targets. You may also use "Batch Build" to build multiple libraries and programs at once.</p> <u><b><big><big><br> <a name="unix"></a>4. Building on Linux/Unix</big></big></b></u><br> ! <p>Quick guide: just move to the root directory of the wxLua project and type:</p> <p style="margin-left: 40px; font-family: monospace;">./configure && make</p> ! to build using the wxWidgets default build and then execute, with <span style="font-family: monospace;">root</span> permissions (you can use <span style="font-family: monospace;">su</span> or <span style="font-family: monospace;">sudo</span> --- 383,401 ---- targets. You may also use "Batch Build" to build multiple libraries and programs at once.</p> + <p>In order to compile the wxLuaEdit application you must compile + the wxStEdit library by using its project file with the same settings + that you will use for wxLua. Then set the environment variable + WXSTEDIT=/path/to/wxstedit by right clicking on "My Computer" -> + "System" -> "Environment Variables" and add it for yourself or + for everyone. You will have to close and reopen MS Visual Studio in + order for the new variable to be used.</p> <u><b><big><big><br> <a name="unix"></a>4. Building on Linux/Unix</big></big></b></u><br> ! <p>Quickstart: Move to the root directory of the wxLua project and type:</p> <p style="margin-left: 40px; font-family: monospace;">./configure && make</p> ! to build using the wxWidgets default build settings and then execute, ! with <span style="font-family: monospace;">root</span> permissions (you can use <span style="font-family: monospace;">su</span> or <span style="font-family: monospace;">sudo</span> *************** *** 385,395 **** Note that <span style="font-family: monospace;">--enable-XXX</span> or <span style="font-family: monospace;">--enable-XXX=yes</span> ! enables the option <span style="font-family: monospace;"></span>and <span style="font-family: monospace;">--disable-XXX</span> or <span style="font-family: monospace;">--enable-debug=no</span> ! disable it.<br> <br> wxLua's <span style="font-family: monospace;">configure</span> tries to determine the wxWidgets build settings automatically ! using <span style="font-family: monospace;">wx-config</span>, ! but if you have multiple wxWidgets builds (you can list them using <span style="font-family: monospace;">wx-config --list</span>) you can select the build you want using the <span style="font-family: monospace;">--enable-unicode</span>, <span style="font-family: monospace;">--enable-debug</span> --- 409,423 ---- Note that <span style="font-family: monospace;">--enable-XXX</span> or <span style="font-family: monospace;">--enable-XXX=yes</span> ! enables the option <span style="font-family: monospace;"></span>and ! <span style="font-family: monospace;">--disable-XXX</span> ! or <span style="font-family: monospace;">--enable-XXX=no</span> ! disables it.<br> <br> wxLua's <span style="font-family: monospace;">configure</span> tries to determine the wxWidgets build settings automatically ! using the <span style="font-family: monospace;">wx-config</span> ! script, ! but if you have multiple wxWidgets builds (you can list them using <span style="font-family: monospace;">wx-config --list</span>) ! you can select the build you want using the <span style="font-family: monospace;">--enable-unicode</span>, <span style="font-family: monospace;">--enable-debug</span> *************** *** 400,413 **** options only if you had built wxWidgets with them. The build settings for wxLua must be identical to the ones used by ! wxWidgets. I.e. you cannot build wxLua in ANSI mode and try to link to a Unicode build of wxWidgets! ! <br> ! <br> ! E.g. if you have a unicode, release, shared library (as opposed to static) build of wxWidgets and want to build wxLua in unicode, release, static mode, then you can do:<br> <br> ! <span style="font-family: monospace;">./configure --enable-unicode --disable-debug --disable-shared --with-wxshared</span><br> <br> --- 428,441 ---- options only if you had built wxWidgets with them. The build settings for wxLua must be identical to the ones used by ! wxWidgets, i.e. you cannot build wxLua in ANSI mode and try to link to a Unicode build of wxWidgets! ! For example, if you have a unicode, release, shared library ! (as opposed to static) build of wxWidgets and want to build wxLua in unicode, release, static mode, then you can do:<br> <br> ! <span style="font-family: monospace;">./configure ! --enable-unicode --disable-debug --disable-shared --with-wxshared</span><br> <br> *************** *** 420,427 **** The options <span style="font-family: monospace;">--enable-wxbindstc</span>, <span style="font-family: monospace;">--enable-wxluadebug</span>, ! <span style="font-family: monospace;">--enable-wxluasocket</span> let you to enable or disable compiling the wxLua <span style="font-weight: bold;">modules</span>.<br> <br> ! It is useful to know that you can compile multiple coexisting wxLua builds by running wxLua's configure script in --- 448,456 ---- The options <span style="font-family: monospace;">--enable-wxbindstc</span>, <span style="font-family: monospace;">--enable-wxluadebug</span>, ! <span style="font-family: monospace;">--enable-wxluasocket</span> ! let you to enable or disable compiling the wxLua <span style="font-weight: bold;">modules</span>.<br> <br> ! You can compile multiple coexisting wxLua builds by running wxLua's configure script in *************** *** 447,450 **** --- 476,493 ---- override the variables existing value so you may want to instead do <span style="font-family: monospace;">export LD_LIBRARY_PATH=$</span><span style="font-family: monospace;">LD_LIBRARY_PATH:</span><span style="font-family: monospace;">/path/to/wxLua/lib</span>.<br> <br> + The wxLuaEdit application depends on the wxStEdit library that you + should have compiled before trying to compile wxLua. There are two ways + to let wxLua's configure find the wxStEdit library: 1) Set the shell + environment variable before running configure <span style="font-family: monospace;">export + WXSTEDIT=/path/to/wxstedit</span> or 2) Use the <span style="font-family: monospace;">--with-wxstedit-prefix=/path/to/wxstedit</span> + configure directive. As a last resort you can help wxLua's + configure find wxStEdit or its libraries by exporting + these environment variables:<br> + <br> + <span style="font-family: monospace;">export + CPPFLAGS="-I/path/to/wxstedit/include" </span><br> + <span style="font-family: monospace;">export + LDFLAGS="-L/path/to/wxstedit/lib"</span><br> + <br> Other useful targets which you can use are:<br> <ul> *************** *** 480,484 **** The bindings in <span style="font-family: monospace;">modules/wxbind</span> contain nearly all of the classes and functions in wxWidgets. They also ! contain the appropriate <span style="font-family: monospace;">#if wxUSE_XXX</span> statements and platform dependent <span style="font-family: monospace;">__WXMSW/GTK/MAC__</span> checks that wxWidgets uses in its headers to ensure that no matter what --- 523,528 ---- The bindings in <span style="font-family: monospace;">modules/wxbind</span> contain nearly all of the classes and functions in wxWidgets. They also ! contain the appropriate <span style="font-family: monospace;">#if ! wxUSE_XXX</span> statements and platform dependent <span style="font-family: monospace;">__WXMSW/GTK/MAC__</span> checks that wxWidgets uses in its headers to ensure that no matter what |