From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by sourceware.org (Postfix) with ESMTPS id 203293858D38 for ; Mon, 3 Oct 2022 10:25:58 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 203293858D38 Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=redhat.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=redhat.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1664792757; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=zX60efyOaGVunnz3G/6UG/KhGVberbWUvS9dTsPafws=; b=FO6+pU7yPAFJwdBznWMqJrlvNDX8Aj2t3J4kByhAjN+ZEUZ9qgFUfl/8MaEzbheT95Wuuz vUXjPjllvr9pcodITxQAlKGuDzHf4/8pwlCD9O6O9/2vNOrRNT7QtuoUAifKem4bI0Ldea eEBd3Zp1dSLsamDjodHdhteEEO5iDQY= Received: from mail-qv1-f71.google.com (mail-qv1-f71.google.com [209.85.219.71]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_128_GCM_SHA256) id us-mta-22-D5zsD44fP52h4ICY6Jiy5Q-1; Mon, 03 Oct 2022 06:25:56 -0400 X-MC-Unique: D5zsD44fP52h4ICY6Jiy5Q-1 Received: by mail-qv1-f71.google.com with SMTP id q20-20020ad44354000000b004afb5a0d33cso5769471qvs.12 for ; Mon, 03 Oct 2022 03:25:56 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:x-gm-message-state:from:to:cc :subject:date; bh=zX60efyOaGVunnz3G/6UG/KhGVberbWUvS9dTsPafws=; b=Ku/a+7jn/alvNDbG7ZQ7wkWYuFHakwjbM8bhCbmGXIUD+TLl3dxZwN1K4m7YcEJgiB 2MWjKr1YeohKWNp3v86pVBtOjMjjHkUo/hgj5T+HVDNfSFY9Q+KshyFywsZ+xBXoyCj6 k0Nn9hGGga9q9QWEJc65F3WHRlU7i1+1GtUqNOctwxLVT9RZ+Ke9XbWmjuWcmK/jizSH 2K8FC5HuXeXfSfu+F/BBdTk5EGDznnkVoCAjTWbPdvtp4qUYgPRaavLAHnjhMUyIPLS9 tiAEeR+m6Ms6ieLkhGmnD2Qf/i8bAwP+r9FXD9ihpNRFHgTXoL2HBpQffn31Ietxd8+C G5vQ== X-Gm-Message-State: ACrzQf3SRiyWqWz43Ik/36zeDIFlKvSZUogshwCsC3iGMK3JVgnYkAQQ tw99tT4ALpo3XJQJ4msrVepnkDhBF421VinRRdMXems+c3on0Rsdv0GgGGgd/7u547SJ1jPzgyI gEQRvyv+j1Lvx49XZa9PdrIzSz+lZHV2rkQ== X-Received: by 2002:a05:620a:28c5:b0:6ce:bc17:15b0 with SMTP id l5-20020a05620a28c500b006cebc1715b0mr13002014qkp.245.1664792756065; Mon, 03 Oct 2022 03:25:56 -0700 (PDT) X-Google-Smtp-Source: AMsMyM69Xsu//+Aw4q9gdIgSX6t2Acj+EeHMF6bZ4djNGaoVvRx5cdK0cFAELJ5qRv0SVZaFp398Xp44a4KpNDjDEyY= X-Received: by 2002:a05:620a:28c5:b0:6ce:bc17:15b0 with SMTP id l5-20020a05620a28c500b006cebc1715b0mr13002006qkp.245.1664792755897; Mon, 03 Oct 2022 03:25:55 -0700 (PDT) MIME-Version: 1.0 References: <20221001184004.3599748-1-arsen@aarsen.me> <5180385.XzS0BqJLIp@bstg> In-Reply-To: <5180385.XzS0BqJLIp@bstg> From: Jonathan Wakely Date: Mon, 3 Oct 2022 11:25:45 +0100 Message-ID: Subject: Re: [PATCH] libstdc++: Use ///< for inline documentation To: =?UTF-8?Q?Arsen_Arsenovi=C4=87?= Cc: gcc-patches@gcc.gnu.org, libstdc++@gcc.gnu.org X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Spam-Status: No, score=-6.6 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,KAM_SHORT,RCVD_IN_DNSWL_NONE,SPF_HELO_NONE,SPF_NONE,TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org List-Id: On Mon, 3 Oct 2022 at 10:29, Arsen Arsenovi=C4=87 wrote: > > On Monday, 3 October 2022 10:37:00 CEST Jonathan Wakely wrote: > > I did look into this after you pointed it out on IRC. Unless I fumbled > > my doxygen roll, the results are the same for /// and ///< so maybe > > at some point Doxygen started to DTRT even without the < character. > > It is actually unchanged for the standard IO objects, for some reason. Yes, those are the ones I checked. > The rounding style enum produced different results after this change Ah OK, thanks. I'll apply the patch then. > (for convenience, link below; intermediate is missing, towards_zero is > misdocumented). > > Unsure what the exact rule is, but, AFAICT, ///< is not worse, and on > top of that, clangd interprets it properly (it's how I stumbled upon > this, cout was "Linked to standard output" in its LSP hover response). > > https://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01635.html#a53db= c8572a84ca50272f9e55a1e23e18 > -- > Arsen Arsenovi=C4=87