[Emacs-diffs] trunk r115993: * tramp.texi (all): Doc fix according to GNU Coding Standards.

[Michael Albinus]

------------------------------------------------------------
revno: 115993
revision-id: address@hidden
parent: address@hidden
committer: Michael Albinus <address@hidden>
branch nick: trunk
timestamp: Sun 2014-01-12 16:19:07 +0100
message:
  * tramp.texi (all): Doc fix according to GNU Coding Standards.
  Use "file name" instead of "filename" or "path".  Use "host"
  instead of "machine".
modified:
  doc/misc/ChangeLog             changelog-20091113204419-o5vbwnq5f7feedwu-6331
  doc/misc/tramp.texi            tramp.texi-20091113204419-o5vbwnq5f7feedwu-6324

=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog        2014-01-12 14:25:10 +0000
+++ b/doc/misc/ChangeLog        2014-01-12 15:19:07 +0000
@@ -1,3 +1,9 @@
+2014-01-12  Michael Albinus  <address@hidden>
+
+       * tramp.texi (all): Doc fix according to GNU Coding Standards.
+       Use "file name" instead of "filename" or "path".  Use "host"
+       instead of "machine".
+
 2014-01-12  Xue Fuqiao  <address@hidden>
 
        * eww.texi (Basics): Use "directory" instead of "path" (Bug#16419).

=== modified file 'doc/misc/tramp.texi'
--- a/doc/misc/tramp.texi       2014-01-06 05:25:46 +0000
+++ b/doc/misc/tramp.texi       2014-01-12 15:19:07 +0000
@@ -17,7 +17,7 @@
 
 @include trampver.texi
 
address@hidden Macro for formatting a filename according to the respective 
syntax.
address@hidden Macro for formatting a file name according to the respective 
syntax.
 @c xxx and yyy are auxiliary macros in order to omit leading and
 @c trailing whitespace.  Not very elegant, but I don't know it better.
 
@@ -198,7 +198,7 @@
 
 Configuring @value{tramp} for use
 
-* Connection types::            Types of connections made to remote machines.
+* Connection types::            Types of connections made to remote hosts.
 * Inline methods::              Inline methods.
 * External methods::            External methods.
 @ifset emacsgvfs
@@ -217,7 +217,7 @@
 * Connection caching::          Reusing connection related information.
 * Predefined connection information::
                                 Setting own connection related information.
-* Remote Programs::             How @value{tramp} finds and uses programs on 
the remote machine.
+* Remote Programs::             How @value{tramp} finds and uses programs on 
the remote host.
 * Remote shell setup::          Remote shell setup hints.
 * Android shell setup::         Android shell setup hints.
 * Auto-save and Backup::        Auto-save and Backup.
@@ -225,8 +225,8 @@
 
 Using @value{tramp}
 
-* Filename Syntax::             @value{tramp} filename conventions.
-* Filename completion::         Filename completion.
+* File name Syntax::            @value{tramp} file name conventions.
+* File name completion::        File name completion.
 * Ad-hoc multi-hops::           Declaring multiple hops in the file name.
 * Remote processes::            Integration with other @value{emacsname} 
packages.
 * Cleanup remote connections::  Cleanup remote connections.
@@ -247,18 +247,18 @@
 @cindex overview
 
 After the installation of @value{tramp} into your @value{emacsname}, you
-will be able to access files on remote machines as though they were
+will be able to access files on remote hosts as though they were
 local.  Access to the remote file system for editing files, version
 control, and @code{dired} are transparently enabled.
 
-Your access to the remote machine can be with the @command{rsh},
+Your access to the remote host can be with the @command{rsh},
 @command{rlogin}, @command{telnet} programs or with any similar
 connection method.  This connection must pass @acronym{ASCII}
 successfully to be usable but need not be 8-bit clean.
 
 The package provides support for @command{ssh} connections out of the
 box, one of the more common uses of the package.  This allows
-relatively secure access to machines, especially if @command{ftp}
+relatively secure access to hosts, especially if @command{ftp}
 access is disabled.
 
 Under Windows, @value{tramp} is integrated with the PuTTY package,
@@ -267,11 +267,11 @@
 The majority of activity carried out by @value{tramp} requires only that
 the remote login is possible and is carried out at the terminal.  In
 order to access remote files @value{tramp} needs to transfer their content
-to the local machine temporarily.
+to the local host temporarily.
 
address@hidden can transfer files between the machines in a variety of ways.
address@hidden can transfer files between the hosts in a variety of ways.
 The details are easy to select, depending on your needs and the
-machines in question.
+hosts in question.
 
 The fastest transfer methods for large files rely on a remote file
 transfer package such as @command{rcp}, @command{scp}, @command{rsync}
@@ -280,7 +280,7 @@
 If the remote copy methods are not suitable for you, @value{tramp} also
 supports the use of encoded transfers directly through the shell.
 This requires that the @command{mimencode} or @command{uuencode} tools
-are available on the remote machine.  These methods are generally
+are available on the remote host.  These methods are generally
 faster for small files.
 
 @value{tramp} is still under active development and any problems you encounter,
@@ -351,7 +351,7 @@
 @item
 Now the remote shell is up and it good working order.  Remember, what
 was supposed to happen is that @value{tramp} tries to find out what files exist
-on the remote host so that it can do filename completion.
+on the remote host so that it can do file name completion.
 
 So, @value{tramp} basically issues @command{cd} and @command{ls} commands and
 also sometimes @command{echo} with globbing.  Another command that is
@@ -360,7 +360,7 @@
 necessary operation.
 
 @item
-Suppose you are finished with filename completion, have entered @kbd{C-x
+Suppose you are finished with file name completion, have entered @kbd{C-x
 C-f}, a full file name and hit @address@hidden  Now comes the time to
 transfer the file contents from the remote host to the local host so
 that you can edit them.
@@ -470,7 +470,7 @@
 file contents were added.  Support for VC was added.
 
 After that, there were added the multi-hop methods in April 2000 and
-the unification of @value{tramp} and Ange-FTP filenames in July 2002.
+the unification of @value{tramp} and Ange-FTP file names in July 2002.
 In July 2004, multi-hop methods have been replaced by proxy hosts.
 Running commands on remote hosts was introduced in December 2005.
 @ifset emacsgw
@@ -508,8 +508,8 @@
 @value{tramp} is (normally) fully functional when it is initially
 installed.  It is initially configured to use the @command{scp}
 program to connect to the remote host.  So in the easiest case, you
-just type @kbd{C-x C-f} and then enter the filename
address@hidden@trampfn{, user, machine, /path/to.file}}.
+just type @kbd{C-x C-f} and then enter the file name
address@hidden@trampfn{, user, host, /path/to.file}}.
 
 On some hosts, there are problems with opening a connection.  These are
 related to the behavior of the remote shell.  See @xref{Remote shell
@@ -518,7 +518,7 @@
 If you do not wish to use these commands to connect to the remote
 host, you should change the default connection and transfer method
 that @value{tramp} uses.  There are several different methods that 
@value{tramp}
-can use to connect to remote machines and transfer files
+can use to connect to remote hosts and transfer files
 (@pxref{Connection types}).
 
 If you don't know which method is right for you, see @xref{Default
@@ -526,7 +526,7 @@
 
 
 @menu
-* Connection types::            Types of connections made to remote machines.
+* Connection types::            Types of connections made to remote hosts.
 * Inline methods::              Inline methods.
 * External methods::            External methods.
 @ifset emacsgvfs
@@ -548,7 +548,7 @@
 * Connection caching::          Reusing connection related information.
 * Predefined connection information::
                                 Setting own connection related information.
-* Remote Programs::             How @value{tramp} finds and uses programs on 
the remote machine.
+* Remote Programs::             How @value{tramp} finds and uses programs on 
the remote host.
 * Remote shell setup::          Remote shell setup hints.
 * Android shell setup::         Android shell setup hints.
 * Auto-save and Backup::        Auto-save and Backup.
@@ -557,17 +557,17 @@
 
 
 @node Connection types
address@hidden Types of connections made to remote machines
address@hidden Types of connections made to remote hosts
 @cindex connection types, overview
 
 There are two basic types of transfer methods, each with its own
 advantages and limitations.  Both types of connection make use of a
 remote shell access program such as @command{rsh}, @command{ssh} or
address@hidden to connect to the remote machine.
address@hidden to connect to the remote host.
 
 This connection is used to perform many of the operations that @value{tramp}
 requires to make the remote file system transparently accessible from
-the local machine.  It is only when visiting files that the methods
+the local host.  It is only when visiting files that the methods
 differ.
 
 @cindex inline methods
@@ -575,9 +575,9 @@
 @cindex methods, inline
 @cindex methods, external
 Loading or saving a remote file requires that the content of the file
-be transferred between the two machines.  The content of the file can
+be transferred between the two hosts.  The content of the file can
 be transferred using one of two methods: the @dfn{inline method} over
-the same connection used to log in to the remote machine, or the
+the same connection used to log in to the remote host, or the
 @dfn{external method} through another connection using a remote copy
 program such as @command{rcp}, @command{scp} or @command{rsync}.
 
@@ -607,12 +607,12 @@
 The inline methods in @value{tramp} are quite powerful and can work in
 situations where you cannot use an external transfer program to connect.
 Inline methods are the only methods that work when connecting to the
-remote machine via telnet.  (There are also strange inline methods which
+remote host via telnet.  (There are also strange inline methods which
 allow you to transfer files between @emph{user identities} rather than
 hosts, see below.)
 
 These methods depend on the existence of a suitable encoding and
-decoding command on remote machine.  Locally, @value{tramp} may be able to
+decoding command on remote host.  Locally, @value{tramp} may be able to
 use features of @value{emacsname} to decode and encode the files or
 it may require access to external commands to perform that task.
 
@@ -789,11 +789,11 @@
 @cindex rsh (with rcp method)
 
 This method uses the @command{rsh} and @command{rcp} commands to connect
-to the remote machine and transfer files.  This is probably the fastest
+to the remote host and transfer files.  This is probably the fastest
 connection method available.
 
 The alternative method @option{remcp} uses the @command{remsh} and
address@hidden commands.  It should be applied on machines where
address@hidden commands.  It should be applied on hosts where
 @command{remsh} is used instead of @command{rsh}.
 
 
@@ -804,8 +804,8 @@
 @cindex ssh (with scp method)
 
 Using @command{ssh} to connect to the remote host and @command{scp} to
-transfer files between the machines is the best method for securely
-connecting to a remote machine and accessing files.
+transfer files between the hosts is the best method for securely
+connecting to a remote host and accessing files.
 
 The performance of this option is also quite good.  It may be slower than
 the inline methods when you often open and close small files however.
@@ -843,7 +843,7 @@
 @cindex ssh (with rsync method)
 
 Using the @command{ssh} command to connect securely to the remote
-machine and the @command{rsync} command to transfer files is almost
+host and the @command{rsync} command to transfer files is almost
 identical to the @option{scp} method.
 
 While @command{rsync} performs much better than @command{scp} when
@@ -945,7 +945,7 @@
 This is not a native @value{tramp} method.  Instead, it forwards all
 requests to @value{ftppackagename}.
 @ifset xemacs
-This works only for unified filenames, see @ref{Issues}.
+This works only for unified file names, see @ref{Issues}.
 @end ifset
 
 
@@ -974,15 +974,15 @@
 Because of this, the @value{tramp} syntax has been extended: you can
 specify a user name which looks like @code{user%domain} (the real user
 name, then a percent sign, then the domain name).  So, to connect to
-the machine @code{melancholia} as user @code{daniel} of the domain
+the host @code{melancholia} as user @code{daniel} of the domain
 @code{BIZARRE}, and edit @file{.emacs} in the home directory (share
address@hidden) I would specify the filename @address@hidden,
address@hidden) I would specify the file name @address@hidden,
 daniel%BIZARRE, melancholia, /daniel$$/.emacs}}.
 
 Depending on the Windows domain configuration, a Windows user might be
 considered as domain user per default.  In order to connect as local
-user, the WINS name of that machine must be given as domain name.
-Usually, it is the machine name in capital letters.  In the example
+user, the WINS name of that host must be given as domain name.
+Usually, it is the host name in capital letters.  In the example
 above, the local user @code{daniel} would be specified as
 @address@hidden, daniel%MELANCHOLIA, melancholia, /daniel$$/.emacs}}.
 
@@ -1156,7 +1156,7 @@
 method for all user names matching @samp{john} and the @option{rsync}
 method for all host names matching @samp{lily}.  The third line
 specifies to use the @option{su} method for the user @samp{root} on
-the machine @samp{localhost}.
+the host @samp{localhost}.
 
 @lisp
 (add-to-list 'tramp-default-method-alist '("" "john" "ssh"))
@@ -1180,9 +1180,9 @@
 Internet, the security implications of your preferred method.
 
 The @option{rsh} and @option{telnet} methods send your password as
-plain text as you log in to the remote machine, as well as
+plain text as you log in to the remote host, as well as
 transferring the files in such a way that the content can easily be
-read from other machines.
+read from other hosts.
 
 If you need to connect to remote systems that are accessible from the
 Internet, you should give serious thought to using @option{ssh} based
@@ -1207,7 +1207,7 @@
 compression (driven by @var{tramp-inline-compress-start-size}) shall
 still result in good performance.
 
-I guess that these days, most people can access a remote machine by
+I guess that these days, most people can access a remote host by
 using @command{ssh}.  So I suggest that you use the @option{ssh}
 method.  So, type @kbd{C-x C-f @trampfn{ssh, root, otherhost,
 /etc/motd} @key{RET}} to edit the @file{/etc/motd} file on the other
@@ -1359,7 +1359,7 @@
 @var{host} and @var{user} are regular expressions or @code{nil}, which
 is interpreted as a regular expression which always matches.
 
address@hidden must be a Tramp filename which localname part is ignored.
address@hidden must be a Tramp file name which localname part is ignored.
 Method and user name on @var{proxy} are optional, which is interpreted
 with the default values.
 @ifset emacsgw
@@ -1500,7 +1500,7 @@
 
 The variable @code{tramp-completion-function-alist} is intended to
 customize which files are taken into account for user and host name
-completion (@pxref{Filename completion}).  For every method, it keeps
+completion (@pxref{File name completion}).  For every method, it keeps
 a set of configuration files, accompanied by a Lisp function able to
 parse that file.  Entries in @code{tramp-completion-function-alist}
 have the form (@var{method} @var{pair1} @var{pair2} ...).
@@ -1763,7 +1763,7 @@
 
 
 @node Remote Programs
address@hidden How @value{tramp} finds and uses programs on the remote machine
address@hidden How @value{tramp} finds and uses programs on the remote host
 
 @value{tramp} depends on a number of programs on the remote host in order to
 function, including @command{ls}, @command{test}, @command{find} and
@@ -1782,14 +1782,14 @@
 @vindex tramp-default-remote-path
 @vindex tramp-own-remote-path
 @defopt tramp-remote-path
-When @value{tramp} connects to the remote machine, it searches for the
+When @value{tramp} connects to the remote host, it searches for the
 programs that it can use.  The variable @code{tramp-remote-path}
-controls the directories searched on the remote machine.
+controls the directories searched on the remote host.
 
 By default, this is set to a reasonable set of defaults for most
-machines.  The symbol @code{tramp-default-remote-path} is a place
+hosts.  The symbol @code{tramp-default-remote-path} is a place
 holder, it is replaced by the list of directories received via the
-command @command{getconf PATH} on your remote machine.  For example,
+command @command{getconf PATH} on your remote host.  For example,
 on Debian GNU/Linux this is @file{/bin:/usr/bin}, whereas on Solaris
 this is @file{/usr/xpg4/bin:/usr/ccs/bin:/usr/bin:/opt/SUNWspro/bin}.
 It is recommended to apply this symbol on top of
@@ -2067,7 +2067,7 @@
 Android devices use a restricted shell.  They can be accessed via the
 @option{adb} method.  However, this restricts the access to a USB
 connection, and it requires the installation of the Android SDK on the
-local machine.
+local host.
 
 When an @command{sshd} process runs on the Android device, like
 provided by the @code{SSHDroid} app, any @option{ssh}-based method can
@@ -2293,7 +2293,7 @@
 @cindex sshx method with Cygwin
 The recent Cygwin installation of @command{ssh} works only with a
 Cygwinized @value{emacsname}.  You can check it by typing @kbd{M-x
-eshell}, and starting @kbd{ssh test.machine}.  The problem is evident
+eshell}, and starting @kbd{ssh test.host}.  The problem is evident
 if you see a message like this:
 
 @example
@@ -2309,12 +2309,12 @@
 @cindex scpx method with Cygwin
 If you wish to use the @option{scpx} connection method, then you might
 have the problem that @value{emacsname} calls @command{scp} with a
-Windows filename such as @code{c:/foo}.  The Cygwin version of
address@hidden does not know about Windows filenames and interprets
-this as a remote filename on the host @code{c}.
+Windows file name such as @code{c:/foo}.  The Cygwin version of
address@hidden does not know about Windows file names and interprets
+this as a remote file name on the host @code{c}.
 
 One possible workaround is to write a wrapper script for @option{scp}
-which converts the Windows filename to a Cygwinized filename.
+which converts the Windows file name to a Cygwinized file name.
 
 @cindex Cygwin and ssh-agent
 @cindex SSH_AUTH_SOCK and @value{emacsname} on Windows
@@ -2338,7 +2338,7 @@
 @cindex using @value{tramp}
 
 Once you have installed @value{tramp} it will operate fairly
-transparently.  You will be able to access files on any remote machine
+transparently.  You will be able to access files on any remote host
 that you can log in to as though they were local.
 
 Files are specified to @value{tramp} using a formalized syntax specifying the
@@ -2357,52 +2357,52 @@
 minute you have already forgotten that you hit that key!
 
 @menu
-* Filename Syntax::             @value{tramp} filename conventions.
-* Filename completion::         Filename completion.
+* File name Syntax::            @value{tramp} file name conventions.
+* File name completion::        File name completion.
 * Ad-hoc multi-hops::           Declaring multiple hops in the file name.
 * Remote processes::            Integration with other @value{emacsname} 
packages.
 * Cleanup remote connections::  Cleanup remote connections.
 @end menu
 
 
address@hidden Filename Syntax
address@hidden @value{tramp} filename conventions
address@hidden filename syntax
address@hidden filename examples
address@hidden File name Syntax
address@hidden @value{tramp} file name conventions
address@hidden file name syntax
address@hidden file name examples
 
-To access the file @var{localname} on the remote machine @var{machine}
-you would specify the filename @address@hidden, , machine,
-localname}}.  This will connect to @var{machine} and transfer the file
+To access the file @var{localname} on the remote host @var{host}
+you would specify the file name @address@hidden, , host,
+localname}}.  This will connect to @var{host} and transfer the file
 using the default method.  @xref{Default Method}.
 
-Some examples of @value{tramp} filenames are shown below.
+Some examples of @value{tramp} file names are shown below.
 
 @table @file
 @item @address@hidden
-Edit the file @file{.emacs} in your home directory on the machine
+Edit the file @file{.emacs} in your home directory on the host
 @code{melancholia}.
 
 @item @address@hidden
 This edits the same file, using the fully qualified domain name of
-the machine.
+the host.
 
 @item @address@hidden/.emacs
 This also edits the same file; the @file{~} is expanded to your
-home directory on the remote machine, just like it is locally.
+home directory on the remote host, just like it is locally.
 
 @item @address@hidden/.emacs
 This edits the file @file{.emacs} in the home directory of the user
address@hidden on the machine @code{melancholia}.  The @file{~<user>}
address@hidden on the host @code{melancholia}.  The @file{~<user>}
 construct is expanded to the home directory of that user on the remote
-machine.
+host.
 
 @item @address@hidden/etc/squid.conf
-This edits the file @file{/etc/squid.conf} on the machine
+This edits the file @file{/etc/squid.conf} on the host
 @code{melancholia}.
 
 @end table
 
address@hidden can also be an IPv4 or IPv6 address, like in
address@hidden can also be an IPv4 or IPv6 address, like in
 @address@hidden, , 127.0.0.1, .emacs}} or @address@hidden, ,
 @value{ipv6prefix}::address@hidden, .emacs}}.
 @ifset emacs
@@ -2413,17 +2413,17 @@
 Unless you specify a different name to use, @value{tramp} will use the
 current local user name as the remote user name to log in with.  If you
 need to log in as a different user, you can specify the user name as
-part of the filename.
+part of the file name.
 
-To log in to the remote machine as a specific user, you use the syntax
address@hidden@trampfn{, user, machine, path/to.file}}.  That means that
+To log in to the remote host as a specific user, you use the syntax
address@hidden@trampfn{, user, host, path/to.file}}.  That means that
 connecting to @code{melancholia} as @code{daniel} and editing
 @file{.emacs} in your home directory you would specify
 @address@hidden, daniel, melancholia, .emacs}}.
 
 It is also possible to specify other file transfer methods
 (@pxref{Inline methods}, @pxref{External methods}) as part of the
-filename.
+file name.
 @ifset emacs
 This is done by putting the method before the user and host name, as
 in @address@hidden@address@hidden (Note the
@@ -2434,15 +2434,15 @@
 @address@hidden<method>@value{postfixhop}}.  (Note the trailing
 slash!).
 @end ifset
-The user, machine and file specification remain the same.
+The user, host and file specification remain the same.
 
-So, to connect to the machine @code{melancholia} as @code{daniel},
+So, to connect to the host @code{melancholia} as @code{daniel},
 using the @option{ssh} method to transfer files, and edit
address@hidden in my home directory I would specify the filename
address@hidden in my home directory I would specify the file name
 @address@hidden, daniel, melancholia, .emacs}}.
 
 @ifset emacs
-A remote filename containing a host name only, which is equal to a
+A remote file name containing a host name only, which is equal to a
 method name, is not allowed.  If such a host name is used, it must
 always be preceded by an explicit method name, like
 @address@hidden@address@hidden
@@ -2454,13 +2454,13 @@
 daniel, melancholia#42, .emacs}}.
 
 
address@hidden Filename completion
address@hidden Filename completion
address@hidden filename completion
address@hidden File name completion
address@hidden File name completion
address@hidden file name completion
 
-Filename completion works with @value{tramp} for completion of method
-names, of user names and of machine names as well as for completion of
-file names on remote machines.
+File name completion works with @value{tramp} for completion of method
+names, of user names and of host names as well as for completion of
+file names on remote hosts.
 @ifset emacs
 In order to enable this, partial completion must be activated in your
 @file{.emacs}.
@@ -2488,8 +2488,7 @@
 @address@hidden@value{postfixhop}}
 is a possible completion for the respective method,
 @ifset emacs
address@hidden/} stands for the directory @file{/tmp} on your local
-machine,
address@hidden/} stands for the directory @file{/tmp} on your local host,
 @end ifset
 and @address@hidden@value{postfix}}
 might be a host @value{tramp} has detected in your @file{~/.ssh/known_hosts}
@@ -2497,7 +2496,7 @@
 
 If you go on to type @kbd{e @key{TAB}}, the minibuffer is completed to
 @address@hidden@value{postfixhop}}.
-Next @address@hidden brings you all machine names @value{tramp} detects in
+Next @address@hidden brings you all host names @value{tramp} detects in
 your @file{/etc/hosts} file, let's say
 
 @example
@@ -2509,21 +2508,21 @@
 @end multitable
 @end example
 
-Now you can choose the desired machine, and you can continue to
-complete file names on that machine.
+Now you can choose the desired host, and you can continue to
+complete file names on that host.
 
 If the configuration files (@pxref{Customizing Completion}), which
 @value{tramp} uses for analysis of completion, offer user names, those user
 names will be taken into account as well.
 
-Remote machines which have been visited in the past and kept
+Remote hosts which have been visited in the past and kept
 persistently (@pxref{Connection caching}) will be offered too.
 
-Once the remote machine identification is completed, it comes to
-filename completion on the remote host.  This works pretty much like
+Once the remote host identification is completed, it comes to
+file name completion on the remote host.  This works pretty much like
 for files on the local host, with the exception that minibuffer
-killing via a double-slash works only on the filename part, except
-that filename part starts with @file{//}.
+killing via a double-slash works only on the file name part, except
+that file name part starts with @file{//}.
 @ifset emacs
 A triple-slash stands for the default behavior.
 @end ifset
@@ -2557,14 +2556,14 @@
 
 A remote directory might have changed its contents out of
 @value{emacsname} control, for example by creation or deletion of
-files by other processes.  Therefore, during filename completion, the
+files by other processes.  Therefore, during file name completion, the
 remote directory contents are reread regularly in order to detect such
 changes, which would be invisible otherwise (@pxref{Connection caching}).
 
 @defopt tramp-completion-reread-directory-timeout
 This variable defines the number of seconds since last remote command
 before rereading a directory contents.  A value of 0 would require an
-immediate reread during filename completion, @code{nil} means to use
+immediate reread during file name completion, @code{nil} means to use
 always cached values for the directory contents.
 @end defopt
 
@@ -2632,7 +2631,7 @@
 @ifset emacsgvfs
 If the remote host is mounted via GVFS (see @ref{GVFS based methods}),
 the remote filesystem is mounted locally.  Therefore, there are no
-remote processes; all processes run still locally on your machine with
+remote processes; all processes run still locally on your host with
 an adapted @code{default-directory}.  This section does not apply for
 such connection methods.
 @end ifset
@@ -2645,7 +2644,7 @@
 this is welcome!
 
 When your program is not found in the default search path
address@hidden sets on the remote machine, you should either use an
address@hidden sets on the remote host, you should either use an
 absolute path, or extend @code{tramp-remote-path} (see @ref{Remote
 Programs}):
 
@@ -2713,18 +2712,18 @@
 
 Calling @kbd{M-x shell} in a buffer related to a remote host runs the
 local shell as defined in @option{shell-file-name}.  This might be
-also a valid path name for a shell to be applied on the remote host,
+also a valid file name for a shell to be applied on the remote host,
 but it will fail at least when your local and remote hosts belong to
 different system types, like @samp{windows-nt} and @samp{gnu/linux}.
 
 You must set the variable @option{explicit-shell-file-name} to the
-shell path name on the remote host, in order to start that shell on
+shell file name on the remote host, in order to start that shell on
 the remote host.
 
 @ifset emacs
 Starting with Emacs 24 this won't be necessary, if you call
 @code{shell} interactively.  You will be asked for the remote shell
-path, if you are on a remote buffer, and if
+file name, if you are on a remote buffer, and if
 @option{explicit-shell-file-name} is equal to @code{nil}.
 @end ifset
 
@@ -2924,7 +2923,7 @@
 @ifset emacs
 @ifset installchapter
 Before sending a bug report, you could check whether @value{tramp}
-works at all.  Run the test suite on your local machine, @ref{Testing}.
+works at all.  Run the test suite on your local host, @ref{Testing}.
 @end ifset
 @end ifset
 
@@ -2935,7 +2934,7 @@
 
 When submitting a bug report, please try to describe in excruciating
 detail the steps required to reproduce the problem, the setup of the
-remote machine and any special conditions that exist.  You should also
+remote host and any special conditions that exist.  You should also
 check that your problem is not described already in @xref{Frequently
 Asked Questions}.
 
@@ -3009,7 +3008,7 @@
 confident that files on remote hosts are not changed out of
 @value{emacsname}' control, set @code{remote-file-name-inhibit-cache}
 to @code{nil}.  Set also @code{tramp-completion-reread-directory-timeout}
-to @code{nil}, @ref{Filename completion}.
+to @code{nil}, @ref{File name completion}.
 
 Disable version control.  If you access remote files which are not
 under version control, a lot of check operations can be avoided by
@@ -3037,7 +3036,7 @@
 @item
 Unknown characters in the prompt
 
address@hidden needs to recognize the prompt on the remote machine
address@hidden needs to recognize the prompt on the remote host
 after execution any command.  This is not possible when the prompt
 contains unknown characters like escape sequences for coloring.  This
 should be avoided on the remote side.  @xref{Remote shell setup}. for
@@ -3069,7 +3068,7 @@
 @item
 Echoed characters after login
 
-When the remote machine opens an echoing shell, there might be control
+When the remote host opens an echoing shell, there might be control
 characters in the welcome message.  @value{tramp} tries to suppress
 such echoes via the @command{stty -echo} command, but sometimes this
 command is not reached, because the echoed output has confused
@@ -3167,7 +3166,7 @@
 @item
 File name completion does not work with @value{tramp}
 
-When you log in to the remote machine, do you see the output of
+When you log in to the remote host, do you see the output of
 @command{ls} in color? If so, this may be the cause of your problems.
 
 @command{ls} outputs @acronym{ANSI} escape sequences that your terminal
@@ -3175,12 +3174,12 @@
 confuse @value{tramp} however.
 
 In your @file{.bashrc}, @file{.profile} or equivalent on the remote
-machine you probably have an alias configured that adds the option
+host you probably have an alias configured that adds the option
 @option{--color=yes} or @option{--color=auto}.
 
 You should remove that alias and ensure that a new login @emph{does not}
 display the output of @command{ls} in color.  If you still cannot use
-filename completion, report a bug to the @value{tramp} developers.
+file name completion, report a bug to the @value{tramp} developers.
 
 
 @item
@@ -3726,7 +3725,7 @@
 package.
 
 Their replacements are reasonably simplistic in their approach.  They
-dissect the filename, call the original handler on the localname and
+dissect the file name, call the original handler on the localname and
 then rebuild the @value{tramp} file name with the result.
 
 This allows the platform specific hacks in the original handlers to take
@@ -3736,19 +3735,19 @@
 @ifset emacs
 @node External packages
 @section Integration with external Lisp packages
address@hidden Filename completion.
address@hidden File name completion.
 
-While reading filenames in the minibuffer, @value{tramp} must decide
-whether it completes possible incomplete filenames, or not.  Imagine
+While reading file names in the minibuffer, @value{tramp} must decide
+whether it completes possible incomplete file names, or not.  Imagine
 there is the following situation: You have typed @kbd{C-x C-f
 @address@hidden @key{TAB}}.  @value{tramp} cannot
 know, whether @option{ssh} is a method or a host name.  It checks
 therefore the last input character you have typed.  If this is
 @key{TAB}, @key{SPACE} or @kbd{?}, @value{tramp} assumes that you are
-still in filename completion, and it does not connect to the possible
+still in file name completion, and it does not connect to the possible
 remote host @option{ssh}.
 
-External packages, which use other characters for completing filenames
+External packages, which use other characters for completing file names
 in the minibuffer, must signal this to @value{tramp}.  For this case,
 the variable @code{non-essential} can be bound temporarily to
 a address@hidden value.
@@ -3891,16 +3890,16 @@
 But I have decided that this is too fragile to reliably work, so on some
 systems you'll have to do without the uuencode methods.
 
address@hidden The @value{tramp} filename syntax differs between Emacs and 
XEmacs.
address@hidden The @value{tramp} file name syntax differs between Emacs and 
XEmacs.
 
-The Emacs maintainers wish to use a unified filename syntax for
+The Emacs maintainers wish to use a unified file name syntax for
 Ange-FTP and @value{tramp} so that users don't have to learn a new
 syntax.  It is sufficient to learn some extensions to the old syntax.
 
 For the XEmacs maintainers, the problems caused from using a unified
-filename syntax are greater than the gains.  The XEmacs package system
+file name syntax are greater than the gains.  The XEmacs package system
 uses EFS for downloading new packages.  So, obviously, EFS has to be
-installed from the start.  If the filenames were unified, @value{tramp}
+installed from the start.  If the file names were unified, @value{tramp}
 would have to be installed from the start, too.
 
 @ifset xemacs
@@ -3917,12 +3916,12 @@
 disabled.  This can be achieved by setting file permissions @code{000}
 to the files @file{.../xemacs-packages/lisp/tramp/auto-autoloads.el*}.
 
-In case of unified filenames, all @value{emacsname} download sites are
+In case of unified file names, all @value{emacsname} download sites are
 added to @code{tramp-default-method-alist} with default method
 @option{ftp} @xref{Default Method}.  These settings shouldn't be
 touched for proper working of the @value{emacsname} package system.
 
-The syntax for unified filenames is described in the @value{tramp} manual
+The syntax for unified file names is described in the @value{tramp} manual
 for @value{emacsothername}.
 @end ifset
 @end itemize
@@ -3955,7 +3954,5 @@
 @c   shells.
 @c * Explain how tramp.el works in principle: open a shell on a remote
 @c   host and then send commands to it.
address@hidden * Use `filename' resp. `file name' consistently.
address@hidden * Use `host' resp. `machine' consistently.
 @c * Consistent small or capitalized words especially in menus.
 @c * Make a unique declaration of @trampfn.