[libstdc++,doc] Strip links to ANSI (web shop)

[libstdc++,doc] Strip links to ANSI (web shop)

[Gerald Pfeifer]

First of all, I am not sure whether this is really a FAQ (and even
if so, why we duplicate text in the FAQ and the manual).

But referring to ANSI's webshop (and even ANSI) via a link feels a
little over the edge, doesn't it?

I have _not_ applied this yet.  What do you think?  Any objections?

Gerald

2017-02-05  Gerald Pfeifer  <gerald@pfeifer.com>

	* doc/xml/faq.xml: Remove links to ANSI and their webshop.
	* doc/xml/manual/appendix_contributing.xml: Ditto.

Index: doc/xml/faq.xml
===================================================================
--- doc/xml/faq.xml	(revision 245197)
+++ doc/xml/faq.xml	(working copy)
@@ -1183,11 +1183,7 @@
     and sustained their two-meeting commitment for voting rights, may
     get a copy of the standard from their respective national
     standards organization.  In the USA, this national standards
-    organization is ANSI and their website is
-    right <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.ansi.org">here</link>.  (And if
-    you've already registered with them, clicking this link will take
-    you to directly to the place where you can
-    <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://webstore.ansi.org/RecordDetail.aspx?sku=ISO%2FIEC+14882:2003">buy the standard on-line</link>.
+    organization is ANSI.
     </para>
     <para>
     Who is your country's member body?  Visit the
Index: doc/xml/manual/appendix_contributing.xml
===================================================================
--- doc/xml/manual/appendix_contributing.xml	(revision 245197)
+++ doc/xml/manual/appendix_contributing.xml	(working copy)
@@ -44,10 +44,7 @@
 	  two meeting commitment for voting rights, may get a copy of
 	  the standard from their respective national standards
 	  organization. In the USA, this national standards
-	  organization is
-	  <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.ansi.org">ANSI</link>.
-	  (And if you've already registered with them you can
-	  <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://webstore.ansi.org/RecordDetail.aspx?sku=INCITS%2fISO%2fIEC+14882-2012">buy the standard on-line</link>.)
+	  organization is ANSI.
 	</para>
       </listitem>
 

Re: [libstdc++,doc] Strip links to ANSI (web shop)

[Jonathan Wakely]

On 05/02/17 22:22 +0100, Gerald Pfeifer wrote:
>First of all, I am not sure whether this is really a FAQ (and even
>if so, why we duplicate text in the FAQ and the manual).
>
>But referring to ANSI's webshop (and even ANSI) via a link feels a
>little over the edge, doesn't it?

ANSI sells the standard for a much more reasonable price than ISO or
any of the other national standards bodies. I think many people use
draft standards now, rather than buying it, but for those who do want
an official copy ANSI is the cheapest source.

>I have _not_ applied this yet.  What do you think?  Any objections?

I don't see a need to remove the links, but no objections either.

Re: [libstdc++,doc] Strip links to ANSI (web shop)

[Gerald Pfeifer]

On Sun, 5 Feb 2017, Jonathan Wakely wrote:
> ANSI sells the standard for a much more reasonable price than ISO or
> any of the other national standards bodies. I think many people use
> draft standards now, rather than buying it, but for those who do want
> an official copy ANSI is the cheapest source.

Ah, makes sense.  Unfortunately the direct link into the ANSI
web shop is broken, and I somehow failed to find a good replacement.
Do you have one?

Also, below an updated patch suggestion that mostly removes the
essential duplication of information in faq.xml.

What do you think?

Gerald


2017-02-09  Gerald Pfeifer  <gerald@pfeifer.com>

	* doc/xml/manual/appendix_contributing.xml: Use https for ansi.org.

	* doc/xml/faq.xml (How do I get a copy of the ISO C++ Standard?):
	Remove.

Index: doc/xml/manual/appendix_contributing.xml
===================================================================
--- doc/xml/manual/appendix_contributing.xml	(revision 245299)
+++ doc/xml/manual/appendix_contributing.xml	(working copy)
@@ -45,9 +45,9 @@
 	  the standard from their respective national standards
 	  organization. In the USA, this national standards
 	  organization is
-	  <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.ansi.org">ANSI</link>.
+	  <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://www.ansi.org">ANSI</link>.
 	  (And if you've already registered with them you can
-	  <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://webstore.ansi.org/RecordDetail.aspx?sku=INCITS%2fISO%2fIEC+14882-2012">buy the standard on-line</link>.)
+	  <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://webstore.ansi.org/RecordDetail.aspx?sku=INCITS%2fISO%2fIEC+14882-2012">buy the standard on-line</link>.)
 	</para>
       </listitem>

Index: doc/xml/faq.xml
===================================================================
--- doc/xml/faq.xml	(revision 245299)
+++ doc/xml/faq.xml	(working copy)
@@ -1170,36 +1170,6 @@
   </answer>
 </qandaentry>
 
-<qandaentry xml:id="faq.get_iso_cxx">
-  <question xml:id="q-get_iso_cxx">
-    <para>How do I get a copy of the ISO C++ Standard?
-    </para>
-  </question>
-  <answer xml:id="a-get_iso_cxx">
-    <para>
-    Copies of the full ISO 14882 standard are available on line via
-    the ISO mirror site for committee members.  Non-members, or those
-    who have not paid for the privilege of sitting on the committee
-    and sustained their two-meeting commitment for voting rights, may
-    get a copy of the standard from their respective national
-    standards organization.  In the USA, this national standards
-    organization is ANSI and their website is
-    right <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.ansi.org">here</link>.  (And if
-    you've already registered with them, clicking this link will take
-    you to directly to the place where you can
-    <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://webstore.ansi.org/RecordDetail.aspx?sku=ISO%2FIEC+14882:2003">buy the standard on-line</link>.
-    </para>
-    <para>
-    Who is your country's member body?  Visit the
-    <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.iso.ch/">ISO homepage</link> and find out!
-    </para>
-    <para>
-    The 2003 version of the standard (the 1998 version plus TC1) is
-    available in print, ISBN 0-470-84674-7.
-    </para> 
-  </answer>
-</qandaentry>
-
 <qandaentry xml:id="faq.what_is_abi">
   <question xml:id="q-what_is_abi">
     <para>

Re: [libstdc++,doc] Strip links to ANSI (web shop)

[Jonathan Wakely]

On 09/02/17 15:15 +0100, Gerald Pfeifer wrote:
>On Sun, 5 Feb 2017, Jonathan Wakely wrote:
>> ANSI sells the standard for a much more reasonable price than ISO or
>> any of the other national standards bodies. I think many people use
>> draft standards now, rather than buying it, but for those who do want
>> an official copy ANSI is the cheapest source.
>
>Ah, makes sense.  Unfortunately the direct link into the ANSI
>web shop is broken, and I somehow failed to find a good replacement.
>Do you have one?

The C++14 standard is:
http://webstore.ansi.org/RecordDetail.aspx?sku=ISO%2fIEC+14882%3a2014

>Also, below an updated patch suggestion that mostly removes the
>essential duplication of information in faq.xml.
>
>What do you think?

Should we make the FAQ link to the info in the manual, instead of just
removing it?

Re: [libstdc++,doc] Strip links to ANSI (web shop)

[Gerald Pfeifer]

On Wed, 15 Feb 2017, Jonathan Wakely wrote:
> The C++14 standard is:
> http://webstore.ansi.org/RecordDetail.aspx?sku=ISO%2fIEC+14882%3a2014

Thanks, Jonathan!

>> What do you think?
> Should we make the FAQ link to the info in the manual, instead of just
> removing it?

Great idea.  Unfortunately I do not know the Docbook magic to do
this for the libstdc++ documentation, so I went ahead with the
simple version below.

Can you perhaps help making this a "real" link?

Gerald

2017-03-18  Gerald Pfeifer  <gerald@pfeifer.com>

	* doc/xml/manual/appendix_contributing.xml: Convert link to
	ansi.org to https.
	Update link to the C++ standard at ansi.org.

	* doc/xml/faq.xml: Remove information redundant with the above;
	instead add a reference.

Index: doc/xml/manual/appendix_contributing.xml
===================================================================
--- doc/xml/manual/appendix_contributing.xml	(revision 246258)
+++ doc/xml/manual/appendix_contributing.xml	(working copy)
@@ -45,9 +45,11 @@
 	  the standard from their respective national standards
 	  organization. In the USA, this national standards
 	  organization is
-	  <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.ansi.org">ANSI</link>.
-	  (And if you've already registered with them you can
-	  <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://webstore.ansi.org/RecordDetail.aspx?sku=INCITS%2fISO%2fIEC+14882-2012">buy the standard on-line</link>.)
+	  <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://www.ansi.org">ANSI</link>.
+	  (And if you've already registered with them you can <link
+	  xmlns:xlink="http://www.w3.org/1999/xlink"
+	  xlink:href="https://webstore.ansi.org/RecordDetail.aspx?sku=ISO%2fIEC+14882%3a2014">buy
+	  the standard on-line</link>.)
 	</para>
       </listitem>
 
Index: doc/xml/faq.xml
===================================================================
--- doc/xml/faq.xml	(revision 246258)
+++ doc/xml/faq.xml	(working copy)
@@ -1177,25 +1177,7 @@
   </question>
   <answer xml:id="a-get_iso_cxx">
     <para>
-    Copies of the full ISO 14882 standard are available on line via
-    the ISO mirror site for committee members.  Non-members, or those
-    who have not paid for the privilege of sitting on the committee
-    and sustained their two-meeting commitment for voting rights, may
-    get a copy of the standard from their respective national
-    standards organization.  In the USA, this national standards
-    organization is ANSI and their website is
-    right <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.ansi.org">here</link>.  (And if
-    you've already registered with them, clicking this link will take
-    you to directly to the place where you can
-    <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://webstore.ansi.org/RecordDetail.aspx?sku=ISO%2FIEC+14882:2003">buy the standard on-line</link>.
-    </para>
-    <para>
-    Who is your country's member body?  Visit the
-    <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.iso.ch/">ISO homepage</link> and find out!
-    </para>
-    <para>
-    The 2003 version of the standard (the 1998 version plus TC1) is
-    available in print, ISBN 0-470-84674-7.
+    Please refer to the Contributing section in our manual.
     </para> 
   </answer>
 </qandaentry>

Re: [libstdc++,doc] Strip links to ANSI (web shop)

[Jonathan Wakely]

[-- Attachment #1: Type: text/plain, Size: 607 bytes --]

On 18/03/17 19:44 +0100, Gerald Pfeifer wrote:
>On Wed, 15 Feb 2017, Jonathan Wakely wrote:
>> The C++14 standard is:
>> http://webstore.ansi.org/RecordDetail.aspx?sku=ISO%2fIEC+14882%3a2014
>
>Thanks, Jonathan!
>
>>> What do you think?
>> Should we make the FAQ link to the info in the manual, instead of just
>> removing it?
>
>Great idea.  Unfortunately I do not know the Docbook magic to do
>this for the libstdc++ documentation, so I went ahead with the
>simple version below.
>
>Can you perhaps help making this a "real" link?

Exactly how it's one on line 126 in that file. I'll commit this later.



[-- Attachment #2: patch.txt --]
[-- Type: text/x-patch, Size: 718 bytes --]

commit 90a904a447d5153f1bca007b0b4a599e4d8a8731
Author: Jonathan Wakely <jwakely@redhat.com>
Date:   Thu Mar 23 15:00:06 2017 +0000

    Add link to the right section of the manual
    
    	* doc/xml/faq.xml: Add link.
    	* doc/html/*: Regenerate.

diff --git a/libstdc++-v3/doc/xml/faq.xml b/libstdc++-v3/doc/xml/faq.xml
index db67626..340ba9d 100644
--- a/libstdc++-v3/doc/xml/faq.xml
+++ b/libstdc++-v3/doc/xml/faq.xml
@@ -1177,7 +1177,8 @@
   </question>
   <answer xml:id="a-get_iso_cxx">
     <para>
-    Please refer to the Contributing section in our manual.
+    Please refer to the <link linkend="appendix.contrib">Contributing</link>
+    section in our manual.
     </para> 
   </answer>
 </qandaentry>

Re: [libstdc++,doc] Strip links to ANSI (web shop)

[Jonathan Wakely]

[-- Attachment #1: Type: text/plain, Size: 1525 bytes --]

On 23/03/17 15:01 +0000, Jonathan Wakely wrote:
>On 18/03/17 19:44 +0100, Gerald Pfeifer wrote:
>>On Wed, 15 Feb 2017, Jonathan Wakely wrote:
>>>The C++14 standard is:
>>>http://webstore.ansi.org/RecordDetail.aspx?sku=ISO%2fIEC+14882%3a2014
>>
>>Thanks, Jonathan!
>>
>>>>What do you think?
>>>Should we make the FAQ link to the info in the manual, instead of just
>>>removing it?
>>
>>Great idea.  Unfortunately I do not know the Docbook magic to do
>>this for the libstdc++ documentation, so I went ahead with the
>>simple version below.
>>
>>Can you perhaps help making this a "real" link?
>
>Exactly how it's one on line 126 in that file. I'll commit this later.
>
>

>commit 90a904a447d5153f1bca007b0b4a599e4d8a8731
>Author: Jonathan Wakely <jwakely@redhat.com>
>Date:   Thu Mar 23 15:00:06 2017 +0000
>
>    Add link to the right section of the manual
>    
>    	* doc/xml/faq.xml: Add link.
>    	* doc/html/*: Regenerate.
>
>diff --git a/libstdc++-v3/doc/xml/faq.xml b/libstdc++-v3/doc/xml/faq.xml
>index db67626..340ba9d 100644
>--- a/libstdc++-v3/doc/xml/faq.xml
>+++ b/libstdc++-v3/doc/xml/faq.xml
>@@ -1177,7 +1177,8 @@
>   </question>
>   <answer xml:id="a-get_iso_cxx">
>     <para>
>-    Please refer to the Contributing section in our manual.
>+    Please refer to the <link linkend="appendix.contrib">Contributing</link>
>+    section in our manual.
>     </para> 
>   </answer>
> </qandaentry>


The attached patch also fixes some broken links that Gerald pointed
out.

I'm committing this to trunk today.


[-- Attachment #2: patch.txt --]
[-- Type: text/x-patch, Size: 6683 bytes --]

commit 38850ccfa6dadea710556d5f408cef79c2ffd9ec
Author: Jonathan Wakely <jwakely@redhat.com>
Date:   Thu Mar 23 15:00:06 2017 +0000

    Fix broken links in manual and remove outdated info
    
    	* doc/xml/faq.xml: Add link.
    	* doc/xml/manual/backwards_compatibility.xml: Remove outdated
    	information on pre-ISO headers. Replace broken link to C++ FAQ Lite.
    	* doc/xml/manual/io.xml: Update broken link.
    	* doc/html/*: Regenerate.

diff --git a/libstdc++-v3/doc/xml/faq.xml b/libstdc++-v3/doc/xml/faq.xml
index db67626..340ba9d 100644
--- a/libstdc++-v3/doc/xml/faq.xml
+++ b/libstdc++-v3/doc/xml/faq.xml
@@ -1177,7 +1177,8 @@
   </question>
   <answer xml:id="a-get_iso_cxx">
     <para>
-    Please refer to the Contributing section in our manual.
+    Please refer to the <link linkend="appendix.contrib">Contributing</link>
+    section in our manual.
     </para> 
   </answer>
 </qandaentry>
diff --git a/libstdc++-v3/doc/xml/manual/backwards_compatibility.xml b/libstdc++-v3/doc/xml/manual/backwards_compatibility.xml
index 579c368..dbb3371 100644
--- a/libstdc++-v3/doc/xml/manual/backwards_compatibility.xml
+++ b/libstdc++-v3/doc/xml/manual/backwards_compatibility.xml
@@ -598,86 +598,21 @@ libstdc++-v3.
 
 <para>Portability notes and known implementation limitations are as follows.</para>
 
-<section xml:id="backwards.third.headers"><info><title>Pre-ISO headers moved to backwards or removed</title></info>
+<section xml:id="backwards.third.headers"><info><title>Pre-ISO headers removed</title></info>
 
 
 <para> The pre-ISO C++ headers
       (<filename class="headerfile">&lt;iostream.h&gt;</filename>,
       <filename class="headerfile">&lt;defalloc.h&gt;</filename> etc.) are
-      available, unlike previous libstdc++ versions, but inclusion
-      generates a warning that you are using deprecated headers.
+      not supported.
 </para>
 
-    <para>This compatibility layer is constructed by including the
-    standard C++ headers, and injecting any items in
-    <code>std::</code> into the global namespace.
-   </para>
-   <para>For those of you new to ISO C++ (welcome, time travelers!), no,
-      that isn't a typo. Yes, the headers really have new names.
-      Marshall Cline's C++ FAQ Lite has a good explanation in <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.parashift.com/c++-faq-lite/std-headers.html">What's
+   <para>For those of you new to ISO C++ (welcome, time travelers!), the
+      ancient pre-ISO headers have new names.
+      The C++ FAQ has a good explanation in <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://isocpp.org/wiki/faq/coding-standards#std-headers">What's
       the difference between &lt;xxx&gt; and &lt;xxx.h&gt; headers?</link>.
    </para>
 
-<para> Some include adjustment may be required. What follows is an
-autoconf test that defines <code>PRE_STDCXX_HEADERS</code> when they
-exist.</para>
-
-<programlisting>
-# AC_HEADER_PRE_STDCXX
-AC_DEFUN([AC_HEADER_PRE_STDCXX], [
-  AC_CACHE_CHECK(for pre-ISO C++ include files,
-  ac_cv_cxx_pre_stdcxx,
-  [AC_LANG_SAVE
-  AC_LANG_CPLUSPLUS
-  ac_save_CXXFLAGS="$CXXFLAGS"
-  CXXFLAGS="$CXXFLAGS -Wno-deprecated"
-
-  # Omit defalloc.h, as compilation with newer compilers is problematic.
-  AC_TRY_COMPILE([
-  #include &lt;new.h&gt;
-  #include &lt;iterator.h&gt;
-  #include &lt;alloc.h&gt;
-  #include &lt;set.h&gt;
-  #include &lt;hashtable.h&gt;
-  #include &lt;hash_set.h&gt;
-  #include &lt;fstream.h&gt;
-  #include &lt;tempbuf.h&gt;
-  #include &lt;istream.h&gt;
-  #include &lt;bvector.h&gt;
-  #include &lt;stack.h&gt;
-  #include &lt;rope.h&gt;
-  #include &lt;complex.h&gt;
-  #include &lt;ostream.h&gt;
-  #include &lt;heap.h&gt;
-  #include &lt;iostream.h&gt;
-  #include &lt;function.h&gt;
-  #include &lt;multimap.h&gt;
-  #include &lt;pair.h&gt;
-  #include &lt;stream.h&gt;
-  #include &lt;iomanip.h&gt;
-  #include &lt;slist.h&gt;
-  #include &lt;tree.h&gt;
-  #include &lt;vector.h&gt;
-  #include &lt;deque.h&gt;
-  #include &lt;multiset.h&gt;
-  #include &lt;list.h&gt;
-  #include &lt;map.h&gt;
-  #include &lt;algobase.h&gt;
-  #include &lt;hash_map.h&gt;
-  #include &lt;algo.h&gt;
-  #include &lt;queue.h&gt;
-  #include &lt;streambuf.h&gt;
-  ],,
-  ac_cv_cxx_pre_stdcxx=yes, ac_cv_cxx_pre_stdcxx=no)
-  CXXFLAGS="$ac_save_CXXFLAGS"
-  AC_LANG_RESTORE
-  ])
-  if test "$ac_cv_cxx_pre_stdcxx" = yes; then
-    AC_DEFINE(PRE_STDCXX_HEADERS,,[Define if pre-ISO C++ header files are present. ])
-  fi
-])
-</programlisting>
-
 <para>Porting between pre-ISO headers and ISO headers is simple: headers
 like <filename class="headerfile">&lt;vector.h&gt;</filename> can be replaced with <filename class="headerfile">&lt;vector&gt;</filename> and a using
 directive <code>using namespace std;</code> can be put at the global
diff --git a/libstdc++-v3/doc/xml/manual/io.xml b/libstdc++-v3/doc/xml/manual/io.xml
index 36d04ff..0c069b3 100644
--- a/libstdc++-v3/doc/xml/manual/io.xml
+++ b/libstdc++-v3/doc/xml/manual/io.xml
@@ -240,9 +240,10 @@
     }
    </programlisting>
    <para>Try it yourself!  More examples can be found in 3.1.x code, in
-      <filename>include/ext/*_filebuf.h</filename>, and in this article by James Kanze:
-      <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://kanze.james.neuf.fr/articles/fltrsbf1.html">Filtering
-      Streambufs</link>.
+      <filename>include/ext/*_filebuf.h</filename>, and in the article
+      <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://gabisoft.free.fr/articles/fltrsbf1.html">Filtering
+      Streambufs</link>
+      by James Kanze.
    </para>
 
   </section>
diff --git a/libstdc++-v3/doc/xml/manual/using.xml b/libstdc++-v3/doc/xml/manual/using.xml
index 1970845..3057a93 100644
--- a/libstdc++-v3/doc/xml/manual/using.xml
+++ b/libstdc++-v3/doc/xml/manual/using.xml
@@ -1625,7 +1625,7 @@ gcc version 4.1.2 20070925 (Red Hat 4.1.2-33)
 
       <para>For further details of the C++11 memory model see Hans-J. Boehm's
       <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://www.hboehm.info/c++mm/">Threads
-      and memory model for C++</link> pages, particularly the <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.hpl.hp.com/personal/Hans_Boehm/c++mm/threadsintro.html">introduction</link> 
+      and memory model for C++</link> pages, particularly the <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="http://www.hboehm.info/c++mm/threadsintro.html">introduction</link> 
       and <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="https://www.hboehm.info/c++mm/user-faq.html">FAQ</link>.
       </para>