[lib] Fix capitalization and punctuation in itemdescrs. (#1238)

Author: Johannes Laire

source/containers.tex

@@ -3193,7 +3193,7 @@
 \end{itemdecl}
 
 \begin{itemdescr}
-\pnum\returns \tcode{N}
+\pnum\returns \tcode{N}.
 \end{itemdescr}
 
 \rSec3[array.data]{\tcode{array::data}}

source/iostreams.tex

@@ -2031,7 +2031,7 @@
 \begin{itemdescr}
 \pnum
 \postconditions
-\tcode{traits::eq(fillch, fill())}
+\tcode{traits::eq(fillch, fill())}.
 
 \pnum
 \returns
@@ -4317,7 +4317,7 @@
 
 \pnum
 \postconditions
-\tcode{gcount() == 0}
+\tcode{gcount() == 0}.
 \end{itemdescr}
 
 
@@ -6720,7 +6720,7 @@
 \effects As if by: \tcode{os \shl{} x;}
 
 \pnum
-\returns \tcode{os}
+\returns \tcode{os}.
 
 \pnum
 \remarks This function shall not participate in overload resolution

source/regex.tex

@@ -1039,7 +1039,7 @@
 \begin{itemdescr}
 \pnum\effects  Constructs an object of class \tcode{regex_error}.
 
-\pnum\postconditions  \tcode{ecode == code()}
+\pnum\postconditions  \tcode{ecode == code()}.
 \end{itemdescr}
 
 \indexlibrary{\idxcode{error_type}}%

source/support.tex

@@ -2201,7 +2201,7 @@
 \rSec3[new.delete.placement]{Non-allocating forms}
 
 \pnum
-These functions are reserved, a \Cpp program may not define functions that displace
+These functions are reserved; a \Cpp program may not define functions that displace
 the versions in the \Cpp standard library~(\ref{constraints}).
 The provisions of~(\ref{basic.stc.dynamic}) do not apply to these reserved
 placement forms of \tcode{operator new} and \tcode{operator delete}.
@@ -2451,7 +2451,7 @@
 \indexlibrary{\idxcode{bad_alloc}}%
 \tcode{bad_alloc};
 \item
-terminate execution of the program without returning to the caller;
+terminate execution of the program without returning to the caller.
 \indexlibrary{\idxcode{abort}}%
 \indexlibrary{\idxcode{exit}}%
 \end{itemize}
@@ -2717,7 +2717,7 @@
 objects which compare equal.
 
 \pnum
-\remarks an implementation should return different values for two
+\remarks An implementation should return different values for two
 \tcode{type_info} objects which do not compare equal.
 \end{itemdescr}
 
@@ -3258,7 +3258,7 @@
 \requires \tcode{p} shall not be a null pointer.
 
 \pnum
-\throws the exception object to which \tcode{p} refers.
+\throws The exception object to which \tcode{p} refers.
 \end{itemdescr}
 
 \indexlibrary{\idxcode{make_exception_ptr}}%
@@ -3359,7 +3359,7 @@
 
 \pnum
 \throws
-if \tcode{is_class_v<U> \&\& !is_final_v<U> \&\& !is_base_of_v<nested_exception, U>}
+If \tcode{is_class_v<U> \&\& !is_final_v<U> \&\& !is_base_of_v<nested_exception, U>}
 is \tcode{true},
 an exception of unspecified type that is publicly derived from both
 \tcode{U} and \tcode{nested_exception}
@@ -3443,10 +3443,10 @@
 
 \begin{itemdescr}
 \pnum
-\effects constructs an empty \tcode{initializer_list} object.
+\effects Constructs an empty \tcode{initializer_list} object.
 
 \pnum
-\postconditions \tcode{size() == 0}
+\postconditions \tcode{size() == 0}.
 \end{itemdescr}
 
 \rSec2[support.initlist.access]{Initializer list access}
@@ -3470,7 +3470,7 @@
 
 \begin{itemdescr}
 \pnum
-\returns \tcode{begin() + size()}
+\returns \tcode{begin() + size()}.
 \end{itemdescr}
 
 \indexlibrarymember{size}{initializer_list}%

source/threads.tex

@@ -449,7 +449,7 @@
 
 \begin{itemdescr}
 \pnum
-\returns \tcode{!(y < x)}
+\returns \tcode{!(y < x)}.
 \end{itemdescr}
 
 \indexlibrarymember{operator>}{thread::id}%
@@ -458,7 +458,7 @@
 \end{itemdecl}
 
 \begin{itemdescr}
-\pnum\returns \tcode{y < x}
+\pnum\returns \tcode{y < x}.
 \end{itemdescr}
 
 \indexlibrarymember{operator>=}{thread::id}%
@@ -467,7 +467,7 @@
 \end{itemdecl}
 
 \begin{itemdescr}
-\pnum\returns \tcode{!(x < y)}
+\pnum\returns \tcode{!(x < y)}.
 \end{itemdescr}
 
 \indexlibrarymember{operator\shl}{thread::id}%
@@ -484,7 +484,7 @@
 representation and if \tcode{x != y} the \tcode{thread::id} objects shall have
 distinct text representations.
 
-\pnum\returns \tcode{out}
+\pnum\returns \tcode{out}.
 \end{itemdescr}
 
 \indexlibrary{\idxcode{hash}!\idxcode{thread::id}}%
@@ -506,7 +506,7 @@
 \begin{itemdescr}
 \pnum\effects Constructs a \tcode{thread} object that does not represent a thread of execution.
 
-\pnum\postconditions \tcode{get_id() == id()}
+\pnum\postconditions \tcode{get_id() == id()}.
 \end{itemdescr}
 
 \indexlibrary{\idxcode{thread}!constructor}%
@@ -605,7 +605,7 @@
 \tcode{x.get_id()} prior to the assignment.
 
 \pnum
-\returns \tcode{*this}
+\returns \tcode{*this}.
 \end{itemdescr}
 
 \rSec3[thread.thread.member]{\tcode{thread} members}
@@ -627,7 +627,7 @@
 
 \begin{itemdescr}
 \pnum
-\returns \tcode{get_id() != id()}
+\returns \tcode{get_id() != id()}.
 \end{itemdescr}
 
 \indexlibrarymember{join}{thread}%
@@ -925,7 +925,7 @@
 \postconditions The calling thread owns the mutex.
 
 \pnum
-\returntype \tcode{void}
+\returntype \tcode{void}.
 
 \pnum
 \sync Prior \tcode{unlock()} operations on the same object shall
@@ -966,7 +966,7 @@
 in the absence of contending mutex acquisitions.
 
 \pnum
-\returntype \tcode{bool}
+\returntype \tcode{bool}.
 
 \pnum
 \returns \tcode{true} if ownership of the mutex was obtained for the calling
@@ -994,7 +994,7 @@
 \effects Releases the calling thread's ownership of the mutex.
 
 \pnum
-\returntype \tcode{void}
+\returntype \tcode{void}.
 
 \pnum
 \sync This operation synchronizes with~(\ref{intro.multithread}) subsequent
@@ -1150,7 +1150,7 @@
 \end{note}
 
 \pnum
-\returntype \tcode{bool}
+\returntype \tcode{bool}.
 
 \pnum
 \returns \tcode{true} if ownership was obtained, otherwise \tcode{false}.
@@ -1182,7 +1182,7 @@
 be obtained if the lock is available, but implementations are expected to make a
 strong effort to do so. \end{note}
 
-\pnum\returntype \tcode{bool}
+\pnum\returntype \tcode{bool}.
 
 \pnum
 \returns \tcode{true} if ownership was obtained, otherwise \tcode{false}.
@@ -1966,7 +1966,7 @@
 \effects As if by \tcode{pm->lock()}.
 
 \pnum
-\postconditions \tcode{owns == true}
+\postconditions \tcode{owns == true}.
 
 \pnum
 \throws
@@ -2089,7 +2089,7 @@
 \begin{itemdescr}
 \pnum\effects As if by \tcode{pm->unlock()}.
 
-\pnum\postconditions \tcode{owns == false}
+\pnum\postconditions \tcode{owns == false}.
 
 \pnum\throws \tcode{system_error} when
 an exception is required~(\ref{thread.req.exception}).
@@ -2140,7 +2140,7 @@
 \end{itemdecl}
 
 \begin{itemdescr}
-\pnum\returns \tcode{owns}
+\pnum\returns \tcode{owns}.
 \end{itemdescr}
 
 \indexlibrarymember{operator bool}{unique_lock}%
@@ -2149,7 +2149,7 @@
 \end{itemdecl}
 
 \begin{itemdescr}
-\pnum\returns \tcode{owns}
+\pnum\returns \tcode{owns}.
 \end{itemdescr}
 
 \indexlibrarymember{mutex}{unique_lock}%
@@ -2158,7 +2158,7 @@
 \end{itemdecl}
 
 \begin{itemdescr}
-\pnum\returns \tcode{pm}
+\pnum\returns \tcode{pm}.
 \end{itemdescr}
 
 \rSec3[thread.lock.shared]{Class template \tcode{shared_lock}}

source/utilities.tex

@@ -1281,15 +1281,15 @@
 tuple_element<0, pair<T1, T2>>::type
 \end{itemdecl}
 \begin{itemdescr}
-\pnum\textit{Value:} the type \tcode{T1}.
+\pnum\textit{Value:} The type \tcode{T1}.
 \end{itemdescr}
 
 \indexlibrary{\idxcode{tuple_element}}%
 \begin{itemdecl}
 tuple_element<1, pair<T1, T2>>::type
 \end{itemdecl}
 \begin{itemdescr}
-\pnum\textit{Value:} the type T2.
+\pnum\textit{Value:} The type T2.
 \end{itemdescr}
 
 \indexlibrarymember{get}{pair}%
@@ -7344,7 +7344,7 @@
 
 \begin{itemdescr}
 \pnum
-\remarks automatically detects whether \tcode{T} has a nested \tcode{allocator_type} that
+\remarks Automatically detects whether \tcode{T} has a nested \tcode{allocator_type} that
 is convertible from \tcode{Alloc}. Meets the BinaryTypeTrait
 requirements~(\ref{meta.rqmts}). The implementation shall provide a definition that is
 derived from \tcode{true_type} if the \grammarterm{qualified-id} \tcode{T::allocator_type}
@@ -9635,7 +9635,7 @@
 
 \pnum
 \postconditions \tcode{*this} shall contain the old value of
-\tcode{r}. \tcode{r} shall be empty. \tcode{r.get() == nullptr.}
+\tcode{r}. \tcode{r} shall be empty. \tcode{r.get() == nullptr}.
 \end{itemdescr}
 
 \indexlibrary{\idxcode{shared_ptr}!constructor}%
@@ -18990,7 +18990,7 @@
 \begin{example}
 \begin{codeblock}
 using namespace std;
-vector<int> v = ...
+vector<int> v = @\commentellip@;
 
 // standard sequential sort
 sort(v.begin(), v.end());