Commit 09d6794b by Benjamin Kosnik Committed by Benjamin Kosnik

class.txml: Adjust biblio markup.

2010-02-22  Benjamin Kosnik  <bkoz@redhat.com>

	* doc/xml/class.txml: Adjust biblio markup.
	* doc/xml/manual/allocator.xml: Same.
	* doc/xml/manual/ctype.xml: Same.
	* doc/xml/manual/codecvt.xml: Same.
	* doc/xml/manual/backwards_compatibility.xml: Same.
	* doc/xml/manual/abi.xml: Same.
	* doc/xml/manual/shared_ptr.xml: Same.
	* doc/xml/manual/profile_mode.xml: Same.
	* doc/xml/manual/using_exceptions.xml: Same.
	* doc/xml/manual/locale.xml: Same.
	* doc/xml/manual/appendix_contributing.xml: Same.
	* doc/xml/manual/messages.xml: Same.
	* doc/Makefile.am (DBLATEX_FLAGS): Adjust.
	* doc/Makefile.in: Regenerate.

From-SVN: r156980
parent a98c2819
2010-02-22 Benjamin Kosnik <bkoz@redhat.com>
* doc/xml/class.txml: Adjust biblio markup.
* doc/xml/manual/allocator.xml: Same.
* doc/xml/manual/ctype.xml: Same.
* doc/xml/manual/codecvt.xml: Same.
* doc/xml/manual/backwards_compatibility.xml: Same.
* doc/xml/manual/abi.xml: Same.
* doc/xml/manual/shared_ptr.xml: Same.
* doc/xml/manual/profile_mode.xml: Same.
* doc/xml/manual/using_exceptions.xml: Same.
* doc/xml/manual/locale.xml: Same.
* doc/xml/manual/appendix_contributing.xml: Same.
* doc/xml/manual/messages.xml: Same.
* doc/Makefile.am (DBLATEX_FLAGS): Adjust.
* doc/Makefile.in: Regenerate.
2010-02-22 François Dumont <francois.cppdevs@free.fr> 2010-02-22 François Dumont <francois.cppdevs@free.fr>
* doc/xml/manual/profile_mode.xml: Minor updates and fixes. * doc/xml/manual/profile_mode.xml: Minor updates and fixes.
......
...@@ -228,7 +228,7 @@ doc-pdf-prince: $(xml_sources) ${glibcxx_builddir}/doc/pdf ...@@ -228,7 +228,7 @@ doc-pdf-prince: $(xml_sources) ${glibcxx_builddir}/doc/pdf
# PDF 5 # PDF 5
# dblatex # dblatex
DBLATEX_FLAGS = --verbose --pdf -o pdf/spine.pdf DBLATEX_FLAGS = --dump --verbose --pdf -o pdf/manual.pdf
doc-pdf-dblatex: $(xml_sources) ${glibcxx_builddir}/doc/pdf doc-pdf-dblatex: $(xml_sources) ${glibcxx_builddir}/doc/pdf
@echo "Generating pdf dblatex files..." @echo "Generating pdf dblatex files..."
dblatex $(DBLATEX_FLAGS) ${top_srcdir}/doc/xml/spine.xml dblatex $(DBLATEX_FLAGS) ${top_srcdir}/doc/xml/spine.xml
......
...@@ -377,7 +377,7 @@ PRINCE_FLAGS = --log prince.log -o pdf/spine.pdf ...@@ -377,7 +377,7 @@ PRINCE_FLAGS = --log prince.log -o pdf/spine.pdf
# PDF 5 # PDF 5
# dblatex # dblatex
DBLATEX_FLAGS = --verbose --pdf -o pdf/spine.pdf DBLATEX_FLAGS = --dump --verbose --pdf -o pdf/manual.pdf
# By adding these files here, automake will remove them for 'make clean' # By adding these files here, automake will remove them for 'make clean'
CLEANFILES = *.log CLEANFILES = *.log
......
...@@ -114,8 +114,13 @@ ...@@ -114,8 +114,13 @@
<abbrev> <abbrev>
</abbrev> </abbrev>
<title> <biblioid class="uri">
</title> <ulink url="http://about:blank">
<citetitle>
The Title
</citetitle>
</ulink>
</biblioid>
<editor> <editor>
<firstname></firstname> <firstname></firstname>
...@@ -138,11 +143,6 @@ ...@@ -138,11 +143,6 @@
</publishername> </publishername>
</publisher> </publisher>
<biblioid>
<ulink url="">
</ulink>
</biblioid>
</biblioentry> </biblioentry>
--> -->
......
...@@ -1085,7 +1085,7 @@ indicate a place that may require attention for multi-thread safety. ...@@ -1085,7 +1085,7 @@ indicate a place that may require attention for multi-thread safety.
</para> </para>
<table frame='all'> <table frame='all'>
<title>HTML to Doxygen markup comparison</title> <title>HTML to Doxygen Markup Comparison</title>
<tgroup cols='2' align='left' colsep='1' rowsep='1'> <tgroup cols='2' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'></colspec> <colspec colname='c1'></colspec>
<colspec colname='c2'></colspec> <colspec colname='c2'></colspec>
...@@ -1318,15 +1318,16 @@ xmllint --noout --valid <filename>xml/index.xml</filename> ...@@ -1318,15 +1318,16 @@ xmllint --noout --valid <filename>xml/index.xml</filename>
<sect3 id="docbook.markup"> <sect3 id="docbook.markup">
<title>Markup By Example</title> <title>Markup By Example</title>
<para> <para>
Complete details on Docbook markup can be found in the DocBook Element Complete details on Docbook markup can be found in the DocBook
Reference, <ulink url="http://www.docbook.org/tdg/en/html/part2.html">online</ulink>. An Element Reference,
incomplete reference for HTML to Docbook conversion is detailed in the <ulink url="http://www.docbook.org/tdg/en/html/part2.html">online</ulink>.
table below. An incomplete reference for HTML to Docbook conversion is
</para> detailed in the table below.
</para>
<table frame='all'> <table frame='all'>
<title>HTML to Docbook XML markup comparison</title> <title>HTML to Docbook XML Markup Comparison</title>
<tgroup cols='2' align='left' colsep='1' rowsep='1'> <tgroup cols='2' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'></colspec> <colspec colname='c1'></colspec>
<colspec colname='c2'></colspec> <colspec colname='c2'></colspec>
......
<sect1 id="manual.localization.facet.codecvt" xreflabel="codecvt"> <sect1 id="manual.localization.facet.codecvt" xreflabel="codecvt">
<?dbhtml filename="codecvt.html"?> <?dbhtml filename="codecvt.html"?>
<sect1info> <sect1info>
<keywordset> <keywordset>
<keyword> <keyword>
...@@ -53,21 +53,21 @@ The text around the codecvt definition gives some clues: ...@@ -53,21 +53,21 @@ The text around the codecvt definition gives some clues:
-1- The class codecvt&lt;internT,externT,stateT&gt; is for use when -1- The class codecvt&lt;internT,externT,stateT&gt; is for use when
converting from one codeset to another, such as from wide characters converting from one codeset to another, such as from wide characters
to multibyte characters, between wide character encodings such as to multibyte characters, between wide character encodings such as
Unicode and EUC. Unicode and EUC.
</emphasis> </emphasis>
</para> </para>
</blockquote> </blockquote>
<para> <para>
Hmm. So, in some unspecified way, Unicode encodings and Hmm. So, in some unspecified way, Unicode encodings and
translations between other character sets should be handled by this translations between other character sets should be handled by this
class. class.
</para> </para>
<blockquote> <blockquote>
<para> <para>
<emphasis> <emphasis>
-2- The stateT argument selects the pair of codesets being mapped between. -2- The stateT argument selects the pair of codesets being mapped between.
</emphasis> </emphasis>
</para> </para>
</blockquote> </blockquote>
...@@ -248,7 +248,7 @@ when implemented using standard &quot;C&quot; functions. ...@@ -248,7 +248,7 @@ when implemented using standard &quot;C&quot; functions.
</para> </para>
<para> <para>
Three problems arise, one big, one of medium importance, and one small. Three problems arise, one big, one of medium importance, and one small.
</para> </para>
<para> <para>
...@@ -348,7 +348,7 @@ There are two constructors for encoding_state: ...@@ -348,7 +348,7 @@ There are two constructors for encoding_state:
</para> </para>
<para> <para>
<code> <code>
encoding_state() : __in_desc(0), __out_desc(0) encoding_state() : __in_desc(0), __out_desc(0)
</code> </code>
</para> </para>
...@@ -359,7 +359,7 @@ nl_langinfo(CODESET). ...@@ -359,7 +359,7 @@ nl_langinfo(CODESET).
</para> </para>
<para> <para>
<code> <code>
encoding_state(const char* __int, const char* __ext) encoding_state(const char* __int, const char* __ext)
</code> </code>
</para> </para>
...@@ -380,9 +380,9 @@ inducing) strategy was implemented: end-users can specify any string ...@@ -380,9 +380,9 @@ inducing) strategy was implemented: end-users can specify any string
encodings. It is up to the user to make sure that these strings are encodings. It is up to the user to make sure that these strings are
valid on the target system. valid on the target system.
</para> </para>
<para> <para>
<code> <code>
void void
_M_init() _M_init()
</code> </code>
...@@ -396,7 +396,7 @@ functions will return error. ...@@ -396,7 +396,7 @@ functions will return error.
</para> </para>
<para> <para>
<code> <code>
bool bool
_M_good() _M_good()
</code> </code>
...@@ -413,7 +413,7 @@ ready to convert and will return true. ...@@ -413,7 +413,7 @@ ready to convert and will return true.
</para> </para>
<para> <para>
<code> <code>
encoding_state(const encoding_state&amp;) encoding_state(const encoding_state&amp;)
</code> </code>
</para> </para>
...@@ -448,8 +448,8 @@ codecvt usage. ...@@ -448,8 +448,8 @@ codecvt usage.
const ext_type* e_lit = "black pearl jasmine tea"; const ext_type* e_lit = "black pearl jasmine tea";
int size = strlen(e_lit); int size = strlen(e_lit);
int_type i_lit_base[24] = int_type i_lit_base[24] =
{ 25088, 27648, 24832, 25344, 27392, 8192, 28672, 25856, 24832, 29184, { 25088, 27648, 24832, 25344, 27392, 8192, 28672, 25856, 24832, 29184,
27648, 8192, 27136, 24832, 29440, 27904, 26880, 28160, 25856, 8192, 29696, 27648, 8192, 27136, 24832, 29440, 27904, 26880, 28160, 25856, 8192, 29696,
25856, 24832, 2560 25856, 24832, 2560
}; };
...@@ -465,14 +465,14 @@ codecvt usage. ...@@ -465,14 +465,14 @@ codecvt usage.
locale loc(locale::classic(), new unicode_codecvt); locale loc(locale::classic(), new unicode_codecvt);
// sanity check the constructed locale has the specialized facet. // sanity check the constructed locale has the specialized facet.
VERIFY( has_facet&lt;unicode_codecvt&gt;(loc) ); VERIFY( has_facet&lt;unicode_codecvt&gt;(loc) );
const unicode_codecvt&amp; cvt = use_facet&lt;unicode_codecvt&gt;(loc); const unicode_codecvt&amp; cvt = use_facet&lt;unicode_codecvt&gt;(loc);
// convert between const char* and unicode strings // convert between const char* and unicode strings
unicode_codecvt::state_type state01("UNICODE", "ISO_8859-1"); unicode_codecvt::state_type state01("UNICODE", "ISO_8859-1");
initialize_state(state01); initialize_state(state01);
result r1 = cvt.in(state01, e_lit, e_lit + size, efrom_next, result r1 = cvt.in(state01, e_lit, e_lit + size, efrom_next,
i_arr, i_arr + size, ito_next); i_arr, i_arr + size, ito_next);
VERIFY( r1 == codecvt_base::ok ); VERIFY( r1 == codecvt_base::ok );
VERIFY( !int_traits::compare(i_arr, i_lit, size) ); VERIFY( !int_traits::compare(i_arr, i_lit, size) );
VERIFY( efrom_next == e_lit + size ); VERIFY( efrom_next == e_lit + size );
VERIFY( ito_next == i_arr + size ); VERIFY( ito_next == i_arr + size );
</programlisting> </programlisting>
...@@ -505,7 +505,7 @@ codecvt usage. ...@@ -505,7 +505,7 @@ codecvt usage.
what is equal? A byte by byte comparison or an what is equal? A byte by byte comparison or an
encoding then byte comparison? encoding then byte comparison?
</para></listitem> </para></listitem>
<listitem><para> <listitem><para>
conversions between narrow, wide, and unicode strings conversions between narrow, wide, and unicode strings
</para></listitem> </para></listitem>
...@@ -520,12 +520,12 @@ codecvt usage. ...@@ -520,12 +520,12 @@ codecvt usage.
standards-conformant manner? standards-conformant manner?
</para></listitem> </para></listitem>
<listitem><para> <listitem><para>
how to synchronize the &quot;C&quot; and &quot;C++&quot; how to synchronize the &quot;C&quot; and &quot;C++&quot;
conversion information? conversion information?
</para></listitem> </para></listitem>
<listitem><para> <listitem><para>
wchar_t/char internal buffers and conversions between wchar_t/char internal buffers and conversions between
internal/external buffers? internal/external buffers?
</para></listitem> </para></listitem>
...@@ -542,7 +542,6 @@ codecvt usage. ...@@ -542,7 +542,6 @@ codecvt usage.
<title> <title>
The GNU C Library The GNU C Library
</title> </title>
<author> <author>
<surname>McGrath</surname> <surname>McGrath</surname>
<firstname>Roland</firstname> <firstname>Roland</firstname>
...@@ -551,94 +550,85 @@ codecvt usage. ...@@ -551,94 +550,85 @@ codecvt usage.
<surname>Drepper</surname> <surname>Drepper</surname>
<firstname>Ulrich</firstname> <firstname>Ulrich</firstname>
</author> </author>
<copyright> <copyright>
<year>2007</year> <year>2007</year>
<holder>FSF</holder> <holder>FSF</holder>
</copyright> </copyright>
<pagenums>Chapters 6 Character Set Handling and 7 Locales and Internationalization</pagenums> <pagenums>
Chapters 6 Character Set Handling and 7 Locales and Internationalization
</biblioentry> </pagenums>
</biblioentry>
<biblioentry> <biblioentry>
<title> <title>
Correspondence Correspondence
</title> </title>
<author> <author>
<surname>Drepper</surname> <surname>Drepper</surname>
<firstname>Ulrich</firstname> <firstname>Ulrich</firstname>
</author> </author>
<copyright> <copyright>
<year>2002</year> <year>2002</year>
<holder></holder> <holder></holder>
</copyright> </copyright>
</biblioentry> </biblioentry>
<biblioentry> <biblioentry>
<title> <title>
ISO/IEC 14882:1998 Programming languages - C++ ISO/IEC 14882:1998 Programming languages - C++
</title> </title>
<copyright> <copyright>
<year>1998</year> <year>1998</year>
<holder>ISO</holder> <holder>ISO</holder>
</copyright> </copyright>
</biblioentry> </biblioentry>
<biblioentry> <biblioentry>
<title> <title>
ISO/IEC 9899:1999 Programming languages - C ISO/IEC 9899:1999 Programming languages - C
</title> </title>
<copyright> <copyright>
<year>1999</year> <year>1999</year>
<holder>ISO</holder> <holder>ISO</holder>
</copyright> </copyright>
</biblioentry> </biblioentry>
<biblioentry> <biblioentry>
<title> <biblioid class="uri">
The Open Group Base Specifications, Issue 6 (IEEE Std. 1003.1-2004) <ulink url="http://www.opengroup.org/austin">
</title> <citetitle>
System Interface Definitions, Issue 7 (IEEE Std. 1003.1-2008)
</citetitle>
</ulink>
</biblioid>
<copyright> <copyright>
<year>1999</year> <year>2008</year>
<holder> <holder>
The Open Group/The Institute of Electrical and Electronics Engineers, Inc.</holder> The Open Group/The Institute of Electrical and Electronics
Engineers, Inc.
</holder>
</copyright> </copyright>
</biblioentry>
<biblioid>
<ulink url="http://www.unix.org/version3/ieee_std.html">
</ulink>
</biblioid>
</biblioentry>
<biblioentry> <biblioentry>
<title> <title>
The C++ Programming Language, Special Edition The C++ Programming Language, Special Edition
</title> </title>
<author> <author>
<surname>Stroustrup</surname> <surname>Stroustrup</surname>
<firstname>Bjarne</firstname> <firstname>Bjarne</firstname>
</author> </author>
<copyright> <copyright>
<year>2000</year> <year>2000</year>
<holder>Addison Wesley, Inc.</holder> <holder>Addison Wesley, Inc.</holder>
</copyright> </copyright>
<pagenums>Appendix D</pagenums> <pagenums>Appendix D</pagenums>
<publisher> <publisher>
<publishername> <publishername>
Addison Wesley Addison Wesley
</publishername> </publishername>
</publisher> </publisher>
</biblioentry>
</biblioentry>
<biblioentry> <biblioentry>
...@@ -648,82 +638,67 @@ codecvt usage. ...@@ -648,82 +638,67 @@ codecvt usage.
<subtitle> <subtitle>
Advanced Programmer's Guide and Reference Advanced Programmer's Guide and Reference
</subtitle> </subtitle>
<author> <author>
<surname>Langer</surname> <surname>Langer</surname>
<firstname>Angelika</firstname> <firstname>Angelika</firstname>
</author> </author>
<author> <author>
<surname>Kreft</surname> <surname>Kreft</surname>
<firstname>Klaus</firstname> <firstname>Klaus</firstname>
</author> </author>
<copyright> <copyright>
<year>2000</year> <year>2000</year>
<holder>Addison Wesley Longman, Inc.</holder> <holder>Addison Wesley Longman, Inc.</holder>
</copyright> </copyright>
<publisher> <publisher>
<publishername> <publishername>
Addison Wesley Longman Addison Wesley Longman
</publishername> </publishername>
</publisher> </publisher>
</biblioentry>
</biblioentry>
<biblioentry> <biblioentry>
<title> <biblioid class="uri">
A brief description of Normative Addendum 1 <ulink url="http://www.lysator.liu.se/c/na1.html">
</title> <citetitle>
A brief description of Normative Addendum 1
</citetitle>
</ulink>
</biblioid>
<author> <author>
<surname>Feather</surname> <surname>Feather</surname>
<firstname>Clive</firstname> <firstname>Clive</firstname>
</author> </author>
<pagenums>Extended Character Sets</pagenums> <pagenums>Extended Character Sets</pagenums>
<biblioid> </biblioentry>
<ulink url="http://www.lysator.liu.se/c/na1.html">
</ulink>
</biblioid>
</biblioentry>
<biblioentry> <biblioentry>
<title> <biblioid class="uri">
The Unicode HOWTO <ulink url="http://tldp.org/HOWTO/Unicode-HOWTO.html">
</title> <citetitle>
The Unicode HOWTO
</citetitle>
</ulink>
</biblioid>
<author> <author>
<surname>Haible</surname> <surname>Haible</surname>
<firstname>Bruno</firstname> <firstname>Bruno</firstname>
</author> </author>
</biblioentry>
<biblioid> <biblioentry>
<ulink url="http://tldp.org/HOWTO/Unicode-HOWTO.html"> <biblioid class="uri">
<ulink url="http://www.cl.cam.ac.uk/~mgk25/unicode.html">
<citetitle>
UTF-8 and Unicode FAQ for Unix/Linux
</citetitle>
</ulink> </ulink>
</biblioid> </biblioid>
</biblioentry>
<biblioentry>
<title>
UTF-8 and Unicode FAQ for Unix/Linux
</title>
<author> <author>
<surname>Khun</surname> <surname>Khun</surname>
<firstname>Markus</firstname> <firstname>Markus</firstname>
</author> </author>
</biblioentry>
<biblioid>
<ulink url="http://www.cl.cam.ac.uk/~mgk25/unicode.html">
</ulink>
</biblioid>
</biblioentry>
</bibliography> </bibliography>
......
<sect1 id="manual.localization.facet.ctype" xreflabel="ctype"> <sect1 id="manual.localization.facet.ctype" xreflabel="ctype">
<?dbhtml filename="ctype.html"?> <?dbhtml filename="ctype.html"?>
<sect1info> <sect1info>
<keywordset> <keywordset>
<keyword> <keyword>
...@@ -67,45 +67,45 @@ characters. ...@@ -67,45 +67,45 @@ characters.
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para> <para>
How to deal with the global locale issue? How to deal with the global locale issue?
</para></listitem> </para></listitem>
<listitem> <listitem>
<para> <para>
How to deal with different types than char, wchar_t? </para></listitem> How to deal with different types than char, wchar_t? </para></listitem>
<listitem><para> <listitem><para>
Overlap between codecvt/ctype: narrow/widen Overlap between codecvt/ctype: narrow/widen
</para></listitem> </para></listitem>
<listitem> <listitem>
<para> <para>
Mask typedef in codecvt_base, argument types in codecvt. what Mask typedef in codecvt_base, argument types in codecvt. what
is know about this type? is know about this type?
</para></listitem> </para></listitem>
<listitem> <listitem>
<para> <para>
Why mask* argument in codecvt? Why mask* argument in codecvt?
</para></listitem> </para></listitem>
<listitem> <listitem>
<para> <para>
Can this be made (more) generic? is there a simple way to Can this be made (more) generic? is there a simple way to
straighten out the configure-time mess that is a by-product of straighten out the configure-time mess that is a by-product of
this class? this class?
</para></listitem> </para></listitem>
<listitem> <listitem>
<para> <para>
Get the ctype&lt;wchar_t&gt;::mask stuff under control. Need to Get the ctype&lt;wchar_t&gt;::mask stuff under control. Need to
make some kind of static table, and not do lookup every time make some kind of static table, and not do lookup every time
somebody hits the do_is... functions. Too bad we can't just somebody hits the do_is... functions. Too bad we can't just
redefine mask for ctype&lt;wchar_t&gt; redefine mask for ctype&lt;wchar_t&gt;
</para></listitem> </para></listitem>
<listitem> <listitem>
<para> <para>
Rename abstract base class. See if just smash-overriding is a Rename abstract base class. See if just smash-overriding is a
better approach. Clarify, add sanity to naming. better approach. Clarify, add sanity to naming.
</para> </para>
...@@ -124,7 +124,6 @@ characters. ...@@ -124,7 +124,6 @@ characters.
<title> <title>
The GNU C Library The GNU C Library
</title> </title>
<author> <author>
<surname>McGrath</surname> <surname>McGrath</surname>
<firstname>Roland</firstname> <firstname>Roland</firstname>
...@@ -133,95 +132,81 @@ characters. ...@@ -133,95 +132,81 @@ characters.
<surname>Drepper</surname> <surname>Drepper</surname>
<firstname>Ulrich</firstname> <firstname>Ulrich</firstname>
</author> </author>
<copyright> <copyright>
<year>2007</year> <year>2007</year>
<holder>FSF</holder> <holder>FSF</holder>
</copyright> </copyright>
<pagenums>Chapters 6 Character Set Handling and 7 Locales and Internationalization</pagenums> <pagenums>Chapters 6 Character Set Handling and 7 Locales and Internationalization</pagenums>
</biblioentry>
</biblioentry>
<biblioentry> <biblioentry>
<title> <title>
Correspondence Correspondence
</title> </title>
<author> <author>
<surname>Drepper</surname> <surname>Drepper</surname>
<firstname>Ulrich</firstname> <firstname>Ulrich</firstname>
</author> </author>
<copyright> <copyright>
<year>2002</year> <year>2002</year>
<holder></holder> <holder></holder>
</copyright> </copyright>
</biblioentry> </biblioentry>
<biblioentry> <biblioentry>
<title> <title>
ISO/IEC 14882:1998 Programming languages - C++ ISO/IEC 14882:1998 Programming languages - C++
</title> </title>
<copyright> <copyright>
<year>1998</year> <year>1998</year>
<holder>ISO</holder> <holder>ISO</holder>
</copyright> </copyright>
</biblioentry> </biblioentry>
<biblioentry> <biblioentry>
<title> <title>
ISO/IEC 9899:1999 Programming languages - C ISO/IEC 9899:1999 Programming languages - C
</title> </title>
<copyright> <copyright>
<year>1999</year> <year>1999</year>
<holder>ISO</holder> <holder>ISO</holder>
</copyright> </copyright>
</biblioentry> </biblioentry>
<biblioentry> <biblioentry>
<title> <biblioid class="uri">
The Open Group Base Specifications, Issue 6 (IEEE Std. 1003.1-2004) <ulink url="http://www.unix.org/version3/ieee_std.html">
</title> <citetitle>
The Open Group Base Specifications, Issue 6 (IEEE Std. 1003.1-2004)
</citetitle>
</ulink>
</biblioid>
<copyright> <copyright>
<year>1999</year> <year>1999</year>
<holder> <holder>
The Open Group/The Institute of Electrical and Electronics Engineers, Inc.</holder> The Open Group/The Institute of Electrical and Electronics Engineers, Inc.</holder>
</copyright> </copyright>
</biblioentry>
<biblioid>
<ulink url="http://www.unix.org/version3/ieee_std.html">
</ulink>
</biblioid>
</biblioentry>
<biblioentry> <biblioentry>
<title> <title>
The C++ Programming Language, Special Edition The C++ Programming Language, Special Edition
</title> </title>
<author> <author>
<surname>Stroustrup</surname> <surname>Stroustrup</surname>
<firstname>Bjarne</firstname> <firstname>Bjarne</firstname>
</author> </author>
<copyright> <copyright>
<year>2000</year> <year>2000</year>
<holder>Addison Wesley, Inc.</holder> <holder>Addison Wesley, Inc.</holder>
</copyright> </copyright>
<pagenums>Appendix D</pagenums> <pagenums>Appendix D</pagenums>
<publisher> <publisher>
<publishername> <publishername>
Addison Wesley Addison Wesley
</publishername> </publishername>
</publisher> </publisher>
</biblioentry>
</biblioentry>
<biblioentry> <biblioentry>
<title> <title>
...@@ -230,29 +215,24 @@ characters. ...@@ -230,29 +215,24 @@ characters.
<subtitle> <subtitle>
Advanced Programmer's Guide and Reference Advanced Programmer's Guide and Reference
</subtitle> </subtitle>
<author> <author>
<surname>Langer</surname> <surname>Langer</surname>
<firstname>Angelika</firstname> <firstname>Angelika</firstname>
</author> </author>
<author> <author>
<surname>Kreft</surname> <surname>Kreft</surname>
<firstname>Klaus</firstname> <firstname>Klaus</firstname>
</author> </author>
<copyright> <copyright>
<year>2000</year> <year>2000</year>
<holder>Addison Wesley Longman, Inc.</holder> <holder>Addison Wesley Longman, Inc.</holder>
</copyright> </copyright>
<publisher> <publisher>
<publishername> <publishername>
Addison Wesley Longman Addison Wesley Longman
</publishername> </publishername>
</publisher> </publisher>
</biblioentry>
</biblioentry>
</bibliography> </bibliography>
......
<sect1 id="manual.localization.locales.locale" xreflabel="Locale"> <sect1 id="manual.localization.locales.locale" xreflabel="Locale">
<sect1info> <sect1info>
<keywordset> <keywordset>
<keyword> <keyword>
...@@ -113,8 +113,8 @@ portability is an issue. ...@@ -113,8 +113,8 @@ portability is an issue.
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para> <para>
<code>`locale -a`</code> displays available locales. <code>`locale -a`</code> displays available locales.
</para> </para>
<blockquote> <blockquote>
<programlisting> <programlisting>
...@@ -419,9 +419,9 @@ zh_TW.utf8 ...@@ -419,9 +419,9 @@ zh_TW.utf8
</programlisting> </programlisting>
</blockquote> </blockquote>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
<code>`locale`</code> displays environmental variables that <code>`locale`</code> displays environmental variables that
impact how locale("") will be deduced. impact how locale("") will be deduced.
</para> </para>
...@@ -478,33 +478,33 @@ global locale" (emphasis Paolo), that is: ...@@ -478,33 +478,33 @@ global locale" (emphasis Paolo), that is:
<para> <para>
Locale initialization: at what point does _S_classic, _S_global Locale initialization: at what point does _S_classic, _S_global
get initialized? Can named locales assume this initialization get initialized? Can named locales assume this initialization
has already taken place? has already taken place?
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Document how named locales error check when filling data Document how named locales error check when filling data
members. I.e., a fr_FR locale that doesn't have members. I.e., a fr_FR locale that doesn't have
numpunct::truename(): does it use "true"? Or is it a blank numpunct::truename(): does it use "true"? Or is it a blank
string? What's the convention? string? What's the convention?
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Explain how locale aliasing happens. When does "de_DE" use "de" Explain how locale aliasing happens. When does "de_DE" use "de"
information? What is the rule for locales composed of just an information? What is the rule for locales composed of just an
ISO language code (say, "de") and locales with both an ISO ISO language code (say, "de") and locales with both an ISO
language code and ISO country code (say, "de_DE"). language code and ISO country code (say, "de_DE").
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
What should non-required facet instantiations do? If the What should non-required facet instantiations do? If the
generic implementation is provided, then how to end-users generic implementation is provided, then how to end-users
provide specializations? provide specializations?
</para> </para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>
...@@ -517,7 +517,6 @@ global locale" (emphasis Paolo), that is: ...@@ -517,7 +517,6 @@ global locale" (emphasis Paolo), that is:
<title> <title>
The GNU C Library The GNU C Library
</title> </title>
<author> <author>
<surname>McGrath</surname> <surname>McGrath</surname>
<firstname>Roland</firstname> <firstname>Roland</firstname>
...@@ -526,95 +525,86 @@ global locale" (emphasis Paolo), that is: ...@@ -526,95 +525,86 @@ global locale" (emphasis Paolo), that is:
<surname>Drepper</surname> <surname>Drepper</surname>
<firstname>Ulrich</firstname> <firstname>Ulrich</firstname>
</author> </author>
<copyright> <copyright>
<year>2007</year> <year>2007</year>
<holder>FSF</holder> <holder>FSF</holder>
</copyright> </copyright>
<pagenums>Chapters 6 Character Set Handling and 7 Locales and Internationalization</pagenums> <pagenums>
Chapters 6 Character Set Handling and 7 Locales and
</biblioentry> Internationalization
</pagenums>
</biblioentry>
<biblioentry> <biblioentry>
<title> <title>
Correspondence Correspondence
</title> </title>
<author> <author>
<surname>Drepper</surname> <surname>Drepper</surname>
<firstname>Ulrich</firstname> <firstname>Ulrich</firstname>
</author> </author>
<copyright> <copyright>
<year>2002</year> <year>2002</year>
<holder></holder> <holder></holder>
</copyright> </copyright>
</biblioentry> </biblioentry>
<biblioentry> <biblioentry>
<title> <title>
ISO/IEC 14882:1998 Programming languages - C++ ISO/IEC 14882:1998 Programming languages - C++
</title> </title>
<copyright> <copyright>
<year>1998</year> <year>1998</year>
<holder>ISO</holder> <holder>ISO</holder>
</copyright> </copyright>
</biblioentry> </biblioentry>
<biblioentry> <biblioentry>
<title> <title>
ISO/IEC 9899:1999 Programming languages - C ISO/IEC 9899:1999 Programming languages - C
</title> </title>
<copyright> <copyright>
<year>1999</year> <year>1999</year>
<holder>ISO</holder> <holder>ISO</holder>
</copyright> </copyright>
</biblioentry> </biblioentry>
<biblioentry> <biblioentry>
<title> <biblioid class="uri">
The Open Group Base Specifications, Issue 6 (IEEE Std. 1003.1-2004) <ulink url="http://www.opengroup.org/austin">
</title> <citetitle>
System Interface Definitions, Issue 7 (IEEE Std. 1003.1-2008)
</citetitle>
</ulink>
</biblioid>
<copyright> <copyright>
<year>1999</year> <year>2008</year>
<holder> <holder>
The Open Group/The Institute of Electrical and Electronics Engineers, Inc.</holder> The Open Group/The Institute of Electrical and Electronics
Engineers, Inc.
</holder>
</copyright> </copyright>
</biblioentry>
<biblioid>
<ulink url="http://www.unix.org/version3/ieee_std.html">
</ulink>
</biblioid>
</biblioentry>
<biblioentry> <biblioentry>
<title> <title>
The C++ Programming Language, Special Edition The C++ Programming Language, Special Edition
</title> </title>
<author> <author>
<surname>Stroustrup</surname> <surname>Stroustrup</surname>
<firstname>Bjarne</firstname> <firstname>Bjarne</firstname>
</author> </author>
<copyright> <copyright>
<year>2000</year> <year>2000</year>
<holder>Addison Wesley, Inc.</holder> <holder>Addison Wesley, Inc.</holder>
</copyright> </copyright>
<pagenums>Appendix D</pagenums> <pagenums>Appendix D</pagenums>
<publisher> <publisher>
<publishername> <publishername>
Addison Wesley Addison Wesley
</publishername> </publishername>
</publisher> </publisher>
</biblioentry>
</biblioentry>
<biblioentry> <biblioentry>
<title> <title>
...@@ -623,29 +613,24 @@ global locale" (emphasis Paolo), that is: ...@@ -623,29 +613,24 @@ global locale" (emphasis Paolo), that is:
<subtitle> <subtitle>
Advanced Programmer's Guide and Reference Advanced Programmer's Guide and Reference
</subtitle> </subtitle>
<author> <author>
<surname>Langer</surname> <surname>Langer</surname>
<firstname>Angelika</firstname> <firstname>Angelika</firstname>
</author> </author>
<author> <author>
<surname>Kreft</surname> <surname>Kreft</surname>
<firstname>Klaus</firstname> <firstname>Klaus</firstname>
</author> </author>
<copyright> <copyright>
<year>2000</year> <year>2000</year>
<holder>Addison Wesley Longman, Inc.</holder> <holder>Addison Wesley Longman, Inc.</holder>
</copyright> </copyright>
<publisher> <publisher>
<publishername> <publishername>
Addison Wesley Longman Addison Wesley Longman
</publishername> </publishername>
</publisher> </publisher>
</biblioentry>
</biblioentry>
</bibliography> </bibliography>
......
<sect1 id="manual.localization.facet.messages" xreflabel="Messages"> <sect1 id="manual.localization.facet.messages" xreflabel="Messages">
<?dbhtml filename="messages.html"?> <?dbhtml filename="messages.html"?>
<sect1info> <sect1info>
<keywordset> <keywordset>
<keyword> <keyword>
...@@ -40,7 +40,7 @@ during program execution. ...@@ -40,7 +40,7 @@ during program execution.
<para> <para>
This class has three public member functions, which directly This class has three public member functions, which directly
correspond to three protected virtual member functions. correspond to three protected virtual member functions.
</para> </para>
<para> <para>
...@@ -84,7 +84,7 @@ catalog can be opened. ...@@ -84,7 +84,7 @@ catalog can be opened.
<blockquote> <blockquote>
<para> <para>
<emphasis> <emphasis>
-3- Requires: A catalog cat obtained from open() and not yet closed. -3- Requires: A catalog cat obtained from open() and not yet closed.
-4- Returns: A message identified by arguments set, msgid, and dfault, -4- Returns: A message identified by arguments set, msgid, and dfault,
according to an implementation-defined mapping. If no such message can according to an implementation-defined mapping. If no such message can
be found, returns dfault. be found, returns dfault.
...@@ -98,9 +98,9 @@ be found, returns dfault. ...@@ -98,9 +98,9 @@ be found, returns dfault.
<blockquote> <blockquote>
<para> <para>
<emphasis> <emphasis>
-5- Requires: A catalog cat obtained from open() and not yet closed. -5- Requires: A catalog cat obtained from open() and not yet closed.
-6- Effects: Releases unspecified resources associated with cat. -6- Effects: Releases unspecified resources associated with cat.
-7- Notes: The limit on such resources, if any, is implementation-defined. -7- Notes: The limit on such resources, if any, is implementation-defined.
</emphasis> </emphasis>
</para> </para>
</blockquote> </blockquote>
...@@ -112,14 +112,14 @@ be found, returns dfault. ...@@ -112,14 +112,14 @@ be found, returns dfault.
<title>Design</title> <title>Design</title>
<para> <para>
A couple of notes on the standard. A couple of notes on the standard.
</para> </para>
<para> <para>
First, why is <code>messages_base::catalog</code> specified as a typedef First, why is <code>messages_base::catalog</code> specified as a typedef
to int? This makes sense for implementations that use to int? This makes sense for implementations that use
<code>catopen</code>, but not for others. Fortunately, it's not heavily <code>catopen</code>, but not for others. Fortunately, it's not heavily
used and so only a minor irritant. used and so only a minor irritant.
</para> </para>
<para> <para>
...@@ -145,7 +145,7 @@ reflection. ...@@ -145,7 +145,7 @@ reflection.
Lastly, it seems odd that messages, which explicitly require code Lastly, it seems odd that messages, which explicitly require code
conversion, don't use the codecvt facet. Because the messages facet conversion, don't use the codecvt facet. Because the messages facet
has only one template parameter, it is assumed that ctype, and not has only one template parameter, it is assumed that ctype, and not
codecvt, is to be used to convert between character sets. codecvt, is to be used to convert between character sets.
</para> </para>
<para> <para>
...@@ -183,12 +183,12 @@ other, explicitly named locales. ...@@ -183,12 +183,12 @@ other, explicitly named locales.
generic generic
</para> </para>
<para> <para>
This model does very little, and is what is used by default. This model does very little, and is what is used by default.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
gnu gnu
</para> </para>
<para> <para>
...@@ -203,7 +203,7 @@ other, explicitly named locales. ...@@ -203,7 +203,7 @@ other, explicitly named locales.
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
ieee_1003.1-200x ieee_1003.1-200x
</para> </para>
<para> <para>
...@@ -257,14 +257,14 @@ model. ...@@ -257,14 +257,14 @@ model.
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Make initial catalog (see "4 Making the PO Template File" from Make initial catalog (see "4 Making the PO Template File" from
the gettext docs).</para> the gettext docs).</para>
<para> <para>
<code> xgettext --c++ --debug string_literals.cc -o libstdc++.pot </code> <code> xgettext --c++ --debug string_literals.cc -o libstdc++.pot </code>
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para>Make language and country-specific locale catalogs.</para> <para>Make language and country-specific locale catalogs.</para>
<para> <para>
...@@ -284,7 +284,7 @@ model. ...@@ -284,7 +284,7 @@ model.
<code>emacs fr_FR.po</code> <code>emacs fr_FR.po</code>
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para>Make the binary mo files.</para> <para>Make the binary mo files.</para>
<para> <para>
...@@ -336,9 +336,9 @@ void test01() ...@@ -336,9 +336,9 @@ void test01()
{ {
typedef messages&lt;char&gt;::catalog catalog; typedef messages&lt;char&gt;::catalog catalog;
const char* dir = const char* dir =
"/mnt/egcs/build/i686-pc-linux-gnu/libstdc++/po/share/locale"; "/mnt/egcs/build/i686-pc-linux-gnu/libstdc++/po/share/locale";
const locale loc_de("de_DE"); const locale loc_de("de_DE");
const messages&lt;char&gt;&amp; mssg_de = use_facet&lt;messages&lt;char&gt; &gt;(loc_de); const messages&lt;char&gt;&amp; mssg_de = use_facet&lt;messages&lt;char&gt; &gt;(loc_de);
catalog cat_de = mssg_de.open("libstdc++", loc_de, dir); catalog cat_de = mssg_de.open("libstdc++", loc_de, dir);
string s01 = mssg_de.get(cat_de, 0, 0, "please"); string s01 = mssg_de.get(cat_de, 0, 0, "please");
...@@ -373,7 +373,7 @@ void test01() ...@@ -373,7 +373,7 @@ void test01()
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
There are issues with gettext needing the global locale set There are issues with gettext needing the global locale set
to extract a message. This dependence on the global locale to extract a message. This dependence on the global locale
makes the current "gnu" model non MT-safe. Future versions makes the current "gnu" model non MT-safe. Future versions
...@@ -385,7 +385,7 @@ void test01() ...@@ -385,7 +385,7 @@ void test01()
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
Development versions of the GNU "C" library, glibc 2.3 will allow Development versions of the GNU "C" library, glibc 2.3 will allow
a more efficient, MT implementation of std::messages, and will a more efficient, MT implementation of std::messages, and will
allow the removal of the _M_name_messages data member. If this is allow the removal of the _M_name_messages data member. If this is
...@@ -414,14 +414,14 @@ void test01() ...@@ -414,14 +414,14 @@ void test01()
<para> <para>
<code> <code>
catalog catalog
open(const basic_string&lt;char&gt;&amp; __s, const locale&amp; __loc) const open(const basic_string&lt;char&gt;&amp; __s, const locale&amp; __loc) const
</code> </code>
</para> </para>
<para> <para>
<code> <code>
catalog catalog
open(const basic_string&lt;char&gt;&amp;, const locale&amp;, const char*) const; open(const basic_string&lt;char&gt;&amp;, const locale&amp;, const char*) const;
</code> </code>
</para> </para>
...@@ -445,7 +445,6 @@ void test01() ...@@ -445,7 +445,6 @@ void test01()
<title> <title>
The GNU C Library The GNU C Library
</title> </title>
<author> <author>
<surname>McGrath</surname> <surname>McGrath</surname>
<firstname>Roland</firstname> <firstname>Roland</firstname>
...@@ -454,42 +453,37 @@ void test01() ...@@ -454,42 +453,37 @@ void test01()
<surname>Drepper</surname> <surname>Drepper</surname>
<firstname>Ulrich</firstname> <firstname>Ulrich</firstname>
</author> </author>
<copyright> <copyright>
<year>2007</year> <year>2007</year>
<holder>FSF</holder> <holder>FSF</holder>
</copyright> </copyright>
<pagenums>Chapters 6 Character Set Handling, and 7 Locales and Internationalization <pagenums>Chapters 6 Character Set Handling, and 7 Locales and Internationalization
</pagenums> </pagenums>
</biblioentry>
</biblioentry>
<biblioentry> <biblioentry>
<title> <title>
Correspondence Correspondence
</title> </title>
<author> <author>
<surname>Drepper</surname> <surname>Drepper</surname>
<firstname>Ulrich</firstname> <firstname>Ulrich</firstname>
</author> </author>
<copyright> <copyright>
<year>2002</year> <year>2002</year>
<holder></holder> <holder></holder>
</copyright> </copyright>
</biblioentry> </biblioentry>
<biblioentry> <biblioentry>
<title> <title>
ISO/IEC 14882:1998 Programming languages - C++ ISO/IEC 14882:1998 Programming languages - C++
</title> </title>
<copyright> <copyright>
<year>1998</year> <year>1998</year>
<holder>ISO</holder> <holder>ISO</holder>
</copyright> </copyright>
</biblioentry> </biblioentry>
<biblioentry> <biblioentry>
<title> <title>
...@@ -500,50 +494,44 @@ void test01() ...@@ -500,50 +494,44 @@ void test01()
<year>1999</year> <year>1999</year>
<holder>ISO</holder> <holder>ISO</holder>
</copyright> </copyright>
</biblioentry> </biblioentry>
<biblioentry> <biblioentry>
<title> <biblioid class="uri">
System Interface Definitions, Issue 6 (IEEE Std. 1003.1-200x) <ulink url="http://www.opengroup.org/austin">
</title> <citetitle>
System Interface Definitions, Issue 7 (IEEE Std. 1003.1-2008)
</citetitle>
</ulink>
</biblioid>
<copyright> <copyright>
<year>1999</year> <year>2008</year>
<holder> <holder>
The Open Group/The Institute of Electrical and Electronics Engineers, Inc.</holder> The Open Group/The Institute of Electrical and Electronics
Engineers, Inc.
</holder>
</copyright> </copyright>
</biblioentry>
<biblioid>
<ulink url="http://www.opengroup.org/austin/">
</ulink>
</biblioid>
</biblioentry>
<biblioentry> <biblioentry>
<title> <title>
The C++ Programming Language, Special Edition The C++ Programming Language, Special Edition
</title> </title>
<author> <author>
<surname>Stroustrup</surname> <surname>Stroustrup</surname>
<firstname>Bjarne</firstname> <firstname>Bjarne</firstname>
</author> </author>
<copyright> <copyright>
<year>2000</year> <year>2000</year>
<holder>Addison Wesley, Inc.</holder> <holder>Addison Wesley, Inc.</holder>
</copyright> </copyright>
<pagenums>Appendix D</pagenums> <pagenums>Appendix D</pagenums>
<publisher> <publisher>
<publishername> <publishername>
Addison Wesley Addison Wesley
</publishername> </publishername>
</publisher> </publisher>
</biblioentry>
</biblioentry>
<biblioentry> <biblioentry>
<title> <title>
...@@ -552,52 +540,48 @@ void test01() ...@@ -552,52 +540,48 @@ void test01()
<subtitle> <subtitle>
Advanced Programmer's Guide and Reference Advanced Programmer's Guide and Reference
</subtitle> </subtitle>
<author> <author>
<surname>Langer</surname> <surname>Langer</surname>
<firstname>Angelika</firstname> <firstname>Angelika</firstname>
</author> </author>
<author> <author>
<surname>Kreft</surname> <surname>Kreft</surname>
<firstname>Klaus</firstname> <firstname>Klaus</firstname>
</author> </author>
<copyright> <copyright>
<year>2000</year> <year>2000</year>
<holder>Addison Wesley Longman, Inc.</holder> <holder>Addison Wesley Longman, Inc.</holder>
</copyright> </copyright>
<publisher> <publisher>
<publishername> <publishername>
Addison Wesley Longman Addison Wesley Longman
</publishername> </publishername>
</publisher> </publisher>
</biblioentry>
</biblioentry>
<biblioentry> <biblioentry>
<title> <biblioid class="uri">
Java 2 Platform, Standard Edition, v 1.3.1 API Specification
</title>
<pagenums>java.util.Properties, java.text.MessageFormat,
java.util.Locale, java.util.ResourceBundle</pagenums>
<biblioid>
<ulink url="http://java.sun.com/reference/api/index.html"> <ulink url="http://java.sun.com/reference/api/index.html">
<citetitle>
API Specifications, Java Platform
</citetitle>
</ulink> </ulink>
</biblioid> </biblioid>
</biblioentry> <pagenums>java.util.Properties, java.text.MessageFormat,
java.util.Locale, java.util.ResourceBundle
</pagenums>
</biblioentry>
<biblioentry> <biblioentry>
<title> <biblioid class="uri">
GNU gettext tools, version 0.10.38, Native Language Support
Library and Tools.
</title>
<biblioid>
<ulink url="http://www.gnu.org/software/gettext/"> <ulink url="http://www.gnu.org/software/gettext/">
<citetitle>
GNU gettext tools, version 0.10.38, Native Language Support
Library and Tools.
</citetitle>
</ulink> </ulink>
</biblioid> </biblioid>
</biblioentry> </biblioentry>
</bibliography> </bibliography>
......
...@@ -225,7 +225,7 @@ vector-size: improvement = 3: call stack = 0x804842c ... ...@@ -225,7 +225,7 @@ vector-size: improvement = 3: call stack = 0x804842c ...
<para> <para>
</para> </para>
<table frame='all'> <table frame='all'>
<title>Code Location</title> <title>Profile Code Location</title>
<tgroup cols='2' align='left' colsep='1' rowsep='1'> <tgroup cols='2' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'></colspec> <colspec colname='c1'></colspec>
<colspec colname='c2'></colspec> <colspec colname='c2'></colspec>
...@@ -713,7 +713,7 @@ it helps the user focus on the key problems and ignore the uninteresting ones. ...@@ -713,7 +713,7 @@ it helps the user focus on the key problems and ignore the uninteresting ones.
</para> </para>
<table frame='all'> <table frame='all'>
<title>Diagnostics</title> <title>Profile Diagnostics</title>
<tgroup cols='6' align='left' colsep='1' rowsep='1'> <tgroup cols='6' align='left' colsep='1' rowsep='1'>
<colspec colname='c1'></colspec> <colspec colname='c1'></colspec>
<colspec colname='c2'></colspec> <colspec colname='c2'></colspec>
......
...@@ -501,78 +501,55 @@ the following types, depending on how the shared_ptr is constructed. ...@@ -501,78 +501,55 @@ the following types, depending on how the shared_ptr is constructed.
<title>Bibliography</title> <title>Bibliography</title>
<biblioentry> <biblioentry>
<abbrev> <biblioid class="uri">
n2351
</abbrev>
<title>
Improving shared_ptr for C++0x, Revision 2
</title>
<subtitle>
N2351
</subtitle>
<biblioid>
<ulink url="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2007/n2351.htm"> <ulink url="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2007/n2351.htm">
<citetitle>
Improving shared_ptr for C++0x, Revision 2
</citetitle>
</ulink> </ulink>
</biblioid> </biblioid>
</biblioentry>
<biblioentry>
<abbrev>
n2456
</abbrev>
<title>
C++ Standard Library Active Issues List (Revision R52)
</title>
<subtitle> <subtitle>
N2456 N2351
</subtitle> </subtitle>
</biblioentry>
<biblioid> <biblioentry>
<biblioid class="uri">
<ulink url="http://open-std.org/jtc1/sc22/wg21/docs/papers/2007/n2456.html"> <ulink url="http://open-std.org/jtc1/sc22/wg21/docs/papers/2007/n2456.html">
<citetitle>
C++ Standard Library Active Issues List
</citetitle>
</ulink> </ulink>
</biblioid> </biblioid>
</biblioentry>
<biblioentry>
<abbrev>
n2461
</abbrev>
<title>
Working Draft, Standard for Programming Language C++
</title>
<subtitle> <subtitle>
N2461 N2456
</subtitle> </subtitle>
</biblioentry>
<biblioid> <biblioentry>
<biblioid class="uri">
<ulink url="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2007/n2461.pdf"> <ulink url="http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2007/n2461.pdf">
<citetitle>
Working Draft, Standard for Programming Language C++
</citetitle>
</ulink> </ulink>
</biblioid> </biblioid>
</biblioentry>
<biblioentry>
<abbrev>
boostshared_ptr
</abbrev>
<title>
Boost C++ Libraries documentation - shared_ptr class template
</title>
<subtitle> <subtitle>
N2461 N2461
</subtitle> </subtitle>
</biblioentry>
<biblioid> <biblioentry>
<biblioid class="uri">
<ulink url="http://boost.org/libs/smart_ptr/shared_ptr.htm">shared_ptr <ulink url="http://boost.org/libs/smart_ptr/shared_ptr.htm">shared_ptr
<citetitle>
Boost C++ Libraries documentation, shared_ptr
</citetitle>
</ulink> </ulink>
</biblioid> </biblioid>
<subtitle>
N2461
</subtitle>
</biblioentry> </biblioentry>
</bibliography> </bibliography>
......
...@@ -39,7 +39,7 @@ the <literal>throw</literal> keyword. ...@@ -39,7 +39,7 @@ the <literal>throw</literal> keyword.
These are very powerful constructs, and require some thought when These are very powerful constructs, and require some thought when
applied to the standard library in order to yield components that work applied to the standard library in order to yield components that work
efficiently while cleaning up resources when unexpectedly killed via efficiently while cleaning up resources when unexpectedly killed via
exceptional circumstances. exceptional circumstances.
</para> </para>
<para> <para>
...@@ -51,8 +51,8 @@ exception neutrality and exception safety. ...@@ -51,8 +51,8 @@ exception neutrality and exception safety.
<sect2 id="intro.using.exception.safety" xreflabel="Exception Safety"> <sect2 id="intro.using.exception.safety" xreflabel="Exception Safety">
<title>Exception Safety</title> <title>Exception Safety</title>
<para> <para>
What is exception-safe code? What is exception-safe code?
</para> </para>
<para> <para>
...@@ -230,9 +230,9 @@ exception neutrality and exception safety. ...@@ -230,9 +230,9 @@ exception neutrality and exception safety.
use <literal>-fno-exceptions</literal>. If you have some code that use <literal>-fno-exceptions</literal>. If you have some code that
uses <literal>try</literal> or <literal>catch</literal>, you uses <literal>try</literal> or <literal>catch</literal>, you
shouldn't use <literal>-fno-exceptions</literal>. shouldn't use <literal>-fno-exceptions</literal>.
</para> </para>
<para> <para>
And what it to be gained, tinkering in the back alleys with a And what it to be gained, tinkering in the back alleys with a
language like this? Exception handling overhead can be measured language like this? Exception handling overhead can be measured
in the size of the executable binary, and varies with the in the size of the executable binary, and varies with the
...@@ -318,7 +318,7 @@ exception neutrality and exception safety. ...@@ -318,7 +318,7 @@ exception neutrality and exception safety.
library has been transformed, user code may need modification. User library has been transformed, user code may need modification. User
code that attempts or expects to do error checking on standard code that attempts or expects to do error checking on standard
library components compiled with exception handling disabled should library components compiled with exception handling disabled should
be evaluated and potentially made conditional. be evaluated and potentially made conditional.
</para> </para>
<para> <para>
...@@ -360,7 +360,7 @@ exception neutrality and exception safety. ...@@ -360,7 +360,7 @@ exception neutrality and exception safety.
<sect3 id="using.exception.compat.c"> <sect3 id="using.exception.compat.c">
<title>With <literal>C</literal></title> <title>With <literal>C</literal></title>
<para> <para>
C language code that is expecting to interoperate with C++ should be C language code that is expecting to interoperate with C++ should be
compiled with <literal>-fexceptions</literal>. This will make compiled with <literal>-fexceptions</literal>. This will make
debugging a C language function called as part of C++-induced stack debugging a C language function called as part of C++-induced stack
...@@ -386,7 +386,7 @@ is called. ...@@ -386,7 +386,7 @@ is called.
<sect3 id="using.exception.compat.posix"> <sect3 id="using.exception.compat.posix">
<title>With <literal>POSIX</literal> thread cancellation</title> <title>With <literal>POSIX</literal> thread cancellation</title>
<para> <para>
GNU systems re-use some of the exception handling mechanisms to GNU systems re-use some of the exception handling mechanisms to
track control flow for <literal>POSIX</literal> thread cancellation. track control flow for <literal>POSIX</literal> thread cancellation.
</para> </para>
...@@ -439,30 +439,33 @@ is called. ...@@ -439,30 +439,33 @@ is called.
<title>Bibliography</title> <title>Bibliography</title>
<biblioentry> <biblioentry>
<title> <biblioid class="uri">
System Interface Definitions, Issue 7 (IEEE Std. 1003.1-2008) <ulink url="http://www.opengroup.org/austin">
</title> <citetitle>
System Interface Definitions, Issue 7 (IEEE Std. 1003.1-2008)
</citetitle>
</ulink>
</biblioid>
<pagenums> <pagenums>
2.9.5 Thread Cancellation 2.9.5 Thread Cancellation
</pagenums> </pagenums>
<copyright> <copyright>
<year>2008</year> <year>2008</year>
<holder> <holder>
The Open Group/The Institute of Electrical and Electronics Engineers, Inc.</holder> The Open Group/The Institute of Electrical and Electronics
Engineers, Inc.
</holder>
</copyright> </copyright>
</biblioentry>
<biblioid> <biblioentry>
<ulink url="http://www.opengroup.org/austin/"> <biblioid class="uri">
<ulink url="http://www.boost.org/community/error_handling.html">
<citetitle>
Error and Exception Handling
</citetitle>
</ulink> </ulink>
</biblioid> </biblioid>
</biblioentry>
<biblioentry>
<title>
Error and Exception Handling
</title>
<author> <author>
<firstname>David</firstname> <firstname>David</firstname>
<surname>Abrahams </surname> <surname>Abrahams </surname>
...@@ -472,17 +475,17 @@ is called. ...@@ -472,17 +475,17 @@ is called.
Boost Boost
</publishername> </publishername>
</publisher> </publisher>
<biblioid> </biblioentry>
<ulink url="http://www.boost.org/community/error_handling.html">
</ulink>
</biblioid>
</biblioentry>
<biblioentry> <biblioentry>
<title> <biblioid class="uri">
Exception-Safety in Generic Components <ulink url="http://www.boost.org/community/exception_safety.html">
</title> <citetitle>
Exception-Safety in Generic Components
</citetitle>
</ulink>
</biblioid>
<author> <author>
<firstname>David</firstname> <firstname>David</firstname>
<surname>Abrahams</surname> <surname>Abrahams</surname>
...@@ -492,16 +495,16 @@ is called. ...@@ -492,16 +495,16 @@ is called.
Boost Boost
</publishername> </publishername>
</publisher> </publisher>
<biblioid> </biblioentry>
<ulink url="http://www.boost.org/community/exception_safety.html">
</ulink>
</biblioid>
</biblioentry>
<biblioentry> <biblioentry>
<title> <biblioid class="uri">
Standard Library Exception Policy <ulink url="www.open-std.org/jtc1/sc22/wg21/docs/papers/1997/N1077.pdf">
</title> <citetitle>
Standard Library Exception Policy
</citetitle>
</ulink>
</biblioid>
<author> <author>
<firstname>Matt</firstname> <firstname>Matt</firstname>
<surname>Austern</surname> <surname>Austern</surname>
...@@ -511,16 +514,16 @@ is called. ...@@ -511,16 +514,16 @@ is called.
WG21 N1077 WG21 N1077
</publishername> </publishername>
</publisher> </publisher>
<biblioid> </biblioentry>
<ulink url="www.open-std.org/jtc1/sc22/wg21/docs/papers/1997/N1077.pdf">
</ulink>
</biblioid>
</biblioentry>
<biblioentry> <biblioentry>
<title> <biblioid class="uri">
ia64 c++ abi exception handling <ulink url="http://gcc.gnu.org/ml/gcc-patches/2001-03/msg00661.html">
</title> <citetitle>
ia64 c++ abi exception handling
</citetitle>
</ulink>
</biblioid>
<author> <author>
<firstname>Richard</firstname> <firstname>Richard</firstname>
<surname>Henderson</surname> <surname>Henderson</surname>
...@@ -530,25 +533,21 @@ is called. ...@@ -530,25 +533,21 @@ is called.
GNU GNU
</publishername> </publishername>
</publisher> </publisher>
<biblioid> </biblioentry>
<ulink url="http://gcc.gnu.org/ml/gcc-patches/2001-03/msg00661.html">
</ulink>
</biblioid>
</biblioentry>
<biblioentry> <biblioentry>
<title> <biblioid class="uri">
Appendix E: Standard-Library Exception Safety <ulink url="http://www.research.att.com/~bs/3rd_safe.pdf">
</title> <citetitle>
Appendix E: Standard-Library Exception Safety
</citetitle>
</ulink>
</biblioid>
<author> <author>
<firstname>Bjarne</firstname> <firstname>Bjarne</firstname>
<surname>Stroustrup</surname> <surname>Stroustrup</surname>
</author> </author>
<biblioid> </biblioentry>
<ulink url="http://www.research.att.com/~bs/3rd_safe.pdf">
</ulink>
</biblioid>
</biblioentry>
<biblioentry> <biblioentry>
<title> <title>
...@@ -561,18 +560,17 @@ is called. ...@@ -561,18 +560,17 @@ is called.
<firstname>Herb</firstname> <firstname>Herb</firstname>
<surname>Sutter</surname> <surname>Sutter</surname>
</author> </author>
</biblioentry> </biblioentry>
<biblioentry> <biblioentry>
<title> <biblioid class="uri">
exception_defines.h #defines try/catch <ulink url="http://gcc.gnu.org/PR25191">
</title> <citetitle>
<subtitle> GCC Bug 25191: exception_defines.h #defines try/catch
GCC Bug <ulink url="http://gcc.gnu.org/PR25191">25191</ulink> </citetitle>
</subtitle> </ulink>
<biblioid>
</biblioid> </biblioid>
</biblioentry> </biblioentry>
</bibliography> </bibliography>
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment