Minor edits to library discovered while fixing \effects clauses

* fix punctuation in \returns
* add missing \tcodes
* break long lines

Author: Dawn Perchik

source/atomics.tex

@@ -817,7 +817,7 @@
 
 \begin{itemdescr}
 \pnum
-\returns True if the object's operations are lock-free, false otherwise.
+\returns \tcode{true} if the object's operations are lock-free, \tcode{false} otherwise.
 \enternote
 The return value of the \tcode{is_lock_free} member function
 is consistent with the value of \tcode{is_always_lock_free} for the same type.
@@ -882,7 +882,7 @@
 \effects As if by \tcode{store(desired)}.
 
 \pnum
-\returns \tcode{desired}
+\returns \tcode{desired}.
 \end{itemdescr}
 
 \indexlibrary{\idxcode{atomic type}!\idxcode{atomic_load}}%
@@ -1149,7 +1149,7 @@
 \effects As if by \tcode{fetch_\placeholder{key}(operand)}.
 
 \pnum
-\returns \tcode{fetch_\placeholder{key}(operand) op operand}
+\returns \tcode{fetch_\placeholder{key}(operand) op operand}.
 \end{itemdescr}
 
 \indexlibrary{\idxcode{atomic type}!\idxcode{operator++}}%
@@ -1161,7 +1161,7 @@
 
 \begin{itemdescr}
 \pnum
-\returns \tcode{fetch_add(1)}
+\returns \tcode{fetch_add(1)}.
 \end{itemdescr}
 
 \indexlibrary{\idxcode{atomic type}!\idxcode{operator\dcr}}%
@@ -1173,7 +1173,7 @@
 
 \begin{itemdescr}
 \pnum
-\returns \tcode{fetch_sub(1)}
+\returns \tcode{fetch_sub(1)}.
 \end{itemdescr}
 
 \indexlibrary{\idxcode{atomic type}!\idxcode{operator++}}%
@@ -1188,7 +1188,7 @@
 \effects As if by \tcode{fetch_add(1)}.
 
 \pnum
-\returns \tcode{fetch_add(1) + 1}
+\returns \tcode{fetch_add(1) + 1}.
 \end{itemdescr}
 
 \indexlibrary{\idxcode{atomic type}!\idxcode{operator\dcr}}%
@@ -1203,7 +1203,7 @@
 \effects As if by \tcode{fetch_sub(1)}.
 
 \pnum
-\returns \tcode{fetch_sub(1) - 1}
+\returns \tcode{fetch_sub(1) - 1}.
 \end{itemdescr}
 
 \rSec1[atomics.flag]{Flag type and operations}
@@ -1276,7 +1276,8 @@
 \tcode{order}. These operations are atomic read-modify-write operations~(\ref{intro.multithread}).
 
 \pnum
-\returns Atomically, the value of the object immediately before the effects. \end{itemdescr}
+\returns Atomically, the value of the object immediately before the effects.
+\end{itemdescr}
 
 \indexlibrary{\idxcode{atomic_flag_clear}}%
 \indexlibrary{\idxcode{atomic_flag_clear_explicit}}%

source/diagnostics.tex

@@ -1294,7 +1294,11 @@
 
 \begin{itemdescr}
 \pnum
-\returns \tcode{lhs.category() < rhs.category() || lhs.category() == rhs.category() \&\& lhs.value() < rhs.value()}.
+\returns
+\begin{codeblock}
+lhs.category() < rhs.category() ||
+(lhs.category() == rhs.category() && lhs.value() < rhs.value()).
+\end{codeblock}
 \end{itemdescr}
 
 \indexlibrary{\idxcode{operator\shl}!\idxcode{error_code}}%

source/numerics.tex

@@ -3852,7 +3852,8 @@
 \pnum\effects Constructs a \tcode{random_device}
  non-deterministic uniform random number generator object.
  The semantics and default value of the \tcode{token}
- parameter are implementation-defined.\footnote{   The parameter is intended
+ parameter are implementation-defined.
+ \footnote{The parameter is intended
    to allow an implementation to differentiate
    between different sources of randomness.
  }
@@ -8656,7 +8657,8 @@
   template<class InputIterator, class UnaryFunction, class T, class BinaryOperation>
     T transform_reduce(InputIterator first, InputIterator last,
                        UnaryOperation unary_op, T init, BinaryOperation binary_op);
-  template<class ExecutionPolicy, class InputIterator, class UnaryFunction, class T, class BinaryOperation>
+  template<class ExecutionPolicy, class InputIterator,
+           class UnaryFunction, class T, class BinaryOperation>
     T transform_reduce(ExecutionPolicy&& exec, // see \ref{algorithms.parallel.overloads}
                        InputIterator first, InputIterator last,
                        UnaryOperation unary_op, T init, BinaryOperation binary_op);
@@ -8706,7 +8708,8 @@
                                   InputIterator first, InputIterator last,
                                   OutputIterator result,
                                   T init);
-  template<class ExecutionPolicy, class InputIterator, class OutputIterator, class T, class BinaryOperation>
+  template<class ExecutionPolicy, class InputIterator, class OutputIterator, class T,
+           class BinaryOperation>
     OutputIterator exclusive_scan(ExecutionPolicy&& exec, // see \ref{algorithms.parallel.overloads}
                                   InputIterator first, InputIterator last,
                                   OutputIterator result,
@@ -8726,12 +8729,14 @@
     OutputIterator inclusive_scan(ExecutionPolicy&& exec, // see \ref{algorithms.parallel.overloads}
                                   InputIterator first, InputIterator last,
                                   OutputIterator result);
-  template<class ExecutionPolicy, class InputIterator, class OutputIterator, class BinaryOperation>
+  template<class ExecutionPolicy, class InputIterator, class OutputIterator,
+           class BinaryOperation>
     OutputIterator inclusive_scan(ExecutionPolicy&& exec, // see \ref{algorithms.parallel.overloads}
                                   InputIterator first, InputIterator last,
                                   OutputIterator result,
                                   BinaryOperation binary_op);
-  template<class ExecutionPolicy, class InputIterator, class OutputIterator, class BinaryOperation, class T>
+  template<class ExecutionPolicy, class InputIterator, class OutputIterator,
+           class BinaryOperation, class T>
     OutputIterator inclusive_scan(ExecutionPolicy&& exec, // see \ref{algorithms.parallel.overloads}
                                   InputIterator first, InputIterator last,
                                   OutputIterator result,
@@ -8948,7 +8953,7 @@
   T inner_product(InputIterator1 first1, InputIterator1 last1,
                   InputIterator2 first2, T init);
 template <class InputIterator1, class InputIterator2, class T,
-    class BinaryOperation1, class BinaryOperation2>
+          class BinaryOperation1, class BinaryOperation2>
   T inner_product(InputIterator1 first1, InputIterator1 last1,
                   Inputgterator2 first2, T init,
                   BinaryOperation1 binary_op1,
@@ -8998,11 +9003,10 @@
   OutputIterator partial_sum(
     InputIterator first, InputIterator last,
     OutputIterator result);
-template
-  <class InputIterator, class OutputIterator, class BinaryOperation>
-    OutputIterator partial_sum(
-      InputIterator first, InputIterator last,
-      OutputIterator result, BinaryOperation binary_op);
+template <class InputIterator, class OutputIterator, class BinaryOperation>
+  OutputIterator partial_sum(
+    InputIterator first, InputIterator last,
+    OutputIterator result, BinaryOperation binary_op);
 \end{itemdecl}
 
 \begin{itemdescr}

source/regex.tex

@@ -3483,8 +3483,7 @@
 
 \begin{itemdescr}
 \pnum
-\returns  \tcode{regex_search(str, str + char_traits<charT>::length(str), 
-e, flags)}
+\returns \tcode{regex_search(str, str + char_traits<charT>::length(str), e, flags)}.
 \end{itemdescr}
 
 \indexlibrary{\idxcode{regex_search}}%

source/utilities.tex

@@ -14643,7 +14643,7 @@
 
 \begin{itemdescr}
 \pnum
-\returns \tcode{duration(-rep_);}.
+\returns \tcode{duration(-rep_)}.
 \end{itemdescr}
 
 \indexlibrary{\idxcode{operator++}!\idxcode{duration}}%
@@ -14668,7 +14668,7 @@
 
 \begin{itemdescr}
 \pnum
-\returns \tcode{duration(rep_++);}.
+\returns \tcode{duration(rep_++)}.
 \end{itemdescr}
 
 \indexlibrary{\idxcode{operator\dcr}!\idxcode{duration}}%
@@ -14693,7 +14693,7 @@
 
 \begin{itemdescr}
 \pnum
-\returns \tcode{duration(rep_-{}-);}.
+\returns \tcode{duration(rep_-{}-)}.
 \end{itemdescr}
 
 \indexlibrary{\idxcode{operator+=}!\idxcode{duration}}%