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

2017-03-23 Thread Jonathan Wakely 

On 23/03/17 15:01 +, 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 
Date:   Thu Mar 23 15:00:06 2017 +

   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 @@
  
  

-Please refer to the Contributing section in our manual.
+Please refer to the Contributing
+section in our manual.
 
  





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

I'm committing this to trunk today.

commit 38850ccfa6dadea710556d5f408cef79c2ffd9ec
Author: Jonathan Wakely 
Date:   Thu Mar 23 15:00:06 2017 +

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 @@
   
   
 
-Please refer to the Contributing section in our manual.
+Please refer to the Contributing
+section in our manual.
  
   
 
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.
 
 Portability notes and known implementation limitations are as follows.
 
-Pre-ISO headers moved to backwards or removed
+Pre-ISO headers removed
 
 
  The pre-ISO C++ headers
   (iostream.h,
   defalloc.h etc.) are
-  available, unlike previous libstdc++ versions, but inclusion
-  generates a warning that you are using deprecated headers.
+  not supported.
 
 
-This compatibility layer is constructed by including the
-standard C++ headers, and injecting any items in
-std:: into the global namespace.
-   
-   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 http://www.w3.org/1999/xlink; xlink:href="http://www.parashift.com/c++-faq-lite/std-headers.html;>What's
+   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 http://www.w3.org/1999/xlink; xlink:href="https://isocpp.org/wiki/faq/coding-standards#std-headers;>What's
   the difference between xxx and xxx.h headers?.

 
- Some include adjustment may be required. What follows is an
-autoconf test that defines PRE_STDCXX_HEADERS when they
-exist.
-
-
-# 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 new.h
-  #include iterator.h
-  #include alloc.h
-  #include set.h
-  #include hashtable.h
-  #include hash_set.h
-  #include fstream.h
-  #include tempbuf.h
-  #include istream.h
-  #include bvector.h
-  #include stack.h
-  #include rope.h
-  #include complex.h
-  #include ostream.h
-  #include heap.h
-  #include iostream.h
-  #include function.h
-  #include multimap.h
-  #include pair.h
-  #include stream.h
-  #include iomanip.h
-  #include slist.h
-  #include tree.h
-  #include vector.h
-  #include deque.h
-  #include multiset.h
-  #include list.h
-  #include map.h
-  #include algobase.h
-  #include hash_map.h
-  #include algo.h
-  #include queue.h
-  #include streambuf.h
-  ],,
-  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
-

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

2017-03-23 Thread Jonathan Wakely 

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 
Date:   Thu Mar 23 15:00:06 2017 +

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 @@
   
   
 
-Please refer to the Contributing section in our manual.
+Please refer to the Contributing
+section in our manual.

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

2017-03-18 Thread 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  

* 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
- http://www.w3.org/1999/xlink; 
xlink:href="http://www.ansi.org;>ANSI.
- (And if you've already registered with them you can
- 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.)
+ http://www.w3.org/1999/xlink; 
xlink:href="https://www.ansi.org;>ANSI.
+ (And if you've already registered with them you can http://www.w3.org/1999/xlink;
+ 
xlink:href="https://webstore.ansi.org/RecordDetail.aspx?sku=ISO%2fIEC+14882%3a2014;>buy
+ the standard on-line.)

   
 
Index: doc/xml/faq.xml
===
--- doc/xml/faq.xml (revision 246258)
+++ doc/xml/faq.xml (working copy)
@@ -1177,25 +1177,7 @@
   
   
 
-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 http://www.w3.org/1999/xlink; 
xlink:href="http://www.ansi.org;>here.  (And if
-you've already registered with them, clicking this link will take
-you to directly to the place where you can
-http://www.w3.org/1999/xlink; 
xlink:href="http://webstore.ansi.org/RecordDetail.aspx?sku=ISO%2FIEC+14882:2003;>buy
 the standard on-line.
-
-
-Who is your country's member body?  Visit the
-http://www.w3.org/1999/xlink; 
xlink:href="http://www.iso.ch/;>ISO homepage and find out!
-
-
-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.

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

2017-02-15 Thread 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)

2017-02-09 Thread 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  

* 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
- http://www.w3.org/1999/xlink; 
xlink:href="http://www.ansi.org;>ANSI.
+ http://www.w3.org/1999/xlink; 
xlink:href="https://www.ansi.org;>ANSI.
  (And if you've already registered with them you can
- 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.)
+ 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.)

   

Index: doc/xml/faq.xml
===
--- doc/xml/faq.xml (revision 245299)
+++ doc/xml/faq.xml (working copy)
@@ -1170,36 +1170,6 @@
   
 
 
-
-  
-How do I get a copy of the ISO C++ Standard?
-
-  
-  
-
-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 http://www.w3.org/1999/xlink; 
xlink:href="http://www.ansi.org;>here.  (And if
-you've already registered with them, clicking this link will take
-you to directly to the place where you can
-http://www.w3.org/1999/xlink; 
xlink:href="http://webstore.ansi.org/RecordDetail.aspx?sku=ISO%2FIEC+14882:2003;>buy
 the standard on-line.
-
-
-Who is your country's member body?  Visit the
-http://www.w3.org/1999/xlink; 
xlink:href="http://www.iso.ch/;>ISO homepage and find out!
-
-
-The 2003 version of the standard (the 1998 version plus TC1) is
-available in print, ISBN 0-470-84674-7.
- 
-  
-
-

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

2017-02-05 Thread 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.

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

2017-02-05 Thread 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  

* 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 http://www.w3.org/1999/xlink; 
xlink:href="http://www.ansi.org;>here.  (And if
-you've already registered with them, clicking this link will take
-you to directly to the place where you can
-http://www.w3.org/1999/xlink; 
xlink:href="http://webstore.ansi.org/RecordDetail.aspx?sku=ISO%2FIEC+14882:2003;>buy
 the standard on-line.
+organization is ANSI.
 
 
 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
- http://www.w3.org/1999/xlink; 
xlink:href="http://www.ansi.org;>ANSI.
- (And if you've already registered with them you can
- 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.)
+ organization is ANSI.