m4_comment([$Id: test.so,v 10.32 2003/11/08 19:17:43 bostic Exp $])ifdef([__m4_product_name],, [define(__m4_product_name, m4_db)])ifelse(__m4_product_name, m4_db, [dnldefine(__m4_prev_link, build_unix/shlib)define(__m4_next_link, build_unix/notes)],[dnldefine(__m4_prev_link, xml_unix/shlib)define(__m4_next_link, xml_unix/notes)])m4_ref_title(Building __m4_product_name for UNIX/POSIX systems,    Running the test suite under UNIX,    running the @test suite under UNIX, __m4_prev_link, __m4_next_link)m4_p([dnlThe __m4_product_name test suite is built if you specifym4_linkpage(M4RELDIR/ref/build_unix/conf, --enable-test, --enable-test)as an argument when configuring __m4_product_name.  The test suite alsorequires that you configure and build the Tcl interface to thelibrary.])m4_p([dnlBefore running the tests for the first time, you may need to edit them4_path(include.tcl) file in your build directory.  The__m4_product_name configuration assumes that you intend to use theversion of the tclsh utility included in the Tcl installation with which__m4_product_name was configured to run the test suite, and furtherassumes that the test suite will be run with the libraries prebuilt inthe __m4_product_name build directory.  If either of these assumptionsare incorrect, you will need to edit the m4_path(include.tcl) file andchange the following line to correctly specify the full path to theversion of tclsh with which you are going to run the test suite:])m4_indent([set tclsh_path ...])m4_p([dnlYou may also need to change the following line to correctly specify thepath from the directory where you are running the test suite to thelocation of the __m4_product_name Tcl library you built:])m4_indent([set test_path ...])m4_p([dnlIt may not be necessary that this be a full path if you have configuredyour system's shared library mechanisms to search the directory whereyou built or installed the Tcl library.])m4_p([dnlAll __m4_product_name tests are run from within m4_bold(tclsh).  Afterstarting tclsh, you must source the file m4_path(test.tcl) in the testdirectory.  For example, if you built in the m4_path(build_unix)directory of the distribution, this would be done using the followingcommand:])m4_indent([% source ../test/test.tcl])m4_p([dnlIf no errors occur, you should get a "%" prompt.])m4_p([dnlYou are now ready to run tests in the test suite; seem4_link(M4RELDIR/ref/test/run, Running the test suite) for moreinformation.])m4_page_footer