From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from eggs.gnu.org (eggs.gnu.org [IPv6:2001:470:142:3::10]) by sourceware.org (Postfix) with ESMTPS id 22C2F3858C52 for ; Fri, 29 Sep 2023 07:46:23 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 22C2F3858C52 Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=gnu.org Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=gnu.org Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qm8Ca-00075g-Rk; Fri, 29 Sep 2023 03:46:20 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=V9YwpQeCkauzo1t6wtV/sXYCW+Er6wSVuAYtCcP3BbI=; b=I1tXeHRQCrlB bgYo0L/uOxbu/IY0tZvCsCEAcdcdFSa5/MHvcmiJvAbk9jNx8hjXuEl4a23sCR5lLQMbERtbozDLS 6zrmBbVyq5IdD00ZrD77xjMxX+u4+4G82EEQ1GZIvGRbBfZoY6ytKC6Ki6QAQPh6jhRVIHKZ02CHW eimrpMO7aBZgSLL+iCLXhewXTY3n2w1fyRrj+kXBbhLUc1vrUuQNljq6Qi00WpGc+mBGY317UQz2n Gb/7MOqVau1ifVzJNfOa+fVeSo6bonp3uqsa2kdCvoh5lf/VfcVowQmqUXHhxFruPvOEC3PMv+aIe Ut2fgM/Ia4DESPppBkDDrw==; Date: Fri, 29 Sep 2023 10:45:57 +0300 Message-Id: <83bkdl1ky2.fsf@gnu.org> From: Eli Zaretskii To: Andrew Burgess Cc: gdb-patches@sourceware.org In-Reply-To: <87zg19vvvx.fsf@redhat.com> (message from Andrew Burgess on Tue, 26 Sep 2023 15:42:26 +0100) Subject: Re: [PATCH 07/10] gdb: add qMachineId packet References: <94e68e6c1400ede2e9e46fc8ef76bd82aa533e0e.1692200989.git.aburgess@redhat.com> <83y1ib6j5x.fsf@gnu.org> <87r0nr9nz7.fsf@redhat.com> <83zg2fmaj5.fsf@gnu.org> <87zg19vvvx.fsf@redhat.com> X-Spam-Status: No, score=0.6 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,SPF_HELO_PASS,SPF_PASS,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: > From: Andrew Burgess > Cc: gdb-patches@sourceware.org > Date: Tue, 26 Sep 2023 15:42:26 +0100 > > Eli Zaretskii writes: > > > No, @xref always produces "See". Where did you see it without "See"? > > Sorry Eli, I missed your reply here. > > I am using GNU texinfo 6.7, and I don't see @xref adding "See" when > generating 'info' output format. When producing 'pdf' output I do see > the "See" prefix. > > This is visible to me in the current GDB info page(s). > > For example, this paragraph in gdb.texinfo: > > If the architecture supports memory tagging, the @code{print} command will > display pointer/memory tag mismatches if what is being printed is a pointer > or reference type. @xref{Memory Tagging}. > > Is rendered like this in 'info' format: > > If the architecture supports memory tagging, the 'print' command will > display pointer/memory tag mismatches if what is being printed is a > pointer or reference type. *Note Memory Tagging::. > > I guess it has the '*Note ' prefix instead, but in contrast Yes, in Info format, @xref produces a capitalized "Note". (Emacs replaces that on display with "See", so I tend to forget about the actual conversion, sorry about that). And a capitalize "Note" is also inappropriate in the middle of a sentence. > This command allows to control the information printed when > the debugger prints a frame. See @ref{Frames}, @ref{Backtrace}, > for a general explanation about frames and frame information. > > Is rendered like this in 'info' format: > > This command allows to control the information printed when the > debugger prints a frame. See *note Frames::, *note Backtrace::, > for a general explanation about frames and frame information. > > Which I think is nicer, for me starting the sentence with 'Note' doesn't > seem as friendly. It's your personal preference, so I don't want to argue. It is suboptimal from my POV, which is why you will almost never see that in the Emacs manuals.