This is the mail archive of the
libstdc++@gcc.gnu.org
mailing list for the libstdc++ project.
Re: dead documentation link
- From: Benjamin Kosnik <bkoz at redhat dot com>
- To: libstdc++ at gcc dot gnu dot org
- Cc: tfogal at sci dot utah dot edu
- Date: Mon, 20 Jul 2009 12:26:10 -0700
- Subject: Re: dead documentation link
- References: <auto-000019991083@sci.utah.edu>
> Minor nit in the online docs:
>
> http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt03ch08.html
>
> The "--enable-concept-checks" link gives a 404. Presumably it meant
> to link to:
>
> http://gcc.gnu.org/onlinedocs/libstdc++/manual/configure.html
this should be fixed now. I ran the docs through the W3C link checker
and did some fixups, then regenerated the HTML. Please allow a bit of
time for this to propagate to the web page.
-benjamin
2009-07-20 Benjamin Kosnik <bkoz@redhat.com>
* doc/xml/manual/intro.xml: Escape '&', validate.
* doc/xml/manual/using.xml: Validate, dead link check.
* doc/xml/manual/strings.xml: Same.
* doc/xml/manual/appendix_contributing.xml: Same.
* doc/xml/manual/iterators.xml: Same.
* doc/xml/manual/spine.xml: Same.
* doc/html: Regenerate.
Index: doc/xml/manual/intro.xml
===================================================================
--- doc/xml/manual/intro.xml (revision 149825)
+++ doc/xml/manual/intro.xml (working copy)
@@ -78,7 +78,7 @@
Version 3.1, 31 March 2009
-Copyright (C) 2009 <ulink url="http://fsf.org">Free Software Foundation, Inc.</ulink>
+Copyright (C) 2009 <ulink url="http://www.fsf.org">Free Software Foundation, Inc.</ulink>
Everyone is permitted to copy and distribute verbatim copies of this
license document, but changing it is not allowed.
@@ -737,7 +737,7 @@
</para></listitem></varlistentry>
<varlistentry><term><ulink url="../ext/lwg-active.html#696">696</ulink>:
- <emphasis>istream::operator>>(int&) broken</emphasis>
+ <emphasis>istream::operator>>(int&) broken</emphasis>
</term>
<listitem><para>Implement the straightforward resolution.
</para></listitem></varlistentry>
Index: doc/xml/manual/using.xml
===================================================================
--- doc/xml/manual/using.xml (revision 149825)
+++ doc/xml/manual/using.xml (working copy)
@@ -918,26 +918,24 @@
<varlistentry><term><code>_GLIBCXX_DEBUG</code></term>
<listitem>
<para>
- Undefined by default. When defined, compiles
- user code using the <ulink url="../ext/debug.html#safe">libstdc++ debug
- mode</ulink>.
+ Undefined by default. When defined, compiles user code using
+ the <link linkend="manual.ext.debug_mode">debug mode</link>.
</para>
</listitem></varlistentry>
<varlistentry><term><code>_GLIBCXX_DEBUG_PEDANTIC</code></term>
<listitem>
<para>
- Undefined by default. When defined while
- compiling with the <ulink url="../ext/debug.html#safe">libstdc++ debug
- mode</ulink>, makes the debug mode extremely picky by making the use
- of libstdc++ extensions and libstdc++-specific behavior into
- errors.
+ Undefined by default. When defined while compiling with
+ the <link linkend="manual.ext.debug_mode">debug mode</link>, makes
+ the debug mode extremely picky by making the use of libstdc++
+ extensions and libstdc++-specific behavior into errors.
</para>
</listitem></varlistentry>
<varlistentry><term><code>_GLIBCXX_PARALLEL</code></term>
<listitem>
- <para>Undefined by default. When defined, compiles
- user code using the <ulink url="../ext/parallel_mode.html">libstdc++ parallel
- mode</ulink>.
+ <para>Undefined by default. When defined, compiles user code
+ using the <link linkend="manual.ext.parallel_mode">parallel
+ mode</link>.
</para>
</listitem></varlistentry>
</variablelist>
Index: doc/xml/manual/strings.xml
===================================================================
--- doc/xml/manual/strings.xml (revision 149825)
+++ doc/xml/manual/strings.xml (working copy)
@@ -370,10 +370,11 @@
<programlisting>
std::string(str.data(), str.size()).swap(str);
</programlisting>
- <para>This is similar to the idiom for reducing a <code>vector</code>'s
- memory usage (see <ulink url='../faq/index.html#5_9'>FAQ 5.9</ulink>) but
- the regular copy constructor cannot be used because libstdc++'s
- <code>string</code> is Copy-On-Write.
+ <para>This is similar to the idiom for reducing
+ a <code>vector</code>'s memory usage
+ (see <link linkend="faq.size_equals_capacity">this FAQ
+ entry</link>) but the regular copy constructor cannot be used
+ because libstdc++'s <code>string</code> is Copy-On-Write.
</para>
Index: doc/xml/manual/appendix_contributing.xml
===================================================================
--- doc/xml/manual/appendix_contributing.xml (revision 149825)
+++ doc/xml/manual/appendix_contributing.xml (working copy)
@@ -52,7 +52,7 @@
organization is ANSI and their web-site is right
<ulink url="http://www.ansi.org">here.</ulink>
(And if you've already registered with them, clicking this link will take you to directly to the place where you can
- <ulink url="http://webstore.ansi.org/ansidocstore/product.asp?sku=ISO%2FIEC+14882%3A2003">buy the standard on-line.)</ulink>
+ <ulink url="http://webstore.ansi.org/RecordDetail.aspx?sku=ISO/IEC%2014882:2003">buy the standard on-line.)</ulink>
</para>
</listitem>
@@ -1708,7 +1708,7 @@
Anyone participating in implementation of the library should obtain
a copy of the standard, ISO 14882. People in the U.S. can obtain an
electronic copy for US$18 from ANSI's web site. Those from other
- countries should visit http://www.iso.ch/ to find out the location
+ countries should visit http://www.iso.org/ to find out the location
of their country's representation in ISO, in order to know who can
sell them a copy.
Index: doc/xml/manual/iterators.xml
===================================================================
--- doc/xml/manual/iterators.xml (revision 149825)
+++ doc/xml/manual/iterators.xml (working copy)
@@ -28,9 +28,12 @@
<sect1 id="iterators.predefined.vs_pointers" xreflabel="Versus Pointers">
<title>Iterators vs. Pointers</title>
- <para><ulink url="../faq/index.html#5_1">FAQ 5.1</ulink> points out that iterators
- are not implemented as pointers. They are a generalization of
- pointers, but they are implemented in libstdc++ as separate classes.
+ <para>
+ The following
+FAQ <link linkend="faq.iterator_as_pod">entry</link> points out that
+iterators are not implemented as pointers. They are a generalization
+of pointers, but they are implemented in libstdc++ as separate
+classes.
</para>
<para>Keeping that simple fact in mind as you design your code will
prevent a whole lot of difficult-to-understand bugs.
Index: doc/xml/manual/spine.xml
===================================================================
--- doc/xml/manual/spine.xml (revision 149825)
+++ doc/xml/manual/spine.xml (working copy)
@@ -12,7 +12,7 @@
<copyright>
<year>2009</year>
<holder>
- <ulink url="http://fsf.org">FSF</ulink>
+ <ulink url="http://www.fsf.org">FSF</ulink>
</holder>
</copyright>
<legalnotice>
Index: ChangeLog
===================================================================
--- ChangeLog (revision 149825)
+++ ChangeLog (working copy)
@@ -1,3 +1,7 @@
+2009-07-20 Benjamin Kosnik <bkoz@redhat.com>
+
+ * doc/xml/manual/intro.xml: Escape &, validate.
+
2009-07-18 Paolo Carlini <paolo.carlini@oracle.com>
PR libstdc++/40712