Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/2218832/?format=api
{ "id": 2218832, "url": "http://patchwork.ozlabs.org/api/patches/2218832/?format=api", "web_url": "http://patchwork.ozlabs.org/project/gcc/patch/20260401215920.674286-10-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-10-jwakely@redhat.com>", "list_archive_url": null, "date": "2026-04-01T20:42:10", "name": "[10/10] libstdc++: Add Doxygen documentation to <version>", "commit_ref": null, "pull_url": null, "state": "new", "archived": false, "hash": "250d807ef0618c836de1d3e3182a3c27ac0cb324", "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-10-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/2218832/comments/", "check": "pending", "checks": "http://patchwork.ozlabs.org/api/patches/2218832/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=cSG6Evwf;\n\tdkim-atps=neutral", "legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=gcc.gnu.org\n (client-ip=38.145.34.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=cSG6Evwf", "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 [38.145.34.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 4fmJzC3k3Lz1yFv\n\tfor <incoming@patchwork.ozlabs.org>; Thu, 02 Apr 2026 09:08:39 +1100 (AEDT)", "from vm01.sourceware.org (localhost [127.0.0.1])\n\tby sourceware.org (Postfix) with ESMTP id ACD5E4BA23F2\n\tfor <incoming@patchwork.ozlabs.org>; Wed, 1 Apr 2026 22:08:37 +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 5B19E4BAD15C\n for <gcc-patches@gcc.gnu.org>; Wed, 1 Apr 2026 22:00:42 +0000 (GMT)", "from mx-prod-mc-06.mail-002.prod.us-west-2.aws.redhat.com\n (ec2-35-165-154-97.us-west-2.compute.amazonaws.com [35.165.154.97]) by\n relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3,\n cipher=TLS_AES_256_GCM_SHA384) id us-mta-212-xEc_q9MoPmuqRRXlzjfWOQ-1; Wed,\n 01 Apr 2026 17:59:38 -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-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS\n id 59CAF1800365; Wed, 1 Apr 2026 21:59:37 +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 5F26519560AB; Wed, 1 Apr 2026 21:59:36 +0000 (UTC)" ], "DKIM-Filter": "OpenDKIM Filter v2.11.0 sourceware.org ACD5E4BA23F2", "DMARC-Filter": "OpenDMARC Filter v1.4.2 sourceware.org 5B19E4BAD15C", "ARC-Filter": "OpenARC Filter v1.0.0 sourceware.org 5B19E4BAD15C", "ARC-Seal": "i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1775080842; cv=none;\n b=FGia4lRM8vi9z8CwmEgmGSicnHAqQqb+5eyyyy0Fa7soe1XFqpJISMxL+5skDXMPTjCkVEyhi+o5gwRlU58lm78qf8NQbxAucyntUGF8TuUL8oHlsD4xdkAwjjsUSk34O72YJ8Uk9jLn7EvseODPp6evY7vXLaC28ah1NK2s/+o=", "ARC-Message-Signature": "i=1; a=rsa-sha256; d=sourceware.org; s=key;\n t=1775080842; c=relaxed/simple;\n bh=J1KyYHYrcBvN+43cHPGcIAr5zC3Y1imc6lGuVCUXx9Q=;\n h=DKIM-Signature:From:To:Subject:Date:Message-ID:MIME-Version;\n b=LW/FzR9HDAA0G1J/QYppZzOvw7rWPJQPalCHzoZefIxpgCbN2dHWq9NzdXQH84fY6n+O+KcHr6+DvoOuSGVle5IZoHjGXq8Kz7722x+ZsJ0OjWDgbPQenQ97NCbAZd5LugYSNYmLJToY54cFTH9eohUJuoaXQUrOvdMzVivXMKw=", "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=1775080781;\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=Npq304BzcZWdwN04aaEgwgnPEkdrUC/grDuf4oiOC0Q=;\n b=cSG6EvwfZg9GyAyrOq+2RsJaN6IInGyUYxemcs8Yww7IGZNTmQxi2elJM3WsH4/SFQbqNw\n FuYRVNauFwmbK+7A8Lk6wbtthJcp5G6WCvPWV5qYcMOgGQEGh4biyJU7ZQMPxxoZSXZ9fZ\n sj3cXGVScyaRqsdV8AFg+HKMMwnbQ7M=", "X-MC-Unique": "xEc_q9MoPmuqRRXlzjfWOQ-1", "X-Mimecast-MFC-AGG-ID": "xEc_q9MoPmuqRRXlzjfWOQ_1775080777", "From": "Jonathan Wakely <jwakely@redhat.com>", "To": "gcc-patches@gcc.gnu.org,\n\tlibstdc++@gcc.gnu.org", "Subject": "[PATCH 10/10] libstdc++: Add Doxygen documentation to <version>", "Date": "Wed, 1 Apr 2026 21:42:10 +0100", "Message-ID": "<20260401215920.674286-10-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": "5S6kFK3oqffJwyNfFjrMpvF9eTRyNR3np_lNj3NCdu4_1775080777", "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\nTested x86_64-linux, docs built with Doxygen 1.13.2 and 1.17.0 (from git)\n\n libstdc++-v3/include/std/version | 26 ++++++++++++++++++++++++++\n 1 file changed, 26 insertions(+)", "diff": "diff --git a/libstdc++-v3/include/std/version b/libstdc++-v3/include/std/version\nindex c6ac031f6b54..7b2273a245d8 100644\n--- a/libstdc++-v3/include/std/version\n+++ b/libstdc++-v3/include/std/version\n@@ -25,6 +25,32 @@\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+ *\n+ * The `<version>` header defines feature test macros that can be used to\n+ * programmatically test properties of the C++ implementation you are using.\n+ * For example, by including `<version>` and then checking whether the\n+ * `__cpp_lib_expected` macro is defined, you can tell whether `std::expected`\n+ * is supported. The macros that are defined by `<version>` and the values\n+ * of those macros depend on the C++ Standard Library implementation and on\n+ * compiler flags such as `-std=c++23`, `-ffreestanding`, and `-fno-rtti`.\n+ *\n+ * The list of macros that should be defined by `<version>` header can be\n+ * found in the C++ standard committee's SD-6 document:\n+ * https://isocpp.org/std/standing-documents/sd-6-sg10-feature-test-recommendations\n+ * That document also documents which standard proposals the different macro\n+ * values correspond to, e.g. `__cpp_lib_expected == 202202L` implies that\n+ * only the original feature set of `std::expected` is supported, and\n+ * `__cpp_lib_expected == 202211L` implies that the additional monadic\n+ * functions such as `std::expected::and_then` are also supported.\n+ *\n+ * The `<version>` header should also define any implementation-specific\n+ * macros, which can sometimes be used to tell which C++ implementation\n+ * the code is being compiled with. For example, in libstdc++ `<version>`\n+ * defines the `_GLIBCXX_RELEASE` macro. Testing for the\n+ *\n+ * The `<version>` header was first defined in C++20, but libstdc++\n+ * provides it unconditionally and many of the macros it defines are\n+ * present (and meaningful) for C++17 and older standards.\n */\n \n #ifndef _GLIBCXX_VERSION_INCLUDED\n", "prefixes": [ "10/10" ] }