From patchwork Sat Jun 14 20:22:07 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Wakely X-Patchwork-Id: 359791 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from sourceware.org (server1.sourceware.org [209.132.180.131]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id B6D5014009A for ; Sun, 15 Jun 2014 06:22:21 +1000 (EST) DomainKey-Signature: a=rsa-sha1; c=nofws; d=gcc.gnu.org; h=list-id :list-unsubscribe:list-archive:list-post:list-help:sender:date :from:to:subject:message-id:mime-version:content-type; q=dns; s= default; b=VkWv4WUTdpuVRIaj/q54GYiw02qpoi/ywnu6WqhvYx1L90U19EppS Qzvo5GIpj4cU6Dt+XjF25vvDxiXqmooYkofL7lvmJhqN0Bijq6AZNpB0Ux3+3xn6 K2VERvB3F0N2mCFOg2SpVKk1lgO8EaXCPWVx0kZlExvFztZszUuNwc= DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=gcc.gnu.org; h=list-id :list-unsubscribe:list-archive:list-post:list-help:sender:date :from:to:subject:message-id:mime-version:content-type; s= default; bh=BPn/osWJtbZAyCZoVvDnUnwJrZ0=; b=UwxwdkbNFHh/kpgqZ/57 wPBjzjB8uReHB+y7rMRSowDVYYu+esQmSSRkaHTXM9DTGh7eBqKmOhKK7y/pjbus lgTPhSirXwczUfC4+1IWg8rgrDviiVUUBTVlCDD/h/q/P/sd45oTnbO3vv16SA1w c5VjLve1RRz7yXmdSqzu4X0= Received: (qmail 12788 invoked by alias); 14 Jun 2014 20:22:14 -0000 Mailing-List: contact gcc-patches-help@gcc.gnu.org; run by ezmlm Precedence: bulk List-Id: List-Unsubscribe: List-Archive: List-Post: List-Help: Sender: gcc-patches-owner@gcc.gnu.org Delivered-To: mailing list gcc-patches@gcc.gnu.org Received: (qmail 12708 invoked by uid 89); 14 Jun 2014 20:22:13 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-2.4 required=5.0 tests=AWL, BAYES_00, RP_MATCHES_RCVD, SPF_HELO_PASS, SPF_PASS autolearn=ham version=3.3.2 X-Spam-User: qpsmtpd, 2 recipients X-HELO: mx1.redhat.com Received: from mx1.redhat.com (HELO mx1.redhat.com) (209.132.183.28) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Sat, 14 Jun 2014 20:22:10 +0000 Received: from int-mx10.intmail.prod.int.phx2.redhat.com (int-mx10.intmail.prod.int.phx2.redhat.com [10.5.11.23]) by mx1.redhat.com (8.14.4/8.14.4) with ESMTP id s5EKM9cv004777 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 14 Jun 2014 16:22:09 -0400 Received: from localhost (vpn1-7-243.ams2.redhat.com [10.36.7.243]) by int-mx10.intmail.prod.int.phx2.redhat.com (8.14.4/8.14.4) with ESMTP id s5EKM8MA014481; Sat, 14 Jun 2014 16:22:09 -0400 Date: Sat, 14 Jun 2014 21:22:07 +0100 From: Jonathan Wakely To: libstdc++@gcc.gnu.org, gcc-patches@gcc.gnu.org Subject: [patch] Fix links in libstdc++ doxygen comments Message-ID: <20140614202207.GJ30729@redhat.com> MIME-Version: 1.0 Content-Disposition: inline User-Agent: Mutt/1.5.23 (2014-03-12) Fix old, broken links from Doxygen comments to pages in the manual that have a different URL now. Unfortunately the URLs make some lines too long to fit in 80 chars, but I'm not sure what we can do about that. Any suggestions? Tested x86_64-linux, committed to trunk. commit 2a0f6d650951c63f1b56a6113a8a1c003f0b06c8 Author: Jonathan Wakely Date: Sat Jun 14 21:02:47 2014 +0100 * doc/xml/api.xml: Link to more recent API docs. * include/bits/allocator.h: Fix link in doxygen comment. * include/bits/char_traits.h: Likewise. * include/bits/ios_base.h: Likewise. * include/bits/stl_map.h: Likewise. * include/bits/stl_multimap.h: Likewise. * include/bits/stl_multiset.h: Likewise. * include/bits/stl_set.h: Likewise. * include/bits/unordered_map.h: Likewise. * include/bits/unordered_set.h: Likewise. * include/ext/mt_allocator.h: Likewise. * include/std/fstream: Likewise. * include/std/iosfwd: Likewise. * include/std/ostream: Likewise. * include/std/sstream: Likewise. * include/std/streambuf: Likewise. * doc/html/*: Regenerate. diff --git a/libstdc++-v3/doc/xml/api.xml b/libstdc++-v3/doc/xml/api.xml index 7c02dff..f9478c3 100644 --- a/libstdc++-v3/doc/xml/api.xml +++ b/libstdc++-v3/doc/xml/api.xml @@ -13,6 +13,9 @@ 2010 + + 2014 + FSF @@ -85,6 +88,24 @@ + for the 4.7.4 release + + + + + + for the 4.8.3 release + + + + + + for the 4.9.0 release + + + + + "the latest collection" (For the main development tree; see the date on the first page.) @@ -94,7 +115,7 @@ The rendered HTML, as above, is also available for download on the - gcc.org site in a directory located at + gcc.gnu.org site in a directory located at <URL:ftp://gcc.gnu.org/pub/gcc/libstdc++/doxygen/>. You will almost certainly need to use one of the mirror sites to download diff --git a/libstdc++-v3/include/bits/allocator.h b/libstdc++-v3/include/bits/allocator.h index 05a06ba..37248ab 100644 --- a/libstdc++-v3/include/bits/allocator.h +++ b/libstdc++-v3/include/bits/allocator.h @@ -83,7 +83,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION /** * @brief The @a standard allocator, as per [20.4]. * - * See http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt04ch11.html + * See https://gcc.gnu.org/onlinedocs/libstdc++/manual/memory.html#std.util.memory.allocator * for further details. * * @tparam _Tp Type of allocated object. diff --git a/libstdc++-v3/include/bits/char_traits.h b/libstdc++-v3/include/bits/char_traits.h index 8c3bf96..2b7cd3f 100644 --- a/libstdc++-v3/include/bits/char_traits.h +++ b/libstdc++-v3/include/bits/char_traits.h @@ -75,7 +75,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION * may not be specialized for fundamental types, but classes in * namespace __gnu_cxx may be. * - * See http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt05ch13s03.html + * See https://gcc.gnu.org/onlinedocs/libstdc++/manual/strings.html#strings.string.character_types * for advice on how to make use of this class for @a unusual character * types. Also, check out include/ext/pod_char_traits.h. */ @@ -219,7 +219,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION * __gnu_cxx::char_traits, it is possible to achieve a more * appropriate definition by specializing __gnu_cxx::char_traits. * - * See http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt05ch13s03.html + * See https://gcc.gnu.org/onlinedocs/libstdc++/manual/strings.html#strings.string.character_types * for advice on how to make use of this class for @a unusual character * types. Also, check out include/ext/pod_char_traits.h. */ diff --git a/libstdc++-v3/include/bits/ios_base.h b/libstdc++-v3/include/bits/ios_base.h index 59c5066..4aade68 100644 --- a/libstdc++-v3/include/bits/ios_base.h +++ b/libstdc++-v3/include/bits/ios_base.h @@ -368,7 +368,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION /// Perform input and output in binary mode (as opposed to text mode). /// This is probably not what you think it is; see - /// http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt11ch27s02.html + /// https://gcc.gnu.org/onlinedocs/libstdc++/manual/fstreams.html#std.io.filestreams.binary static const openmode binary = _S_bin; /// Open for input. Default for @c ifstream and fstream. @@ -666,7 +666,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION * The synchronization referred to is @e only that between the standard * C facilities (e.g., stdout) and the standard C++ objects (e.g., * cout). User-declared streams are unaffected. See - * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt11ch28s02.html + * https://gcc.gnu.org/onlinedocs/libstdc++/manual/fstreams.html#std.io.filestreams.binary */ static bool sync_with_stdio(bool __sync = true); diff --git a/libstdc++-v3/include/bits/stl_map.h b/libstdc++-v3/include/bits/stl_map.h index 334c54f..405d4b8 100644 --- a/libstdc++-v3/include/bits/stl_map.h +++ b/libstdc++-v3/include/bits/stl_map.h @@ -595,7 +595,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER * cause no gains in efficiency. * * See - * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt07ch17.html + * https://gcc.gnu.org/onlinedocs/libstdc++/manual/associative.html#containers.associative.insert_hints * for more on @a hinting. * * Insertion requires logarithmic time (if the hint is not taken). @@ -669,7 +669,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER * cause no gains in efficiency. * * See - * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt07ch17.html + * https://gcc.gnu.org/onlinedocs/libstdc++/manual/associative.html#containers.associative.insert_hints * for more on @a hinting. * * Insertion requires logarithmic time (if the hint is not taken). diff --git a/libstdc++-v3/include/bits/stl_multimap.h b/libstdc++-v3/include/bits/stl_multimap.h index c7b80c9..a73164e 100644 --- a/libstdc++-v3/include/bits/stl_multimap.h +++ b/libstdc++-v3/include/bits/stl_multimap.h @@ -508,7 +508,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER * cause no gains in efficiency. * * For more on @a hinting, see: - * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt07ch17.html + * https://gcc.gnu.org/onlinedocs/libstdc++/manual/associative.html#containers.associative.insert_hints * * Insertion requires logarithmic time (if the hint is not taken). */ @@ -562,7 +562,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER * cause no gains in efficiency. * * For more on @a hinting, see: - * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt07ch17.html + * https://gcc.gnu.org/onlinedocs/libstdc++/manual/associative.html#containers.associative.insert_hints * * Insertion requires logarithmic time (if the hint is not taken). */ diff --git a/libstdc++-v3/include/bits/stl_multiset.h b/libstdc++-v3/include/bits/stl_multiset.h index 6d71c1b..f379aef 100644 --- a/libstdc++-v3/include/bits/stl_multiset.h +++ b/libstdc++-v3/include/bits/stl_multiset.h @@ -463,7 +463,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER * improve the performance of the insertion process. A bad hint would * cause no gains in efficiency. * - * See http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt07ch17.html + * See https://gcc.gnu.org/onlinedocs/libstdc++/manual/associative.html#containers.associative.insert_hints * for more on @a hinting. * * Insertion requires logarithmic time (if the hint is not taken). @@ -513,7 +513,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER * improve the performance of the insertion process. A bad hint would * cause no gains in efficiency. * - * See http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt07ch17.html + * See https://gcc.gnu.org/onlinedocs/libstdc++/manual/associative.html#containers.associative.insert_hints * for more on @a hinting. * * Insertion requires logarithmic time (if the hint is not taken). diff --git a/libstdc++-v3/include/bits/stl_set.h b/libstdc++-v3/include/bits/stl_set.h index 3a39154..48dc761 100644 --- a/libstdc++-v3/include/bits/stl_set.h +++ b/libstdc++-v3/include/bits/stl_set.h @@ -469,7 +469,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER * hint would cause no gains in efficiency. * * For more on @a hinting, see: - * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt07ch17.html + * https://gcc.gnu.org/onlinedocs/libstdc++/manual/associative.html#containers.associative.insert_hints * * Insertion requires logarithmic time (if the hint is not taken). */ @@ -528,7 +528,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER * hint would cause no gains in efficiency. * * For more on @a hinting, see: - * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt07ch17.html + * https://gcc.gnu.org/onlinedocs/libstdc++/manual/associative.html#containers.associative.insert_hints * * Insertion requires logarithmic time (if the hint is not taken). */ diff --git a/libstdc++-v3/include/bits/unordered_map.h b/libstdc++-v3/include/bits/unordered_map.h index 914d26a..580aed9 100644 --- a/libstdc++-v3/include/bits/unordered_map.h +++ b/libstdc++-v3/include/bits/unordered_map.h @@ -360,7 +360,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER * cause no gains in efficiency. * * See - * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt07ch17.html + * https://gcc.gnu.org/onlinedocs/libstdc++/manual/associative.html#containers.associative.insert_hints * for more on @a hinting. * * Insertion requires amortized constant time. @@ -417,7 +417,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER * hint would cause no gains in efficiency. * * See - * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt07ch17.html + * https://gcc.gnu.org/onlinedocs/libstdc++/manual/associative.html#containers.associative.insert_hints * for more on @a hinting. * * Insertion requires amortized constant time. @@ -1064,7 +1064,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER * cause no gains in efficiency. * * See - * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt07ch17.html + * https://gcc.gnu.org/onlinedocs/libstdc++/manual/associative.html#containers.associative.insert_hints * for more on @a hinting. * * Insertion requires amortized constant time. @@ -1111,7 +1111,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER * cause no gains in efficiency. * * See - * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt07ch17.html + * https://gcc.gnu.org/onlinedocs/libstdc++/manual/associative.html#containers.associative.insert_hints * for more on @a hinting. * * Insertion requires amortized constant time. diff --git a/libstdc++-v3/include/bits/unordered_set.h b/libstdc++-v3/include/bits/unordered_set.h index e37bcda..3cf248d 100644 --- a/libstdc++-v3/include/bits/unordered_set.h +++ b/libstdc++-v3/include/bits/unordered_set.h @@ -346,7 +346,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER * hint would cause no gains in efficiency. * * For more on @a hinting, see: - * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt07ch17.html + * https://gcc.gnu.org/onlinedocs/libstdc++/manual/associative.html#containers.associative.insert_hints * * Insertion requires amortized constant time. */ @@ -394,7 +394,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER * hint would cause no gains in efficiency. * * For more on @a hinting, see: - * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt07ch17.html + * https://gcc.gnu.org/onlinedocs/libstdc++/manual/associative.html#containers.associative.insert_hints * * Insertion requires amortized constant. */ @@ -969,7 +969,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER * cause no gains in efficiency. * * For more on @a hinting, see: - * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt07ch17.html + * https://gcc.gnu.org/onlinedocs/libstdc++/manual/associative.html#containers.associative.insert_hints * * Insertion requires amortized constant time. */ @@ -1008,7 +1008,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER * cause no gains in efficiency. * * For more on @a hinting, see: - * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt07ch17.html + * https://gcc.gnu.org/onlinedocs/libstdc++/manual/associative.html#containers.associative.insert_hints * * Insertion requires amortized constant. */ diff --git a/libstdc++-v3/include/ext/mt_allocator.h b/libstdc++-v3/include/ext/mt_allocator.h index 0e6cfd9..856ef3b 100644 --- a/libstdc++-v3/include/ext/mt_allocator.h +++ b/libstdc++-v3/include/ext/mt_allocator.h @@ -632,7 +632,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION * @ingroup allocators * * Further details: - * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt12ch32.html + * https://gcc.gnu.org/onlinedocs/libstdc++/manual/mt_allocator.html */ template > diff --git a/libstdc++-v3/include/std/bitset b/libstdc++-v3/include/std/bitset index d9d4f4d..b89a283 100644 --- a/libstdc++-v3/include/std/bitset +++ b/libstdc++-v3/include/std/bitset @@ -732,7 +732,7 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER * @endcode * * Also see: - * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt12ch33s02.html + * https://gcc.gnu.org/onlinedocs/libstdc++/manual/ext_containers.html * for a description of extensions. * * Most of the actual code isn't contained in %bitset<> itself, but in the diff --git a/libstdc++-v3/include/std/fstream b/libstdc++-v3/include/std/fstream index 51db21b..4d802f1 100644 --- a/libstdc++-v3/include/std/fstream +++ b/libstdc++-v3/include/std/fstream @@ -358,7 +358,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION * If no file has been opened, and both @a __s and @a __n are zero, then * the stream becomes unbuffered. Otherwise, @c __s is used as a * buffer; see - * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt11ch25s02.html + * https://gcc.gnu.org/onlinedocs/libstdc++/manual/streambufs.html#io.streambuf.buffering * for more. */ virtual __streambuf_type* diff --git a/libstdc++-v3/include/std/iosfwd b/libstdc++-v3/include/std/iosfwd index 50dd949..ed8af5c 100644 --- a/libstdc++-v3/include/std/iosfwd +++ b/libstdc++-v3/include/std/iosfwd @@ -67,7 +67,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION * themselves (e.g., class ostream;) is not valid ISO C++. * * For more specific declarations, see - * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt11ch24.html + * https://gcc.gnu.org/onlinedocs/libstdc++/manual/io.html#std.io.objects * * @{ */ diff --git a/libstdc++-v3/include/std/ostream b/libstdc++-v3/include/std/ostream index 18a56ae..a25b3d0 100644 --- a/libstdc++-v3/include/std/ostream +++ b/libstdc++-v3/include/std/ostream @@ -556,7 +556,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION * * This manipulator is often mistakenly used when a simple newline is * desired, leading to poor buffering performance. See - * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt11ch25s02.html + * https://gcc.gnu.org/onlinedocs/libstdc++/manual/streambufs.html#io.streambuf.buffering * for more on this subject. */ template diff --git a/libstdc++-v3/include/std/sstream b/libstdc++-v3/include/std/sstream index 74ce16c..f97caba 100644 --- a/libstdc++-v3/include/std/sstream +++ b/libstdc++-v3/include/std/sstream @@ -195,7 +195,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION * * If no buffer has already been created, and both @a __s and @a __n are * non-zero, then @c __s is used as a buffer; see - * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt11ch25s02.html + * https://gcc.gnu.org/onlinedocs/libstdc++/manual/streambufs.html#io.streambuf.buffering * for more. */ virtual __streambuf_type* diff --git a/libstdc++-v3/include/std/streambuf b/libstdc++-v3/include/std/streambuf index 0cb609d..d3aa0ee 100644 --- a/libstdc++-v3/include/std/streambuf +++ b/libstdc++-v3/include/std/streambuf @@ -582,7 +582,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION * * Each derived class provides its own appropriate behavior. See * the next-to-last paragraph of - * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt11ch25s02.html + * https://gcc.gnu.org/onlinedocs/libstdc++/manual/streambufs.html#io.streambuf.buffering * for more on this function. * * @note Base class version does nothing, returns @c this. @@ -679,7 +679,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION * * A functioning input streambuf can be created by overriding only * this function (no buffer area will be used). For an example, see - * http://gcc.gnu.org/onlinedocs/libstdc++/manual/bk01pt11ch25.html + * https://gcc.gnu.org/onlinedocs/libstdc++/manual/streambufs.html * * @note Base class version does nothing, returns eof(). */