[sdk/lokalize] doc: doc: mention that Esc in catalog filter brings user back to TT field

[Finley Watson]

Git commit db5f31b86fd5561ddb8b95a6299419b12f5d53bb by Finley Watson, on behalf of Kisaragi Hiu.
Committed on 19/08/2025 at 20:58.
Pushed by finw into branch 'master'.

doc: mention that Esc in catalog filter brings user back to TT field

This is so hard to notice that I only noticed it after reading the code
and saw that the filter's Escaped signal is hooked up to focus the Target
Text field. This came after I've prototyped an action to do the same,
thinking there is no keybind to jump from the filter back to the
Target Text field.

    // lokalize/src/editortab.cpp::221
    connect(m_transUnitsView, &CatalogView::escaped, this, &EditorTab::setProperFocus);

Nowhere in the interface is this indicated, even though it's very
useful. The analogous feature in browsers, Ctrl+l to focus the address
bar, does not leave the focus somewhere useful after Esc, so a user used
to Ctrl+l in browsers also wouldn't notice this feature.

This commit doesn't change that fact, but at least those who read the
manual get a chance to be taught this behavior right next to learning
that Ctrl+l focuses the filter bar.

M  +4    -2    doc/index.docbook

https://invent.kde.org/sdk/lokalize/-/commit/db5f31b86fd5561ddb8b95a6299419b12f5d53bb

diff --git a/doc/index.docbook b/doc/index.docbook
index 12390df97..41860a15e 100644
--- a/doc/index.docbook
+++ b/doc/index.docbook
@@ -26,8 +26,8 @@
 
 <legalnotice>&FDLNotice;</legalnotice>
 
-<date>2020-03-09</date>
-<releaseinfo>Applications 20.04</releaseinfo>
+<date>2025-08-19</date>
+<releaseinfo>Applications 25.10</releaseinfo>
 
 <abstract>
 <para>
@@ -174,6 +174,8 @@ menus and toolbars for increased productivity. For example, use the
 <keycombo>&Ctrl;<keycap>L</keycap></keycombo> to focus <guilabel>Quick search</guilabel>
 input line to filter the unit list in <guilabel>Translation Units</guilabel> view.
 Once you are done, press <keycap>Page Down</keycap> to start moving along the filtered list.
+Pressing <keycap>Esc</keycap> in the filter input will move the focus back to the target text
+field without selecting another unit.
 </para>
 </tip>
 <para>