{"id":2224341,"url":"http://patchwork.ozlabs.org/api/1.2/patches/2224341/?format=json","web_url":"http://patchwork.ozlabs.org/project/gcc/patch/20260417100134.305327-1-jwakely@redhat.com/","project":{"id":17,"url":"http://patchwork.ozlabs.org/api/1.2/projects/17/?format=json","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":"<20260417100134.305327-1-jwakely@redhat.com>","list_archive_url":null,"date":"2026-04-17T10:01:14","name":"[committed] libstdc++: Improve Doxygen comments in ","commit_ref":null,"pull_url":null,"state":"new","archived":false,"hash":"fe61125462909ddb5cb22a0acf7943b5824c4408","submitter":{"id":48004,"url":"http://patchwork.ozlabs.org/api/1.2/people/48004/?format=json","name":"Jonathan Wakely","email":"jwakely@redhat.com"},"delegate":null,"mbox":"http://patchwork.ozlabs.org/project/gcc/patch/20260417100134.305327-1-jwakely@redhat.com/mbox/","series":[{"id":500298,"url":"http://patchwork.ozlabs.org/api/1.2/series/500298/?format=json","web_url":"http://patchwork.ozlabs.org/project/gcc/list/?series=500298","date":"2026-04-17T10:01:14","name":"[committed] libstdc++: Improve Doxygen comments in ","version":1,"mbox":"http://patchwork.ozlabs.org/series/500298/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/2224341/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/2224341/checks/","tags":{},"related":[],"headers":{"Return-Path":"","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=JgeALYx2;\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=JgeALYx2","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 4fxr6B6FMcz1yD3\n\tfor ; Fri, 17 Apr 2026 20:02:42 +1000 (AEST)","from vm01.sourceware.org (localhost [127.0.0.1])\n\tby sourceware.org (Postfix) with ESMTP id D613D4C515F7\n\tfor ; Fri, 17 Apr 2026 10:02:40 +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 1F1324BA23EF\n for ; Fri, 17 Apr 2026 10:01:41 +0000 (GMT)","from mx-prod-mc-08.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-502-e4deXUHLMDSHKzL9ZaPOyg-1; Fri,\n 17 Apr 2026 06:01:39 -0400","from mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com\n (mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com [10.30.177.93])\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-08.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTPS\n id 9956518002C6; Fri, 17 Apr 2026 10:01:37 +0000 (UTC)","from zen.kayari.org (unknown [10.44.48.52])\n by mx-prod-int-06.mail-002.prod.us-west-2.aws.redhat.com (Postfix) with ESMTP\n id 5038918004AD; Fri, 17 Apr 2026 10:01:35 +0000 (UTC)"],"DKIM-Filter":["OpenDKIM Filter v2.11.0 sourceware.org D613D4C515F7","OpenDKIM Filter v2.11.0 sourceware.org 1F1324BA23EF"],"DMARC-Filter":"OpenDMARC Filter v1.4.2 sourceware.org 1F1324BA23EF","ARC-Filter":"OpenARC Filter v1.0.0 sourceware.org 1F1324BA23EF","ARC-Seal":"i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1776420101; cv=none;\n b=AuCnHGyVA9/HbYZ7GRGtosW9CtZNE8EjdGxuC+6wu6DDai8R4aq4r3j/A1X9hfODSfUiq9eXocLdsTx1qy7Jo6PW3+E6pTc0cplfNEwBCMmJ0FTJ0C46QAcwYyJkneJqOPOgh1nABYY06gXpnVjt5PlImxZ9MSdrmb4hZlrc4xI=","ARC-Message-Signature":"i=1; a=rsa-sha256; d=sourceware.org; s=key;\n t=1776420101; c=relaxed/simple;\n bh=3bKLZDnpFCqm5cTib7gfz+13E7uv0IlkX6KAaiEbxAI=;\n h=DKIM-Signature:From:To:Subject:Date:Message-ID:MIME-Version;\n b=hBu9iflePA91c4j0dR+iP9lCY2RgAE3GKu9KsagJm6COfvHEaIue425Ao386ekQeRzpgTzkqH68jGTxAqQeReW4t1Sjmnpo9V63vVC+S4Wyi7cVnindS9Cjzjq8Hnwywp/duPlL1aKFbj2F3T3aQ6phqO1xR9deKxbqAt0Rlixo=","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=1776420100;\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=4U2WZppQufSr+qz1XtC3/HGnr2m22+/4vbWRYGuqNB0=;\n b=JgeALYx2K/cpm2kjgGbMHPN9Wz68Eq9Em2hw6ddabifUhf2RyC+uKmes86zZHWnQiFedM3\n vW+g31PYIwJ1xjDayWtPwGI94oafzmN2oU5fLSzxpGDMFNihWS9BM5xpgVLc2iziJzdpV3\n /0FhXAniMUpWH77pAmWVk85nnJrnXY8=","X-MC-Unique":"e4deXUHLMDSHKzL9ZaPOyg-1","X-Mimecast-MFC-AGG-ID":"e4deXUHLMDSHKzL9ZaPOyg_1776420098","From":"Jonathan Wakely ","To":"libstdc++@gcc.gnu.org,\n\tgcc-patches@gcc.gnu.org","Subject":"[committed] libstdc++: Improve Doxygen comments in ","Date":"Fri, 17 Apr 2026 11:01:14 +0100","Message-ID":"<20260417100134.305327-1-jwakely@redhat.com>","MIME-Version":"1.0","X-Scanned-By":"MIMEDefang 3.4.1 on 10.30.177.93","X-Mimecast-Spam-Score":"0","X-Mimecast-MFC-PROC-ID":"3ZBYQeGo1w9rlkmpCsq3q3nn8rAKN4Rg4HF0n3GxMMo_1776420098","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 ","List-Unsubscribe":",\n ","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n ","Errors-To":"gcc-patches-bounces~incoming=patchwork.ozlabs.org@gcc.gnu.org"},"content":"libstdc++-v3/ChangeLog:\n\n\t* include/std/chrono: Improve Doxygen comments.\n---\n\nTested x86_64-linux, powerc64le-linux, sparc-solaris2.11.\n\nPushed to trunk.\n\n libstdc++-v3/include/std/chrono | 16 +++++++++++++++-\n 1 file changed, 15 insertions(+), 1 deletion(-)","diff":"diff --git a/libstdc++-v3/include/std/chrono b/libstdc++-v3/include/std/chrono\nindex 573bcfc7c4bc..7c887f56cc23 100644\n--- a/libstdc++-v3/include/std/chrono\n+++ b/libstdc++-v3/include/std/chrono\n@@ -301,12 +301,14 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION\n \t { return utc_clock::to_sys(__t); }\n };\n \n+ /// @cond undocumented\n template\n inline constexpr bool __is_time_point_for_v = false;\n \n template\n inline constexpr bool\n __is_time_point_for_v, _Clock> = true;\n+ /// @endcond\n \n // Conversions between system_clock and other clocks\n \n@@ -517,6 +519,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION\n \n inline constexpr last_spec last{};\n \n+ /// @cond undocumented\n namespace __detail\n {\n // Helper to __add_modulo and __sub_modulo.\n@@ -564,7 +567,8 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION\n \n inline constexpr unsigned __days_per_month[12]\n \t= { 31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 };\n- }\n+ } // namespace __detail\n+ /// @endcond\n \n // DAY\n \n@@ -1438,6 +1442,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION\n \n // YEAR_MONTH\n \n+ /// @cond undocumented\n namespace __detail\n {\n // [time.cal.ym], [time.cal.ymd], etc constrain the 'months'-based\n@@ -1454,6 +1459,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION\n // 'years'.\n using __months_years_conversion_disambiguator = void;\n }\n+ /// @endcond\n \n class year_month\n {\n@@ -2489,14 +2495,17 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION\n \n // 12/24 HOURS FUNCTIONS\n \n+ /// True if a `chrono::hours` value represents a time before midday.\n constexpr bool\n is_am(const hours& __h) noexcept\n { return 0h <= __h && __h <= 11h; }\n \n+ /// True if a `chrono::hours` value represents a time after midday.\n constexpr bool\n is_pm(const hours& __h) noexcept\n { return 12h <= __h && __h <= 23h; }\n \n+ /// Convert a 24-hour time into a 12-hour time.\n constexpr hours\n make12(const hours& __h) noexcept\n {\n@@ -2507,6 +2516,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION\n return __h;\n }\n \n+ /// Convert a 12-hour time and p.m. flag into a 24-hour time.\n constexpr hours\n make24(const hours& __h, bool __is_pm) noexcept\n {\n@@ -2604,6 +2614,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION\n \t}\n };\n \n+ /// @cond undocumented\n template\n [[noreturn]] void\n __throw_bad_local_time(const local_time<_Duration>& __tp,\n@@ -2617,6 +2628,7 @@ _GLIBCXX_BEGIN_NAMESPACE_VERSION\n \t__builtin_abort();\n #endif\n }\n+ /// @endcond\n \n enum class choose { earliest, latest };\n \n@@ -3337,6 +3349,7 @@ namespace __detail\n \n namespace chrono {\n \n+ /// @cond undocumented\n template\n [[__gnu__::__always_inline__]]\n constexpr auto\n@@ -3407,6 +3420,7 @@ namespace __detail\n \t return chrono::__int_hash(__res);\n \t }\n }\n+ /// @endcond\n } // namespace chrono\n \n // duration\n","prefixes":["committed"]}