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

Previous Next

Full log

View this message in rfc822 format

From: Mauro Aranda <maurooaranda <at> gmail.com>
To: Noam Postavsky <npostavs <at> gmail.com>
Cc: 35793 <at> debbugs.gnu.org
Subject: bug#35793: 27.0.50; Redundant "See" in the ELisp manual
Date: Sun, 19 May 2019 10:49:21 -0300

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

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

> Mauro Aranda <maurooaranda <at> gmail.com> writes:
>
>> In the HTML format of the GNU Emacs Lisp Reference Manual, navigate to
>> the node Skipping Characters, under the node Motion.  There, look for
>> the cross references to Regular Expressions and to Char Classes, and
>> note the redundant "See".
>
> Hmm, the HTML output has a redundant "See", but the .info doesn't.  But
> I see the texinfo manual examples don't put "see" in front of @xref, so
> I guess it's just coincidence that it produces okay results for .info.

Yes.  Initially, I spotted the redundant "See" in HTML, and when I went
to my computer to fix them, I thought they were already fixed because I
couldn't see them in .info.  I don't know why .info doesn't show the
redundant "See".

>> * doc/lispref/positions.texi (Skipping Characters): Remove redundant
>>   "See" before cross references.  Change @xref to @pxref, which is
>>   more suitable when at the end of a sentence.  (Bug#35793)
>
> M-x rgrep RET [Ss]ee @.\?xref RET *.texi RET doc/ RET finds a few more
> hits in other manuals, could you fix those too please?

Of course Noam, but you should get credit for finding them.  The
attached patch should cover them.

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.