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.129.124]) by sourceware.org (Postfix) with ESMTPS id 4237E3857B8E for ; Mon, 3 Oct 2022 10:26:00 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 4237E3857B8E 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=1664792759; 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=YuePSDc67XXXk+FC82xKDN8Zg+dobfaxa+zbvGHUQCvx+sVA1V3Z3aiGNSjeCMLb3v72YO FZSM03EzESynJxjbJu9s0UaDdMB54SbWAgovE+fWhvNWU4KUO0zWNy6Lo6AtlrHqG+AK6P +b5zMa+zgq/+dGNZZTAWjGHnCqBBApg= Received: from mail-qk1-f197.google.com (mail-qk1-f197.google.com [209.85.222.197]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_128_GCM_SHA256) id us-mta-259-Z1D5zNitMJeBXwn7QrcCtA-1; Mon, 03 Oct 2022 06:25:56 -0400 X-MC-Unique: Z1D5zNitMJeBXwn7QrcCtA-1 Received: by mail-qk1-f197.google.com with SMTP id bq17-20020a05620a469100b006d2c613ebcbso4932060qkb.19 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=r6qlxRNfCq+tZVPE1HkowTj99UVWmTby+oQaPmaC+5nztOyeBPmGorGNsaq+WuouOJ He45ofQEFbqNB70y9GILNNxJShQVPjLxAGEVXXb1TH2g3gH4ilCYvoEEKz+NELSM00bh zL0W3bDUFR7N/yJqIV2W1pt3cmlyOk4ImKkdYAJ89C85b8yx6SQ4zlyqa1NJ42WsqO8w CpQNGPXPy3lm2AoImKCCQt5KOSukuwGqtQoUNtuf8AB+fTrOSltP/ZXU+m1efMzJhdBv GGw0J96D+3YCT8473HPa6u9C3xNblyWw17x6xvOB8bpvc9ADqDk8KUum7N6IuPWHEzGQ bWMA== X-Gm-Message-State: ACrzQf042hu7r29x0EuYsZOKxTJxYo8Ie6z55oJedZjn4+aqn8QsR2lZ BzBtrZP0kS0tYKMnVa1QTIL6AaLF1ohYH3Ipf/ux2vQDxdsK0I0E0B8tnNpJZ4dswBuKXlrdgem zHnU8mVhnVt23slRoMxF9Lb3K5boOZRE= X-Received: by 2002:a05:620a:28c5:b0:6ce:bc17:15b0 with SMTP id l5-20020a05620a28c500b006cebc1715b0mr13002013qkp.245.1664792756064; 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.8 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,KAM_SHORT,RCVD_IN_DNSWL_LOW,SPF_HELO_NONE,SPF_NONE,TXREP autolearn=unavailable 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