• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1<html>
2<head>
3<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4<title>Document Conventions</title>
5<link rel="stylesheet" href="../math.css" type="text/css">
6<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
7<link rel="home" href="../index.html" title="Math Toolkit 2.12.0">
8<link rel="up" href="../overview.html" title="Chapter 1. Overview">
9<link rel="prev" href="navigation.html" title="Navigation">
10<link rel="next" href="hints.html" title="Other Hints and tips">
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="navigation.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../overview.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="hints.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
24</div>
25<div class="section">
26<div class="titlepage"><div><div><h2 class="title" style="clear: both">
27<a name="math_toolkit.conventions"></a><a class="link" href="conventions.html" title="Document Conventions">Document Conventions</a>
28</h2></div></div></div>
29<p>
30      <a class="indexterm" name="idm45255001704400"></a>
31    </p>
32<p>
33      This documentation aims to use of the following naming and formatting conventions.
34    </p>
35<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
36<li class="listitem">
37          C++ Code is in <code class="computeroutput"><span class="identifier">fixed</span> <span class="identifier">width</span>
38          <span class="identifier">font</span></code> and is syntax-highlighted
39          in color, for example <code class="computeroutput"><span class="keyword">double</span></code>.
40        </li>
41<li class="listitem">
42          Other code is in block <code class="literal">teletype fixed-width font</code>.
43        </li>
44<li class="listitem">
45          Replaceable text that <span class="bold"><strong>you</strong></span> will need to
46          supply is in <em class="replaceable"><code>italics</code></em>.
47        </li>
48<li class="listitem">
49          If a name refers to a free function, it is specified like this: <code class="computeroutput"><span class="identifier">free_function</span><span class="special">()</span></code>;
50          that is, it is in <em class="replaceable"><code>code font</code></em> and its name is
51          followed by <code class="computeroutput"><span class="special">()</span></code> to indicate
52          that it is a free function.
53        </li>
54<li class="listitem">
55          If a name refers to a class template, it is specified like this: <code class="computeroutput"><span class="identifier">class_template</span><span class="special">&lt;&gt;</span></code>;
56          that is, it is in code font and its name is followed by <code class="computeroutput"><span class="special">&lt;&gt;</span></code>
57          to indicate that it is a class template.
58        </li>
59<li class="listitem">
60          If a name refers to a function-like macro, it is specified like this:
61          <code class="computeroutput"><span class="identifier">MACRO</span><span class="special">()</span></code>;
62          that is, it is uppercase in code font and its name is followed by <code class="computeroutput"><span class="special">()</span></code> to indicate that it is a function-like
63          macro. Object-like macros appear without the trailing <code class="computeroutput"><span class="special">()</span></code>.
64        </li>
65<li class="listitem">
66          Names that refer to <span class="emphasis"><em>concepts</em></span> in the generic programming
67          sense (like template parameter names) are specified in CamelCase.
68        </li>
69</ul></div>
70</div>
71<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
72<td align="left"></td>
73<td align="right"><div class="copyright-footer">Copyright © 2006-2019 Nikhar
74      Agrawal, Anton Bikineev, Paul A. Bristow, Marco Guazzone, Christopher Kormanyos,
75      Hubert Holin, Bruno Lalande, John Maddock, Jeremy Murphy, Matthew Pulver, Johan
76      Råde, Gautam Sewani, Benjamin Sobotta, Nicholas Thompson, Thijs van den Berg,
77      Daryle Walker and Xiaogang Zhang<p>
78        Distributed under the Boost Software License, Version 1.0. (See accompanying
79        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>)
80      </p>
81</div></td>
82</tr></table>
83<hr>
84<div class="spirit-nav">
85<a accesskey="p" href="navigation.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../overview.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="hints.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
86</div>
87</body>
88</html>
89