[re] Move long pieces of code into codeblocks and remove redundant "the result of" from return statements

This fixes overfull hboxes, see #693.

Author: tkoeppe

source/regex.tex

@@ -1115,8 +1115,12 @@
 \end{itemdecl}
 
 \begin{itemdescr}
-\pnum\effects If \tcode{typeid(use_facet<collate<charT>>)
-== typeid(collate_byname<charT>)}
+\pnum
+\effects
+If
+\begin{codeblock}
+typeid(use_facet<collate<charT>>) == typeid(collate_byname<charT>)
+\end{codeblock}
 and the form of the sort key returned
 by \tcode{collate_byname<charT>::transform(first, last)} is known and
 can be converted into a primary sort key then returns that key,
@@ -2000,7 +2004,11 @@
 \end{itemdecl}
 
 \begin{itemdescr}
-\pnum\returns \tcode{rhs.compare(typename sub_match<BiIter>::string_type(lhs.data(), lhs.size())) == 0}.
+\pnum
+\returns
+\begin{codeblock}
+rhs.compare(typename sub_match<BiIter>::string_type(lhs.data(), lhs.size())) == 0
+\end{codeblock}
 \end{itemdescr}
 
 \indexlibrarymember{sub_match}{operator"!=}%
@@ -2024,7 +2032,11 @@
 \end{itemdecl}
 
 \begin{itemdescr}
-\pnum\returns \tcode{rhs.compare(typename sub_match<BiIter>::string_type(lhs.data(), lhs.size())) > 0}.
+\pnum
+\returns
+\begin{codeblock}
+rhs.compare(typename sub_match<BiIter>::string_type(lhs.data(), lhs.size())) > 0
+\end{codeblock}
 \end{itemdescr}
 
 \indexlibrarymember{sub_match}{operator>}%
@@ -2072,7 +2084,11 @@
 \end{itemdecl}
 
 \begin{itemdescr}
-\pnum\returns \tcode{lhs.compare(typename sub_match<BiIter>::string_type(rhs.data(), rhs.size())) == 0}.
+\pnum
+\returns
+\begin{codeblock}
+lhs.compare(typename sub_match<BiIter>::string_type(rhs.data(), rhs.size())) == 0
+\end{codeblock}
 \end{itemdescr}
 
 \indexlibrary{\idxcode{operator"!=}!\idxcode{sub_match}}%
@@ -2098,7 +2114,11 @@
 \end{itemdecl}
 
 \begin{itemdescr}
-\pnum\returns \tcode{lhs.compare(typename sub_match<BiIter>::string_type(rhs.data(), rhs.size())) < 0}.
+\pnum
+\returns
+\begin{codeblock}
+lhs.compare(typename sub_match<BiIter>::string_type(rhs.data(), rhs.size())) < 0
+\end{codeblock}
 \end{itemdescr}
 
 \indexlibrarymember{operator>}{sub_match}%
@@ -3268,8 +3288,7 @@
 
 \begin{itemdescr}
 \pnum
-\returns The result of \tcode{regex_search(str,
-str + char_traits<charT>::length(str), m, e, flags)}.
+\returns \tcode{regex_search(str, str + char_traits<charT>::length(str), m, e, flags)}.
 \end{itemdescr}
 
 \indexlibrary{\idxcode{regex_search}}%
@@ -3283,8 +3302,8 @@
 \end{itemdecl}
 
 \begin{itemdescr}
-\pnum\returns The result of \tcode{regex_search(s.begin(), s.end(), m,
-e, flags)}.
+\pnum
+\returns \tcode{regex_search(s.begin(), s.end(), m, e, flags)}.
 \end{itemdescr}
 
 \indexlibrary{\idxcode{regex_search}}%
@@ -3297,9 +3316,9 @@
 
 \begin{itemdescr}
 \pnum
-\effects  Behaves ``as if'' by constructing an object \tcode{what}
-of type \tcode{match_results<BidirectionalIterator>}, and then returning
-the result of \tcode{regex_search(first, last, what, e, flags)}.
+\effects Behaves ``as if'' by constructing an object \tcode{what}
+of type \tcode{match_results<Bidirectional\-Iterator>} and returning
+\tcode{regex_search(first, last, what, e, flags)}.
 \end{itemdescr}
 
 \indexlibrary{\idxcode{regex_search}}%