diff --git a/common/annotations/en.xml b/common/annotations/en.xml
index a3f2a11ad41..0fc6360b9b1 100644
--- a/common/annotations/en.xml
+++ b/common/annotations/en.xml
@@ -762,15 +762,15 @@ annotations.
smiling face with smiling eyes
angel | angelic | angels | blessed | face | fairy | fairytale | fantasy | halo | happy | innocent | peaceful | smile | smiling | spirit | tale
smiling face with halo
- 3 | adore | crush | face | heart | hearts | I | ily | love | romance | smile | smiling | you
+ 3 | adore | crush | face | heart | hearts | ily | love | romance | smile | smiling | you
smiling face with hearts
143 | bae | eye | face | feels | heart-eyes | hearts | ily | kisses | love | romance | romantic | smile | xoxo
smiling face with heart-eyes
excited | eyes | face | grinning | smile | star | star-struck | starry-eyed | wow
star-struck
- adorbs | bae | blowing | face | flirt | heart | I | ily | kiss | love | lover | miss | morning | muah | romantic | smooch | xoxo | you
+ adorbs | bae | blowing | face | flirt | heart | ily | kiss | love | lover | miss | muah | romantic | smooch | xoxo | you
face blowing a kiss
- 143 | date | dating | face | flirt | ily | kiss | kisses | kissing | love | smooch | smooches | xoxo | you
+ 143 | date | dating | face | flirt | ily | kiss | love | smooch | smooches | xoxo | you
kissing face
face | happy | outlined | relaxed | smile | smiling
smiling face
@@ -810,11 +810,11 @@ annotations.
zipper-mouth face
disapproval | disbelief | distrust | emoji | eyebrow | face | hmm | mild | raised | scepticism | skeptic | skeptical | surprise | what
face with raised eyebrow
- awkward | blank | deadpan | expressionless | face | fine | jealous | meh | neutral | oh | shade | straight | uh | unamused | unhappy | unimpressed | whatever
+ awkward | blank | deadpan | expressionless | face | fine | jealous | meh | neutral | oh | shade | straight | unamused | unhappy | unimpressed | whatever
neutral face
- awkward | bad | dead | expressionless | face | fine | impressed | inexpressive | jealous | meh | not | oh | omg | straight | uh | unhappy | unimpressed | whatever
+ awkward | dead | expressionless | face | fine | inexpressive | jealous | meh | not | oh | omg | straight | uh | unhappy | unimpressed | whatever
expressionless face
- awkward | blank | cant | even | expressionless | face | mouth | mouthless | mute | quiet | secret | silence | silent | speechlessout
+ awkward | blank | can't | even | expressionless | face | mouth | mouthless | mute | quiet | secret | silence | silent | speechlessout
face without mouth
depressed | disappear | dotted | face | hidden | hide | introvert | invisible | line | meh | whatever | wtv
dotted line face
@@ -896,7 +896,7 @@ annotations.
slightly frowning face
face | frown | frowning | sad
frowning face
- believe | donโt | face | forgot | I | mouth | omg | open | shocked | surprised | sympathy | unbelievable | unreal | whoa | woah | wow | you
+ believe | donโt | face | forgot | mouth | omg | open | shocked | surprised | sympathy | unbelievable | unreal | whoa | wow | you
face with open mouth
epic | face | hushed | omg | stunned | surprised | whoa | woah
hushed face
@@ -988,11 +988,11 @@ annotations.
crying cat
animal | cat | face | pouting
pouting cat
- cant | embarrassed | evil | face | forbidden | forgot | gesture | hide | monkey | no | omg | prohibited | scared | secret | see-no-evil | smh | watch
+ can't | embarrassed | evil | face | forbidden | forgot | gesture | hide | monkey | no | omg | prohibited | scared | secret | smh | watch
see-no-evil monkey
- animal | ears | evil | face | forbidden | gesture | hear | hear-no-evil | listen | monkey | no | not | prohibited | secret | shh | tmi
+ animal | ears | evil | face | forbidden | gesture | hear | listen | monkey | no | not | prohibited | secret | shh | tmi
hear-no-evil monkey
- animal | evil | face | forbidden | gesture | monkey | no | not | oops | prohibited | quiet | secret | speak | speak-no-evil | stealth
+ animal | evil | face | forbidden | gesture | monkey | no | not | oops | prohibited | quiet | secret | speak | stealth
speak-no-evil monkey
heart | letter | love | mail | romance | valentine
love letter
@@ -1072,7 +1072,7 @@ annotations.
thought balloon
comic | good | goodnight | night | sleep | sleeping | sleepy | tired | zzz
ZZZ
- bye | cya | g2g | greetings | gtg | hand | hello | hey | hi | later | outtie | there? | ttfn | ttyl | wave | yo | you
+ bye | cya | g2g | greetings | gtg | hand | hello | hey | hi | later | outtie | ttfn | ttyl | wave | yo | you
waving hand
back | backhand | hand | raised
raised back of hand
@@ -1106,7 +1106,7 @@ annotations.
crossed fingers
<3 | crossed | expensive | finger | hand | heart | index | love | money | snap | thumb
hand with index finger and thumb crossed
- fingers | gesture | hand | I | ILY | love | love-you | three | you
+ fingers | gesture | hand | ILY | love | love-you | three | you
love-you gesture
finger | hand | horns | rock-on | sign
sign of the horns
@@ -1124,9 +1124,9 @@ annotations.
backhand index pointing down
finger | hand | index | point | pointing | this | up
index pointing up
- at | finger | hand | index | pointing | poke | the | viewer | you
+ at | finger | hand | index | pointing | poke | viewer | you
index pointing at the viewer
- +1
+ +1 | good | hand | like | thumb | up | yes
thumbs up
-1 | bad | dislike | down | good | hand | no | nope | thumb | thumbs
thumbs down
@@ -1138,7 +1138,7 @@ annotations.
left-facing fist
fist | right-facing | rightwards
right-facing fist
- applause | approval | awesome | clap | congrats | congratulations | done | excited | good | great | hand | homie | job | nice | prayed | well | yay
+ applause | approval | awesome | clap | congrats | congratulations | excited | good | great | hand | homie | job | nice | prayed | well | yay
clapping hands
celebration | gesture | hand | hands | hooray | praise | raised | raising
raising hands
@@ -1256,11 +1256,11 @@ annotations.
man tipping hand
fetch | flick | flip | gossip | hand | sarcasm | sarcastic | sassy | seriously | tipping | whatever | woman
woman tipping hand
- gesture | hand | here | I | know | me | person | pick | question | raise | raising
+ gesture | hand | here | know | me | person | pick | question | raise | raising
person raising hand
- gesture | hand | here | I | know | man | me | pick | question | raise | raising
+ gesture | hand | here | know | man | me | pick | question | raise | raising
man raising hand
- gesture | hand | here | I | know | me | pick | question | raise | raising | woman
+ gesture | hand | here | know | me | pick | question | raise | raising | woman
woman raising hand
accessibility | deaf | ear | gesture | hear | person
deaf person
@@ -1280,11 +1280,11 @@ annotations.
man facepalming
again | bewilder | disbelief | exasperation | facepalm | no | not | oh | omg | shock | smh | woman
woman facepalming
- doubt | dunno | guess | I | idk | ignorance | indifference | knows | maybe | person | shrug | shrugging | whatever | who
+ doubt | dunno | guess | idk | ignorance | indifference | knows | maybe | person | shrug | shrugging | whatever | who
person shrugging
- doubt | dunno | guess | I | idk | ignorance | indifference | knows | man | maybe | shrug | shrugging | whatever | who
+ doubt | dunno | guess | idk | ignorance | indifference | knows | man | maybe | shrug | shrugging | whatever | who
man shrugging
- doubt | dunno | guess | I | idk | ignorance | indifference | knows | maybe | shrug | shrugging | whatever | who | woman
+ doubt | dunno | guess | idk | ignorance | indifference | knows | maybe | shrug | shrugging | whatever | who | woman
woman shrugging
doctor | health | healthcare | nurse | therapist | worker
health worker
@@ -3641,7 +3641,7 @@ annotations.
transgender symbol
ร | cancel | multiplication | multiply | sign | x
multiply
- +
+ + | plus
plus
- | โ | heavy | math | minus | sign
minus
diff --git a/docs/ldml/tr35-general.md b/docs/ldml/tr35-general.md
index 3c958cf3ef2..cb92e480229 100644
--- a/docs/ldml/tr35-general.md
+++ b/docs/ldml/tr35-general.md
@@ -2620,28 +2620,68 @@ For more information, see version 5.0 or [UTR #51, Unicode Emoji](https://www.un
```
-There are two kinds of annotations: **short names**, and **keywords**.
+There are two kinds of annotations: **short names**, and **search keywords**.
-With an attribute `type="tts"`, the value is a **short name**, such as one that can be used for text-to-speech. It should be treated as one of the element values for other purposes.
+With an attribute `type="tts"`, the value is a **short name**, such as one that can be used for text-to-speech.
+It should be treated as one of the element values for other purposes.
-When there is no `type` attribute, the value is a set of **keywords**, delimited by |. Spaces around each element are to be trimmed. The **keywords** are words associated with the character(s) that might be used in searching for the character, or in predictive typing on keyboards. The short name itself can be used as a keyword.
+When there is no `type` attribute, the value is a set of **keywords**, delimited by |.
+Spaces around each element are to be trimmed.
+The **keywords** are words associated with the character(s) that might be used in searching for the character,
+or in predictive typing on keyboards. The short name itself can be used as a keyword.
Here is an example from German:
```xml
-schlecht | Hand | Daumen | nach unten
+schlecht | Hand | Daumen | nach | unten
Daumen runter
```
-The `cp` attribute value has two formats: either a single string, or if contained within \[โฆ\] a UnicodeSet. The latter format can contain multiple code points or strings. A code point pr string can occur in multiple annotation element **cp** values, such as the following, which also contains the "thumbs down" character.
+These are intended as search keywords, and not for "triggering" (aka suggesting).
+
+- For triggering, the user is typing out a message and concurrently seeing a few emoji
+ displayed adjacent to the virtual keyboard. Selecting the emoji adds it to the message.
+ For example, you mention your birthday while writing, and an emoji cake pops up.
+ That is typically done with an LLM or similar advanced technology.
+- For searching, the user is looking for an emoji in a search box,
+ and typing in in words that narrow down a displayed set of emoji.
+ For example, you type 'heart', but that has too many hits, so you add 'blue' and get the set of blue hearts.
+
+### Usage Model
+
+The usage model for the search keywords is:
+
+- The user types one or more words in an emoji search field.
+- Each word successively narrows a number of emoji in a results box.
+ - heart โ ๐ฅฐ ๐ ๐ป ๐ ๐ ๐ ๐ ๐ ๐ ๐ ๐ ๐ โฃ๏ธ ๐ โค๏ธโ๐ฅ โค๏ธโ๐ฉน โค๏ธ ๐ฉท ๐งก ๐ ๐ ๐ ๐ฉต ๐ ๐ค ๐ค ๐ฉถ ๐ค ๐ ๐ซฐ ๐ซถ ๐ซ ๐ ๐ ๐ ๐ก โฅ๏ธ ๐ฉบ
+ - blue โ ๐ฅถ ๐ฐ ๐ ๐ฉต ๐ซ ๐ ๐ ๐ ๐งฟ ๐ต ๐ฆ ๐ท ๐น ๐ณ๏ธโโง๏ธ
+ - heart blue โ ๐ ๐ฉต
+- A word with no hits is ignored
+ - [heart | blue | confabulation] is equivalent to [heart | blue]
+- As the user types a word, each character added to the word narrows the results.
+- Whenever the list is short enough to scan, the user will mouse-click on the right emoji โ so it doesnโt have to be narrowed too far.
+ - In the following, the user would just click on ๐ if that works for them.
+ - celebrate โ ๐ฅณ ๐ฅ ๐ ๐ ๐ ๐ช
+- The order of words doesnโt matter.
+
+Multiword search keywords are typically broken up into separate parts,
+because that works better with the usage model. So [hand | mouth | omg | open | over] covers the phrase "hand over mouth".
+
+### cp attribute
+
+The `cp` attribute value has two formats: either a single string, or if contained within \[โฆ\] a UnicodeSet.
+The latter format can contain multiple code points or strings. A code point pr string can occur in multiple annotation element **cp** values, such as the following, which also contains the "thumbs down" character.
```xml
hand
```
-Both for short names and keywords, values do not have to match between different languages. They should be the most common values that people using _that_ language would associate with those characters. For example, a "black heart" might have the association of "wicked" in English, but not in some other languages.
+Both for short names and keywords, values do not have to match between different languages.
+They should be the most common values that people using _that_ language would associate with those characters.
+For example, a "black heart" might have the association of "wicked" in English, but not in some other languages.
-The cp value may contain sequences, but does not contain any Emoji or Text Variant (VS15 & VS16) characters. All such characters should be removed before looking up any short names and keywords.
+The cp value may contain sequences, but does not contain any Emoji or Text Variant (VS15 & VS16) characters.
+All such characters should be removed before looking up any short names and keywords.
### Synthesizing Sequence Names