Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/2219126/?format=api
{ "id": 2219126, "url": "http://patchwork.ozlabs.org/api/patches/2219126/?format=api", "web_url": "http://patchwork.ozlabs.org/project/gcc/patch/20260402132816.967762-1-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": "<20260402132816.967762-1-jwakely@redhat.com>", "list_archive_url": null, "date": "2026-04-02T13:26:02", "name": "[v2] libstdc++: Add Doxygen documentation to <version>", "commit_ref": null, "pull_url": null, "state": "new", "archived": false, "hash": "d907d5bd026954c2f208496fb831812d67e54eb1", "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/20260402132816.967762-1-jwakely@redhat.com/mbox/", "series": [ { "id": 498481, "url": "http://patchwork.ozlabs.org/api/series/498481/?format=api", "web_url": "http://patchwork.ozlabs.org/project/gcc/list/?series=498481", "date": "2026-04-02T13:26:02", "name": "[v2] libstdc++: Add Doxygen documentation to <version>", "version": 2, "mbox": "http://patchwork.ozlabs.org/series/498481/mbox/" } ], "comments": "http://patchwork.ozlabs.org/api/patches/2219126/comments/", "check": "pending", "checks": "http://patchwork.ozlabs.org/api/patches/2219126/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=L878G2z8;\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;\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=L878G2z8", "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 4fmjP94VRzz1yCs\n\tfor <incoming@patchwork.ozlabs.org>; Fri, 03 Apr 2026 00:29:00 +1100 (AEDT)", "from vm01.sourceware.org (localhost [127.0.0.1])\n\tby sourceware.org (Postfix) with ESMTP id E5F634BA9000\n\tfor <incoming@patchwork.ozlabs.org>; Thu, 2 Apr 2026 13:28:57 +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 D19834BA2E0F\n for <gcc-patches@gcc.gnu.org>; Thu, 2 Apr 2026 13:28:23 +0000 (GMT)", "from mx-prod-mc-03.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-586-kIZAS0rIPOqjP8OnqZCUDg-1; Thu,\n 02 Apr 2026 09:28:20 -0400", "from mx-prod-int-08.mail-002.prod.us-west-2.aws.redhat.com\n (mx-prod-int-08.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.111])\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-03.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS\n id 717561956068; Thu, 2 Apr 2026 13:28:19 +0000 (UTC)", "from zen.kayari.org (unknown [10.44.48.134])\n by mx-prod-int-08.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP\n id 373E51800351; Thu, 2 Apr 2026 13:28:17 +0000 (UTC)" ], "DKIM-Filter": [ "OpenDKIM Filter v2.11.0 sourceware.org E5F634BA9000", "OpenDKIM Filter v2.11.0 sourceware.org D19834BA2E0F" ], "DMARC-Filter": "OpenDMARC Filter v1.4.2 sourceware.org D19834BA2E0F", "ARC-Filter": "OpenARC Filter v1.0.0 sourceware.org D19834BA2E0F", "ARC-Seal": "i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1775136503; cv=none;\n b=RxCZ5J/0dNngTYNXY9StKPDo0v1r3kawRTsbvdCFLXXWHGzE3axY2tpMWUjeWjEeONwFyMe1Djhp+pnsk4mzfaJEq4Mq9m/ibbw2CcAcoEJHR/7IR9YBRDtFmn+lJpoiSWQFd0DBGx558i7ctI4H5OaQhmnM8BtXzRGwz99cyzg=", "ARC-Message-Signature": "i=1; a=rsa-sha256; d=sourceware.org; s=key;\n t=1775136503; c=relaxed/simple;\n bh=7iQV1H/HN1gA0rLMKHO7gXTWD4debihW7rOxCdE17o4=;\n h=DKIM-Signature:From:To:Subject:Date:Message-ID:MIME-Version;\n b=obVGtVmCLltmHG8dVICRaKt6KlwUay++bGYawxE9npgnLNiBti2rHK+ctQN4cJ5+6660QhkECq2sPRZGWi4MPTaq2NaQzp13XUWdZf8Bxm7syZpt7wIlRF4ldR3bLgNMvQkhA+C+Q/BJIXwCeK379RFJtOsH3xgFCKjOTu8cIKM=", "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=1775136503;\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 bh=sUguJP6hGkm4JQ2kQ+kvD/lD3bK3+wr/2xm11Cs4f0g=;\n b=L878G2z8Vyi2oNqKUWzu7bSDDMiBXTPTn81KNksZ/xlpBcGZjgle8BHH2yZkkQUmHhO6JT\n i0ff7/s7RqgMqmExuJnMZqOeVfO/DDcIJyo8m5sR7/p4mka6ArAa3QxJ+UD2SsMu7DF1jE\n iO63sFT2Ej1BclHaeNcG04bfY8ud3jo=", "X-MC-Unique": "kIZAS0rIPOqjP8OnqZCUDg-1", "X-Mimecast-MFC-AGG-ID": "kIZAS0rIPOqjP8OnqZCUDg_1775136499", "From": "Jonathan Wakely <jwakely@redhat.com>", "To": "gcc-patches@gcc.gnu.org,\n\tlibstdc++@gcc.gnu.org", "Subject": "[PATCH v2] libstdc++: Add Doxygen documentation to <version>", "Date": "Thu, 2 Apr 2026 14:26:02 +0100", "Message-ID": "<20260402132816.967762-1-jwakely@redhat.com>", "MIME-Version": "1.0", "X-Scanned-By": "MIMEDefang 3.4.1 on 10.30.177.111", "X-Mimecast-Spam-Score": "0", "X-Mimecast-MFC-PROC-ID": "PeKvZT8mYiLY-Qrj4FH8QSQw3A9JO68t00aTMqtiGGk_1775136499", "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": "libstdc++-v3/ChangeLog:\n\n\t* include/std/version: Add Doxygen documentation comment.\n---\n\nv2: rewrite, prompted by Tomasz suggesting some changes. Tried to\nshorten it to be more concise.\n\n libstdc++-v3/include/std/version | 38 ++++++++++++++++++++++++++++++--\n 1 file changed, 36 insertions(+), 2 deletions(-)", "diff": "diff --git a/libstdc++-v3/include/std/version b/libstdc++-v3/include/std/version\nindex c6ac031f6b54..8ab9acc17a0a 100644\n--- a/libstdc++-v3/include/std/version\n+++ b/libstdc++-v3/include/std/version\n@@ -23,8 +23,42 @@\n // <http://www.gnu.org/licenses/>.\n \n /** @file version\n- * This is a Standard C++ Library file. You should @c \\#include this file\n- * in your programs, rather than any of the @a *.h implementation files.\n+ * This is a Standard C++ Library header. You should `#include` this header\n+ * in your programs, rather than any of the `*.h` implementation files.\n+ *\n+ * The `<version>` header defines feature test macros that describe the\n+ * supported features of the C++ standard library implementation being used.\n+ * The macros that are defined, and their values, depend on compiler flags\n+ * (usually `-std`, but others such as `-fcoroutines` and `-fno-aligned-new`\n+ * can affect them).\n+ *\n+ * These macros can be used to conditionally enable or disable code:\n+ *\n+ * ```\n+ * #include <version>\n+ * #ifdef __cpp_lib_expected\n+ * // std::expected is supported\n+ * #endif\n+ * ```\n+ *\n+ * The macro values indicate different levels of support, for example\n+ * `__cpp_lib_expected == 202202L` means only the original feature set of\n+ * `std::expected` is supported, while `__cpp_lib_expected == 202211L` means\n+ * that the monadic functions such as `std::expected::and_then` are also\n+ * supported.\n+ *\n+ * The list of macros defined in `<version>` and their meanings is given in\n+ * the C++ standard committee's SD-6 document:\n+ * https://isocpp.org/std/standing-documents/sd-6-sg10-feature-test-recommendations\n+ *\n+ * `<version>` may also define non-standard, implementation-specific macros,\n+ * such as libstdc++'s `_GLIBCXX_RELEASE`. However, the standard feature\n+ * test macros should be preferred over depending on specific versions of any\n+ * particular implementation.\n+ *\n+ * The `<version>` header was introduced in C++20, but libstdc++ provides it\n+ * unconditionally. As documented in SD-6, some macros correspond to features\n+ * in C++17 and earlier standards.\n */\n \n #ifndef _GLIBCXX_VERSION_INCLUDED\n", "prefixes": [ "v2" ] }