Remove [facets.examples]. (#1957)

Author: Eelis

source/locales.tex

@@ -219,7 +219,7 @@
 function template
 \tcode{has_facet<Facet>()}.
 User-defined facets may be installed in a locale, and used identically as
-may standard facets\iref{facets.examples}.
+may standard facets.
 
 \pnum
 \begin{note}
@@ -5036,218 +5036,6 @@
 }
 \end{codeblock}
 
-\rSec2[facets.examples]{Program-defined facets}
-
-\pnum
-A \Cpp{} program may define facets to be added to a locale and used identically as
-the built-in facets.
-To create a new facet interface, \Cpp{} programs simply derive from
-\tcode{locale::facet}
-a class containing a static member:
-\tcode{static locale::id id}.
-
-\pnum
-\begin{note}
-The locale member function templates verify its type and storage class.
-\end{note}
-
-\pnum
-\begin{example}
-Traditional global localization is still easy:
-
-\begin{codeblock}
-#include <iostream>
-#include <locale>
-int main(int argc, char** argv) {
-  using namespace std;
-  locale::global(locale(""));           // set the global locale
-                                        // imbue it on all the std streams
-  cin.imbue(locale());
-  cout.imbue(locale());
-  cerr.imbue(locale());
-  wcin.imbue(locale());
-  wcout.imbue(locale());
-  wcerr.imbue(locale());
-
-  return MyObject(argc, argv).doit();
-}
-\end{codeblock}
-\end{example}
-
-\pnum
-\begin{example}
-Greater flexibility is possible:
-
-\begin{codeblock}
-#include <iostream>
-#include <locale>
-int main() {
-  using namespace std;
-  cin.imbue(locale(""));        // the user's preferred locale
-  cout.imbue(locale::classic());
-  double f;
-  while (cin >> f) cout << f << endl;
-  return (cin.fail() != 0);
-}
-\end{codeblock}
-
-In a European locale, with input
-\tcode{3.456,78},
-output is
-\tcode{3456.78}.
-\end{example}
-
-\pnum
-This can be important even for simple programs, which may need to
-write a data file in a fixed format, regardless of a user's preference.
-
-\pnum
-\begin{example}
-Here is an example of the use of locales in a library interface.
-
-\begin{codeblock}
-// file: \tcode{Date.h}
-#include <iosfwd>
-#include <string>
-#include <locale>
-
-class Date {
-public:
-  Date(unsigned day, unsigned month, unsigned year);
-  std::string asString(const std::locale& = std::locale());
-};
-
-std::istream& operator>>(std::istream& s, Date& d);
-std::ostream& operator<<(std::ostream& s, Date d);
-\end{codeblock}
-
-\pnum
-This example illustrates two architectural uses of class
-\tcode{locale}.
-
-\pnum
-The first is as a default argument in
-\tcode{Date::asString()},
-where the
-default is the global (presumably user-preferred) locale.
-
-\pnum
-The second is in the operators
-\tcode{<<} and \tcode{>>},
-where a locale ``hitchhikes''
-on another object, in this case a stream, to the point where it
-is needed.
-
-\begin{codeblock}
-// file: \tcode{Date.C}
-#include "Date"                 // includes \tcode{<ctime>}
-#include <sstream>
-std::string Date::asString(const std::locale& l) {
-  using namespace std;
-  ostringstream s; s.imbue(l);
-  s << *this; return s.str();
-}
-
-std::istream& operator>>(std::istream& s, Date& d) {
-  using namespace std;
-  istream::sentry cerberos(s);
-  if (cerberos) {
-    ios_base::iostate err = goodbit;
-    struct tm t;
-    use_facet<time_get<char>>(s.getloc()).get_date(s, 0, s, err, &t);
-    if (!err) d = Date(t.tm_day, t.tm_mon + 1, t.tm_year + 1900);
-    s.setstate(err);
-  }
-  return s;
-}
-\end{codeblock}
-\end{example}
-
-\pnum
-A locale object may be extended with a new facet simply by constructing
-it with an instance of a class derived from
-\tcode{locale::facet}.
-The only member a \Cpp{} program must define is the static member
-\tcode{id},
-which identifies your class interface as a new facet.
-
-\pnum
-\begin{example}
-Classifying Japanese characters:
-
-\begin{codeblock}
-// file: \tcode{<jctype>}
-#include <locale>
-namespace My {
-  using namespace std;
-  class JCtype : public locale::facet {
-  public:
-    static locale::id id;       // required for use as a new locale facet
-    bool is_kanji (wchar_t c) const;
-    JCtype() { }
-  protected:
-    ~JCtype() { }
-  };
-}
-
-// file: \tcode{filt.C}
-#include <iostream>
-#include <locale>
-#include "jctype"               // above
-std::locale::id My::JCtype::id; // the static \tcode{JCtype} member declared above.
-
-int main() {
-  using namespace std;
-  using wctype = ctype<wchar_t>;
-  locale loc(locale(""),        // the user's preferred locale ...
-         new My::JCtype);       // and a new feature ...
-  wchar_t c = use_facet<wctype>(loc).widen('!');
-  if (!use_facet<My::JCtype>(loc).is_kanji(c))
-    cout << "no it isn't!" << endl;
-}
-\end{codeblock}
-
-\pnum
-The new facet is used exactly like the built-in facets.
-\end{example}
-
-\pnum
-\begin{example}
-Replacing an existing facet is even easier.
-The code does not define a member
-\tcode{id}
-because it is reusing the
-\tcode{numpunct<charT>}
-facet interface:
-
-\begin{codeblock}
-// file: \tcode{my_bool.C}
-#include <iostream>
-#include <locale>
-#include <string>
-namespace My {
-  using namespace std;
-  using cnumpunct = numpunct_byname<char>;
-  class BoolNames : public cnumpunct {
-  protected:
-    string do_truename()  const { return "Oui Oui!"; }
-    string do_falsename() const { return "Mais Non!"; }
-    ~BoolNames() { }
-  public:
-    BoolNames(const char* name) : cnumpunct(name) { }
-  };
-}
-
-int main(int argc, char** argv) {
-  using namespace std;
-  // make the user's preferred locale, except for...
-  locale loc(locale(""), new My::BoolNames(""));
-  cout.imbue(loc);
-  cout << boolalpha << "Any arguments today? " << (argc > 1) << endl;
-}
-\end{codeblock}
-\end{example}
-
 \rSec1[c.locales]{C library locales}
 
 \rSec2[clocale.syn]{Header \tcode{<clocale>} synopsis}

source/xrefdelta.tex

@@ -18,6 +18,9 @@
 %\removedxref{removed.label}
 \removedxref{variant.traits}
 
+% [facets.examples] was removed.
+\removedxref{facets.examples}
+
 % Renamed sections.
 %\movedxref{old.label}{new.label}
 %\movedxrefii{old.label}{new.label.1}{new.label.2}