From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#37078: 27.0.50; Proposal: new introductory section to the Gnus manual Date: Sat, 25 Jul 2020 09:11:24 +0300 Message-ID: <838sf8dsz7.fsf@gnu.org> References: <87sgpym539.fsf@ericabrahamsen.net> <878spcn9d6.fsf@gnus.org> <878spck0xj.fsf@ericabrahamsen.net> <87h7u3o6ok.fsf@gnus.org> <87zh7uah73.fsf@ericabrahamsen.net> <87pn8qikkp.fsf@gnus.org> <87mu3u9i9g.fsf@ericabrahamsen.net> <87sgdjtidu.fsf@ericabrahamsen.net> <838sfafkno.fsf@gnu.org> <87zh7qrwv1.fsf@ericabrahamsen.net> <834kpyf7pg.fsf@gnu.org> <87y2n8rbo0.fsf@ericabrahamsen.net> <83d04kenov.fsf@gnu.org> <87h7twaaez.fsf@ericabrahamsen.net> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="14315"; mail-complaints-to="usenet@ciao.gmane.io" Cc: larsi@gnus.org, 37078@debbugs.gnu.org To: Eric Abrahamsen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Jul 25 08:12:12 2020 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1jzDPm-0003aw-OL for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 25 Jul 2020 08:12:10 +0200 Original-Received: from localhost ([::1]:33750 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jzDPl-0001bQ-0Z for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 25 Jul 2020 02:12:09 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:51332) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jzDPe-0001b7-FZ for bug-gnu-emacs@gnu.org; Sat, 25 Jul 2020 02:12:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:37639) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jzDPe-0008To-6m for bug-gnu-emacs@gnu.org; Sat, 25 Jul 2020 02:12:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1jzDPe-0004GZ-1H for bug-gnu-emacs@gnu.org; Sat, 25 Jul 2020 02:12:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 25 Jul 2020 06:12:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 37078 X-GNU-PR-Package: emacs Original-Received: via spool by 37078-submit@debbugs.gnu.org id=B37078.159565750516372 (code B ref 37078); Sat, 25 Jul 2020 06:12:01 +0000 Original-Received: (at 37078) by debbugs.gnu.org; 25 Jul 2020 06:11:45 +0000 Original-Received: from localhost ([127.0.0.1]:49185 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jzDPN-0004Fz-AR for submit@debbugs.gnu.org; Sat, 25 Jul 2020 02:11:45 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:57772) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jzDPL-0004Fm-Ce for 37078@debbugs.gnu.org; Sat, 25 Jul 2020 02:11:43 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:40835) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jzDPF-0008RS-Og; Sat, 25 Jul 2020 02:11:37 -0400 Original-Received: from [176.228.60.248] (port=2500 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1jzDPF-0004gD-4X; Sat, 25 Jul 2020 02:11:37 -0400 In-Reply-To: <87h7twaaez.fsf@ericabrahamsen.net> (message from Eric Abrahamsen on Fri, 24 Jul 2020 14:08:20 -0700) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:183517 Archived-At: > From: Eric Abrahamsen > Cc: larsi@gnus.org, 37078@debbugs.gnu.org > Date: Fri, 24 Jul 2020 14:08:20 -0700 > > > "See @pxref" again. > > > >> +per-group (see @pxref{Mail Sources} for more information). > > > > Same here. > > Okay there's something funny going on here. When I run "make" with this > exact diff, the output looks exactly right: "See _Finding the News_ for > details." Same with your other, later notes. If I "C-x C-f" from the > info manual (now I'm in "/info/") and open gnus.info, I > see there is no "See" in the text, just "*note Finding the News:: for > details." > > Playing with this further, the info display seems to be inserting a > "see" if there isn't one, and not if there is. That's right, you need to look at the file itself, or reset Info-hide-note-references to nil inside Info. > In the info manual for the texinfo package on my system, it says all > three reference commands (@xref, @ref, and @pxref) will insert a see. I think you are misinterpreting the Texinfo manual, or maybe judging by the Info mode display, not the real Info file. In the Info format, the cross-reference marker is "*note ", not "See". The latter appears in the printed manual. And @ref doesn't generate "see" in the printed manual, it leaves that to you, so that you could, for example, say something like "this-and-that, as described in @ref{foo}". > I'm not seeing any doubled "see"s in the output, though. You should see "see *note " in the output, which is already a sign of trouble. And in printed output, you will see a duplicate "see". > The texinfo package version on Arch linux is 6.7-3. Could behavior be > different between versions? Not this one, no. > Anyway, I've edited my diff according to your notes, please take a look. Mostly okay, see below. > +using interactive commands in the Server buffer. @ref{Finding > +the News} for details. ^^^^ You want @xref here, and please remember the comma after the closing brace. > +messages, see @ref{Summary Mail Commands} for details. ^ A comma there is missing.