diff --git a/briar-api/src/main/java/org/briarproject/briar/api/privategroup/invitation/GroupInvitationManager.java b/briar-api/src/main/java/org/briarproject/briar/api/privategroup/invitation/GroupInvitationManager.java index 73a60db14..dcff16b56 100644 --- a/briar-api/src/main/java/org/briarproject/briar/api/privategroup/invitation/GroupInvitationManager.java +++ b/briar-api/src/main/java/org/briarproject/briar/api/privategroup/invitation/GroupInvitationManager.java @@ -85,7 +85,8 @@ public interface GroupInvitationManager extends ConversationClient { * This indicates whether the {@link PrivateGroup} can be shared * with the contact. * - * @throws ProtocolStateException if {@link PrivateGroup} was already left. + * @throws ProtocolStateException if {@link PrivateGroup} + * was already dissolved. */ SharingStatus getSharingStatus(Contact c, GroupId g) throws DbException; } diff --git a/briar-api/src/main/java/org/briarproject/briar/api/sharing/SharingManager.java b/briar-api/src/main/java/org/briarproject/briar/api/sharing/SharingManager.java index 023419126..73f538160 100644 --- a/briar-api/src/main/java/org/briarproject/briar/api/sharing/SharingManager.java +++ b/briar-api/src/main/java/org/briarproject/briar/api/sharing/SharingManager.java @@ -116,7 +116,7 @@ public interface SharingManager * This indicates whether the {@link Shareable} can be shared * with the contact. * - * @throws ProtocolStateException if {@link Shareable} was already left. + * @throws ProtocolStateException if we already left the {@link Shareable}. */ SharingStatus getSharingStatus(GroupId g, Contact c) throws DbException; @@ -126,7 +126,7 @@ public interface SharingManager * This indicates whether the {@link Shareable} can be shared * with the contact. * - * @throws ProtocolStateException if {@link Shareable} was already left. + * @throws ProtocolStateException if we already left the {@link Shareable}. */ SharingStatus getSharingStatus(Transaction txn, GroupId g, Contact c) throws DbException; diff --git a/briar-core/src/main/java/org/briarproject/briar/privategroup/invitation/GroupInvitationManagerImpl.java b/briar-core/src/main/java/org/briarproject/briar/privategroup/invitation/GroupInvitationManagerImpl.java index 0373ad2da..cd78802a5 100644 --- a/briar-core/src/main/java/org/briarproject/briar/privategroup/invitation/GroupInvitationManagerImpl.java +++ b/briar-core/src/main/java/org/briarproject/briar/privategroup/invitation/GroupInvitationManagerImpl.java @@ -539,7 +539,8 @@ class GroupInvitationManagerImpl extends ConversationClientImpl if (state == START) return SharingStatus.SHAREABLE; if (state == INVITED) return SharingStatus.INVITE_RECEIVED; if (state == JOINED) return SharingStatus.SHARING; - // The creator can also be a LEFT state, after re-adding a contact + // Apart from the common case that the contact LEFT the group, + // the creator can also be a LEFT state, after re-adding a contact // and re-creating the session with #recreateSession() if (state == CreatorState.LEFT) return SharingStatus.SHARING; if (state == DISSOLVED) throw new ProtocolStateException();