diff --git a/api_docs/changelog.md b/api_docs/changelog.md index 56cca108ed..1794441747 100644 --- a/api_docs/changelog.md +++ b/api_docs/changelog.md @@ -204,9 +204,12 @@ No changes; feature level used for Zulip 8.0 release. **Feature level 224** * [`GET /events`](/api/get-events), [`GET /messages`](/api/get-messages), - [`GET /messages/{message_id}`](/api/get-message): The `wildcard_mentioned` - flag was deprecated, replaced with `stream_wildcard_mentioned` and - `topic_wildcard_mentioned`, but it is still available for backwards compatibility. + [`GET /messages/{message_id}`](/api/get-message): Of the [available + message flags](/api/update-message-flags#available-flags) that a user + may have for a message, the `wildcard_mentioned` flag was + deprecated in favor of the `stream_wildcard_mentioned` and + `topic_wildcard_mentioned` flags, but it is still available for + backwards compatibility. **Feature level 223** diff --git a/zerver/openapi/zulip.yaml b/zerver/openapi/zulip.yaml index 251e98b097..26a2ff4fc8 100644 --- a/zerver/openapi/zulip.yaml +++ b/zerver/openapi/zulip.yaml @@ -958,13 +958,14 @@ paths: in a new message that the server has already marked as read for the user. - **Changes**: In Zulip 8.0 (feature level 224), the `wildcard_mentioned` flag - was deprecated in favor of the `stream_wildcard_mentioned` and `topic_wildcard_mentioned` - flags. The `wildcard_mentioned` flag exists for backwards compatibility with - older clients and equals `stream_wildcard_mentioned` || `topic_wildcard_mentioned`. - Clients interacting with older servers should treat this field as an old name - for `stream_wildcard_mentioned`. @topic mentions were not available prior to - this feature level. + **Changes**: In Zulip 8.0 (feature level 224), the `wildcard_mentioned` + flag was deprecated in favor of the `stream_wildcard_mentioned` and + `topic_wildcard_mentioned` flags. The `wildcard_mentioned` flag exists + for backwards compatibility with older clients and equals + `stream_wildcard_mentioned || topic_wildcard_mentioned`. Clients + supporting older server versions should treat this field as a previous + name for the `stream_wildcard_mentioned` flag as topic wildcard mentions + were not available prior to this feature level. [message-flags]: /api/update-message-flags#available-flags items: @@ -2412,13 +2413,14 @@ paths: to identify cases where a mention or alert word was added by the edit. - **Changes**: In Zulip 8.0 (feature level 224), the `wildcard_mentioned` flag - was deprecated in favor of the `stream_wildcard_mentioned` and `topic_wildcard_mentioned` - flags. The `wildcard_mentioned` flag exists for backwards compatibility with - older clients and equals `stream_wildcard_mentioned` || `topic_wildcard_mentioned`. - Clients interacting with older servers should treat this field as an old name - for `stream_wildcard_mentioned`. @topic mentions were not available prior to - this feature level. + **Changes**: In Zulip 8.0 (feature level 224), the `wildcard_mentioned` + flag was deprecated in favor of the `stream_wildcard_mentioned` and + `topic_wildcard_mentioned` flags. The `wildcard_mentioned` flag exists + for backwards compatibility with older clients and equals + `stream_wildcard_mentioned || topic_wildcard_mentioned`. Clients + supporting older server versions should treat this field as a previous + name for the `stream_wildcard_mentioned` flag as topic wildcard mentions + were not available prior to this feature level. [message-flags]: /api/update-message-flags#available-flags items: @@ -6318,13 +6320,14 @@ paths: description: | The user's [message flags][message-flags] for the message. - **Changes**: In Zulip 8.0 (feature level 224), the `wildcard_mentioned` flag - was deprecated in favor of the `stream_wildcard_mentioned` and `topic_wildcard_mentioned` - flags. The `wildcard_mentioned` flag exists for backwards compatibility with - older clients and equals `stream_wildcard_mentioned` || `topic_wildcard_mentioned`. - Clients interacting with older servers should treat this field as an old name - for `stream_wildcard_mentioned`. @topic mentions were not available prior to - this feature level. + **Changes**: In Zulip 8.0 (feature level 224), the `wildcard_mentioned` + flag was deprecated in favor of the `stream_wildcard_mentioned` and + `topic_wildcard_mentioned` flags. The `wildcard_mentioned` flag exists + for backwards compatibility with older clients and equals + `stream_wildcard_mentioned || topic_wildcard_mentioned`. Clients + supporting older server versions should treat this field as a previous + name for the `stream_wildcard_mentioned` flag as topic wildcard mentions + were not available prior to this feature level. [message-flags]: /api/update-message-flags#available-flags items: @@ -6837,44 +6840,28 @@ paths: a mention of the current user. -
wildcard_mentioned
stream_wildcard_mentioned
topic_wildcard_mentioned
has_alert_word
historical
true
for messages that the user did not receive
at the time they were sent but later was added to
- the user's history (E.g. because they starred or
+ the user's history (e.g. because they starred or
reacted to a message sent to a public stream
before they subscribed to that stream). Cannot be
changed by the user directly.
wildcard_mentioned
stream_wildcard_mentioned
and
+ topic_wildcard_mentioned
flags. The
+ wildcard_mentioned
flag exists for backwards compatibility
+ with older clients and equals
+ stream_wildcard_mentioned || topic_wildcard_mentioned
.
+ Clients supporting older server versions should treat this field as a
+ previous name for the stream_wildcard_mentioned
flag as
+ topic wildcard mentions were not available prior to this feature level.
+