GNU bug report logs - #35793
27.0.50; Redundant "See" in the ELisp manual

Previous Next

Full log

Message #26 received at 35793 <at> debbugs.gnu.org (full text, mbox):

From: Mauro Aranda <maurooaranda <at> gmail.com>
To: Noam Postavsky <npostavs <at> gmail.com>
Cc: 35793 <at> debbugs.gnu.org
Subject: Re: bug#35793: 27.0.50; Redundant "See" in the ELisp manual
Date: Mon, 20 May 2019 17:55:46 -0300

[Message part 1 (text/plain, inline)]

Noam Postavsky <npostavs <at> gmail.com> writes:

> Mauro Aranda <maurooaranda <at> gmail.com> writes:
>
>>> ../../../doc/misc/gnus.texi:3099: warning: `.' or `,' must follow
@xref, not `f'.
>>> ../../../doc/misc//gnus-faq.texi:710: warning: `.' or `,' must follow
@xref, not `f'.
>>
>> Right.  My version of makeinfo (6.1) doesn't warn about that.
>
> Hmm, I'm using version 4.13 (because it's faster); if newer versions
> don't warn about this, maybe we should ignore these warnings.

IMO, it's fairly easy to avoid these warnings, so I wouldn't suggest
modifications that introduce them.

BTW, one of the hits you reported, namely:
./misc/gnus.texi:3115:See @pxref{Group Mail Splitting} to automatically
split on group

looks like is from the master branch and would produce the same warning
with the previous patch.

So I attach a new patch, that covers all the hits of redundant "See"s
found, and don't produce warnings, AFAICS.

Best regards,
Mauro.

[Message part 2 (text/html, inline)]

[0001-Remove-redundants-See-before-xref-or-pxref-Bug-35793.patch (text/x-patch, attachment)]

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.