diff options
Diffstat (limited to 'docs/installation/build_win_test.html')
| -rw-r--r-- | docs/installation/build_win_test.html | 253 |
1 files changed, 187 insertions, 66 deletions
diff --git a/docs/installation/build_win_test.html b/docs/installation/build_win_test.html index dc477e01..9a870241 100644 --- a/docs/installation/build_win_test.html +++ b/docs/installation/build_win_test.html @@ -14,17 +14,16 @@ <body> <div xmlns="" class="navheader"> <div class="libver"> - <p>Library Version 11.2.5.3</p> + <p>Library Version 12.1.6.1</p> </div> <table width="100%" summary="Navigation header"> <tr> - <th colspan="3" align="center">Running the test suite under Windows</th> + <th colspan="3" align="center">Running the test suite under + Windows</th> </tr> <tr> <td width="20%" align="left"><a accesskey="p" href="build_win_small.html">Prev</a> </td> - <th width="60%" align="center">Chapter 5. - Building Berkeley DB for Windows - </th> + <th width="60%" align="center">Chapter 5. Building Berkeley DB for Windows </th> <td width="20%" align="right"> <a accesskey="n" href="build_win_notes.html">Next</a></td> </tr> </table> @@ -34,7 +33,8 @@ <div class="titlepage"> <div> <div> - <h2 class="title" style="clear: both"><a id="build_win_test"></a>Running the test suite under Windows</h2> + <h2 class="title" style="clear: both"><a id="build_win_test"></a>Running the test suite under + Windows</h2> </div> </div> </div> @@ -42,111 +42,231 @@ <dl> <dt> <span class="sect2"> - <a href="build_win_test.html#idp126120">Building the software needed by the tests</a> + <a href="build_win_test.html#idp458352">Building the software needed + by the tests</a> </span> </dt> <dt> <span class="sect2"> - <a href="build_win_test.html#idp137576">Running the test suite under Windows</a> + <a href="build_win_test.html#idp389880">Running the test suite under Windows</a> </span> </dt> <dt> <span class="sect2"> - <a href="build_win_test.html#build_win_test_sql">Building the software needed by the SQL tests</a> + <a href="build_win_test.html#build_win_test_sql">Building the software + needed by the SQL tests</a> </span> </dt> </dl> </div> - <p>To build the test suite on Windows platforms, you will need to configure -Tcl support. You will also need sufficient main memory (at least 64MB), -and disk (around 250MB of disk will be sufficient).</p> - <div class="sect2" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="idp126120"></a>Building the software needed by the tests</h3></div></div></div> -The test suite must be run against a Debug version of -Berkeley DB, so you will need a Debug version of the Tcl -libraries. This involves building Tcl from its source. See the Tcl -sources for more information. -Then build the Tcl API - see -<a class="xref" href="build_win_tcl.html" title="Building the Tcl API">Building the Tcl API</a> for details. -<div class="sect3" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="idp134640"></a>Visual Studio 2005 or newer</h4></div></div></div><p>To build for testing, perform the following steps:</p><p> -</p><div class="orderedlist"><ol type="1"><li>Open the Berkeley DB solution.</li><li>Ensure that the target configuration is Debug</li><li>Right click the <span class="emphasis"><em>db_tcl</em></span> project in the Solution Explorer, and select <span class="emphasis"><em>Build</em></span>.</li><li>Right click the <span class="emphasis"><em>db_test</em></span> project in the Solution Explorer, and select <span class="emphasis"><em>Build</em></span>.</li></ol></div><p> - -</p></div></div> + <p> + To build the test suite on Windows platforms, you will need + to configure Tcl support. You will also need sufficient main + memory (at least 64MB), and disk (around 250MB of disk will be + sufficient). + </p> <div class="sect2" lang="en" xml:lang="en"> <div class="titlepage"> <div> <div> - <h3 class="title"><a id="idp137576"></a>Running the test suite under Windows</h3> + <h3 class="title"><a id="idp458352"></a>Building the software needed + by the tests</h3> </div> </div> </div> - <p>Before running the tests for the first time, you must edit the file -<code class="filename">include.tcl</code> in your build directory and change the line -that reads:</p> + <p> + The test suite must be run against a Debug version of + Berkeley DB, so you will need a Debug version of the Tcl + libraries. This involves building Tcl from its source. See + the Tcl sources for more information. Then build the Tcl + API - see <a class="xref" href="build_win_tcl.html" title="Building the Tcl API">Building the Tcl API</a> for details. + </p> + <div class="sect3" lang="en" xml:lang="en"> + <div class="titlepage"> + <div> + <div> + <h4 class="title"><a id="idp472136"></a>Visual Studio 2005 or newer</h4> + </div> + </div> + </div> + <p> + To build for testing, perform the following steps: + </p> + <div class="orderedlist"> + <ol type="1"> + <li> + Open the Berkeley DB solution. + </li> + <li> + Ensure that the target configuration is + Debug + </li> + <li> + Right click the <span class="emphasis"><em>db_tcl</em></span> + project in the Solution Explorer, and select + <span class="emphasis"><em>Build</em></span>. + </li> + <li> + Right click the + <span class="emphasis"><em>db_test</em></span> project in the + Solution Explorer, and select + <span class="emphasis"><em>Build</em></span>. + </li> + </ol> + </div> + </div> + </div> + <div class="sect2" lang="en" xml:lang="en"> + <div class="titlepage"> + <div> + <div> + <h3 class="title"><a id="idp389880"></a>Running the test suite under Windows</h3> + </div> + </div> + </div> + <p> + Before running the tests for the first time, you must + edit the file <code class="filename">include.tcl</code> in your + build directory and change the line that reads: + </p> <pre class="programlisting">set tclsh_path SET_YOUR_TCLSH_PATH</pre> - <p>You will want to use the location of the <code class="filename">tclsh</code> program (be -sure to include the name of the executable). For example, if Tcl is -installed in <code class="filename">d:\tcl</code>, this line should be the following:</p> - <pre class="programlisting">set tclsh_path d:\tcl\bin\tclsh85g.exe</pre> - <p>If your path includes spaces be sure to enclose it in quotes:</p> - <pre class="programlisting">set tclsh_path "c:\Program Files\tcl\bin\tclsh85g.exe"</pre> - <p>Make sure that the path to Berkeley DB's tcl library is in your -current path. On Windows NT/2000/XP, edit your PATH using the My -Computer -> Properties -> Advanced -> Environment -Variables dialog. On earlier versions of Windows, you may find it -convenient to add a line to c:\AUTOEXEC.BAT:</p> + <p> + You will want to use the location of the + <code class="filename">tclsh</code> program (be sure to include + the name of the executable). For example, if Tcl is + installed in <code class="filename">d:\tcl</code>, this line should + be the following: + </p> + <pre class="programlisting">set tclsh_path d:\tcl\bin\tclsh85.exe</pre> + <p> + If your path includes spaces be sure to enclose it in + quotes: + </p> + <pre class="programlisting">set tclsh_path "c:\Program Files\tcl\bin\tclsh85.exe"</pre> + <p> + Make sure that the path to Berkeley DB's tcl library is + in your current path. Edit your PATH using the Control + Panel -> System -> Advanced system settings + -> Environment Variables dialog. On earlier versions of + Windows, you may find it convenient to add a line to + c:\AUTOEXEC.BAT: + </p> <pre class="programlisting">SET PATH=%PATH%;c:\db\build_windows</pre> - <p>Then, in a shell of your choice enter the following commands:</p> + <p> + Then, in a shell of your choice enter the following + commands: + </p> <div class="orderedlist"> <ol type="1"> - <li>cd build_windows</li> - <li>run <code class="filename">d:\tcl\bin\tclsh85g.exe</code>, or the equivalent name of -the Tcl shell for your system. -<p>You should get a "%" prompt.</p></li> - <li>% source ../test/tcl/test.tcl -<p>If no errors occur, you should get a "%" prompt.</p></li> + <li> + cd build_windows + </li> + <li> + run + <code class="filename">d:\tcl\bin\tclsh85.exe</code>, or the + equivalent name of the Tcl shell for your system. + <p> + You should get a "%" prompt. + </p></li> + <li> + % source ../test/tcl/test.tcl + <p> + If no + errors occur, you should get a "%" prompt. + </p></li> </ol> </div> - <p>You are now ready to run tests in the test suite; see - Running the test suite for more -information.</p> + <p> + You are now ready to run tests in the test suite; see + Running the test suite for more information. + </p> </div> <div class="sect2" lang="en" xml:lang="en"> <div class="titlepage"> <div> <div> - <h3 class="title"><a id="build_win_test_sql"></a>Building the software needed by the SQL tests</h3> + <h3 class="title"><a id="build_win_test_sql"></a>Building the software + needed by the SQL tests</h3> </div> </div> </div> - <p> The SQL test suite must be run against a Debug version of Berkeley DB, so you need a Debug version of the Tcl libraries. This involves building Tcl from its source. See the Tcl sources for more information. Then build the Tcl API - see <a class="xref" href="build_win_tcl.html" title="Building the Tcl API">Building the Tcl API</a> for details. - </p> - <p>Before building for SQL tests, build the db_tcl and db_sql_testfixture projects. This requires Tcl 8.5 or above. If you are using a later version of Tcl, edit the Tcl library that db_tcl and db_sql_testfixture link to. </p> - <p>To do this right click the <span class="emphasis"><em>db_tcl</em></span><code class="literal">/</code><span class="emphasis"><em>db_sql_testfixture</em></span> project, select <span class="emphasis"><em>Properties->Configuration Properties->Linker->Input->Additional Dependencies</em></span> and edit the Tcl library, <span class="emphasis"><em>tcl85g.lib</em></span>, to match the version you are using. - </p> - <p>Building the db_sql_testfixture project builds the testfixture.exe program in <code class="literal">../build_windows/Win32/Debug</code>. It also builds the projects db and db_sql, on which it depends. - </p> + <p> + The SQL test suite must be run against a Debug version + of Berkeley DB, so you need a Debug version of the Tcl + libraries. This involves building Tcl from its source. See + the Tcl sources for more information. Then build the Tcl + API - see <a class="xref" href="build_win_tcl.html" title="Building the Tcl API">Building the Tcl API</a> for details. + </p> + <p> + Before building for SQL tests, build the db_tcl and + db_sql_testfixture projects. This requires Tcl 8.5 or + above. If you are using a later version of Tcl, edit the + Tcl library that db_tcl and db_sql_testfixture link to. + </p> + <p> + To do this right click the + <span class="emphasis"><em>db_tcl</em></span><code class="literal">/</code><span class="emphasis"><em>db_sql_testfixture</em></span> + project, select <span class="emphasis"><em>Properties -> Configuration + Properties -> Linker -> Input -> Additional + Dependencies</em></span> and edit the Tcl library, + <span class="emphasis"><em>tcl85.lib</em></span>, to match the version + you are using. + </p> + <p> + Building the db_sql_testfixture project builds the + testfixture.exe program in + <code class="literal">../build_windows/Win32/Debug</code>. It + also builds the projects db and db_sql, on which it + depends. + </p> <div class="sect3" lang="en" xml:lang="en"> <div class="titlepage"> <div> <div> - <h4 class="title"><a id="idp154912"></a>Visual Studio 2005 or newer</h4> + <h4 class="title"><a id="idp488224"></a>Visual Studio 2005 or newer</h4> </div> </div> </div> - <p> To build for testing, perform the following steps:</p> + <p> + To build for testing, perform the following steps: + </p> <div class="orderedlist"> <ol type="1"> - <li>Open the Berkeley DB solution.</li> - <li>Ensure that the target configuration is Debug.</li> - <li>Right click the <span class="emphasis"><em>db_tcl</em></span> project in the Solution Explorer, and select <span class="emphasis"><em>Build</em></span>.</li> - <li>Right click the <span class="emphasis"><em>db_sql_testfixture</em></span> project in the Solution Explorer, and select <span class="emphasis"><em>Build</em></span>.</li> + <li> + Open the Berkeley DB solution. + </li> + <li> + Ensure that the target configuration is + Debug. + </li> + <li> + Right click the <span class="emphasis"><em>db_tcl</em></span> + project in the Solution Explorer, and select + <span class="emphasis"><em>Build</em></span>. + </li> + <li> + Right click the + <span class="emphasis"><em>db_sql_testfixture</em></span> + project in the Solution Explorer, and select + <span class="emphasis"><em>Build</em></span>. + </li> </ol> </div> - <p>To test extensions, specify the following in the <span class="emphasis"><em>Preprocessor Definitions</em></span> of the <span class="emphasis"><em>db_sql_testfixture</em></span> project:</p> + <p> + To test extensions, specify the following in the + <span class="emphasis"><em>Preprocessor Definitions</em></span> of + the <span class="emphasis"><em>db_sql_testfixture</em></span> project: + </p> <div class="itemizedlist"> <ul type="disc"> - <li><code class="literal">SQLITE_ENABLE_FTS3</code> to enable the full text search layer</li> - <li><code class="literal">SQLITE_ENABLE_RTREE</code> to enable the R-Tree layer</li> + <li><code class="literal"> + SQLITE_ENABLE_FTS3</code> to enable + the full text search layer + </li> + <li><code class="literal"> + SQLITE_ENABLE_RTREE</code> to enable + the R-Tree layer + </li> </ul> </div> </div> @@ -163,7 +283,8 @@ information.</p> <td width="40%" align="right"> <a accesskey="n" href="build_win_notes.html">Next</a></td> </tr> <tr> - <td width="40%" align="left" valign="top">Building a small memory footprint library </td> + <td width="40%" align="left" valign="top">Building a small memory + footprint library </td> <td width="20%" align="center"> <a accesskey="h" href="index.html">Home</a> </td> |