From: Michael Albinus <michael.albinus@gmx.de>
Date: Wed, 30 Mar 2022 09:16:57 +0000 (+0200)
Subject: ; Extend Tramp FAQ
X-Git-Tag: emacs-29.0.90~1931^2~860
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=c0f5e0a559bab530d6a2e1de3bb021d004a855cf;p=emacs.git

; Extend Tramp FAQ

* doc/misc/tramp.texi (Frequently Asked Questions): Explain Tramp
temporary file identification.
---

diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi
index c527f3e8068..526e92aaddf 100644
--- a/doc/misc/tramp.texi
+++ b/doc/misc/tramp.texi
@@ -5029,6 +5029,26 @@ be restored by moving them manually from
 @file{$@{XDG_DATA_HOME@}/Trash/files/}, if needed.
 
 
+@item
+How to identify temporary files produced by @value{tramp}?
+
+@vindex tramp-temp-name-prefix
+Temporary files are kept in your @code{temporary-file-directory}
+directory, which is often @file{/tmp/}.  By default, they have the
+file name prefix @t{"tramp."}.  If you want to change this prefix, for
+example because you want to identify temporary files produced by
+@code{file-local-copy} in your package, you can bind the variable
+@code{tramp-temp-name-prefix} temporarily:
+
+@example
+@group
+(let ((tramp-temp-name-prefix "my-prefix."))
+  (file-local-copy "@trampfn{ssh,,.emacs}"))
+@result{} "/tmp/my-prefix.HDfgDZ"
+@end group
+@end example
+
+
 @item
 How to shorten long file names when typing in @value{tramp}?