Skip to content
GitLab
Projects
Groups
Snippets
Help
Loading...
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
Open sidebar
emacs
emacs
Commits
8b358e90
Commit
8b358e90
authored
Dec 17, 2010
by
Daiki Ueno
Browse files
Mention epa-file-select-keys in epa.texi.
parent
9efd720d
Changes
2
Hide whitespace changes
Inline
Side-by-side
Showing
2 changed files
with
52 additions
and
17 deletions
+52
-17
doc/misc/ChangeLog
doc/misc/ChangeLog
+5
-0
doc/misc/epa.texi
doc/misc/epa.texi
+47
-17
No files found.
doc/misc/ChangeLog
View file @
8b358e90
2010-12-17 Daiki Ueno <ueno@unixuser.org>
* epa.texi (Encrypting/decrypting *.gpg files): Mention
epa-file-select-keys.
2010-12-16 Lars Magne Ingebrigtsen <larsi@gnus.org>
* gnus.texi (Archived Messages): Remove outdated text.
...
...
doc/misc/epa.texi
View file @
8b358e90
...
...
@@ -353,16 +353,21 @@ key in the recipient list, use @samp{encrypt-to} option in
@node Encrypting/decrypting *.gpg files
@section Encrypting/decrypting *.gpg files
By default, every file whose extension is @samp
{
.gpg
}
will be treated
as encrypted. That is, when you attempt to open such a file which
already exists, the decrypted text is inserted in the buffer rather
than encrypted one. On the other hand, when you attempt to save the
buffer to a file whose extension is @samp
{
.gpg
}
, encrypted data is
written.
By default, every file whose name ends with @samp
{
.gpg
}
will be
treated as encrypted. That is, when you open such a file, the
decrypted text is inserted in the buffer rather than encrypted one.
Similarly, when you save the buffer to a @samp
{
foo.gpg
}
file,
encrypted data is written.
If you want to temporarily disable this behavior, use @kbd
{
M-x
epa-file-disable
}
, and then to enable this behavior use @kbd
{
M-x
epa-file-enable
}
.
The file name pattern for encrypted files can be controlled by
@var
{
epa-file-name-regexp
}
.
@defvar epa-file-name-regexp
Regexp which matches filenames treated as encrypted.
@end defvar
You can disable this behavior with @kbd
{
M-x epa-file-disable
}
, and
then get it back with @kbd
{
M-x epa-file-enable
}
.
@deffn Command epa-file-disable
Disable automatic encryption/decryption of *.gpg files.
...
...
@@ -373,23 +378,48 @@ Enable automatic encryption/decryption of *.gpg files.
@end deffn
@noindent
@code
{
epa-file
}
will let you select recipients. If you want to
suppress this question, it might be a good idea to put the following
line on the first line of the text being encrypted.
By default, @code
{
epa-file
}
will try to use symmetric encryption, aka
password-based encryption. If you want to use public key encryption
instead, do @kbd
{
M-x epa-file-select-keys
}
, which will pops up the key
selection dialog.
@deffn Command epa-file-select-keys
Select recipient keys to encrypt the currently visiting file with
public key encryption.
@end deffn
You can also change the default behavior with the variable
@var
{
epa-file-select-keys
}
.
@defvar epa-file-select-keys
Control whether or not to pop up the key selection dialog.
@end defvar
For frequently visited files, it might be a good idea to tell Emacs
which encryption method should be used through @xref
{
File Variables, ,
, emacs, the Emacs Manual
}
. Use the @code
{
epa-file-encrypt-to
}
local
variable for this.
@vindex epa-file-encrypt-to
For example, if you want an Elisp file should be encrypted with a
public key associated with an email address @samp
{
ueno@@unixuser.org
}
,
add the following line to the beginning of the file.
@cartouche
@lisp
;; -*- epa-file-encrypt-to: ("ueno@@unixuser.org") -*-
@end lisp
@end cartouche
The file name extension of encrypted files can be controlled by
@var
{
epa-file-name-regexp
}
.
Instead, if you want the file always (regardless of the value of the
@code
{
epa-file-select-keys
}
variable) encrypted with symmetric
encryption, change the line as follows.
@defvar epa-file-name-regexp
Regexp which matches filenames treated as encrypted.
@end defvar
@cartouche
@lisp
;; -*- epa-file-encrypt-to: nil -*-
@end lisp
@end cartouche
Other variables which control the automatic encryption/decryption
behavior are below.
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
.
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment