From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Noam Postavsky Newsgroups: gmane.emacs.bugs Subject: bug#35793: 27.0.50; Redundant "See" in the ELisp manual Date: Sun, 19 May 2019 08:14:40 -0400 Message-ID: <87a7fid4jz.fsf@gmail.com> References: Mime-Version: 1.0 Content-Type: text/plain Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="156144"; mail-complaints-to="usenet@blaine.gmane.org" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.2 (gnu/linux) Cc: 35793@debbugs.gnu.org To: Mauro Aranda Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun May 19 14:15:17 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1hSKif-000ePE-Vk for geb-bug-gnu-emacs@m.gmane.org; Sun, 19 May 2019 14:15:14 +0200 Original-Received: from localhost ([127.0.0.1]:47990 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hSKif-0006Sf-0A for geb-bug-gnu-emacs@m.gmane.org; Sun, 19 May 2019 08:15:13 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:39161) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hSKiV-0006SL-Mz for bug-gnu-emacs@gnu.org; Sun, 19 May 2019 08:15:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hSKiU-00011Z-Ld for bug-gnu-emacs@gnu.org; Sun, 19 May 2019 08:15:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:48786) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hSKiU-00011V-IA for bug-gnu-emacs@gnu.org; Sun, 19 May 2019 08:15:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hSKiU-000096-30 for bug-gnu-emacs@gnu.org; Sun, 19 May 2019 08:15:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Noam Postavsky Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 19 May 2019 12:15:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 35793 X-GNU-PR-Package: emacs Original-Received: via spool by 35793-submit@debbugs.gnu.org id=B35793.1558268090525 (code B ref 35793); Sun, 19 May 2019 12:15:02 +0000 Original-Received: (at 35793) by debbugs.gnu.org; 19 May 2019 12:14:50 +0000 Original-Received: from localhost ([127.0.0.1]:34097 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hSKiI-00008P-8G for submit@debbugs.gnu.org; Sun, 19 May 2019 08:14:50 -0400 Original-Received: from mail-io1-f45.google.com ([209.85.166.45]:39525) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hSKiF-00008A-Ml for 35793@debbugs.gnu.org; Sun, 19 May 2019 08:14:48 -0400 Original-Received: by mail-io1-f45.google.com with SMTP id m7so8920544ioa.6 for <35793@debbugs.gnu.org>; Sun, 19 May 2019 05:14:47 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=skE11+f5JGmkComIImGVywLCczxotvQ0P6RzirAAUWc=; b=iHF0xu8ds9+UIdPljl34o5LK2mh5+XFo3D/MacxhDoY3DzOHYd3piJET/C+8wflkw3 idDeHQlzwWpCbs399sBMupODL+ILQjmX13RkII0dajMtlMx52Ozvn0xNEfkwoEP73ZY/ L85xmyjWmYzP9wslZXsXZwM3dSugBYO90QHiUTEV9pzRAWdb96tMLO+OdAh6MLAbvyf8 7pfnIa9d9y2sLXDc8lFmeYxmzozteZw8op79SUFGHS/nqvIdSO+XmtAcbbfRD62y5bsC LqGByTbBSc3MS6MQrusO6E+gBlhu2mulEYo0E87cp95BNgPT41HIrYzRo2mKdLK+BqAc yQGQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version; bh=skE11+f5JGmkComIImGVywLCczxotvQ0P6RzirAAUWc=; b=svVB3vUe5WNP/9/E3UJI/NmrBqxOamTp3RkStpPLOcAB2ip3vYJfk9exgE0M7vsuqx jpb241NULyY8enhwx9X8ODiJvHGB6008wAy21FLmEEbiIExMYj/VBVUSEcePBBTIcQ0o 5ZjsDYgvd15LcwifwMIQT0bhOhvdfAHQjuTrqo3eYE5QxqVptWKIANob/CMc24VqCSnY 1Wc8+2RnmzSy7kZTo0qOHWUYgt+KWG2W2iuUWWoHbrKwRa5RLou6MCzrFNzdvz2P+43r yrzSWAHFWocw6Y/S+dp2y/bH0Slexkl6R6vqDaw7YgD5u6G2VRK8PPj+JBcnHckc0bAa DWZA== X-Gm-Message-State: APjAAAWqIqDuKEcR7O2E4oJSRefZ4mrEs4XlhqLEi2Yqy+9n4gVCIdlW fqhU3zsG5jQxL9PAka/OhaTv32HJ X-Google-Smtp-Source: APXvYqy5uzZn3BRk4Bv4jM0bkD3nHVJA4QnN+dX5RCKDkBFtl58iHbE4pL0gs9sWxwj5Vty8X3TjiA== X-Received: by 2002:a6b:400a:: with SMTP id k10mr18117923ioa.291.1558268081973; Sun, 19 May 2019 05:14:41 -0700 (PDT) Original-Received: from minid (cbl-45-2-119-34.yyz.frontiernetworks.ca. [45.2.119.34]) by smtp.gmail.com with ESMTPSA id x11sm4652229ioj.49.2019.05.19.05.14.40 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Sun, 19 May 2019 05:14:40 -0700 (PDT) In-Reply-To: (Mauro Aranda's message of "Sat, 18 May 2019 17:57:08 -0300") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 209.51.188.43 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.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:159534 Archived-At: Mauro Aranda 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. > * 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? ./lispref/positions.texi:843:the first letter. See @xref{Regular Expressions}. Character classes ./lispref/positions.texi:844:can also be used, e.g., @code{"[:alnum:]"}. See @pxref{Char Classes}. ./lispref/modes.texi:3017:For details, see @xref{Multiline Font Lock}. ./lispref/control.texi:1454:iterators. See @xref{Loop Facility,,,cl,Common Lisp Extensions}. ./lispref/functions.texi:2377:explicitly risky (see @pxref{File Local Variables}). ./misc/dired-x.texi:899:done. See @xref{Optional Installation File At Point}. ./misc/dired-x.texi:907:@code{find-file-other-window}. See @xref{Optional Installation File At Point}. ./misc/gnus-faq.texi:710:POP3 mail source. See @pxref{Mail Source Specifiers} for VALUE. ./misc/gnus.texi:3097:See @pxref{Sieve Commands} for commands and variables that might be of ./misc/gnus.texi:3115:See @pxref{Group Mail Splitting} to automatically split on group ./misc/gnus.texi:12859:the corresponding parenthetical matches (see @xref{Replacing Match,, ./misc/gnus.texi:24245:events. See @xref{Extending the Spam package}. ./misc/eudc.texi:609:This variable has protocol-local definitions (see @pxref{Server/Protocol ./misc/eudc.texi:717:or server local fashion (see @pxref{Server/Protocol Locals}). ./misc/dbus.texi:1931:Incoming D-Bus messages are handled as Emacs events, see @pxref{Misc ./misc/dbus.texi:1955:this message (see @pxref{Signals}). When a @code{dbus-event} event ./misc/org.texi:10293:export}) or transcode the math into images (see @pxref{Previewing @LaTeX{} ./misc/org.texi:10359:used for inclusion while exporting to HTML (see @pxref{@LaTeX{} fragments}), ./misc/reftex.texi:3700:menu. See @xref{Key Bindings}. ./misc/cc-mode.texi:1063:where Emacs does auto-filling (see @pxref{Custom Filling and ./misc/cc-mode.texi:1481:inserted (see @pxref{Custom Auto-newlines}). Typically, the style ./misc/cc-mode.texi:6856:see @xref{Macros with ;}.