[lib] Harmonize introductory comments in synopses (#1775)

Even if no section reference is given, make them lowercase
and remove trailing colons.

Author: jensmaurer

source/containers.tex

@@ -1106,7 +1106,7 @@
   class strstream
     : public basic_iostream<char> {
   public:
-    // Types
+    // types
     using char_type = char;
     using int_type  = char_traits<char>::int_type;
     using pos_type  = char_traits<char>::pos_type;
@@ -1118,7 +1118,7 @@
               ios_base::openmode mode = ios_base::in|ios_base::out);
     virtual ~strstream();
 
-    // Members:
+    // members
     strstreambuf* rdbuf() const;
     void freeze(bool freezefl = true);
     int pcount() const;
@@ -1753,7 +1753,7 @@
 \indexlibrary{\idxcode{allocator}}%
 \begin{codeblock}
 namespace std {
-  // specialize for \tcode{void}:
+  // specialization for \tcode{void}
   template <> class allocator<void> {
   public:
     using value_type    = void;

source/future.tex

@@ -809,10 +809,10 @@
     long&  iword(int index);
     void*& pword(int index);
 
-    // destructor:
+    // destructor
     virtual ~ios_base();
 
-    // \ref{ios.base.callback}, callbacks;
+    // \ref{ios.base.callback}, callbacks
     enum event { erase_event, imbue_event, copyfmt_event };
     using event_callback = void (*)(event, ios_base&, int index);
     void register_callback(event_callback fn, int index);
@@ -2932,7 +2932,7 @@
                           = ios_base::in | ios_base::out);
     int      pubsync();
 
-    // Get and put areas
+    // get and put areas
     // \ref{streambuf.pub.get}, get area
     streamsize in_avail();
     int_type snextc();
@@ -4145,7 +4145,7 @@
   template <class charT, class traits = char_traits<charT>>
   class basic_istream : virtual public basic_ios<charT, traits> {
   public:
-    // types (inherited from \tcode{basic_ios}\iref{ios}):
+    // types (inherited from \tcode{basic_ios}\iref{ios})
     using char_type   = charT;
     using int_type    = typename traits::int_type;
     using pos_type    = typename traits::pos_type;
@@ -5705,7 +5705,7 @@
   template <class charT, class traits = char_traits<charT>>
   class basic_ostream : virtual public basic_ios<charT, traits> {
   public:
-    // types (inherited from \tcode{basic_ios}\iref{ios}):
+    // types (inherited from \tcode{basic_ios}\iref{ios})
     using char_type   = charT;
     using int_type    = typename traits::int_type;
     using pos_type    = typename traits::pos_type;
@@ -12588,7 +12588,7 @@
     file_status(file_status&&) noexcept = default;
     ~file_status();
 
-    // assignments:
+    // assignments
     file_status& operator=(const file_status&) noexcept = default;
     file_status& operator=(file_status&&) noexcept = default;
 
@@ -12679,7 +12679,7 @@
     directory_entry(const filesystem::path& p, error_code& ec);
     ~directory_entry();
 
-    // assignments:
+    // assignments
     directory_entry& operator=(const directory_entry&) = default;
     directory_entry& operator=(directory_entry&&) noexcept = default;
 

source/iostreams.tex

@@ -122,7 +122,7 @@
 namespace std {
   class locale {
   public:
-    // types:
+    // types
     class facet;
     class id;
     using category = int;
@@ -133,7 +133,7 @@
       time     = 0x100, messages = 0x200,
       all = collate | ctype | monetary | numeric | time  | messages;
 
-    // construct/copy/destroy:
+    // construct/copy/destroy
     locale() noexcept;
     locale(const locale& other) noexcept;
     explicit locale(const char* std_name);
@@ -146,7 +146,7 @@
     const locale& operator=(const locale& other) noexcept;
     template <class Facet> locale combine(const locale& other) const;
 
-    // locale operations:
+    // locale operations
     basic_string<char> name() const;
 
     bool operator==(const locale& other) const;
@@ -156,7 +156,7 @@
       bool operator()(const basic_string<charT, traits, Allocator>& s1,
                       const basic_string<charT, traits, Allocator>& s2) const;
 
-    // global locale objects:
+    // global locale objects
     static       locale  global(const locale&);
     static const locale& classic();
   };

source/locales.tex

@@ -10435,7 +10435,7 @@
   long double  sph_legendrel(unsigned l, unsigned m, long double theta);
 
   // \ref{sf.cmath.sph_neumann}, spherical Neumann functions;
-  // spherical Bessel functions of the second kind:
+  // spherical Bessel functions of the second kind
   double       sph_neumann(unsigned n, double x);
   float        sph_neumannf(unsigned n, float x);
   long double  sph_neumannl(unsigned n, long double x);

source/numerics.tex

@@ -1329,7 +1329,7 @@
   template <class charT, class traits = regex_traits<charT>>
     class basic_regex {
     public:
-      // types:
+      // types
       using value_type  =          charT;
       using traits_type =          traits;
       using string_type = typename traits::string_type;

source/regex.tex

@@ -878,7 +878,7 @@
            class Allocator = allocator<charT>>
   class basic_string {
   public:
-    // types:
+    // types
     using traits_type            = traits;
     using value_type             = charT;
     using allocator_type         = Allocator;

source/strings.tex

@@ -331,11 +331,11 @@
 namespace std {
   class thread {
   public:
-    // types:
+    // types
     class id;
     using native_handle_type = @\impdefnc@;         // see~\ref{thread.req.native}
 
-    // construct/copy/destroy:
+    // construct/copy/destroy
     thread() noexcept;
     template <class F, class... Args> explicit thread(F&& f, Args&&... args);
     ~thread();
@@ -344,15 +344,15 @@
     thread& operator=(const thread&) = delete;
     thread& operator=(thread&&) noexcept;
 
-    // members:
+    // members
     void swap(thread&) noexcept;
     bool joinable() const noexcept;
     void join();
     void detach();
     id get_id() const noexcept;
     native_handle_type native_handle();                         // see~\ref{thread.req.native}
 
-    // static members:
+    // static members
     static unsigned int hardware_concurrency() noexcept;
   };
 }
@@ -380,7 +380,7 @@
     basic_ostream<charT, traits>&
       operator<<(basic_ostream<charT, traits>& out, thread::id id);
 
-  // Hash support
+  // hash support
   template <class T> struct hash;
   template <> struct hash<thread::id>;
 }
@@ -1443,12 +1443,12 @@
     shared_mutex(const shared_mutex&) = delete;
     shared_mutex& operator=(const shared_mutex&) = delete;
 
-    // Exclusive ownership
+    // exclusive ownership
     void lock();                // blocking
     bool try_lock();
     void unlock();
 
-    // Shared ownership
+    // shared ownership
     void lock_shared();         // blocking
     bool try_lock_shared();
     void unlock_shared();
@@ -1578,7 +1578,7 @@
     shared_timed_mutex(const shared_timed_mutex&) = delete;
     shared_timed_mutex& operator=(const shared_timed_mutex&) = delete;
 
-    // Exclusive ownership
+    // exclusive ownership
     void lock();                // blocking
     bool try_lock();
     template <class Rep, class Period>
@@ -1587,7 +1587,7 @@
       bool try_lock_until(const chrono::time_point<Clock, Duration>& abs_time);
     void unlock();
 
-    // Shared ownership
+    // shared ownership
     void lock_shared();         // blocking
     bool try_lock_shared();
     template <class Rep, class Period>

source/threads.tex

@@ -5701,7 +5701,7 @@
 namespace std {
   template<size_t N> class bitset {
   public:
-    // bit reference:
+    // bit reference
     class reference {
       friend class bitset;
       reference() noexcept;
@@ -5747,7 +5747,7 @@
     bitset<N>& flip() noexcept;
     bitset<N>& flip(size_t pos);
 
-    // element access:
+    // element access
     constexpr bool operator[](size_t pos) const;        // for \tcode{b[i];}
     reference operator[](size_t pos);                   // for \tcode{b[i];}
 
@@ -18658,7 +18658,7 @@
 
     static time_point now() noexcept;
 
-    // Map to C API
+    // map to C API
     static time_t      to_time_t  (const time_point& t) noexcept;
     static time_point  from_time_t(time_t t) noexcept;
   };