Significant progress on issue #22. Switching it to review.

Author: mikebmcl

source/abs-new-path.tex

@@ -89,7 +89,7 @@
 
 \rSec1 [\iotwod.absnewpath.nonmember]{Non-member functions}%
 
-\indexlibrary{operator==}{abs_new_path}%
+\indexlibrarymember{operator==}{abs_new_path}%
 \begin{itemdecl}
 constexpr bool operator==(const abs_new_path& lhs, const abs_new_path& rhs) 
   noexcept;
@@ -100,7 +100,7 @@
 \tcode{lhs.at() == rhs.at()}.
 \end{itemdescr}
 
-\indexlibrary{operator!=}{abs_new_path}%
+\indexlibrarymember{operator!=}{abs_new_path}%
 \begin{itemdecl}
 constexpr bool operator!=(const abs_new_path& lhs, const abs_new_path& rhs) 
   noexcept;

source/brush-props.tex

@@ -9,7 +9,7 @@
 The \tcode{brush_props} class provides general state information that is applicable to all rendering and composing operations (\ref{\iotwod.surface.rendering}).
 
 \pnum
-It has a Wrap Mode of type \tcode{wrap_mode}, a Filter of type \tcode{filter}, a Fill Rule of type \tcode{fill_rule}, and a Brush Matrix of type \tcode{matrix_2d}.
+It has a \term{wrap mode} of type \tcode{wrap_mode}, a \term{filter} of type \tcode{filter}, a \term{fill rule} of type \tcode{fill_rule}, and a \term{brush matrix} of type \tcode{matrix_2d}.
 
 \rSec1 [\iotwod.brushprops.synopsis] {\tcode{brush_props} synopsis}
 
@@ -41,7 +41,7 @@
 
 \rSec1 [\iotwod.brushprops.cons] {\tcode{brush_props} constructors}
 
-\indexlibrary{\idxcode{brush_props}!constructor}
+\indexlibrary{\idxcode{brush_props}!constructor}%
 \begin{itemdecl}
 constexpr brush_props(
   experimental::io2d::wrap_mode w = experimental::io2d::wrap_mode::none,
@@ -56,51 +56,45 @@
 
 \pnum
 \effects
-The value of Wrap Mode is \tcode{w}.
+Constructs an object of type \tcode{brush_props}.
 
 \pnum
-The value of Filter is \tcode{fi}.
-
-\pnum
-The value of Fill Rule is \tcode{fr}.
-
-\pnum
-The value of Brush Matrix is \tcode{m}.
+The wrap mode is \tcode{w}. The filter is \tcode{fi}. The fill rule is \tcode{fr}. The brush matrix is \tcode{m}.
 \end{itemdescr}
 
 \rSec1 [\iotwod.brushprops.modifiers] {\tcode{brush_props} modifiers}
 
-\indexlibrary{\idxcode{brush_props}!\idxcode{wrap_mode}}
+\indexlibrarymember{brush_props}{wrap_mode}%
 \begin{itemdecl}
 constexpr void wrap_mode(experimental::io2d::wrap_mode w) noexcept;
 \end{itemdecl}
 \begin{itemdescr}
 \pnum
 \effects
-The value of Wrap Mode is \tcode{w}.
+The wrap mode is \tcode{w}.
 \end{itemdescr}
 
-\indexlibrary{\idxcode{brush_props}!\idxcode{filter}}
+\indexlibrarymember{brush_props}{filter}%
 \begin{itemdecl}
 constexpr void filter(experimental::io2d::filter fi) noexcept;
 \end{itemdecl}
 \begin{itemdescr}
 \pnum
 \effects
-The value of Filter is \tcode{fi}.
+The filter is \tcode{fi}.
 \end{itemdescr}
 
-\indexlibrary{\idxcode{brush_props}!\idxcode{fill_rule}}
+\indexlibrarymember{brush_props}{fill_rule}%
 \begin{itemdecl}
 constexpr void fill_rule(experimental::io2d::fill_rule fr) noexcept;
 \end{itemdecl}
 \begin{itemdescr}
 \pnum
 \effects
-The value of Fill Rule is \tcode{fr}.
+The fill rule is \tcode{fr}.
 \end{itemdescr}
 
-\indexlibrary{\idxcode{brush_props}!\idxcode{brush_matrix}}
+\indexlibrarymember{brush_props}{brush_matrix}%
 \begin{itemdecl}
 constexpr void brush_matrix(const matrix_2d& m) noexcept;
 \end{itemdecl}
@@ -111,47 +105,47 @@
 
 \pnum
 \effects
-The value of Brush Matrix is \tcode{m}.
+The brush matrix is \tcode{m}.
 \end{itemdescr}
 
 \rSec1 [\iotwod.brushprops.observers] {\tcode{brush_props} observers}
 
-\indexlibrary{\idxcode{brush_props}!\idxcode{wrap_mode}}
+\indexlibrarymember{brush_props}{wrap_mode}%
 \begin{itemdecl}
 constexpr experimental::io2d::wrap_mode wrap_mode() const noexcept;
 \end{itemdecl}
 \begin{itemdescr}
 \pnum
 \returns
-The value of Wrap Mode.
+The wrap mode.
 \end{itemdescr}
 
-\indexlibrary{\idxcode{brush_props}!\idxcode{filter}}
+\indexlibrarymember{brush_props}{filter}%
 \begin{itemdecl}
 constexpr experimental::io2d::filter filter() const noexcept;
 \end{itemdecl}
 \begin{itemdescr}
 \pnum
 \returns
-The value of Filter.
+The filter.
 \end{itemdescr}
 
-\indexlibrary{\idxcode{brush_props}!\idxcode{fill_rule}}
+\indexlibrarymember{brush_props}{fill_rule}%
 \begin{itemdecl}
 constexpr experimental::io2d::fill_rule fill_rule() const noexcept;
 \end{itemdecl}
 \begin{itemdescr}
 \pnum
 \returns
-The value of Fill Rule.
+The fill rule.
 \end{itemdescr}
 
-\indexlibrary{\idxcode{brush_props}!\idxcode{brush_matrix}}
+\indexlibrarymember{brush_props}{brush_matrix}%
 \begin{itemdecl}
 constexpr matrix_2d brush_matrix() const noexcept;
 \end{itemdecl}
 \begin{itemdescr}
 \pnum
 \returns
-The value of Brush Matrix.
+The brush matrix.
 \end{itemdescr}

source/clip-props.tex

@@ -8,7 +8,7 @@
 The \tcode{clip_props} class provides general state information that is applicable to all rendering and composing operations (\ref{\iotwod.surface.rendering}).
 
 \pnum
-It has a Clip Area of type \tcode{path_group} and a Fill Rule of type \tcode{fill_rule}.
+It has a \term{clip area} of type \tcode{path_group} and a \term{fill rule} of type \tcode{fill_rule}.
 
 \rSec1 [\iotwod.clipprops.synopsis] {\tcode{clip_props} synopsis}
 
@@ -20,8 +20,9 @@
     clip_props() noexcept;
     template <class Allocator>
     explicit clip_props(const path_builder<Allocator>& pb,
-      experimental::io2d::fill_rule = experimental::io2d::fill_rule::winding);
-    explicit clip_props(const path_group& pg, experimental::io2d::fill_rule =
+      experimental::io2d::fill_rule fr = 
+      experimental::io2d::fill_rule::winding);
+    explicit clip_props(const path_group& pg, experimental::io2d::fill_rule fr =
       experimental::io2d::fill_rule::winding) noexcept;
 
     // \ref{\iotwod.clipprops.modifiers}, modifiers:
@@ -39,65 +40,86 @@
 
 \rSec1 [\iotwod.clipprops.cons] {\tcode{clip_props} constructors}
 
-\indexlibrary{\idxcode{clip_props}!constructor}
+\indexlibrary{\idxcode{clip_props}!constructor}%
 \begin{itemdecl}
 clip_props() noexcept;
 \end{itemdecl}
 \begin{itemdescr}
 \pnum
 \effects
-The value of Clip Area is its default-constructed value.
+Equivalent to: \tcode{clip_props(path_builder<>\{ \})}.
+\end{itemdescr}
+
+\indexlibrary{\idxcode{clip_props}!constructor}%
+\begin{itemdecl}
+template <class Allocator>
+explicit clip_props(const path_builder<Allocator>& pb,
+  experimental::io2d::fill_rule fr);
+explicit clip_props(const path_group& pg, experimental::io2d::fill_rule fr) 
+  noexcept;
+\end{itemdecl}
+\begin{itemdescr}
+\pnum
+\effects
+Constructs an object of type \tcode{clip_props}.
+
+\pnum
+The clip area is:
+\begin{itemize}
+\item \tcode{path_group\{pb\}}; or
+\item \tcode{pg}.
+\end{itemize}
 
 \pnum
-The value of Fill Rule is \tcode{experimental::io2d::fill_rule::winding}.
+The fill rule is \tcode{fr}.
 \end{itemdescr}
 
 \rSec1 [\iotwod.clipprops.modifiers] {\tcode{clip_props} modifiers}
 
-\indexlibrary{\idxcode{clip_props}!\idxcode{clip}}
+\indexlibrarymember{clip}{clip_props}%
 \begin{itemdecl}
 template <class Allocator>
-void clip(const path_builder<Allocator>& pb);
-void clip(const path_group& pg) noexcept;
+void clip(const path_builder<Allocator>& pb, experimental::io2d::fill_rule fr);
+void clip(const path_group& pg, experimental::io2d::fill_rule fr) noexcept;
 \end{itemdecl}
 \begin{itemdescr}
 \pnum
 \effects
-The value of Clip Area is:
+The clip area is:
 \begin{itemize}
 \item \tcode{path_group\{pb\}}; or
 \item \tcode{pg}.
 \end{itemize}
 \end{itemdescr}
 
-\indexlibrary{\idxcode{clip_props}!\idxcode{fill_rule}}
+\indexlibrarymember{fill_rule}{clip_props}%
 \begin{itemdecl}
 void fill_rule(experimental::io2d::fill_rule fr) noexcept;
 \end{itemdecl}
 \begin{itemdescr}
 \pnum
 \effects
-The value of Fill Rule is \tcode{fr}.
+The fill rule is \tcode{fr}.
 \end{itemdescr}
 
 \rSec1 [\iotwod.clipprops.observers] {\tcode{clip_props} observers}
 
-\indexlibrary{\idxcode{clip_props}!\idxcode{clip}}
+\indexlibrarymember{clip}{clip_props}%
 \begin{itemdecl}
 path_group clip() const noexcept;
 \end{itemdecl}
 \begin{itemdescr}
 \pnum
 \returns
-The value of Clip Area.
+The clip area.
 \end{itemdescr}
 
-\indexlibrary{\idxcode{clip_props}!\idxcode{fill_rule}}
+\indexlibrarymember{fill_rule}{clip_props}%
 \begin{itemdecl}
 experimental::io2d::fill_rule fill_rule() const noexcept;
 \end{itemdecl}
 \begin{itemdescr}
 \pnum
 \returns
-The value of Fill Rule.
+The fill rule.
 \end{itemdescr}

source/io2d.tex

@@ -110,7 +110,7 @@
 \include{scope}
 \include{normative-references}
 \include{terms-and-definitions}
-\include{reqs}
+%\include{reqs}
 \include{error-reporting}
 
 %% header synopsis