master c0f5e0a559: ; Extend Tramp FAQ

[Michael Albinus]

branch: master
commit c0f5e0a559bab530d6a2e1de3bb021d004a855cf
Author: Michael Albinus <michael.albinus@gmx.de>
Commit: Michael Albinus <michael.albinus@gmx.de>

    ; Extend Tramp FAQ
    
    * doc/misc/tramp.texi (Frequently Asked Questions): Explain Tramp
    temporary file identification.
---
 doc/misc/tramp.texi | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi
index c527f3e806..526e92aadd 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}?