how_to_read.html 5.9 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192
  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>