test/doc/src/faq.xml

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE section PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN"  "../../../../tools/boostbook/dtd/boostbook.dtd" [
]>
<section id="btl.faq">
 <title>Frequently Asked Questions</title>
 <titleabbrev>FAQ</titleabbrev>

 <qandaset defaultlabel="none">
  <?dbhtml label-width="0%"?>

  <qandaentry>
   <question>
    <simpara>
     Where the latest version of the Boost Test Library is located?
    </simpara>
   </question>
   <answer>
    <para role="first-line-indented">
     The latest version of Boost Test Library is available online at <ulink url="http://www.boost.org/libs/test"/>
    </para>
   </answer>
  </qandaentry>

  <qandaentry>
   <question>
    <simpara>
     I found a bug. Where can I report it?
    </simpara>
   </question>
   <answer>
    <para role="first-line-indented">
     You can send a bug report to the boost users' mailing list and/or directly to
     <ulink url="mailto:boost-test =at= emailaccount =dot= com">Gennadiy Rozental</ulink>.
    </para>
   </answer>
  </qandaentry>

  <qandaentry>
   <question>
    <simpara>
     I have a request for a new feature. Where can I ask for it?
    </simpara>
   </question>
   <answer>
    <para role="first-line-indented">
     You can send a request to the boost developers' mailing list and/or directly to
     <ulink url="mailto:boost-test =at= emailaccount -dot- com">Gennadiy Rozental</ulink>.
    </para>
   </answer>
  </qandaentry>

  <qandaentry>
   <question>
    <simpara>
     How to create test case using the Unit Test Framework?
    </simpara>
   </question>
   <answer>
    <para role="first-line-indented">
     To create a test case use the macro BOOST_AUTO_TEST_CASE( test_function ). For more details see the Unit Test Framework
     <link linkend="utf.user-guide.test-organization.auto-nullary-test-case">documentation</link>.
    </para>
   </answer>
  </qandaentry>

  <qandaentry>
   <question>
    <simpara>
     How to create test suite using the Unit Test Framework?
    </simpara>
   </question>
   <answer>
    <para role="first-line-indented">
     To create a test suite use the macro BOOST_AUTO_TEST_SUITE( suite_name ). For more details see the Unit Test Framework
     <link linkend="utf.user-guide.test-organization.auto-test-suite">documentation</link>.
    </para>
   </answer>
  </qandaentry>

  <qandaentry>
   <question>
    <simpara>
     Why did I get a linker error when compiling my test program?
    </simpara>
   </question>
   <answer>
    <para role="first-line-indented">
     Boost Test Library components provide several usage variants: to create a test program you can
     link with the one of the precompiled library variants or use single-header variant. For example, to use Unit Test
     Framework you may either include the &lt;<ulink url="../../../../boost/test/unit_test.hpp"><filename>boost/test/unit_test.hpp</filename></ulink>&gt;
     and link with libunit_test_framework.lib or you can include &lt;<ulink url="../../../../boost/test/included/unit_test.hpp"><filename>boost/test/included/unit_test.hpp</filename></ulink>&gt;
     , in which case you should not need to link with any precompiled component. Note also that
     you should strictly follow specification on initialization function in other case some compilers may produce linker
     error like this.
    </para>

    <computeroutput>Unresolved external init_unit_test_suite(int, char**).</computeroutput>

    <para role="first-line-indented">
     The reason for this error is that in your implementation you should specify second argument of
     init_unit_test_suite exactly as in the specification, i.e.: char* [].
    </para>
   </answer>
  </qandaentry>

  <qandaentry>
   <question>
    <simpara>
     How can I redirect testing output?
    </simpara>
   </question>
   <answer>
    <para role="first-line-indented">
     Use unit_test_log::instance().set_log_output( std::ostream&amp; ). For more details see the Unit Test Framework 
     <link linkend="utf.user-guide.test-output.log.ct-config.output-stream">documentation</link>.
    </para>
   </answer>
  </qandaentry>

  <qandaentry>
   <question>
    <simpara>
     I want different default log trace level
    </simpara>
   </question>
   <answer>
    <para role="first-line-indented">
     Use environment variable BOOST_TEST_LOG_LEVEL to define desired log trace level. You still will be able to reset 
     this value from the command line. For the list of acceptable values see the Unit Test Framework 
     <link linkend="utf.user-guide.runtime-config.parameters">documentation</link>.
    </para>
   </answer>
  </qandaentry>

  <qandaentry>
   <question>
    <simpara>
     Is there DLL version of Boost.Test components available on Win32 platform?
    </simpara>
   </question>
   <answer>
    <para role="first-line-indented">
     Yes. Starting with Boost 1.34.0.
    </para>
   </answer>
  </qandaentry>

 </qandaset>
</section>