Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/2218779/?format=api
{ "id": 2218779, "url": "http://patchwork.ozlabs.org/api/patches/2218779/?format=api", "web_url": "http://patchwork.ozlabs.org/project/gcc/patch/20260401215920.674286-4-jwakely@redhat.com/", "project": { "id": 17, "url": "http://patchwork.ozlabs.org/api/projects/17/?format=api", "name": "GNU Compiler Collection", "link_name": "gcc", "list_id": "gcc-patches.gcc.gnu.org", "list_email": "gcc-patches@gcc.gnu.org", "web_url": null, "scm_url": null, "webscm_url": null, "list_archive_url": "", "list_archive_url_format": "", "commit_url_format": "" }, "msgid": "<20260401215920.674286-4-jwakely@redhat.com>", "list_archive_url": null, "date": "2026-04-01T20:42:04", "name": "[04/10] libstdc++: Remove Doxygen @return on void functions", "commit_ref": null, "pull_url": null, "state": "new", "archived": false, "hash": "857b730a4ef0e59ff2bf816a33460bc276135a73", "submitter": { "id": 48004, "url": "http://patchwork.ozlabs.org/api/people/48004/?format=api", "name": "Jonathan Wakely", "email": "jwakely@redhat.com" }, "delegate": null, "mbox": "http://patchwork.ozlabs.org/project/gcc/patch/20260401215920.674286-4-jwakely@redhat.com/mbox/", "series": [ { "id": 498401, "url": "http://patchwork.ozlabs.org/api/series/498401/?format=api", "web_url": "http://patchwork.ozlabs.org/project/gcc/list/?series=498401", "date": "2026-04-01T20:42:04", "name": "[01/10] libstdc++: Tweak Doxygen config file to include C++26 components", "version": 1, "mbox": "http://patchwork.ozlabs.org/series/498401/mbox/" } ], "comments": "http://patchwork.ozlabs.org/api/patches/2218779/comments/", "check": "pending", "checks": "http://patchwork.ozlabs.org/api/patches/2218779/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<gcc-patches-bounces~incoming=patchwork.ozlabs.org@gcc.gnu.org>", "X-Original-To": [ "incoming@patchwork.ozlabs.org", "gcc-patches@gcc.gnu.org" ], "Delivered-To": [ "patchwork-incoming@legolas.ozlabs.org", "gcc-patches@gcc.gnu.org" ], "Authentication-Results": [ "legolas.ozlabs.org;\n\tdkim=pass (1024-bit key;\n unprotected) header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256\n header.s=mimecast20190719 header.b=Fc5UMXSM;\n\tdkim-atps=neutral", "legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=gcc.gnu.org\n (client-ip=2620:52:6:3111::32; helo=vm01.sourceware.org;\n envelope-from=gcc-patches-bounces~incoming=patchwork.ozlabs.org@gcc.gnu.org;\n receiver=patchwork.ozlabs.org)", "sourceware.org; dmarc=pass (p=quarantine dis=none)\n header.from=redhat.com", "sourceware.org; spf=pass smtp.mailfrom=redhat.com", "server2.sourceware.org;\n arc=none smtp.remote-ip=170.10.133.124" ], "Received": [ "from vm01.sourceware.org (vm01.sourceware.org\n [IPv6:2620:52:6:3111::32])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange x25519 server-signature ECDSA (secp384r1) server-digest SHA384)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4fmJnb5kgdz1yCs\n\tfor <incoming@patchwork.ozlabs.org>; Thu, 02 Apr 2026 09:00:19 +1100 (AEDT)", "from vm01.sourceware.org (localhost [127.0.0.1])\n\tby sourceware.org (Postfix) with ESMTP id DF2C74BB58C6\n\tfor <incoming@patchwork.ozlabs.org>; Wed, 1 Apr 2026 22:00:15 +0000 (GMT)", "from us-smtp-delivery-124.mimecast.com\n (us-smtp-delivery-124.mimecast.com [170.10.133.124])\n by sourceware.org (Postfix) with ESMTP id 3802F4BA2E32\n for <gcc-patches@gcc.gnu.org>; Wed, 1 Apr 2026 21:59:35 +0000 (GMT)", "from mx-prod-mc-05.mail-002.prod.us-west-2.aws.redhat.com\n (ec2-54-186-198-63.us-west-2.compute.amazonaws.com [54.186.198.63]) by\n relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3,\n cipher=TLS_AES_256_GCM_SHA384) id us-mta-634-EC0hmlaTMmitui3x2cfnCA-1; Wed,\n 01 Apr 2026 17:59:28 -0400", "from mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com\n (mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.12])\n (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest\n SHA256)\n (No client certificate requested)\n by mx-prod-mc-05.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS\n id 055231956094; Wed, 1 Apr 2026 21:59:28 +0000 (UTC)", "from zen.kayari.org (unknown [10.44.48.64])\n by mx-prod-int-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP\n id 090541955F25; Wed, 1 Apr 2026 21:59:26 +0000 (UTC)" ], "DMARC-Filter": "OpenDMARC Filter v1.4.2 sourceware.org 3802F4BA2E32", "ARC-Filter": "OpenARC Filter v1.0.0 sourceware.org 3802F4BA2E32", "ARC-Seal": "i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1775080775; cv=none;\n b=Oz6jul4rIxPAxIrdIYW3P6ecPmRY/O5OYiwToBqMhD/8ieLJGVn0oWyaqYWQcsehbeSbAA/rLwuffTmBQ4zcEw/fyWMWMTr0LgV4bnrPbpRvp/XIQciPLsg3+t/n7bFpvNVYMZufe/YeNOsLFS1IbOcxW3PwPti/UgSve9ecKZY=", "ARC-Message-Signature": "i=1; a=rsa-sha256; d=sourceware.org; s=key;\n t=1775080775; c=relaxed/simple;\n bh=ZerKpD9zmbP611eK0W8rAY1FBkYm+n31p/5Oi0wptIA=;\n h=DKIM-Signature:From:To:Subject:Date:Message-ID:MIME-Version;\n b=UpKqliVQvbKu1ONH97Fr0EhNvvmeABXPNKMKWQAImx+z9hRr9PeTW1Wk6iXl6apPZrhUMNHCpvay4u13DFBerY8XpAuXyvf++jG5tR48mhUVJazHwcQSB0yhrJtRIJsIHkSoflyDq+aRC/srX+A4WYvLxvSiNuJpJge+RFvzWTA=", "ARC-Authentication-Results": "i=1; server2.sourceware.org", "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com;\n s=mimecast20190719; t=1775080770;\n h=from:from:reply-to:subject:subject:date:date:message-id:message-id:\n to:to:cc:mime-version:mime-version:content-type:content-type:\n content-transfer-encoding:content-transfer-encoding:\n in-reply-to:in-reply-to:references:references;\n bh=e3CLq+qIrndo6LXy4dRS1mBG+ZPmkl+/aDlxCh/+YLc=;\n b=Fc5UMXSMc7DzK3hB74ZOzbLzR4BddWyi19ooT+b670kOsJDC8U4AwVZlNHKdMTCTJzRzvH\n JLvno1g0bXrOoy5P2wBFbuXohyMKozpAAnnB7Zw1pLcFmfnVYHRDQAL8EGl/yHnfDK7qzq\n z2tVnAIeNgjTUhIq+l8OKlbq+Rqt7AY=", "X-MC-Unique": "EC0hmlaTMmitui3x2cfnCA-1", "X-Mimecast-MFC-AGG-ID": "EC0hmlaTMmitui3x2cfnCA_1775080768", "From": "Jonathan Wakely <jwakely@redhat.com>", "To": "gcc-patches@gcc.gnu.org,\n\tlibstdc++@gcc.gnu.org", "Subject": "[PATCH 04/10] libstdc++: Remove Doxygen @return on void functions", "Date": "Wed, 1 Apr 2026 21:42:04 +0100", "Message-ID": "<20260401215920.674286-4-jwakely@redhat.com>", "In-Reply-To": "<20260401215920.674286-1-jwakely@redhat.com>", "References": "<20260401215920.674286-1-jwakely@redhat.com>", "MIME-Version": "1.0", "X-Scanned-By": "MIMEDefang 3.0 on 10.30.177.12", "X-Mimecast-Spam-Score": "0", "X-Mimecast-MFC-PROC-ID": "II2Yj-4-_SZgjvmM1ThAneWEnKs7f7rku1j9XwgM7eA_1775080768", "X-Mimecast-Originator": "redhat.com", "Content-Type": "text/plain", "Content-Transfer-Encoding": "8bit", "X-BeenThere": "gcc-patches@gcc.gnu.org", "X-Mailman-Version": "2.1.30", "Precedence": "list", "List-Id": "Gcc-patches mailing list <gcc-patches.gcc.gnu.org>", "List-Unsubscribe": "<https://gcc.gnu.org/mailman/options/gcc-patches>,\n <mailto:gcc-patches-request@gcc.gnu.org?subject=unsubscribe>", "List-Archive": "<https://gcc.gnu.org/pipermail/gcc-patches/>", "List-Post": "<mailto:gcc-patches@gcc.gnu.org>", "List-Help": "<mailto:gcc-patches-request@gcc.gnu.org?subject=help>", "List-Subscribe": "<https://gcc.gnu.org/mailman/listinfo/gcc-patches>,\n <mailto:gcc-patches-request@gcc.gnu.org?subject=subscribe>", "Errors-To": "gcc-patches-bounces~incoming=patchwork.ozlabs.org@gcc.gnu.org" }, "content": "With the latest version of Doxygen this gives a warning about using\n@return on a function that returns void. Stating it explicitly adds very\nlittle value, anybody can see from the signature that a function returns\nvoid.\n\nlibstdc++-v3/ChangeLog:\n\n\t* include/bits/move.h (swap): Remove @return from Doxygen\n\tcomment.\n\t* include/bits/stl_algo.h (inplace_merge, shuffle)\n\t(random_shuffle, partial_sort, nth_element, sort)\n\t(stable_sort): Likewise.\n\t* include/bits/stl_algobase.h (iter_swap, fill): Likewise.\n\t* include/bits/stl_deque.h (_Deque_base::_M_initialize_map)\n\t(deque::_M_range_initialize, deque::_M_fill_initialize):\n\tLikewise.\n\t* include/bits/stl_iterator_base_funcs.h (advance): Likewise.\n\t* include/bits/stl_numeric.h (iota): Likewise.\n\t* include/bits/stl_tempbuf.h (return_temporary_buffer):\n\tLikewise.\n\t* include/bits/stl_uninitialized.h (uninitialized_fill):\n\tLikewise.\n---\n\nTested x86_64-linux, docs built with Doxygen 1.13.2 and 1.17.0 (from git)\n\n libstdc++-v3/include/bits/move.h | 1 -\n libstdc++-v3/include/bits/stl_algo.h | 13 -------------\n libstdc++-v3/include/bits/stl_algobase.h | 2 --\n libstdc++-v3/include/bits/stl_deque.h | 3 ---\n libstdc++-v3/include/bits/stl_iterator_base_funcs.h | 1 -\n libstdc++-v3/include/bits/stl_numeric.h | 1 -\n libstdc++-v3/include/bits/stl_tempbuf.h | 1 -\n libstdc++-v3/include/bits/stl_uninitialized.h | 1 -\n 8 files changed, 23 deletions(-)", "diff": "diff --git a/libstdc++-v3/include/bits/move.h b/libstdc++-v3/include/bits/move.h\nindex 34962455129e..1a03db661123 100644\n--- a/libstdc++-v3/include/bits/move.h\n+++ b/libstdc++-v3/include/bits/move.h\n@@ -212,7 +212,6 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION\n * @brief Swaps two values.\n * @param __a A thing of arbitrary type.\n * @param __b Another thing of arbitrary type.\n- * @return Nothing.\n */\n template<typename _Tp>\n #if __glibcxx_concepts // >= C++20\ndiff --git a/libstdc++-v3/include/bits/stl_algo.h b/libstdc++-v3/include/bits/stl_algo.h\nindex aa62bff8a469..adf9b9e0f280 100644\n--- a/libstdc++-v3/include/bits/stl_algo.h\n+++ b/libstdc++-v3/include/bits/stl_algo.h\n@@ -2531,7 +2531,6 @@ _GLIBCXX_END_INLINE_ABI_NAMESPACE(_V2)\n * @param __first An iterator.\n * @param __middle Another iterator.\n * @param __last Another iterator.\n- * @return Nothing.\n *\n * Merges two sorted and consecutive ranges, [__first,__middle) and\n * [__middle,__last), and puts the result in [__first,__last). The\n@@ -2570,7 +2569,6 @@ _GLIBCXX_END_INLINE_ABI_NAMESPACE(_V2)\n * @param __middle Another iterator.\n * @param __last Another iterator.\n * @param __comp A functor to use for comparisons.\n- * @return Nothing.\n *\n * Merges two sorted and consecutive ranges, [__first,__middle) and\n * [middle,last), and puts the result in [__first,__last). The output will\n@@ -3678,7 +3676,6 @@ _GLIBCXX_END_INLINE_ABI_NAMESPACE(_V2)\n * @param __first A forward iterator.\n * @param __last A forward iterator.\n * @param __g A UniformRandomNumberGenerator (26.5.1.3).\n- * @return Nothing.\n *\n * Reorders the elements in the range @p [__first,__last) using @p __g to\n * provide random numbers.\n@@ -4499,7 +4496,6 @@ _GLIBCXX_BEGIN_NAMESPACE_ALGO\n * @ingroup mutating_algorithms\n * @param __first A forward iterator.\n * @param __last A forward iterator.\n- * @return Nothing.\n *\n * Reorder the elements in the range `[__first, __last)` using a random\n * distribution, so that every possible ordering of the sequence is\n@@ -4565,7 +4561,6 @@ _GLIBCXX_BEGIN_NAMESPACE_ALGO\n * @param __first A forward iterator.\n * @param __last A forward iterator.\n * @param __rand The RNG functor or function.\n- * @return Nothing.\n *\n * Reorders the elements in the range `[__first, __last)` using `__rand`\n * to provide a random distribution. Calling `__rand(N)` for a positive\n@@ -4647,7 +4642,6 @@ _GLIBCXX_BEGIN_NAMESPACE_ALGO\n * @param __first An iterator.\n * @param __middle Another iterator.\n * @param __last Another iterator.\n- * @return Nothing.\n *\n * Sorts the smallest `(__middle - __first)` elements in the range\n * `[first, last)` and moves them to the range `[__first, __middle)`. The\n@@ -4686,7 +4680,6 @@ _GLIBCXX_BEGIN_NAMESPACE_ALGO\n * @param __middle Another iterator.\n * @param __last Another iterator.\n * @param __comp A comparison functor.\n- * @return Nothing.\n *\n * Sorts the smallest `(__middle - __first)` elements in the range\n * `[__first, __last)` and moves them to the range `[__first, __middle)`.\n@@ -4724,7 +4717,6 @@ _GLIBCXX_BEGIN_NAMESPACE_ALGO\n * @param __first An iterator.\n * @param __nth Another iterator.\n * @param __last Another iterator.\n- * @return Nothing.\n *\n * Rearranges the elements in the range `[__first, __last)` so that `*__nth`\n * is the same element that would have been in that position had the\n@@ -4764,7 +4756,6 @@ _GLIBCXX_BEGIN_NAMESPACE_ALGO\n * @param __nth Another iterator.\n * @param __last Another iterator.\n * @param __comp A comparison functor.\n- * @return Nothing.\n *\n * Rearranges the elements in the range `[__first, __last)` so that `*__nth`\n * is the same element that would have been in that position had the\n@@ -4802,7 +4793,6 @@ _GLIBCXX_BEGIN_NAMESPACE_ALGO\n * @ingroup sorting_algorithms\n * @param __first An iterator.\n * @param __last Another iterator.\n- * @return Nothing.\n *\n * Sorts the elements in the range `[__first, __last)` in ascending order,\n * such that for each iterator `i` in the range `[__first, __last - 1)`,\n@@ -4833,7 +4823,6 @@ _GLIBCXX_BEGIN_NAMESPACE_ALGO\n * @param __first An iterator.\n * @param __last Another iterator.\n * @param __comp A comparison functor.\n- * @return Nothing.\n *\n * Sorts the elements in the range `[__first, __last)` in ascending order,\n * such that `__comp(*(i+1), *i)` is false for every iterator `i` in the\n@@ -5028,7 +5017,6 @@ _GLIBCXX_BEGIN_NAMESPACE_ALGO\n * @ingroup sorting_algorithms\n * @param __first An iterator.\n * @param __last Another iterator.\n- * @return Nothing.\n *\n * Sorts the elements in the range @p [__first,__last) in ascending order,\n * such that for each iterator @p i in the range @p [__first,__last-1),\n@@ -5063,7 +5051,6 @@ _GLIBCXX_BEGIN_NAMESPACE_ALGO\n * @param __first An iterator.\n * @param __last Another iterator.\n * @param __comp A comparison functor.\n- * @return Nothing.\n *\n * Sorts the elements in the range @p [__first,__last) in ascending order,\n * such that for each iterator @p i in the range @p [__first,__last-1),\ndiff --git a/libstdc++-v3/include/bits/stl_algobase.h b/libstdc++-v3/include/bits/stl_algobase.h\nindex 3fdbff973538..1350736a8d8e 100644\n--- a/libstdc++-v3/include/bits/stl_algobase.h\n+++ b/libstdc++-v3/include/bits/stl_algobase.h\n@@ -144,7 +144,6 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION\n * @ingroup mutating_algorithms\n * @param __a An iterator.\n * @param __b Another iterator.\n- * @return Nothing.\n *\n * This function swaps the values pointed to by two iterators, not the\n * iterators themselves.\n@@ -990,7 +989,6 @@ _GLIBCXX_END_NAMESPACE_CONTAINER\n * @param __first A forward iterator.\n * @param __last A forward iterator.\n * @param __value A reference-to-const of arbitrary type.\n- * @return Nothing.\n *\n * This function fills a range with copies of the same value. For char\n * types filling contiguous areas of memory, this becomes an inline call\ndiff --git a/libstdc++-v3/include/bits/stl_deque.h b/libstdc++-v3/include/bits/stl_deque.h\nindex c08212861b6c..aebe865ffc1a 100644\n--- a/libstdc++-v3/include/bits/stl_deque.h\n+++ b/libstdc++-v3/include/bits/stl_deque.h\n@@ -632,7 +632,6 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER\n * @brief Layout storage.\n * @param __num_elements The count of T's for which to allocate space\n * at first.\n- * @return Nothing.\n *\n * The initial underlying memory layout is a bit complicated...\n */\n@@ -1985,7 +1984,6 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER\n * @brief Fills the deque with whatever is in [first,last).\n * @param __first An input iterator.\n * @param __last An input iterator.\n- * @return Nothing.\n *\n * If the iterators are actually forward iterators (or better), then the\n * memory layout can be done all at once. Else we move forward using\n@@ -2006,7 +2004,6 @@ _GLIBCXX_BEGIN_NAMESPACE_CONTAINER\n /**\n * @brief Fills the %deque with copies of value.\n * @param __value Initial value.\n- * @return Nothing.\n * @pre _M_start and _M_finish have already been initialized,\n * but none of the %deque's elements have yet been constructed.\n *\ndiff --git a/libstdc++-v3/include/bits/stl_iterator_base_funcs.h b/libstdc++-v3/include/bits/stl_iterator_base_funcs.h\nindex 515d6e6c04f8..d85b39365400 100644\n--- a/libstdc++-v3/include/bits/stl_iterator_base_funcs.h\n+++ b/libstdc++-v3/include/bits/stl_iterator_base_funcs.h\n@@ -248,7 +248,6 @@ namespace __detail\n * @brief A generalization of pointer arithmetic.\n * @param __i An input iterator.\n * @param __n The @a delta by which to change @p __i.\n- * @return Nothing.\n *\n * This increments @p i by @p n. For bidirectional and random access\n * iterators, @p __n may be negative, in which case @p __i is decremented.\ndiff --git a/libstdc++-v3/include/bits/stl_numeric.h b/libstdc++-v3/include/bits/stl_numeric.h\nindex dad20c806b30..182769f0dc4f 100644\n--- a/libstdc++-v3/include/bits/stl_numeric.h\n+++ b/libstdc++-v3/include/bits/stl_numeric.h\n@@ -79,7 +79,6 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION\n * @param __first Start of range.\n * @param __last End of range.\n * @param __value Starting value.\n- * @return Nothing.\n * @ingroup numeric_ops\n */\n template<typename _ForwardIterator, typename _Tp>\ndiff --git a/libstdc++-v3/include/bits/stl_tempbuf.h b/libstdc++-v3/include/bits/stl_tempbuf.h\nindex 1ae41991910c..a1d0a39f0b98 100644\n--- a/libstdc++-v3/include/bits/stl_tempbuf.h\n+++ b/libstdc++-v3/include/bits/stl_tempbuf.h\n@@ -159,7 +159,6 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION\n /**\n * @brief The companion to get_temporary_buffer().\n * @param __p A buffer previously allocated by get_temporary_buffer.\n- * @return None.\n *\n * Frees the memory pointed to by __p.\n */\ndiff --git a/libstdc++-v3/include/bits/stl_uninitialized.h b/libstdc++-v3/include/bits/stl_uninitialized.h\nindex ecc24023e98f..1c1fcfd62a4d 100644\n--- a/libstdc++-v3/include/bits/stl_uninitialized.h\n+++ b/libstdc++-v3/include/bits/stl_uninitialized.h\n@@ -403,7 +403,6 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION\n * @param __first A forward iterator.\n * @param __last A forward iterator.\n * @param __x The source value.\n- * @return Nothing.\n *\n * Like std::fill, but does not require an initialized output range.\n */\n", "prefixes": [ "04/10" ] }