[locale.general] Add cross-references to class synopsis

Author: tkoeppe

source/locales.tex

@@ -123,9 +123,12 @@
 namespace std {
   class locale {
   public:
-    // types
+    // \ref{locale.types}, types
+    // \ref{locale.facet}, class \tcode{locale::facet}
     class facet;
+    // \ref{locale.id}, class \tcode{locale::id}
     class id;
+    // \ref{locale.category}, type \tcode{locale::category}
     using category = int;
     static const category   // values assigned here are for exposition only
       none     = 0,
@@ -134,7 +137,7 @@
       time     = 0x100, messages = 0x200,
       all = collate | ctype | monetary | numeric | time  | messages;
 
-    // construct/copy/destroy
+    // \ref{locale.cons}, construct/copy/destroy
     locale() noexcept;
     locale(const locale& other) noexcept;
     explicit locale(const char* std_name);
@@ -145,9 +148,9 @@
     locale(const locale& other, const locale& one, category);
     ~locale();                  // not virtual
     const locale& operator=(const locale& other) noexcept;
-    template<class Facet> locale combine(const locale& other) const;
 
-    // locale operations
+    // \ref{locale.members}, locale operations
+    template<class Facet> locale combine(const locale& other) const;
     string name() const;
     text_encoding encoding() const;
 
@@ -157,7 +160,7 @@
       bool operator()(const basic_string<charT, traits, Allocator>& s1,
                       const basic_string<charT, traits, Allocator>& s2) const;
 
-    // global locale objects
+    // \ref{locale.statics}, global locale objects
     static       locale  global(const locale&);
     static const locale& classic();
   };