diff mbox

[doc,libstdc++] Link maintenance for the libstdc++ manual

Message ID alpine.LNX.2.00.1211020121180.2266@tuna.site
State New
Headers show

Commit Message

Gerald Pfeifer Nov. 2, 2012, 12:29 a.m. UTC
So that the libstdc++ guys cannot complain I am only spending time
on Java. ;-)

There is a _lot_ left to do, especially around the imported lwg
pages; those are in a vary bade state.  Any volunteer for that
one?

Applied.

Gerald

2012-11-02  Gerald Pfeifer  <gerald@pfeifer.com>

	* doc/xml/manual/codecvt.xml: Fix reference to Austin Common
	Standards Revision Group.
	* doc/xml/manual/messages.xml: Ditto.
	* doc/xml/manual/using_exceptions.xml: Ditto.

	* doc/xml/manual/messages.xml: Fix reference to GNU gettext.

	* doc/xml/manual/policy_data_structures.xml: Fix reference to
	STL at SGI.
	Update reference to COM at Microsoft.
	Update reference to Worst-case efficient priority queues at ACM.

Comments

Jonathan Wakely Nov. 2, 2012, 12:34 a.m. UTC | #1
On 2 November 2012 00:29, Gerald Pfeifer wrote:
>
> There is a _lot_ left to do, especially around the imported lwg
> pages; those are in a vary bade state.  Any volunteer for that
> one?

They're imported, do we really want to tweak them? And then tweak them
again next time we import them?

If the problem is just missing trailing slashes at the end of URLs it
makes more sense to ask for them to be adjusted upstream, so I've CC'd
Daniel.
Gerald Pfeifer Nov. 2, 2012, 1:01 a.m. UTC | #2
On Fri, 2 Nov 2012, Jonathan Wakely wrote:
>> There is a _lot_ left to do, especially around the imported lwg
>> pages; those are in a vary bade state.  Any volunteer for that
>> one?
> They're imported, do we really want to tweak them? And then tweak them
> again next time we import them?
> 
> If the problem is just missing trailing slashes at the end of URLs it
> makes more sense to ask for them to be adjusted upstream, so I've CC'd
> Daniel.

The problem is actually quite a bit more severe than trailing slashes
(which usually only cause an extra redirect).  There are lots of real
problems, such as the ones below.

If those could be addressed upstream, and then new upstream imported
into libstdc++, that would be awesome.  I'd be happy to provide an
updated list at that point, and after a second iteration, we should
be good.

http://gcc.gnu.org/onlinedocs/libstdc++/ext/lwg-defects.html

 - http://aspn.activestate.com/ASPN/Mail/Message/boost/1395763
   broken link
 - http://www.decadentplace.org.uk/pipermail/cpp-threads/2006-August/001091.html
   different server
 - http://www.dictionary.net/epoch now http://definitions.dictionary.net/epoch

http://gcc.gnu.org/onlinedocs/libstdc++/ext/lwg-closed.html

 - file:///Users/hinnant/std%20documents/C++Mailings/papers/2009/n2997.htm
    broken link
 - http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2009/n2992.html
   http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2009/n2996.html
   http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2009/n2997.html
   all broken links

http://gcc.gnu.org/onlinedocs/libstdc++/ext/lwg-defects.html

  - http://home.twcny.rr.com/hinnant/cpp_extensions/unique_ptr.html
    http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2008/n2661.html
    http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2008/n2783.html
    http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2009/n2984.html
    http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2009/n2994.html
    http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2009/n3025.html
    http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2010/n3188.html
    http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2010/n3189.html
    http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2010/n3191.html
    http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2010/n3192.html
    http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2010/n3193.html
    http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2010/n3194.html
    http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2010/n3195.html
    http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2010/n3197.html
    http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2010/n3198.html
    http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2010/n3209.html
    http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2010/n3210.html
    http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2010/n3215.html
    https://svn.boost.org/trac/boost/browser/trunk/libs/bind/test/ref_fn_test.cpp
    all broken links

http://gcc.gnu.org/onlinedocs/libstdc++/ext/pb_ds/acks.html
 - http://starship.python.net/crew/aaron_watters/kjbuckets/
   broken links

http://gcc.gnu.org/onlinedocs/libstdc++/ext/pb_ds/references.html
 - http://anubis.dkuug.dk/jtc1/sc22/wg21/docs/papers/1997/N1075.pdf
   http://anubis.dkuug.dk/jtc1/sc22/wg21/docs/papers/2001/n1326l.html
   http://myweb.wvnet.edu/~gsa00121/books/amongdead30.zip
   http://www.dinkumware.com/htm_cpl/index.html
   http://www.scit.wlv.ac.uk/cgi-bin/mansec?3C+select
   all broken links

Gerald
Jonathan Wakely Nov. 4, 2012, 5:06 p.m. UTC | #3
On 2 November 2012 01:01, Gerald Pfeifer wrote:
> On Fri, 2 Nov 2012, Jonathan Wakely wrote:
>>> There is a _lot_ left to do, especially around the imported lwg
>>> pages; those are in a vary bade state.  Any volunteer for that
>>> one?
>> They're imported, do we really want to tweak them? And then tweak them
>> again next time we import them?
>>
>> If the problem is just missing trailing slashes at the end of URLs it
>> makes more sense to ask for them to be adjusted upstream, so I've CC'd
>> Daniel.
>
> The problem is actually quite a bit more severe than trailing slashes
> (which usually only cause an extra redirect).  There are lots of real
> problems, such as the ones below.
>
> If those could be addressed upstream, and then new upstream imported
> into libstdc++, that would be awesome.  I'd be happy to provide an
> updated list at that point, and after a second iteration, we should
> be good.
>
> http://gcc.gnu.org/onlinedocs/libstdc++/ext/lwg-defects.html
>
>  - http://aspn.activestate.com/ASPN/Mail/Message/boost/1395763
>    broken link

https://github.com/cplusplus/LWG/pull/3

>  - http://www.decadentplace.org.uk/pipermail/cpp-threads/2006-August/001091.html
>    different server

This already seems to be fixed upstream

>  - http://www.dictionary.net/epoch now http://definitions.dictionary.net/epoch

https://github.com/cplusplus/LWG/pull/4

> http://gcc.gnu.org/onlinedocs/libstdc++/ext/lwg-closed.html
>
>  - file:///Users/hinnant/std%20documents/C++Mailings/papers/2009/n2997.htm
>     broken link

Already fixed upstream

>  - http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2009/n2992.html

https://github.com/cplusplus/LWG/pull/5

>    http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2009/n2996.html

Fixed upstream

>    http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2009/n2997.html

Fixed upstream

>    all broken links
>
> http://gcc.gnu.org/onlinedocs/libstdc++/ext/lwg-defects.html
>
>   - http://home.twcny.rr.com/hinnant/cpp_extensions/unique_ptr.html
>     http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2008/n2661.html
>     http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2008/n2783.html
>     http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2009/n2984.html
>     http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2009/n2994.html
>     http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2009/n3025.html
>     http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2010/n3188.html
>     http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2010/n3189.html
>     http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2010/n3191.html
>     http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2010/n3192.html
>     http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2010/n3193.html
>     http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2010/n3194.html
>     http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2010/n3195.html
>     http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2010/n3197.html
>     http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2010/n3198.html
>     http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2010/n3209.html
>     http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2010/n3210.html
>     http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2010/n3215.html

All fixed upstream

>     https://svn.boost.org/trac/boost/browser/trunk/libs/bind/test/ref_fn_test.cpp
>     all broken links

https://github.com/cplusplus/LWG/pull/6

> http://gcc.gnu.org/onlinedocs/libstdc++/ext/pb_ds/acks.html
>  - http://starship.python.net/crew/aaron_watters/kjbuckets/
>    broken links
>
> http://gcc.gnu.org/onlinedocs/libstdc++/ext/pb_ds/references.html
>  - http://anubis.dkuug.dk/jtc1/sc22/wg21/docs/papers/1997/N1075.pdf
>    http://anubis.dkuug.dk/jtc1/sc22/wg21/docs/papers/2001/n1326l.html
>    http://myweb.wvnet.edu/~gsa00121/books/amongdead30.zip
>    http://www.dinkumware.com/htm_cpl/index.html
>    http://www.scit.wlv.ac.uk/cgi-bin/mansec?3C+select
>    all broken links

These are just in the libstdc++ docs and can be fixed locally.
Gerald Pfeifer Nov. 4, 2012, 8:36 p.m. UTC | #4
On Sun, 4 Nov 2012, Jonathan Wakely wrote:
>> http://gcc.gnu.org/onlinedocs/libstdc++/ext/pb_ds/acks.html
>>  - http://starship.python.net/crew/aaron_watters/kjbuckets/
>>    broken links
>>
>> http://gcc.gnu.org/onlinedocs/libstdc++/ext/pb_ds/references.html
>>  - http://anubis.dkuug.dk/jtc1/sc22/wg21/docs/papers/1997/N1075.pdf
>>    http://anubis.dkuug.dk/jtc1/sc22/wg21/docs/papers/2001/n1326l.html
>>    http://myweb.wvnet.edu/~gsa00121/books/amongdead30.zip
>>    http://www.dinkumware.com/htm_cpl/index.html
>>    http://www.scit.wlv.ac.uk/cgi-bin/mansec?3C+select
>>    all broken links
> These are just in the libstdc++ docs and can be fixed locally.

I looked into this a bit, and could not find the string "kjbuckets"
anywhere under libstdc++?

Anyone has the new locations of the two anubis.dkuug.dk links?

For amongdead30.zip, I failed to find a new link.  I looked for
the title "Thirty Year Among the Dead" and found some PDFs, alas
all behind some dubious download servers.

I also failed to find the dinkumware.com link under libstdc++/,
where does this come from?

The last one, appears in the bibliography, but does not seem to
be referenced from libstdc++/doc?  Not sure about the use case,
but could 
https://www.kernel.org/doc/man-pages/online/pages/man2/select_tut.2.html
by a replacement?

Gerald
Gabriel Dos Reis Nov. 4, 2012, 11:53 p.m. UTC | #5
On Sun, Nov 4, 2012 at 2:36 PM, Gerald Pfeifer <gerald@pfeifer.com> wrote:
> On Sun, 4 Nov 2012, Jonathan Wakely wrote:
>>> http://gcc.gnu.org/onlinedocs/libstdc++/ext/pb_ds/acks.html
>>>  - http://starship.python.net/crew/aaron_watters/kjbuckets/
>>>    broken links
>>>
>>> http://gcc.gnu.org/onlinedocs/libstdc++/ext/pb_ds/references.html
>>>  - http://anubis.dkuug.dk/jtc1/sc22/wg21/docs/papers/1997/N1075.pdf
>>>    http://anubis.dkuug.dk/jtc1/sc22/wg21/docs/papers/2001/n1326l.html
>>>    http://myweb.wvnet.edu/~gsa00121/books/amongdead30.zip
>>>    http://www.dinkumware.com/htm_cpl/index.html
>>>    http://www.scit.wlv.ac.uk/cgi-bin/mansec?3C+select
>>>    all broken links
>> These are just in the libstdc++ docs and can be fixed locally.
>
> I looked into this a bit, and could not find the string "kjbuckets"
> anywhere under libstdc++?
>
> Anyone has the new locations of the two anubis.dkuug.dk links?

http://www.open-std.org/jtc1/sc22/wg21/docs/papers/1997/N1075.pdf
http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2001/n1326.html


Thanks,

-- Gaby
Jonathan Wakely Nov. 5, 2012, 12:33 a.m. UTC | #6
On 4 November 2012 20:36, Gerald Pfeifer <gerald@pfeifer.com> wrote:
> On Sun, 4 Nov 2012, Jonathan Wakely wrote:
>>> http://gcc.gnu.org/onlinedocs/libstdc++/ext/pb_ds/acks.html
>>>  - http://starship.python.net/crew/aaron_watters/kjbuckets/
>>>    broken links
>>>
>>> http://gcc.gnu.org/onlinedocs/libstdc++/ext/pb_ds/references.html
>>>  - http://anubis.dkuug.dk/jtc1/sc22/wg21/docs/papers/1997/N1075.pdf
>>>    http://anubis.dkuug.dk/jtc1/sc22/wg21/docs/papers/2001/n1326l.html
>>>    http://myweb.wvnet.edu/~gsa00121/books/amongdead30.zip
>>>    http://www.dinkumware.com/htm_cpl/index.html
>>>    http://www.scit.wlv.ac.uk/cgi-bin/mansec?3C+select
>>>    all broken links
>> These are just in the libstdc++ docs and can be fixed locally.
>
> I looked into this a bit, and could not find the string "kjbuckets"
> anywhere under libstdc++?
>
> Anyone has the new locations of the two anubis.dkuug.dk links?
>
> For amongdead30.zip, I failed to find a new link.  I looked for
> the title "Thirty Year Among the Dead" and found some PDFs, alas
> all behind some dubious download servers.
>
> I also failed to find the dinkumware.com link under libstdc++/,
> where does this come from?
>
> The last one, appears in the bibliography, but does not seem to
> be referenced from libstdc++/doc?  Not sure about the use case,
> but could
> https://www.kernel.org/doc/man-pages/online/pages/man2/select_tut.2.html
> by a replacement?

I'd use http://pubs.opengroup.org/onlinepubs/9699919799/functions/select.html

Are you sure the other links haven't already been fixed in the
libstdc++ sources?

The copies on the website are usually fairly out of date.
Jonathan Wakely Nov. 5, 2012, 12:48 a.m. UTC | #7
On 5 November 2012 00:33, Jonathan Wakely wrote:
>
> Are you sure the other links haven't already been fixed in the
> libstdc++ sources?
>
> The copies on the website are usually fairly out of date.

Yes, looking at doc/xml/manual/policy_data_structures.xml it seems
that the dinkumware reference isn't in the source.
diff mbox

Patch

Index: doc/xml/manual/using_exceptions.xml
===================================================================
--- doc/xml/manual/using_exceptions.xml	(revision 193072)
+++ doc/xml/manual/using_exceptions.xml	(working copy)
@@ -440,7 +440,7 @@ 
   <biblioentry>
       <title>
 	<link xmlns:xlink="http://www.w3.org/1999/xlink"
-	      xlink:href="http://www.opengroup.org/austin">
+	      xlink:href="http://www.opengroup.org/austin/">
 	System Interface Definitions, Issue 7 (IEEE Std. 1003.1-2008)
 	</link>
       </title>
Index: doc/xml/manual/policy_data_structures.xml
===================================================================
--- doc/xml/manual/policy_data_structures.xml	(revision 193072)
+++ doc/xml/manual/policy_data_structures.xml	(working copy)
@@ -5401,7 +5401,7 @@ 
     <biblioentry xml:id="biblio.brodal96priority">
       <title>
 	<link xmlns:xlink="http://www.w3.org/1999/xlink"
-	      xlink:href="http://portal.acm.org/citation.cfm?id=313883">
+	      xlink:href="https://dl.acm.org/citation.cfm?id=313883">
 	  Worst-case efficient priority queues
 	</link>
       </title>
@@ -6193,7 +6193,7 @@ 
     <biblioentry xml:id="biblio.mscom">
       <title>
 	<link xmlns:xlink="http://www.w3.org/1999/xlink"
-	      xlink:href="http://www.microsoft.com/com">
+	      xlink:href="https://www.microsoft.com/com/">
 	  COM: Component Model Object Technologies
 	</link>
       </title>
@@ -6337,7 +6337,7 @@ 
     <biblioentry xml:id="biblio.sgi_stl">
       <title>
 	<link xmlns:xlink="http://www.w3.org/1999/xlink"
-	      xlink:href="http://www.sgi.com/tech/stl">
+	      xlink:href="http://www.sgi.com/tech/stl/">
 	  Standard Template Library Programmer's Guide
 	</link>
       </title>
Index: doc/xml/manual/messages.xml
===================================================================
--- doc/xml/manual/messages.xml	(revision 193072)
+++ doc/xml/manual/messages.xml	(working copy)
@@ -492,7 +492,7 @@ 
   <biblioentry>
       <title>
 	<link xmlns:xlink="http://www.w3.org/1999/xlink"
-	      xlink:href="http://www.opengroup.org/austin">
+	      xlink:href="http://www.opengroup.org/austin/">
       System Interface Definitions, Issue 7 (IEEE Std. 1003.1-2008)
 	</link>
       </title>
@@ -559,7 +559,7 @@ 
   <biblioentry>
       <title>
 	<link xmlns:xlink="http://www.w3.org/1999/xlink"
-	      xlink:href="http://www.gnu.org/software/gettext">
+	      xlink:href="https://www.gnu.org/software/gettext/">
       GNU gettext tools, version 0.10.38, Native Language Support
       Library and Tools.
 	</link>
Index: doc/xml/manual/codecvt.xml
===================================================================
--- doc/xml/manual/codecvt.xml	(revision 193072)
+++ doc/xml/manual/codecvt.xml	(working copy)
@@ -588,7 +588,7 @@ 
   <biblioentry>
       <title>
 	<link xmlns:xlink="http://www.w3.org/1999/xlink"
-	      xlink:href="http://www.opengroup.org/austin">
+	      xlink:href="http://www.opengroup.org/austin/">
       System Interface Definitions, Issue 7 (IEEE Std. 1003.1-2008)
 	</link>
       </title>