libs/test/doc/html/boost_test/intro/how_to_read.html

   1 <html>
   2 <head>
   3 <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
   4 <title>How to read this documentation</title>
   5 <link rel="stylesheet" href="../../boostbook.css" type="text/css">
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
   7 <link rel="home" href="../../index.html" title="Boost.Test">
   8 <link rel="up" href="../intro.html" title="Introduction">
   9 <link rel="prev" href="design_rationale.html" title="Design rationale">
  10 <link rel="next" href="../usage_variants.html" title="Usage variants">
  11 </head>
  12 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  13 <table cellpadding="2" width="100%"><tr>
  14 <td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
  15 <td align="center"><a href="../../../../../../index.html">Home</a></td>
  16 <td align="center"><a href="../../../../../../libs/libraries.htm">Libraries</a></td>
  17 <td align="center"><a href="http://www.boost.org/users/people.html">People</a></td>
  18 <td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td>
  19 <td align="center"><a href="../../../../../../more/index.htm">More</a></td>
  20 </tr></table>
  21 <hr>
  22 <div class="spirit-nav">
  23 <a accesskey="p" href="design_rationale.html"><img src="../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../intro.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="../usage_variants.html"><img src="../../../../../../doc/src/images/next.png" alt="Next"></a>
  24 </div>
  25 <div class="section">
  26 <div class="titlepage"><div><div><h3 class="title">
  27 <a name="boost_test.intro.how_to_read"></a><a class="link" href="how_to_read.html" title="How to read this documentation">How to read this documentation</a>
  28 </h3></div></div></div>
  29 <p>
  30         This documentation is structured by what <span class="bold"><strong>you</strong></span>,
  31         as a user, need to know to successfully use the <span class="emphasis"><em>Unit Test Framework</em></span>
  32         and the order of decisions you have to make and order of complexity of the
  33         problems you might encounter. If you ever find yourself facing with some
  34         unclear term feel free to jump directly to the <a class="link" href="../section_glossary.html" title="Glossary">glossary</a>
  35         section, where short definitions for all used terms were collected.
  36       </p>
  37 <p>
  38         Typically, when writing a test module using the <span class="emphasis"><em>Unit Test Framework</em></span>
  39         you have to go through the following steps:
  40       </p>
  41 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
  42 <li class="listitem">
  43             You decide how you want to incorporate the <span class="emphasis"><em>Unit Test Framework</em></span>:
  44             <code class="computeroutput"><span class="preprocessor">#include</span></code> it as a header-only
  45             library, or link with it as a static library, or use it as a shared (or
  46             dynamically loaded) library. For details on this topic see section <a class="link" href="../usage_variants.html" title="Usage variants">Usage variants</a>.
  47           </li>
  48 <li class="listitem">
  49             You add a <a class="link" href="../section_glossary.html#test_case">test case</a> into a <a class="link" href="../section_glossary.html#ref_test_tree">test
  50             tree</a>. For details, see section <a class="link" href="../tests_organization/test_cases.html" title="Test cases">Test
  51             cases</a>.
  52           </li>
  53 <li class="listitem">
  54             You perform correctness checks of the code under tested. For details,
  55             see section <a class="link" href="../testing_tools.html" title="Writing unit tests">Writing unit tests</a>.
  56           </li>
  57 <li class="listitem">
  58             You perform the initialization of code under test before each test case.
  59             For details, see section <a class="link" href="../tests_organization/fixtures.html" title="Fixtures">Fixtures</a>.
  60           </li>
  61 <li class="listitem">
  62             You might want to customize the way test failures are reported. For details,
  63             see section <a class="link" href="../test_output.html" title="Controlling outputs">Controlling output</a>.
  64           </li>
  65 <li class="listitem">
  66             You can control the run-time behavior of the built test module (e.g.,
  67             run only selected tests, change the output format). This is covered in
  68             section <a class="link" href="../runtime_config.html" title="Runtime parameters">Runtime configuration</a>.
  69           </li>
  70 </ul></div>
  71 <p>
  72         If you can't find answer to your question in any of the section mentioned
  73         above or if you believe you need even more configuration options, you can
  74         check <a class="link" href="../adv_scenarios.html" title="Advanced Usage Scenarios">Advanced usage scenarios</a>
  75         section.
  76       </p>
  77 </div>
  78 <table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
  79 <td align="left"></td>
  80 <td align="right"><div class="copyright-footer">Copyright &#169; 2001-2019 Boost.Test
  81       contributors<p>
  82         Distributed under the Boost Software License, Version 1.0. (See accompanying
  83         file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)
  84       </p>
  85 </div></td>
  86 </tr></table>
  87 <hr>
  88 <div class="spirit-nav">
  89 <a accesskey="p" href="design_rationale.html"><img src="../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../intro.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="../usage_variants.html"><img src="../../../../../../doc/src/images/next.png" alt="Next"></a>
  90 </div>
  91 </body>
  92 </html>