GNU bug report logs - #46943
27.1; "see @xref" should be "see @ref" in tramp manual

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 46943 in the body.
You can then email your comments to 46943 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

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

From: tsuucat <tsuucat <at> icloud.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 27.1; "see @xref" should be "see @ref" in tramp manual
Date: Fri, 5 Mar 2021 20:59:47 +0900

Hi,

this is tiny patch.

Without this, generated html produces “see See …”.

(See current online manual
https://www.gnu.org/software/emacs/manual/html_node/tramp/Remote-shell-setup.html)


diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi
index 0a968e3945..8eaac14763 100644
--- a/doc/misc/tramp.texi
+++ b/doc/misc/tramp.texi
@@ -2150,7 +2150,7 @@ Remote shell setup

 Per default, @value{tramp} uses the command @command{/bin/sh} for
 starting a shell on the remote host.  This can be changed by setting
-the connection property @t{"remote-shell"}, see @xref{Predefined
+the connection property @t{"remote-shell"}, see @ref{Predefined
 connection information}.  If you want, for example, use
 @command{/usr/bin/zsh} on a remote host, you might apply

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

From: "Basil L. Contovounesios" <contovob <at> tcd.ie>
To: 46943 <at> debbugs.gnu.org
Cc: tsuucat <tsuucat <at> icloud.com>
Subject: Re: bug#46943: 27.1; "see @xref" should be "see @ref" in tramp manual
Date: Fri, 05 Mar 2021 13:07:02 +0000

reassign 46943 emacs,tramp
quit

tsuucat via "Bug reports for GNU Emacs, the Swiss army knife of text
editors" <bug-gnu-emacs <at> gnu.org> writes:

> Without this, generated html produces “see See …”.
[...]
>  Per default, @value{tramp} uses the command @command{/bin/sh} for
>  starting a shell on the remote host.  This can be changed by setting
> -the connection property @t{"remote-shell"}, see @xref{Predefined
> +the connection property @t{"remote-shell"}, see @ref{Predefined
>  connection information}.  If you want, for example, use
>  @command{/usr/bin/zsh} on a remote host, you might apply

Don't know if it makes any difference, but FWIW you can also end
sentences with @pxref:

  the connection property @t{"remote-shell"}, @pxref{Predefined
  connection information}.

Thanks,

-- 
Basil

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

From: Michael Albinus <michael.albinus <at> gmx.de>
To: tsuucat via "Bug reports for GNU Emacs, the Swiss army knife of text
 editors" <bug-gnu-emacs <at> gnu.org>
Cc: 46943-done <at> debbugs.gnu.org, tsuucat <tsuucat <at> icloud.com>
Subject: Re: bug#46943: 27.1; "see @xref" should be "see @ref" in tramp manual
Date: Fri, 05 Mar 2021 17:53:26 +0100

Version: 27.2

tsuucat via "Bug reports for GNU Emacs, the Swiss army knife of text
editors" <bug-gnu-emacs <at> gnu.org> writes:

> Hi,

Hi,

> this is tiny patch.
>
> Without this, generated html produces “see See …”.

Thanks, I've applied it to both emacs-27 and master branches.

Best regards, Michael.

Previous Next

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