From 7062bb0502ba863b73944d9cbccc59f6e4b652ea Mon Sep 17 00:00:00 2001 From: "B. Petersen" Date: Tue, 18 Jul 2023 13:55:18 +0200 Subject: [PATCH] clarify transitive behaviour of dc_contact_is_verfified() --- deltachat-ffi/deltachat.h | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/deltachat-ffi/deltachat.h b/deltachat-ffi/deltachat.h index fdc72f20f..b55b9df30 100644 --- a/deltachat-ffi/deltachat.h +++ b/deltachat-ffi/deltachat.h @@ -5017,7 +5017,12 @@ int dc_contact_is_verified (dc_contact_t* contact); /** * Return the address that verified a contact * - * The UI may use this in addition to a checkmark showing the verification status + * The UI may use this in addition to a checkmark showing the verification status. + * In case of verification chains, + * the last contact in the chain is shown. + * This is because of privacy reasons, but also as it would not help the user + * to see a unknown name here - where one can mostly always ask the shown name + * as it is directly known. * * @memberof dc_contact_t * @param contact The contact object.