Git commit 25879726e1ff4c049c5fc5b97ae676f6e983e175 by Nathaniel Graham. Committed on 30/07/2018 at 22:27. Pushed by ngraham into branch 'master'.
Improve the discoverability of the Filter Text plugin and its menu item Summary: The "Filter Text" plugin is one of Kate's most useful plugins for serious professional use, but it's rather hidden behind a nondescript name, caption, and menu item. This patch improves the caption to mention "terminal commands" to give a hint about its true power, and also uses a compact variant of that same terminology for the menu item. These changes should improve discoverability. BUG: 396864 FIXED-IN: 18.12.0 Test Plan: More descriptive caption in the plugins list: {F6142006} More descriptive menu item text: {F6142008} Reviewers: #kate, dhaumann, cullmann Reviewed By: #kate, dhaumann, cullmann Subscribers: kde-doc-english, lueck, kwrite-devel Tags: #kate, #documentation Differential Revision: https://phabricator.kde.org/D14390 M +1 -1 addons/textfilter/plugin_katetextfilter.cpp M +1 -1 addons/textfilter/textfilterplugin.desktop M +4 -4 doc/kate/plugins.docbook https://commits.kde.org/kate/25879726e1ff4c049c5fc5b97ae676f6e983e175 diff --git a/addons/textfilter/plugin_katetextfilter.cpp b/addons/textfilter/plugin_katetextfilter.cpp index 023c9b66e..6aa99419b 100644 --- a/addons/textfilter/plugin_katetextfilter.cpp +++ b/addons/textfilter/plugin_katetextfilter.cpp @@ -260,7 +260,7 @@ PluginViewKateTextFilter::PluginViewKateTextFilter(PluginKateTextFilter *plugin, // create our one and only action QAction* a = actionCollection()->addAction(QStringLiteral("edit_filter")); - a->setText(i18n("Filter Te&xt...")); + a->setText(i18n("&Filter Through Command...")); actionCollection()->setDefaultShortcut(a, Qt::CTRL + Qt::Key_Backslash); connect(a, &QAction::triggered, plugin, &PluginKateTextFilter::slotEditFilter); diff --git a/addons/textfilter/textfilterplugin.desktop b/addons/textfilter/textfilterplugin.desktop index e3eb87b46..1ae72fb84 100644 --- a/addons/textfilter/textfilterplugin.desktop +++ b/addons/textfilter/textfilterplugin.desktop @@ -60,7 +60,7 @@ Name[vi]=Bộ lọc văn bản Name[x-test]=xxText Filterxx Name[zh_CN]=文本过滤 Name[zh_TW]=文字過濾器 -Comment=Easy text filtering +Comment=Process text using terminal commands Comment[ar]=ترشيح سهل للنّصوص Comment[ast]=Peñera fácil de testu Comment[bg]=Лесно филтриране на текст diff --git a/doc/kate/plugins.docbook b/doc/kate/plugins.docbook index 0416d6061..69cf42a31 100644 --- a/doc/kate/plugins.docbook +++ b/doc/kate/plugins.docbook @@ -2874,14 +2874,14 @@ so the calling program is aware you have finished editing the file.</para></list <sect1 id="kate-application-plugin-textfilter"> -<title>Text Filter Plugin</title><!--Name is completely misleading and should be changed--> +<title>Text Filter Plugin</title> <sect2 id="textfilter-using"> <title>Using the Text Filter Plugin</title> -<para>You can use this plugin to execute shell commands. A selection will -be used as argument for the shell command, the output will either replace the selection -or copied to the clipboard. +<para>You can use this plugin to process selected text using terminal commands. +The selection will be used as input for the command, and the output will either +replace the selection or be copied to the clipboard, depending on the user's preference. </para> <itemizedlist>