1
0
Fork 0
mirror of https://github.com/pgpainless/pgpainless.git synced 2024-11-26 22:32:07 +01:00

Add documentation to SecretKeyRingEditor

This commit is contained in:
Paul Schaub 2021-12-28 01:23:47 +01:00
parent 2d319051d4
commit 376e234baf
Signed by: vanitasvitae
GPG key ID: 62BEE9264BF17311

View file

@ -69,10 +69,28 @@ public interface SecretKeyRingEditorInterface {
@Nonnull SecretKeyRingProtector protector) @Nonnull SecretKeyRingProtector protector)
throws PGPException; throws PGPException;
/**
* Convenience method to revoke selected user-ids using soft revocation signatures.
* The revocation will use {@link RevocationAttributes.Reason#USER_ID_NO_LONGER_VALID}, so that the user-id
* can be re-certified at a later point.
*
* @param userIdSelector selector to select user-ids
* @param protector protector to unlock the primary key
* @return the builder
*/
SecretKeyRingEditorInterface removeUserId(SelectUserId userIdSelector, SecretKeyRingEditorInterface removeUserId(SelectUserId userIdSelector,
SecretKeyRingProtector protector) SecretKeyRingProtector protector)
throws PGPException; throws PGPException;
/**
* Convenience method to revoke a single user-id using a soft revocation signature.
* The revocation will use {@link RevocationAttributes.Reason#USER_ID_NO_LONGER_VALID}. so that the user-id
* can be re-certified at a later point.
*
* @param userId user-id to revoke
* @param protector protector to unlock the primary key
* @return the builder
*/
SecretKeyRingEditorInterface removeUserId(CharSequence userId, SecretKeyRingEditorInterface removeUserId(CharSequence userId,
SecretKeyRingProtector protector) SecretKeyRingProtector protector)
throws PGPException; throws PGPException;