; 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 c527f3e8068fecc920a49c8ae104ad98ecdc49f8..526e92aaddf20a66a3ec6109a74fe142697c1f81 100644 (file)
--- 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}?