[Emacs-diffs] /srv/bzr/emacs/emacs-23 r100006: Sync with Tramp 2.1.19.

[Michael Albinus]

------------------------------------------------------------
revno: 100006
committer: Michael Albinus <address@hidden>
branch nick: emacs-23
timestamp: Thu 2010-08-26 21:40:13 +0200
message:
  Sync with Tramp 2.1.19.
  
  * tramp.texi (Inline methods, Default Method): Mention
  `tramp-inline-compress-start-size'.  Remove "kludgy" phrase.  Remove
  remark about doubled "-t" argument.
  (Auto-save and Backup): Remove reference to Emacs 21.
  (Filename Syntax): Describe port numbers.
  (Frequently Asked Questions): Adapt supported (X)Emacs versions.  Adapt
  supported MS Windows versions.  Remove obsolete URL.  Recommend "sshx"
  and "scpx" for echoing shells.  Use the $() syntax, texi2dvi reports
  errors with the backquotes.
  (External packages): File attributes cache flushing for asynchronous
  processes.
  (Traces and Profiles): Describe verbose level 9.
  
  * trampver.texi: Update release number.
modified:
  doc/misc/ChangeLog
  doc/misc/tramp.texi
  doc/misc/trampver.texi

=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog        2010-08-01 04:00:59 +0000
+++ b/doc/misc/ChangeLog        2010-08-26 19:40:13 +0000
@@ -1,3 +1,22 @@
+2010-08-26  Michael Albinus  <address@hidden>
+
+       Sync with Tramp 2.1.19.
+
+       * tramp.texi (Inline methods, Default Method): Mention
+       `tramp-inline-compress-start-size'.  Remove "kludgy" phrase.  Remove
+       remark about doubled "-t" argument.
+       (Auto-save and Backup): Remove reference to Emacs 21.
+       (Filename Syntax): Describe port numbers.
+       (Frequently Asked Questions): Adapt supported (X)Emacs versions.  Adapt
+       supported MS Windows versions.  Remove obsolete URL.  Recommend "sshx"
+       and "scpx" for echoing shells.  Use the $() syntax, texi2dvi reports
+       errors with the backquotes.
+       (External packages): File attributes cache flushing for asynchronous
+       processes.
+       (Traces and Profiles): Describe verbose level 9.
+
+       * trampver.texi: Update release number.
+
 2010-08-01  Juanma Barranquero  <address@hidden>
 
        * org.texi (Footnotes, Tables in HTML export): Fix typos.

=== modified file 'doc/misc/tramp.texi'
--- a/doc/misc/tramp.texi       2010-06-24 07:10:51 +0000
+++ b/doc/misc/tramp.texi       2010-08-26 19:40:13 +0000
@@ -592,6 +592,10 @@
 transfers a small piece of Perl code to the remote host, and tries to
 apply it for encoding and decoding.
 
+The variable @var{tramp-inline-compress-start-size} controls, whether
+a file shall be compressed before encoding.  This could increase
+transfer speed for large text files.
+
 
 @table @asis
 @item @option{rsh}
@@ -625,11 +629,11 @@
 @command{ssh1} and @command{ssh2} commands explicitly.  If you don't
 know what these are, you do not need these options.
 
-All the methods based on @command{ssh} have an additional kludgy
-feature: you can specify a host name which looks like @file{host#42}
-(the real host name, then a hash sign, then a port number).  This
-means to connect to the given host but to also pass @code{-p 42} as
-arguments to the @command{ssh} command.
+All the methods based on @command{ssh} have an additional feature: you
+can specify a host name which looks like @file{host#42} (the real host
+name, then a hash sign, then a port number).  This means to connect to
+the given host but to also pass @code{-p 42} as arguments to the
address@hidden command.
 
 
 @item @option{telnet}
@@ -689,8 +693,6 @@
 invoked from an @value{emacsname} buffer, tells them that it is not
 allocating a pseudo tty.  When this happens, the login shell is wont
 to not print any shell prompt, which confuses @value{tramp} mightily.
-For reasons unknown, some Windows ports for @command{ssh} require the
-doubled @samp{-t} option.
 
 This supports the @samp{-p} argument.
 
@@ -1230,7 +1232,9 @@
 
 My suggestion is to use an inline method.  For large files, external
 methods might be more efficient, but I guess that most people will
-want to edit mostly small files.
+want to edit mostly small files.  And if you access large text files,
+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
 using @command{ssh}.  So I suggest that you use the @option{ssh}
@@ -2125,10 +2129,9 @@
 
 The same problem can happen with auto-saving files.
 @ifset emacs
-Since @value{emacsname} 21, the variable
address@hidden keeps information, on which
-directory an auto-saved file should go.  By default, it is initialized
-for @value{tramp} files to the local temporary directory.
+The variable @code{auto-save-file-name-transforms} keeps information,
+on which directory an auto-saved file should go.  By default, it is
+initialized for @value{tramp} files to the local temporary directory.
 
 On some versions of @value{emacsname}, namely the version built for
 Debian GNU/Linux, the variable @code{auto-save-file-name-transforms}
@@ -2305,6 +2308,11 @@
 @file{.emacs} in my home directory I would specify the filename
 @address@hidden, daniel, melancholia, .emacs}}.
 
+Finally, for some methods it is possible to specify a different port
+number than the default one, given by the method.  This is specified
+by adding @file{#<port>} to the host name, like in @address@hidden,
+daniel, melancholia#42, .emacs}}.
+
 
 @node Alternative Syntax
 @section URL-like filename syntax
@@ -2749,17 +2757,13 @@
 @item
 Which systems does it work on?
 
-The package has been used successfully on GNU Emacs 21, GNU Emacs 22,
-GNU Emacs 23, XEmacs 21 (starting with 21.4), and SXEmacs 22.
+The package has been used successfully on GNU Emacs 22, GNU Emacs 23,
+XEmacs 21 (starting with 21.4), and SXEmacs 22.
 
 The package was intended to work on Unix, and it really expects a
-Unix-like system on the remote end (except the @option{smb} method),
-but some people seemed to have some success getting it to work on MS
-Windows NT/2000/XP @value{emacsname}.
-
-There is some informations on @value{tramp} on NT at the following URL;
-many thanks to Joe Stoy for providing the information:
address@hidden://ftp.comlab.ox.ac.uk/tmp/Joe.Stoy/}
+Unix-like system on the remote end (except the @option{smb} and
address@hidden methods), but some people seemed to have some success
+getting it to work on MS Windows XP/Vista/7 @value{emacsname}.
 
 
 @item
@@ -2797,7 +2801,7 @@
 @item
 @value{tramp} does not connect to the remote host
 
-When @value{tramp} does not connect to the remote host, there are two
+When @value{tramp} does not connect to the remote host, there are three
 reasons heading the bug mailing list:
 
 @itemize @minus
@@ -2832,6 +2836,17 @@
 @end example
 
 @item
+Echoed characters after login
+
+When the remote machine opens an echoing shell, there might be control
+characters in the welcome message.  @value{tramp} tries to suppress
+such echoes via the @code{stty -echo} command, but sometimes this
+command is not reached, because the echoed output has confused
address@hidden already.  In such situations it might be helpful to use
+the @option{sshx} or @option{scpx} methods, which allocate a pseudo tty.
address@hidden methods}.
+
address@hidden
 @value{tramp} doesn't transfer strings with more than 500 characters
 correctly
 
@@ -3339,7 +3354,7 @@
 
 @example
 #!/bin/sh
-emacsclient @trampfn{ssh, `whoami`, `hostname --fqdn`, $1}
+emacsclient @trampfn{ssh, $(whoami), $(hostname --fqdn), $1}
 @end example
 
 Then you must set the environment variable @code{EDITOR} pointing to
@@ -3456,7 +3471,7 @@
 
 This is a performance degradation, because the lost file attributes
 must be recomputed, when needed again.  In cases the caller of
address@hidden knows that there are file attribute changes, it
address@hidden knows that there are no file attribute changes, it
 shall let-bind the variable @code{process-file-side-effects} to
 @code{nil}.  @value{tramp} wouldn't flush the file attributes cache then.
 
@@ -3464,6 +3479,25 @@
 (let (process-file-side-effects)
   ...)
 @end lisp
+
+For asynchronous processes, @value{tramp} flushes the file attributes
+cache via a process sentinel.  If the caller of
address@hidden knows that there are no file attribute
+changes, it shall set the process sentinel to @code{nil}.  In case the
+caller defines an own process sentinel, @value{tramp}'s process
+sentinel is overwritten.  The caller can still flush the file
+attributes cache in its process sentinel with this code:
+
address@hidden
+(unless (memq (process-status proc) '(run open))
+  (dired-uncache remote-directory))
address@hidden lisp
+
address@hidden shall be the root directory, where file
+attribute changes can happen during the process lifetime.
address@hidden traverses all subdirectories, starting at this
+directory.  Often, it is sufficient to use @code{default-directory} of
+the process buffer as root directory.
 @end ifset
 
 
@@ -3486,6 +3520,7 @@
 @address@hidden @w{ 6}  sent and received strings
 @address@hidden @w{ 7}  file caching
 @address@hidden @w{ 8}  connection properties
address@hidden@indent @w{ 9}  test commands
 @address@hidden @w{10}  traces (huge)
 
 When @code{tramp-verbose} is greater than or equal to 4, the messages

=== modified file 'doc/misc/trampver.texi'
--- a/doc/misc/trampver.texi    2010-03-14 20:10:47 +0000
+++ b/doc/misc/trampver.texi    2010-08-26 19:40:13 +0000
@@ -2,14 +2,14 @@
 @c texi/trampver.texi.  Generated from trampver.texi.in by configure.
 
 @c This is part of the Emacs manual.
address@hidden Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010
address@hidden   Free Software Foundation, Inc.
address@hidden Copyright (C) 2003, 2004, 2005, 2006, 2007, 2008, 2009,
address@hidden   2010 Free Software Foundation, Inc.
 @c See file doclicense.texi for copying conditions.
 
 @c In the Tramp CVS, the version number is auto-frobbed from
 @c configure.ac, so you should edit that file and run
 @c "autoconf && ./configure" to change the version number.
address@hidden trampver 2.1.18-23.2
address@hidden trampver 2.1.19
 
 @c Other flags from configuration
 @set instprefix /usr/local