[Emacs-diffs] Changes to emacs/doc/misc/tramp.texi,v

[Michael Albinus]

CVSROOT:        /sources/emacs
Module name:    emacs
Changes by:     Michael Albinus <albinus>       07/10/21 14:11:18

Index: tramp.texi
===================================================================
RCS file: /sources/emacs/emacs/doc/misc/tramp.texi,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -b -r1.4 -r1.5
--- tramp.texi  6 Oct 2007 11:55:36 -0000       1.4
+++ tramp.texi  21 Oct 2007 14:11:17 -0000      1.5
@@ -164,6 +164,8 @@
 * Usage::                       An overview of the operation of @value{tramp}.
 * Bug Reports::                 Reporting Bugs and Problems.
 * Frequently Asked Questions::  Questions and answers from the mailing list.
+* Function Index::              @value{tramp} functions.
+* Variable Index::              User options and variables.
 * Concept Index::               An item for each concept.
 
 For the developer:
@@ -214,6 +216,7 @@
 * Alternative Syntax::          URL-like filename syntax.
 * Filename completion::         Filename completion.
 * Remote processes::            Integration with other @value{emacsname} 
packages.
+* Cleanup remote connections::  Cleanup remote connections.
 
 The inner workings of remote version control
 
@@ -1548,12 +1551,6 @@
 seconds how long passwords are cached.  Setting it to @code{nil}
 disables the expiration.
 
address@hidden tramp-clear-passwd
-A password is removed from the cache if a connection isn't established
-successfully.  You can remove a password from the cache also by
-executing @kbd{M-x tramp-clear-passwd} in a buffer containing a
-related remote file or directory.
-
 @vindex password-cache
 If you don't like this feature for security reasons, password caching
 can be disabled totally by customizing the variable
@@ -1654,7 +1651,6 @@
 
 
 @node Remote shell setup
address@hidden  node-name,  next,  previous,  up
 @section Remote shell setup hints
 @cindex remote shell setup
 @cindex @file{.profile} file
@@ -1719,6 +1715,39 @@
 @code{shell-prompt-pattern}, which is reported to work well in many
 circumstances.
 
address@hidden @var{tramp-password-prompt-regexp}
address@hidden tramp-password-prompt-regexp
address@hidden tramp-wrong-passwd-regexp
+
+During login, @value{tramp} might be forced to enter a password or a
+passphrase.  The difference between both is that a password is
+requested from the shell on the remote host, while a passphrase is
+needed for accessing local authentication information, like your ssh
+key.
+
address@hidden handles the detection of such
+requests for English environments.  When you use another localization
+of your (local or remote) host, you might need to adapt this. Example:
+
address@hidden
+(setq
+  tramp-password-prompt-regexp
+    (concat
+      "^.*"
+      (regexp-opt
+        '("passphrase" "Passphrase"
+          ;; English
+          "password" "Password"
+          ;; Deutsch
+          "passwort" "Passwort"
+          ;; Fran@,{c}ais
+          "mot de passe" "Mot de passe") t)
+      ".*:? *"))
address@hidden lisp
+
+In parallel, it might also be necessary to adapt
address@hidden
+
 @item @command{tset} and other questions
 @cindex Unix command tset
 @cindex tset Unix command
@@ -2030,6 +2059,7 @@
 * Alternative Syntax::          URL-like filename syntax.
 * Filename completion::         Filename completion.
 * Remote processes::            Integration with other @value{emacsname} 
packages.
+* Cleanup remote connections::  Cleanup remote connections.
 @end menu
 
 
@@ -2356,6 +2386,35 @@
 absolute file names, without any remote specification.
 
 
address@hidden Cleanup remote connections
address@hidden Cleanup remote connections.
address@hidden cleanup
+
+Sometimes it is useful to cleanup remote connections.  The following
+commands support this.
+
address@hidden Command tramp-cleanup-connection vec
+This command flushes all connection related objects.  @option{vec} is
+the internal representation of a remote connection.  Called
+interactively, the command offers all active remote connections in the
+minibuffer as remote file name prefix like @address@hidden,
+user, host, }}.  The cleanup includes password cache (@pxref{Password
+caching}), file cache, connection cache (@pxref{Connection caching}),
+connection buffers.
address@hidden deffn
+
address@hidden Command tramp-cleanup-all-connections
+This command flushes objects for all active remote connections.  The
+same objects are removed as in @code{tramp-cleanup-connection}.
address@hidden deffn
+
address@hidden Command tramp-cleanup-all-buffers
+Like in @code{tramp-cleanup-all-connections}, all remote connections
+are cleaned up.  Additionally all buffers, which are related to a
+remote connection, are killed.
address@hidden deffn
+
+
 @node Bug Reports
 @chapter Reporting Bugs and Problems
 @cindex bug reports
@@ -2379,6 +2438,7 @@
 @uref{http://lists.gnu.org/mailman/listinfo/tramp-devel/,
 the @value{tramp} Mail Subscription Page}.
 
address@hidden tramp-bug
 To report a bug in @value{tramp}, you should execute @kbd{M-x
 tramp-bug}.  This will automatically generate a buffer with the details
 of your system and @value{tramp} version.
@@ -3304,10 +3364,18 @@
 @appendix GNU Free Documentation License
 @include doclicense.texi
 
address@hidden Function Index
address@hidden Function Index
address@hidden fn
+
address@hidden Variable Index
address@hidden Variable Index
address@hidden vr
+
 @node Concept Index
address@hidden node-name,    next,  previous,      up
 @unnumbered Concept Index
 @printindex cp
+
 @contents
 @c End of tramp.texi - the TRAMP User Manual
 @bye