| 1 | <HTML> |
|---|
| 2 | <HEAD> |
|---|
| 3 | <TITLE>Boost Test Library: FAQ</TITLE> |
|---|
| 4 | <LINK rel="stylesheet" type="text/css" href="style/btl.css" media="screen"> |
|---|
| 5 | <LINK rel="stylesheet" type="text/css" href="style/btl-print.css" media="print"> |
|---|
| 6 | <META http-equiv="Content-Language" content="en-us"> |
|---|
| 7 | <META http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> |
|---|
| 8 | </HEAD> |
|---|
| 9 | <BODY> |
|---|
| 10 | <DIV class="header"> <A href="index.html">Boost.Test</A> > <SPAN class="current_article">FAQ</SPAN> </DIV> |
|---|
| 11 | <DIV class="body"> <IMG src='btl1.gif' width='252' height='43' alt="Boost Test logo"> |
|---|
| 12 | <H1 class="subtitle">Frequently Asked Questions</H1> |
|---|
| 13 | <UL> |
|---|
| 14 | <LI><A href="#Item_1">Where the latest version of the Boost Test Library |
|---|
| 15 | is located?</A></LI> |
|---|
| 16 | <LI><A href="#Item_2">I found a bug. Where could I report it?</A></LI> |
|---|
| 17 | <LI><A href="#Item_3">I have a request for a new feature. Where could I ask |
|---|
| 18 | for it? </A></LI> |
|---|
| 19 | <LI><A href="#Item_4">How to create test case?</A></LI> |
|---|
| 20 | <LI><A href="#Item_5">How to create test suite?</A></LI> |
|---|
| 21 | <LI><A href="#Item_7">Why did I get a linker error when compiling my test |
|---|
| 22 | program?</A></LI> |
|---|
| 23 | <LI><A href="#Item_7">How could I redirect testing output?</A></LI> |
|---|
| 24 | <LI><A href="#Item_8">I want different default log trace level</A></LI> |
|---|
| 25 | <LI><A href="#Item_9">Is there dll version of Boost Test components available |
|---|
| 26 | on Win32 platform?</A></LI> |
|---|
| 27 | </UL> |
|---|
| 28 | <H2><A name="Item_1">Where the latest version of the Boost Test Library is |
|---|
| 29 | located?</A></H2> |
|---|
| 30 | <P class="first-line-indented">The latest version of Boost Test Library is |
|---|
| 31 | available online on <A href="http://www.boost.org">www.boost.org</A>.</P> |
|---|
| 32 | <H2><A name="Item_2">I found a bug. Where could I report it?</A></H2> |
|---|
| 33 | <P class="first-line-indented">Send a bug report to <A href='mailto:boost-test at emailaccount dot com (please unobscure)'>Gennadiy |
|---|
| 34 | Rozental</A>.</P> |
|---|
| 35 | <H2><A name="Item_3">I have a request for a new feature. Where could I ask |
|---|
| 36 | for it?</A></H2> |
|---|
| 37 | <P class="first-line-indented">You can send a request to <A href='mailto:boost-test at emailaccount dot com (please unobscure)'>Gennadiy |
|---|
| 38 | Rozental</A>.</P> |
|---|
| 39 | <H2><A name="Item_4">How to create test case?</A></H2> |
|---|
| 40 | <P class="first-line-indented">To create a test case use the macro BOOST_TEST_CASE( |
|---|
| 41 | test_function ). For more details see the <A href="components/utf/components/test_case/index.html">Unit |
|---|
| 42 | Test Framework</A> documentation.</P> |
|---|
| 43 | <H2><A name="Item_5">How to create test suite?</A></H2> |
|---|
| 44 | <P class="first-line-indented">To create a test suite use the macro BOOST_TEST_SUITE( |
|---|
| 45 | suite_name ). For more details see the <A href="components/utf/components/test_suite/index.html">Unit |
|---|
| 46 | Test Framework</A> documentation.</P> |
|---|
| 47 | <H2><A name="Item_6">Why did I get a linker error when compiling my test program?</A></H2> |
|---|
| 48 | <P class="first-line-indented">Boost Test Library is implemented off-line. |
|---|
| 49 | To create a test program you should link with the one of the precompiled |
|---|
| 50 | library components or use "included" version of the component located in |
|---|
| 51 | a boost/test/included directory. For example, to use Test Execution Monitor |
|---|
| 52 | you may either include the <boost/test/test_tools.hpp> and link with |
|---|
| 53 | libtest_exec_monitor.lib or you could include <boost/test/included/test_exec_monitor.hpp> in |
|---|
| 54 | which case you would not need to link with any precompiled component. Note |
|---|
| 55 | also that you should strictly follow specification on integration function |
|---|
| 56 | in other case some compilers may produce linker error like this: |
|---|
| 57 | <P> |
|---|
| 58 | <P>Unresolved external init_unit_test_suite(int, char**).</P> |
|---|
| 59 | <P>The reasons for this error is that in your implementation you should specify |
|---|
| 60 | second argument of init_unit_test_suite exactly as in a specification, i.e.: |
|---|
| 61 | char* [].</P> |
|---|
| 62 | <H2><A name="Item_7">How could I redirect testing output?</A></H2> |
|---|
| 63 | <P class="first-line-indented">Use unit_test_log::instance().set_log_output( |
|---|
| 64 | std::ostream& ). For more details see the <A href="components/utf/components/test_log/index.html">Unit |
|---|
| 65 | Test Framework </A>documentation.</P> |
|---|
| 66 | <H2><A name="Item_8">I want different default log trace level</A></H2> |
|---|
| 67 | <P class="first-line-indented">Use environment variable BOOST_TEST_LOG_LEVEL |
|---|
| 68 | to define desired log trace level. You still will be able to reset this value |
|---|
| 69 | from the command line. For the list of acceptable values see the <A href="components/utf/parameters/log_level.html">Unit |
|---|
| 70 | Test Framework</A> documentation. </P> |
|---|
| 71 | <H2><A name="Item_9">Is there DLL version of Boost Test components available |
|---|
| 72 | on Win32 platform?</A></H2> |
|---|
| 73 | <P class="first-line-indented">No. At the moment Boost Test components could |
|---|
| 74 | not be compiled into dlls to be loaded at runtime.</P> |
|---|
| 75 | </DIV> |
|---|
| 76 | <DIV class="footer"> |
|---|
| 77 | <DIV class="footer-body"> |
|---|
| 78 | <P> © <A name="Copyright">Copyright</A> <A href='mailto:boost-test at emailaccount dot com (please unobscure)'>Gennadiy |
|---|
| 79 | Rozental</A> 2001-2005. <BR> |
|---|
| 80 | Distributed under the Boost Software License, Version 1.0. |
|---|
| 81 | (See accompanying file <A href="../../../LICENSE_1_0.txt">LICENSE_1_0.txt</A> or |
|---|
| 82 | copy at <A href="http://www.boost.org/LICENSE_1_0.txt">www.boost.org/LICENSE_1_0.txt</A>)</P> |
|---|
| 83 | <P>Revised: |
|---|
| 84 | <!-- #BeginDate format:Sw1 -->17 July, 2004<!-- #EndDate --> |
|---|
| 85 | </P> |
|---|
| 86 | </DIV> |
|---|
| 87 | </DIV> |
|---|
| 88 | </BODY> |
|---|
| 89 | </HTML> |
|---|