[Emacs-diffs] emacs-25 3772f44: Port Tramp manual to latest Texinfo

[Paul Eggert]

branch: emacs-25
commit 3772f444228a07404c5af1fdf67a220025d37645
Author: Paul Eggert <address@hidden>
Commit: Paul Eggert <address@hidden>

    Port Tramp manual to latest Texinfo
    
    Otherwise, 'make pdf' did not work (Bug#22416).
    * doc/misc/tramp.texi (xxx, yyy): Remove macros.
    (trampfn): Specialize to the case where METHOD is nonempty.
    The 2nd argument is now address@hidden, not 2nd user and 3rd host args.
    All uses changed.
    (trampf): New macro.
---
 doc/misc/tramp.texi |  214 +++++++++++++++++++++-----------------------------
 1 files changed, 90 insertions(+), 124 deletions(-)

diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi
index eafd238..1b2b89e 100644
--- a/doc/misc/tramp.texi
+++ b/doc/misc/tramp.texi
@@ -18,52 +18,21 @@
 @include trampver.texi
 
 @c Macro for formatting a file name according to the respective syntax.
address@hidden xxx and yyy are auxiliary macros in order to omit leading and
address@hidden Macro arguments should not have any leading or
 @c trailing whitespace.  Not very elegant, but I don't know it better.
 
address@hidden There are subtle differences between texinfo 4.13 and 5.0.  We 
must
address@hidden declare two versions of the macro.  This will be improved, 
hopefully.
-
address@hidden Texinfo 5.0.
address@hidden txicommandconditionals
address@hidden xxx {one}
address@hidden \one\
address@hidden macro
-
address@hidden yyy {one, two}
address@hidden@c
address@hidden x
address@hidden@c
address@hidden ifclear
address@hidden x\one\
address@hidden macro
-
address@hidden trampfn {method, user, host, localname}
address@hidden trampfn {method, userhost, localname}
 @address@hidden
address@hidden,@address@hidden
address@hidden,@@address@hidden
address@hidden
address@hidden@c
address@hidden
 @end macro
address@hidden ifset
 
address@hidden Texinfo 4.13.
address@hidden txicommandconditionals
address@hidden xxx address@hidden
address@hidden address@hidden
address@hidden macro
-
address@hidden yyy {one, address@hidden
address@hidden@c
address@hidden address@hidden
address@hidden@c
address@hidden ifclear
address@hidden address@hidden
address@hidden macro
address@hidden Similar, but without a method prefix.
 
address@hidden trampfn {method, user, host, address@hidden
address@hidden@yyy{\method\,@address@hidden,@@address@hidden@c
address@hidden trampf {userhost, localname}
address@hidden@c
address@hidden
 @end macro
address@hidden ifclear
 
 @copying
 Copyright @copyright{} 1999--2016 Free Software Foundation, Inc.
@@ -499,7 +468,7 @@ In December 2001, XEmacs package repository adds 
@value{tramp}.
 
 @value{tramp} is initially configured to use the @command{scp} program
 to connect to the remote host.  Just type @kbd{C-x C-f} and then enter
-file name @address@hidden, user, host, /path/to.file}}.  For details,
+file name @address@hidden@@host,/path/to.file}}.  For details,
 see @xref{Default Method}.
 
 For problems related to the behavior of remote shell, see @ref{Remote
@@ -913,7 +882,7 @@ authorization, @value{tramp} provides for an extended 
syntax in
 percent symbol, and domain is the windows domain name).  An example:
 
 @example
address@hidden, daniel%BIZARRE, melancholia, /daniel$$/.emacs}
address@hidden,daniel%BIZARRE@@melancholia,/daniel$$/.emacs}
 @end example
 
 where user @code{daniel} connects as a domain user to the SMB host
@@ -925,7 +894,7 @@ substitute the domain name with the name of the local host 
in
 UPPERCASE as shown here:
 
 @example
address@hidden, daniel%MELANCHOLIA, melancholia, /daniel$$/.emacs}
address@hidden,daniel%MELANCHOLIA@@melancholia,/daniel$$/.emacs}
 @end example
 
 where user @code{daniel} connects as local user to the SMB host
@@ -969,7 +938,7 @@ the custom option 
@option{tramp-adb-connect-if-not-connected} is not
 
 @value{tramp} does not require a host name part of the remote file
 name when a single Android device is connected to @command{adb}.
address@hidden instead uses @address@hidden, , ,}} as the default
address@hidden instead uses @address@hidden,,}} as the default
 name.  @command{adb devices} shows available host names.
 
 @option{adb} method normally does not need user name to authenticate
@@ -1011,7 +980,7 @@ active, @pxref{Top, , D-Bus, dbus}.
 This method is for connecting to remote hosts with the Apple Filing
 Protocol for accessing files on Mac OS X volumes.  @value{tramp} access
 syntax requires a leading volume (share) name, for example:
address@hidden@trampfn{afp, user, host, /volume}}.
address@hidden@trampfn{afp,user@@host,/volume}}.
 
 @item @option{dav}
 @item @option{davs}
@@ -1179,7 +1148,7 @@ access and it has the most reasonable security protocols, 
use
 @file{/etc/motd} file on the otherhost:
 
 @example
address@hidden C-f @trampfn{ssh, root, otherhost,/etc/motd} @key{RET}}
address@hidden C-f @trampfn{ssh,root@@otherhost,/etc/motd} @key{RET}}
 @end example
 
 If @option{ssh} is unavailable for whatever reason, look for other
@@ -1190,7 +1159,7 @@ For editing local files as @option{su} or @option{sudo} 
methods, try
 the shortened syntax of @samp{root}:
 
 @example
address@hidden C-f @trampfn{su, , , /etc/motd} @key{RET}}
address@hidden C-f @trampfn{su,,/etc/motd} @key{RET}}
 @end example
 
 For editing large files, @option{scp} is faster than @option{ssh}.
@@ -1263,7 +1232,7 @@ default user and default host can be overridden as 
follows:
       tramp-default-host "target")
 @end lisp
 
-With both defaults set, @address@hidden, , ,}} will connect
+With both defaults set, @address@hidden,,}} will connect
 @value{tramp} to John's home directory on target.
 
 @ifset emacs
@@ -1323,7 +1292,7 @@ user @samp{bird} to reach remote hosts outside the local 
domain:
 
 @lisp
 (add-to-list 'tramp-default-proxies-alist
-             '("\\." nil "@trampfn{ssh, bird, bastion.your.domain,}"))
+             '("\\." nil "@trampfn{ssh,bird@@bastion.your.domain,}"))
 (add-to-list 'tramp-default-proxies-alist
              '("\\.your\\.domain\\'" nil nil))
 @end lisp
@@ -1339,7 +1308,7 @@ connect to @samp{bastion.your.domain}, then:
 (add-to-list 'tramp-default-proxies-alist
              '("\\`bastion\\.your\\.domain\\'"
                "\\`bird\\'"
-               "@trampfn{ssh, , jump.your.domain,}"))
+               "@trampfn{ssh,jump.your.domain,}"))
 @end lisp
 
 @var{proxy} can take patterns @code{%h} or @code{%u} for @var{host} or
@@ -1351,10 +1320,10 @@ access, then use this alist entry:
 
 @lisp
 (add-to-list 'tramp-default-proxies-alist
-             '("\\.your\\.domain\\'" "\\`root\\'" "@trampfn{ssh, , %h,}"))
+             '("\\.your\\.domain\\'" "\\`root\\'" "@trampfn{ssh,%h,}"))
 @end lisp
 
-Opening @address@hidden, , randomhost.your.domain,}} first
+Opening @address@hidden,randomhost.your.domain,}} first
 connects to @samp{randomhost.your.domain} via @code{ssh} under your
 account name, and then perform @code{sudo -u root} on that host.
 
@@ -1370,7 +1339,7 @@ local one, first connect via @command{ssh}, and then apply
 
 @lisp
 (add-to-list 'tramp-default-proxies-alist
-             '(nil "\\`root\\'" "@trampfn{ssh, , %h,}"))
+             '(nil "\\`root\\'" "@trampfn{ssh,%h,}"))
 (add-to-list 'tramp-default-proxies-alist
              '((regexp-quote (system-name)) nil nil))
 @end lisp
@@ -1395,7 +1364,7 @@ discussion of ethical issues.}  Then the configuration is:
 @lisp
 (add-to-list 'tramp-default-proxies-alist
              '("\\`host\\.other\\.domain\\'" nil
-             "@trampfn{tunnel, , proxy.your.domain#3128,}"))
+             "@trampfn{tunnel,proxy.your.domain#3128,}"))
 @end lisp
 
 Gateway methods in a multiple hop chain can be declared only as the first hop.
@@ -1647,8 +1616,7 @@ cases, two different connections may result in the same 
persistent
 information.  For example, connecting to a host using @command{ssh} and
 connecting to the same host through @code{sshd} on port 3001.  Both
 access methods result in nearly identical persistent specifications
address@hidden@trampfn{ssh, , localhost,}} and @address@hidden, ,
-localhost#3001,}}.
address@hidden@trampfn{ssh,localhost,}} and @address@hidden,localhost#3001,}}.
 
 Changing host names could avoid duplicates.  One way is to add a
 @option{Host} section in @file{~/.ssh/config} (@pxref{Frequently Asked
@@ -1680,10 +1648,10 @@ remote shell:
 
 @lisp
 (add-to-list 'tramp-connection-properties
-             (list (regexp-quote "@trampfn{ssh, user, 
randomhost.your.domain,}")
+             (list (regexp-quote "@trampfn{ssh,user@@randomhost.your.domain,}")
                    "remote-shell" "/bin/ksh"))
 (add-to-list 'tramp-connection-properties
-             (list (regexp-quote "@trampfn{ssh, user, 
randomhost.your.domain,}")
+             (list (regexp-quote "@trampfn{ssh,user@@randomhost.your.domain,}")
                    "remote-shell-login" '("-")))
 @end lisp
 
@@ -1699,7 +1667,7 @@ special property @samp{busybox}.  For example:
 
 @lisp
 (add-to-list 'tramp-connection-properties
-             (list (regexp-quote "@trampfn{ssh, user, 
randomhost.your.domain,}")
+             (list (regexp-quote "@trampfn{ssh,user@@randomhost.your.domain,}")
                    "busybox" t))
 @end lisp
 
@@ -2002,8 +1970,8 @@ directory for temporary files:
 @end lisp
 
 @noindent
-Open a remote connection with the command @kbd{C-x C-f @trampfn{ssh, ,
-192.168.0.26#2222, }}, where @command{sshd} is listening on port
+Open a remote connection with the command @kbd{C-x C-f
address@hidden,192.168.0.26#2222,}}, where @command{sshd} is listening on port
 @samp{2222}.
 
 To add a corresponding entry to the @file{~/.ssh/config} file
@@ -2027,7 +1995,7 @@ the previous example, fix the connection properties as 
follows:
 
 @noindent
 Open a remote connection with a more concise command @kbd{C-x C-f
address@hidden, , android, }}.
address@hidden,android,}}.
 
 
 @node Auto-save and Backup
@@ -2056,7 +2024,7 @@ exposed.  @value{emacsname} by default writes backup 
files to the same
 directory as the original files unless changed to another location,
 such as @file{~/.emacs.d/backups/}.  Such a directory will also be used
 by default by @value{tramp} when using, say, a restricted file
address@hidden@trampfn{su, root, localhost, /etc/secretfile}}.  The backup file
address@hidden@trampfn{su,root@@localhost,/etc/secretfile}}.  The backup file
 of the secretfile is now owned by the user logged in from tramp and
 not root.
 
@@ -2145,15 +2113,13 @@ Example:
 @end ifset
 
 @noindent
-The backup file name of @address@hidden, root, localhost,
-/etc/secretfile}} would be
+The backup file name of
address@hidden@trampfn{su,root@@localhost,/etc/secretfile}} would be
 @ifset emacs
address@hidden@trampfn{su, root, localhost,
-~/.emacs.d/backups/!su:root@@localhost:!etc!secretfile~}}
address@hidden@trampfn{su,root@@localhost,~/.emacs.d/backups/!su:root@@localhost:!etc!secretfile~}}
 @end ifset
 @ifset xemacs
address@hidden@trampfn{su, root, localhost,
-~/.emacs.d/backups/![su!root@@localhost]!etc!secretfile~}}
address@hidden@trampfn{su,root@@localhost,~/.emacs.d/backups/![su!root@@localhost]!etc!secretfile~}}
 @end ifset
 
 Just as for backup files, similar issues of file naming affect
@@ -2263,7 +2229,7 @@ passwords or authentication appear in the minibuffer.  
Hitting
 @cindex file name syntax
 @cindex file name examples
 
address@hidden@trampfn{, , host, localfilename}}
address@hidden@trampf{host,localfilename}}
 opens file @var{localfilename} on the remote host @var{host}, using
 the default method.  @xref{Default Method}.
 
@@ -2289,9 +2255,9 @@ For the file @file{/etc/squid.conf} on the host 
@code{melancholia}.
 
 @end table
 
address@hidden can take IPv4 or IPv6 address, as in @address@hidden, ,
-127.0.0.1, .emacs}} or @address@hidden, ,
address@hidden::address@hidden, .emacs}}.
address@hidden can take IPv4 or IPv6 address, as in
address@hidden@trampf{127.0.0.1,.emacs}} or
address@hidden@address@hidden::address@hidden,.emacs}}.
 @ifset emacs
 For syntactical reasons, IPv6 addresses must be embedded in square
 brackets @address@hidden and @address@hidden
@@ -2302,10 +2268,10 @@ remote user name for log in to the remote host.  
Specifying a different
 name using the proper syntax will override this default behavior:
 
 @example
address@hidden, user, host, path/to.file}
address@hidden@@host,path/to.file}
 @end example
 
address@hidden@trampfn{, daniel, melancholia, .emacs}} is for file
address@hidden@trampf{daniel@@melancholia,.emacs}} is for file
 @file{.emacs} in @code{daniel}'s home directory on the host,
 @code{melancholia}.
 
@@ -2326,15 +2292,14 @@ The syntax specifications for user, host, and file do 
not change.
 
 To connect to the host @code{melancholia} as @code{daniel}, using
 @option{ssh} method for @file{.emacs} in @code{daniel}'s home
-directory, the full specification is: @address@hidden, daniel,
-melancholia, .emacs}}.
+directory, the full specification is:
address@hidden@trampfn{ssh,daniel@@melancholia,.emacs}}.
 
 A remote file name containing a host name, which is the same string as
 a method name, is not allowed.
 
 For specifying port numbers, affix @file{#<port>} to the host
-name.  For example: @address@hidden, daniel, melancholia#42,
-.emacs}}.
+name.  For example: @address@hidden,daniel@@melancholia#42,.emacs}}.
 
 
 @node File name completion
@@ -2355,7 +2320,7 @@ For example, type @kbd{C-x C-f @value{prefix}t @key{TAB}},
 @value{tramp} completion choices show up as
 
 @example
address@hidden @multitable address@hidden, , melancholia.danann.net,}} 
address@hidden, , 192.168.0.1,}}
address@hidden @multitable address@hidden,melancholia.danann.net,}} 
address@hidden,192.168.0.1,}}
 @multitable @columnfractions .5 .5
 @ifset emacs
 @item @address@hidden @tab tmp/
@@ -2382,10 +2347,11 @@ shows host names @value{tramp} from @file{/etc/hosts} 
file, for example.
 
 @example
 @multitable @columnfractions .5 .5
address@hidden @multitable address@hidden, , melancholia.danann.net,}} 
address@hidden, , 192.168.0.1,}}
address@hidden @trampfn{telnet, , 127.0.0.1,} @tab @trampfn{telnet, , 
192.168.0.1,}
address@hidden @trampfn{telnet, , @value{ipv6prefix}::address@hidden,} @tab 
@trampfn{telnet, , localhost,}
address@hidden @trampfn{telnet, , melancholia.danann.net,} @tab 
@trampfn{telnet, , melancholia,}
address@hidden @multitable address@hidden,melancholia.danann.net,}} 
address@hidden,192.168.0.1,}}
address@hidden @trampfn{telnet,127.0.0.1,} @tab @trampfn{telnet,192.168.0.1,}
address@hidden @item @trampfn{telnet,@value{ipv6prefix}::address@hidden,} @tab 
@trampfn{telnet,localhost,}
address@hidden @address@hidden@value{ipv6prefix}::address@hidden@value{postfix} 
@tab @trampfn{telnet,localhost,}
address@hidden @trampfn{telnet,melancholia.danann.net,} @tab 
@trampfn{telnet,melancholia,}
 @end multitable
 @end example
 
@@ -2415,21 +2381,21 @@ Example:
 
 @example
 @ifset emacs
address@hidden C-f @trampfn{telnet, , melancholia, /usr/local/bin//etc} 
@key{TAB}}
-     @print{} @trampfn{telnet, , melancholia, /etc}
address@hidden C-f @trampfn{telnet,melancholia,/usr/local/bin//etc} @key{TAB}}
+     @print{} @trampfn{telnet,melancholia,/etc}
 
address@hidden C-f @trampfn{telnet, , melancholia, //etc} @key{TAB}}
address@hidden C-f @trampfn{telnet,melancholia,//etc} @key{TAB}}
      @print{} /etc
 
address@hidden C-f @trampfn{telnet, , melancholia, /usr/local/bin///etc} 
@key{TAB}}
address@hidden C-f @trampfn{telnet,melancholia,/usr/local/bin///etc} @key{TAB}}
      @print{} /etc
 @end ifset
 
 @ifset xemacs
address@hidden C-f @trampfn{telnet, , melancholia, /usr/local/bin//}}
-     @print{} @trampfn{telnet, , melancholia, /}
address@hidden C-f @trampfn{telnet,melancholia,/usr/local/bin//}}
+     @print{} @trampfn{telnet,melancholia,/}
 
address@hidden C-f @trampfn{telnet, , melancholia, //}}
address@hidden C-f @trampfn{telnet,melancholia,//}}
      @print{} /
 @end ifset
 @end example
@@ -2464,8 +2430,7 @@ remote host name and file name.  For example, hopping 
over a single
 proxy @samp{bird@@bastion} to a remote file on @samp{you@@remotehost}:
 
 @example
address@hidden @kbd{C-x C-f @address@hidden@@bastion|ssh, you,
address@hidden remotehost, /path}}
address@hidden @kbd{C-x C-f @address@hidden@@bastion|ssh,you,remotehost,/path}}
 @kbd{C-x C-f @address@hidden@@bastion|address@hidden@@address@hidden/path}
 @end example
 
@@ -2475,7 +2440,7 @@ Proxies can take patterns @code{%h} or @code{%u}.
 @code{tramp-default-proxies-alist} and is available for re-use during
 that @value{emacsname} session.  Subsequent @value{tramp} connections
 to the same remote host can then use the shortcut form:
address@hidden@trampfn{ssh, you, remotehost, /path}}.
address@hidden@trampfn{ssh,you@@remotehost,/path}}.
 
 @defopt tramp-save-ad-hoc-proxies
 @vindex tramp-save-ad-hoc-proxies
@@ -2631,7 +2596,7 @@ on remote hosts and displays output in buffers on the 
local
 host.  Example:
 
 @example
address@hidden C-f @trampfn{sudo, , , } @key{RET}}
address@hidden C-f @trampfn{sudo,,} @key{RET}}
 @kbd{M-! tail -f /var/log/syslog.log & @key{RET}}
 @end example
 
@@ -2653,14 +2618,14 @@ You must add the module @code{eshell-tramp} to
 @kbd{M-x eshell} on a remote host:
 
 @example
address@hidden $} cd @trampfn{sudo, , , /etc} @key{RET}
address@hidden@trampfn{sudo, root, host, /etc} $} hostname @key{RET}
address@hidden $} cd @trampfn{sudo,,/etc} @key{RET}
address@hidden@trampfn{sudo,root@@host,/etc} $} hostname @key{RET}
 host
address@hidden@trampfn{sudo, root, host, /etc} $} id @key{RET}
address@hidden@trampfn{sudo,root@@host,/etc} $} id @key{RET}
 uid=0(root) gid=0(root) groups=0(root)
address@hidden@trampfn{sudo, root, host, /etc} $} find-file shadow @key{RET}
address@hidden@trampfn{sudo,root@@host,/etc} $} find-file shadow @key{RET}
 #<buffer shadow>
address@hidden@trampfn{sudo, root, host, /etc} $}
address@hidden@trampfn{sudo,root@@host,/etc} $}
 @end example
 
 @ifset emacs
@@ -2671,16 +2636,16 @@ uid=0(root) gid=0(root) groups=0(root)
 (@pxref{Multi-hops}):
 
 @example
address@hidden $} cd @trampfn{ssh, user, remotehost, /etc} @key{RET}
address@hidden@trampfn{ssh, user, remotehost, /etc} $} find-file shadow 
@key{RET}
-File is not readable: @trampfn{ssh, user, remotehost, /etc/shadow}
address@hidden@trampfn{ssh, user, remotehost, /etc} $} sudo find-file shadow 
@key{RET}
address@hidden $} cd @trampfn{ssh,user@@remotehost,/etc} @key{RET}
address@hidden@trampfn{ssh,user@@remotehost,/etc} $} find-file shadow @key{RET}
+File is not readable: @trampfn{ssh,user@@remotehost,/etc/shadow}
address@hidden@trampfn{ssh,user@@remotehost,/etc} $} sudo find-file shadow 
@key{RET}
 #<buffer shadow>
 
address@hidden@trampfn{ssh, user, remotehost, /etc} $} su - @key{RET}
address@hidden@trampfn{su, root, remotehost, /root} $} id @key{RET}
address@hidden@trampfn{ssh,user@@remotehost,/etc} $} su - @key{RET}
address@hidden@trampfn{su,root@@remotehost,/root} $} id @key{RET}
 uid=0(root) gid=0(root) groups=0(root)
address@hidden@trampfn{su, root, remotehost, /root} $}
address@hidden@trampfn{su,root@@remotehost,/root} $}
 @end example
 @end ifset
 
@@ -2702,11 +2667,11 @@ with a remote file name:
 
 @example
 @kbd{M-x gdb @key{RET}}
address@hidden gdb (like this):} gdb --annotate=3 @trampfn{ssh, , host, 
~/myprog} @key{RET}
address@hidden gdb (like this):} gdb --annotate=3 @trampfn{ssh,host,~/myprog} 
@key{RET}
 @end example
 
 Relative file names are based on the remote default directory.  When
address@hidden exists in @address@hidden, , host, /home/user}},
address@hidden exists in @address@hidden,host,/home/user}},
 valid calls include:
 
 @example
@@ -2761,8 +2726,9 @@ To open @command{powershell} as a remote shell, use this:
 This command flushes all connection related objects.  @option{vec} is
 the internal representation of a remote connection.  When called
 interactively, this command lists active remote connections in the
-minibuffer.  Each connection is of the format @address@hidden,
-user, host, }}.  Flushing remote connections also cleans the password
+minibuffer.  Each connection is of the format
address@hidden@trampfn{method,user@@host,}}.  Flushing remote connections also
+cleans the password
 cache (@pxref{Password handling}), file cache, connection cache
 (@pxref{Connection caching}), and connection buffers.
 @end deffn
@@ -3226,7 +3192,7 @@ HISTFILE=/dev/null
 How to shorten long file names when typing in @value{tramp}?
 
 Adapt several of these approaches to reduce typing.  If the full name
-is @address@hidden, news, news.my.domain, /opt/news/etc}}, then:
+is @address@hidden,news@@news.my.domain,/opt/news/etc}}, then:
 
 @enumerate
 
@@ -3241,11 +3207,11 @@ You can define default methods and user names for hosts,
       tramp-default-user "news")
 @end lisp
 
-The reduced typing: @kbd{C-x C-f @trampfn{, , news.my.domain, /opt/news/etc}}.
+The reduced typing: @kbd{C-x C-f @trampf{news.my.domain,/opt/news/etc}}.
 
 @strong{Note} that there are some useful shortcuts already.  Accessing
 your local host as @samp{root} user, is possible just by @kbd{C-x C-f
address@hidden, , ,}}.
address@hidden,,}}.
 
 @item
 Use configuration options of the access method:
@@ -3260,7 +3226,7 @@ Host xy
      User news
 @end example
 
-The reduced typing: @kbd{C-x C-f @trampfn{ssh, , xy, /opt/news/etc}}.
+The reduced typing: @kbd{C-x C-f @trampfn{ssh,xy,/opt/news/etc}}.
 
 Depending on the number of files in the directories, host names
 completion can further reduce key strokes: @kbd{C-x C-f
@@ -3274,7 +3240,7 @@ the minibuffer.  Environment variables are set either 
outside
 @value{emacsname} or inside @value{emacsname} with Lisp:
 
 @lisp
-(setenv "xy" "@trampfn{ssh, news, news.my.domain, /opt/news/etc/}")
+(setenv "xy" "@trampfn{ssh,news@@news.my.domain,/opt/news/etc/}")
 @end lisp
 
 The reduced typing: @kbd{C-x C-f $xy @key{RET}}.
@@ -3295,7 +3261,7 @@ Redefine another key sequence in @value{emacsname} for 
@kbd{C-x C-f}:
    (find-file
     (read-file-name
      "Find Tramp file: "
-     "@trampfn{ssh, news, news.my.domain, /opt/news/etc/}"))))
+     "@trampfn{ssh,news@@news.my.domain,/opt/news/etc/}"))))
 @end lisp
 
 Simply typing @kbd{C-x C-y} would prepare minibuffer editing of file
@@ -3312,7 +3278,7 @@ Abbreviation list expansion can be used to reduce typing 
long file names:
 @lisp
 (add-to-list
  'directory-abbrev-alist
- '("^/xy" . "@trampfn{ssh, news, news.my.domain, /opt/news/etc/}"))
+ '("^/xy" . "@trampfn{ssh,news@@news.my.domain,/opt/news/etc/}"))
 @end lisp
 
 The reduced typing: @kbd{C-x C-f /xy @key{RET}}.
@@ -3329,7 +3295,7 @@ minibuffer:
 
 @lisp
 (define-abbrev-table 'my-tramp-abbrev-table
-  '(("xy" "@trampfn{ssh, news, news.my.domain, /opt/news/etc/}")))
+  '(("xy" "@trampfn{ssh,news@@news.my.domain,/opt/news/etc/}")))
 
 (add-hook
  'minibuffer-setup-hook
@@ -3427,7 +3393,7 @@ directory to the cache:
 @lisp
 (eval-after-load "filecache"
   '(file-cache-add-directory
-    "@trampfn{ssh, news, news.my.domain, /opt/news/etc/}"))
+    "@trampfn{ssh,news@@news.my.domain,/opt/news/etc/}"))
 @end lisp
 
 Then use directory completion in the minibuffer with @kbd{C-x C-f
@@ -3479,11 +3445,11 @@ multi-hops}) via bookmarks, recent files,
 filecache, bbdb,
 @end ifset
 or another package, use the full ad-hoc file name including all hops,
-like @address@hidden, bird,
-bastion|address@hidden, /opt/news/etc}}.
+like
address@hidden@trampfn{ssh,bird@@bastion|address@hidden,/opt/news/etc}}.
 
 Alternatively, when saving abbreviated multi-hop file names
address@hidden@trampfn{ssh, news, news.my.domain, /opt/news/etc}}, the custom
address@hidden@trampfn{ssh,news@@news.my.domain,/opt/news/etc}}, the custom
 option @code{tramp-save-ad-hoc-proxies} must be set address@hidden
 value.
 
@@ -3516,7 +3482,7 @@ location.
 Then start Emacs Client from the command line:
 
 @example
-emacsclient @trampfn{ssh, user, host, /file/to/edit}
+emacsclient @trampfn{ssh,user@@host,/file/to/edit}
 @end example
 
 @code{user} and @code{host} refer to the local host.
@@ -3526,7 +3492,7 @@ script @file{emacsclient.sh}:
 
 @example
 #!/bin/sh
-emacsclient @trampfn{ssh, $(whoami), $(hostname --fqdn), $1}
+emacsclient @trampfn{ssh,$(whoami)@@$(hostname --fqdn),$1}
 @end example
 
 Then change the environment variable @env{EDITOR} to point to the