update function documentation

This commit is contained in:
Hubert Chathi 2021-11-23 16:13:42 -05:00
parent 5e5e32fe83
commit 6f59e16b58
2 changed files with 11 additions and 3 deletions

View file

@ -107,8 +107,10 @@ struct Account {
std::uint8_t * one_time_json, std::size_t one_time_json_length
);
/** Mark the current list of one_time_keys as being published. They
* will no longer be returned by get_one_time_keys_json_length(). */
/** Mark the current list of one_time_keys and the current fallback key as
* being published. The current one time keys will no longer be returned by
* get_one_time_keys_json() and the current fallback key will no longer be
* returned by get_unpublished_fallback_key_json(). */
std::size_t mark_keys_as_published();
/** The largest number of one time keys this account can store. */

View file

@ -245,7 +245,13 @@ OLM_EXPORT size_t olm_account_one_time_keys(
void * one_time_keys, size_t one_time_keys_length
);
/** Marks the current set of one time keys as being published. */
/** Marks the current set of one time keys and fallback key as being published
* Once marked as published, the one time keys will no longer be returned by
* olm_account_one_time_keys(), and the fallback key will no longer be returned
* by olm_account_unpublished_fallback_key().
*
* Returns the number of one-time keys that were marked as published. Note that
* this count does not include the fallback key. */
OLM_EXPORT size_t olm_account_mark_keys_as_published(
OlmAccount * account
);