Resolved #22. Fixed up some typological issues and style issues.

Author: mikebmcl

source/antialias.tex

@@ -1,15 +1,15 @@
 %!TEX root = io2d.tex
 \rSec0 [\iotwod.antialias] {Enum class \tcode{antialias}}
 
-\rSec1 [\iotwod.antialias.summary] {\tcode{antialias} Summary}
+\rSec1 [\iotwod.antialias.summary] {\tcode{antialias} summary}
 
 \pnum
 The antialias enum class specifies the type of anti-aliasing that the rendering
 system uses for rendering and composing paths. See 
 Table~\ref{tab:\iotwod.antialias.meanings} for the meaning of each
 \tcode{antialias} enumerator.
 
-\rSec1 [\iotwod.antialias.synopsis] {\tcode{antialias} Synopsis}
+\rSec1 [\iotwod.antialias.synopsis] {\tcode{antialias} synopsis}
 
 \indexlibrary{\idxcode{antialias}}%
 \begin{codeblock}
@@ -23,7 +23,7 @@
 }
 \end{codeblock}
 
-\rSec1 [\iotwod.antialias.enumerators] {\tcode{antialias} Enumerators}
+\rSec1 [\iotwod.antialias.enumerators] {\tcode{antialias} enumerators}
 
 \begin{libreqtab2}
  {\tcode{antialias} enumerator meanings}

source/arc.tex

@@ -151,7 +151,8 @@
 As-if:
 \begin{codeblock}
 auto lmtx = m;
-lmtx.m20(0.0f); lmtx.m21(0.0f); // Eliminate translation.
+lmtx.m20(0.0f);
+lmtx.m21(0.0f);
 auto centerOffset = point_for_angle(two_pi<float> - _Start_angle, _Radius);
 centerOffset.y(-centerOffset.y());
 return cpt - centerOffset * lmtx;
@@ -170,7 +171,8 @@
 \begin{codeblock}
 auto lmtx = m;
 auto tfrm = matrix_2d::init_rotate(_Start_angle + _Rotation);
-lmtx.m20(0.0f); lmtx.m21(0.0f); // Eliminate translation.
+lmtx.m20(0.0f);
+lmtx.m21(0.0f);
 auto pt = (_Radius * tfrm);
 pt.y(-pt.y());
 return cpt + pt * lmtx;

source/brush-type.tex

@@ -1,7 +1,7 @@
 %!TEX root = io2d.tex
 \rSec0 [\iotwod.brushtype] {Enum class \tcode{brush_type}}
 
-\rSec1 [\iotwod.brushtype.summary] {\tcode{brush_type} Summary}
+\rSec1 [\iotwod.brushtype.summary] {\tcode{brush_type} summary}
 
 \pnum
 The \tcode{brush_type} enum class denotes the type of a \tcode{brush} object.
@@ -10,7 +10,7 @@
 See Table~\ref{tab:\iotwod.brushtype.meanings} for the meaning of each
 \tcode{brush_type} enumerator.
 
-\rSec1 [\iotwod.brushtype.synopsis] {\tcode{brush_type} Synopsis}
+\rSec1 [\iotwod.brushtype.synopsis] {\tcode{brush_type} synopsis}
 
 \begin{codeblock}
 namespace std::experimental::io2d::v1 {
@@ -23,7 +23,7 @@
 }
 \end{codeblock}
 
-\rSec1 [\iotwod.brushtype.enumerators] {\tcode{brush_type} Enumerators}
+\rSec1 [\iotwod.brushtype.enumerators] {\tcode{brush_type} enumerators}
 \begin{libreqtab2}
  {\tcode{brush_type} enumerator meanings}
  {tab:\iotwod.brushtype.meanings}

source/brush.tex

@@ -1,29 +1,30 @@
 %!TEX root = io2d.tex
 \rSec0 [\iotwod.brush] {Class \tcode{brush}}
 
-\rSec1 [\iotwod.brush.intro] {\tcode{brush} Description}
+\rSec1 [\iotwod.brush.intro] {\tcode{brush} summary}
 
 \pnum
 \indexlibrary{\idxcode{brush}}%
-The class \tcode{brush} describes an opaque wrapper for a graphics data graphics resource.
+The class \tcode{brush} describes an opaque wrapper for graphics data.
 
 \pnum
 A \tcode{brush} object is usable with any \tcode{surface} or \tcode{surface}-derived object.
 
 \pnum
-A \tcode{brush} object's graphics data is immutable. It is observable only by the effect that it produces when the brush is used as a Source Brush or as a Mask Brush (\ref{\iotwod.surface.rendering.brushes}).
+A \tcode{brush} object's graphics data is immutable. It is observable only by the effect that it produces when the brush is used as a \term{
+source brush} or as a \term{mask brush} (\ref{\iotwod.surface.rendering.brushes}).
 
 \pnum
 A \tcode{brush} object has a brush type of \tcode{brush_type}, which indicates which type of brush it is (Table~\ref{tab:\iotwod.brushtype.meanings}).
 
 \pnum
-As a result of technological limitations and considerations, a \tcode{brush} object's graphics data can have less precision than the data from which it was created.
-
-\pnum
-\begin{example}
-Several graphics and rendering technologies that are currently widely used typically store individual color and alpha channel data as 8-bit unsigned normalized integer values while the \tcode{float} type that is used by the \tcode{rgba_color} class for individual color and alpha is often a 64-bit value. As such, it is possible for a loss of precision when transforming the 64-bit channel data of an \tcode{rgba_color} object to the 8-bit channel data that is commonly used internally in such graphics and rendering technologies.
-\end{example}
+As a result of technological limitations and considerations, a \tcode{brush} object's graphics data may have less precision than the data from which it was created.
 
+%\pnum
+%\begin{example}
+%Several graphics and rendering technologies that are currently widely used typically store individual color and alpha channel data as 8-bit unsigned normalized integer values while the \tcode{float} type that is used by the \tcode{rgba_color} class for individual color and alpha is often a 64-bit value. As such, it is possible for a loss of precision when transforming the 64-bit channel data of an \tcode{rgba_color} object to the 8-bit channel data that is commonly used internally in such graphics and rendering technologies.
+%\end{example}
+%
 \rSec1 [\iotwod.brush.synopsis] {\tcode{brush} synopsis}
 
 \begin{codeblock}
@@ -64,22 +65,22 @@
 \rSec2 [\iotwod.brush.sampling.color] {Sampling from a solid color brush}
 
 \pnum
-When \tcode{b} is a solid color brush, then when sampling from \tcode{b}, the visual data returned shall always be the visual data equivalent \tcode{rgba_color} used to construct \tcode{b}, regardless of the point which is to be sampled and regardless of the return values of Wrap Mode, Filter, and Matrix.
+When \tcode{b} is a solid color brush, then when sampling from \tcode{b}, the visual data returned is always the visual data used to construct \tcode{b}, regardless of the point which is to be sampled and regardless of the return values of wrap mode, filter, and brush matrix or mask matrix.
 
 \rSec2 [\iotwod.brush.sampling.linear] {Sampling from a linear gradient brush}
 
 \pnum
-When \tcode{b} is a linear gradient brush, when sampling point \tcode{pt}, where \tcode{pt} is the return value of calling the \tcode{transform_point} member function of Matrix using the requested point, from \tcode{b}, the visual data returned shall be as specified by \ref{\iotwod.gradients.linear} and \ref{\iotwod.gradients.sampling}.
+When \tcode{b} is a linear gradient brush, when sampling point \tcode{pt}, where \tcode{pt} is the return value of calling the \tcode{transform_point} member function of brush matrix or mask matrix using the requested point, from \tcode{b}, the visual data returned are as specified by \ref{\iotwod.gradients.linear} and \ref{\iotwod.gradients.sampling}.
 
 \rSec2 [\iotwod.brush.sampling.radial] {Sampling from a radial gradient brush}
 
 \pnum
-When \tcode{b} is a radial gradient brush, when sampling point \tcode{pt}, where \tcode{pt} is the return value of calling the \tcode{transform_point} member function of Matrix using the requested point, from \tcode{b}, the visual data returned shall be as specified by \ref{\iotwod.gradients.radial} and \ref{\iotwod.gradients.sampling}.
+When \tcode{b} is a radial gradient brush, when sampling point \tcode{pt}, where \tcode{pt} is the return value of calling the \tcode{transform_point} member function of brush matrix or mask matrix using the requested point, from \tcode{b}, the visual data are as specified by \ref{\iotwod.gradients.radial} and \ref{\iotwod.gradients.sampling}.
 
 \rSec2 [\iotwod.brush.sampling.surface] {Sampling from a surface brush}
 
 \pnum
-When \tcode{b} is a surface brush, when sampling point \tcode{pt}, where \tcode{pt} is the return value of calling the \tcode{transform_point} member function of Matrix using the requested point, from \tcode{b}, the visual data returned shall be from the point \tcode{pt} in the graphics data of the brush, taking into account the values of Wrap Mode and Filter.
+When \tcode{b} is a surface brush, when sampling point \tcode{pt}, where \tcode{pt} is the return value of calling the \tcode{transform_point} member function of brush matrix or mask matrix using the requested point, from \tcode{b}, the visual data returned are from the point \tcode{pt} in the graphics data of the brush, taking into account the values of wrap mode and filter.
 
 \rSec1 [\iotwod.brush.cons] {\tcode{brush} constructors and assignment operators}
 
@@ -96,7 +97,7 @@
 The brush's brush type shall be set to the value \tcode{brush_type::solid_color}.
 
 \pnum
-The graphics data of the brush shall be created from the value of \tcode{c}. The visual data format of the graphics data shall be as-if it is that specified by \tcode{format::argb}.
+The graphics data of the brush are created from the value of \tcode{c}. The visual data format of the graphics data are as-if it is that specified by \tcode{format::argb32}.
 
 \pnum
 \remarks
@@ -112,7 +113,7 @@
 \begin{itemdescr}
 \pnum
 \effects
-Constructs a linear gradient \tcode{brush} object with a begin point of \tcode{begin}, an end point of \tcode{end}, and a color stop collection containing the values in the range \range{first}{last}.
+Constructs a linear gradient \tcode{brush} object with a begin point of \tcode{begin}, an end point of \tcode{end}, and a sequential series of \tcode{color stop} values beginning at {first} and ending at {last - 1}.
 
 \pnum
 The brush's brush type is \tcode{brush_type::linear}.
@@ -130,7 +131,7 @@
 \begin{itemdescr}
 \pnum
 \effects
-Constructs a linear gradient \tcode{brush} object with a begin point of \tcode{begin}, an end point of \tcode{end}, and a color stop collection containing the \tcode{color_stop} objects in \tcode{il}.
+Constructs a linear gradient \tcode{brush} object with a begin point of \tcode{begin}, an end point of \tcode{end}, and the sequential series of \tcode{color stop} values in \tcode{il}.
 
 \pnum
 The brush's brush type is \tcode{brush_type::linear}.
@@ -149,7 +150,7 @@
 \begin{itemdescr}
 \pnum
 \effects
-Constructs a radial gradient \tcode{brush} object with a start circle of \tcode{start}, an end circle of \tcode{end}, and a color stop collection containing the values in the range \range{first}{last}.
+Constructs a radial gradient \tcode{brush} object with a start circle of \tcode{start}, an end circle of \tcode{end},  and a sequential series of \tcode{color stop} values beginning at {first} and ending at {last - 1}.
 
 \pnum
 The brush's brush type is \tcode{brush_type::radial}.
@@ -167,7 +168,7 @@
 \begin{itemdescr}
 \pnum
 \effects
-Constructs a radial gradient \tcode{brush} object with a start circle of \tcode{start}, an end circle of \tcode{end}, and a color stop collection containing the \tcode{color_stop} objects in \tcode{il}.
+Constructs a radial gradient \tcode{brush} object with a start circle of \tcode{start}, an end circle of \tcode{end}, and the sequential series of \tcode{color stop} values in \tcode{il}.
 
 \pnum
 The brush's brush type is \tcode{brush_type::radial}.
@@ -191,11 +192,11 @@
 The brush's brush type is \tcode{brush_type::surface}.
 
 \pnum
-The graphics data of the brush is as-if it is the \underlyingimagesurface of \tcode{img}.
+The graphics data of the brush is as-if it is the raster graphics data of \tcode{img}.
 
 \pnum
 \remarks
-Sampling from this brush shall produce the results specified in \ref{\iotwod.brush.sampling.surface}.
+Sampling from this brush produces the results specified in \ref{\iotwod.brush.sampling.surface}.
 \end{itemdescr}
 
 \rSec1 [\iotwod.brush.observers]{\tcode{brush} observers}

source/brushes.tex

@@ -25,23 +25,22 @@
 \end{note}
 
 \pnum
-A brush is used either as a Source Brush or a Mask Brush (\ref{\iotwod.surface.rendering.brushes}).
+A brush is used either as a \term{source brush} or a \term{mask brush} (\ref{\iotwod.surface.rendering.brushes}).
 
 \pnum
-When a brush is used in a rendering and composing operation, if it is used as a Source Brush, it has a \tcode{brush_props} object that describes how the brush is interpreted for purposes of sampling. If it is used as a Mask Brush, it has a \tcode{mask_props} object that describes how the brush is interpreted for purposes of sampling.
+When a brush is used in a rendering and composing operation, if it is used as a source brush, it has a \tcode{brush_props} object that describes how the brush is interpreted for purposes of sampling. If it is used as a mask brush, it has a \tcode{mask_props} object that describes how the brush is interpreted for purposes of sampling.
 
 \pnum
-The \tcode{brush_props} and \tcode{mask_props} classes both have a Wrap Mode, Filter and Matrix (\ref{\iotwod.brushprops.summary} and \ref{\iotwod.maskprops.summary}). Where necessary, these shall be referenced using those terms without regard to whether the brush is being used as a Source Brush or a Mask Brush.
-
+The \tcode{brush_props} (\ref{\iotwod.brushprops.summary}) and \tcode{mask_props} (\ref{\iotwod.maskprops.summary}) classes each have a \term{wrap mode} and a \term{filter}. The \tcode{brush_props} class also has a \term{brush matrix} and a \term{fill rule}. The \tcode{mask_props} class also has a \tcode{mask matrix}. Where possible, the terms that are common between the two classes are referenced without regard to whether the brush is being used as a source brush or a mask brush.
 
 %\pnum
 %A brush has its own coordinate space.
 %
 %\pnum
-%If it is being used as a Source Brush, it is the Brush Coordinate Space (\ref{\iotwod.surface.coordinatespaces}).
+%If it is being used as a source brush, it is the Brush Coordinate Space (\ref{\iotwod.surface.coordinatespaces}).
 %
 %\pnum
-%If it is being used as a Mask Brush, it is the Mask Coordinate Space (\ref{\iotwod.surface.coordinatespaces}).
+%If it is being used as a mask brush, it is the Mask Coordinate Space (\ref{\iotwod.surface.coordinatespaces}).
 %
 %\pnum
 %It possesses a \tcode{filter} value and a \tcode{wrap_mode} value, which combine to determine the visual data value returned when a composing operation samples a brush.

source/circle.tex

@@ -1,22 +1,22 @@
 %!TEX root = io2d.tex
 \rSec0 [\iotwod.circle] {Class \tcode{circle}}
 
-\rSec1 [\iotwod.circle.intro] {\tcode{circle} Description}
+\rSec1 [\iotwod.circle.intro] {\tcode{circle} description}
 
 \pnum
 \indexlibrary{\idxcode{circle}}%
 The class \tcode{circle} describes a circle.
 
 \pnum
-It has a Center of type \tcode{vector_2d} and a Radius of type \tcode{float}.
+It has a \term{center} of type \tcode{vector_2d} and a \term{radius} of type \tcode{float}.
 
 \rSec1 [\iotwod.circle.synopsis] {\tcode{circle} synopsis}
 
 \begin{codeblock}
 namespace std::experimental::io2d::v1 {
   class circle {
   public:
-    // \ref{\iotwod.circle.cons}, construct/copy/move/destroy:
+    // \ref{\iotwod.circle.cons}, constructors:
     constexpr circle() noexcept;
     contexpr circle(const vector_2d& ctr, float rad) noexcept;
 
@@ -31,7 +31,7 @@
 }
 \end{codeblock}
 
-\rSec1 [\iotwod.circle.cons] {\tcode{circle} constructors and assignment operators}
+\rSec1 [\iotwod.circle.cons] {\tcode{circle} constructors}
 
 \indexlibrary{\idxcode{circle}!constructor}%
 \begin{itemdecl}
@@ -40,13 +40,7 @@
 \begin{itemdescr}
 \pnum
 \effects
-Constructs an object of type \tcode{circle}.
-
-\pnum
-The value of Center is \tcode{vector_2d\{0,0, 0.0f\}}.
-
-\pnum
-The value of Radius is \tcode{0.0f}.
+Equivalent to: \tcode{circle(\{ 0.0f, 0.0f \}, 0.0f)}.
 \end{itemdescr}
 
 \indexlibrary{\idxcode{circle}!constructor}%
@@ -62,10 +56,7 @@
 Constructs an object of type \tcode{circle}.
 
 \pnum
-The value of Center is \tcode{ctr}.
-
-\pnum
-The value of Radius is \tcode{r}.
+The center is \tcode{ctr}. The fadius is \tcode{r}.
 \end{itemdescr}
 
 \rSec1 [\iotwod.circle.modifiers]{\tcode{circle} modifiers}
@@ -78,7 +69,7 @@
 \begin{itemdescr}
 \pnum
 \effects
-The value of Center is \tcode{ctr}.
+The center is \tcode{ctr}.
 \end{itemdescr}
 
 \indexlibrary{\idxcode{circle}!\idxcode{radius}}%
@@ -91,7 +82,7 @@
 
 \pnum
 \effects
-The value of Radius is \tcode{r}.
+The radius is \tcode{r}.
 \end{itemdescr}
 
 \rSec1 [\iotwod.circle.observers]{\tcode{circle} observers}
@@ -103,7 +94,7 @@
 \begin{itemdescr}
 \pnum
 \returns
-The value of Center.
+The center.
 \end{itemdescr}
 
 \indexlibrary{\idxcode{circle}!\idxcode{radius}}%
@@ -113,5 +104,5 @@
 \begin{itemdescr}
 \pnum
 \returns
-The value of Radius.
+The radius.
 \end{itemdescr}

source/color-stop.tex

@@ -10,7 +10,7 @@
 \pnum
 It has an offset of type \tcode{float} and a color of type \tcode{rgba_color}.
 
-\rSec2 [\iotwod.colorstops.colorstop.synopsis] {\tcode{color_stop} Synopsis}
+\rSec2 [\iotwod.colorstops.colorstop.synopsis] {\tcode{color_stop} synopsis}
 
 \begin{codeblock}
 namespace std::experimental::io2d::v1 {

source/compositing-op.tex

@@ -115,17 +115,17 @@
 own value.
 
 \pnum
-The basic enumerators specify a value for Bound. This value may be 'Yes', 
+The basic enumerators specify a value for \term{bound}. This value may be 'Yes', 
 'No', or 'N/A'.
 
 \pnum
-If the Bound value is 'Yes', then the source is treated as though it is 
+If the bound value is 'Yes', then the source is treated as though it is 
 also a mask. As such, only areas of the surface where the source would affect 
 the surface are altered. The remaining areas of the surface have the same color 
 value as before the compositing operation.
 
 \pnum
-If the Bound value is 'No', then every area of the surface that is not 
+If the bound value is 'No', then every area of the surface that is not 
 affected by the source will become transparent black. In effect, it is as 
 though the source was treated as being the same size as the destination surface 
 with every part of the source that does not already have a color value assigned 
@@ -134,22 +134,22 @@
 black such that evaluation can be bypassed due to the predetermined outcome.
 
 \pnum
-If the Bound value is 'N/A', the operation would have the same effect 
+If the bound value is 'N/A', the operation would have the same effect 
 regardless of whether it was treated as 'Yes' or 'No' such that those 
-Bound values are not applicable to the operation. A 'N/A' formula when 
+bound values are not applicable to the operation. A 'N/A' formula when 
 applied to an area where the source does not provide a value will evaluate to 
 the original value of the destination even if the source is treated as having a 
 value there of transparent black. As such the result is the same as-if the 
 source were treated as being a mask, i.e. 'Yes' and 'No' treatment each 
 produce the same result in areas where the source does not have a value.
 
 \pnum
-If a clip is set and the Bound value is 'Yes' or 'N/A', then only those
+If a clip is set and the bound value is 'Yes' or 'N/A', then only those
 areas of the surface that the are within the clip will be affected by the
 compositing operation.
 
 \pnum
-If a clip is set and the Bound value is 'No', then only those areas of
+If a clip is set and the bound value is 'No', then only those areas of
 the surface that the are within the clip will be affected by the compositing
 operation. Even if no part of the source is within the clip, the operation will
 still set every area within the clip to transparent black. Areas outside the
@@ -325,7 +325,7 @@
 \end{note}
 
 \pnum
-All of the blend enumerators and hsl enumerators have a Bound value of 'N/A'.
+All of the blend enumerators and hsl enumerators have a bound value of 'N/A'.
 
 \begin{libreqtab2}
  {\tcode{compositing_op} blend enumerator meanings}