[utilities/kate] /: Rename to "Scripts & Snippets", and add a little explanation of terms

Thomas Friedrichsmeier null at kde.org
Tue Jun 10 13:42:34 BST 2025


Git commit 854c2a9e13ec56d0c6583eb3ffa12fd774c67dfc by Thomas Friedrichsmeier.
Committed on 10/06/2025 at 12:37.
Pushed by tfry into branch 'master'.

Rename to "Scripts & Snippets", and add a little explanation of terms

M  +2    -2    addons/snippets/katesnippetsplugin.json
M  +12   -5    doc/kate/plugins.docbook

https://invent.kde.org/utilities/kate/-/commit/854c2a9e13ec56d0c6583eb3ffa12fd774c67dfc

diff --git a/addons/snippets/katesnippetsplugin.json b/addons/snippets/katesnippetsplugin.json
index 5eefc997d5..4a8aeea32c 100644
--- a/addons/snippets/katesnippetsplugin.json
+++ b/addons/snippets/katesnippetsplugin.json
@@ -1,6 +1,6 @@
 {
     "KPlugin": {
-        "Description": "Manage your code snippets or download new ones",
+        "Description": "Create or download code snippets and editor scripts",
         "Description[ar]": "إدارة مقتطفات التعليمات البرمجية الخاصة بك أو تنزيل مقتطفات جديدة",
         "Description[az]": "Kod fraqmentlərini idarə edin və yenilərini endirin",
         "Description[bg]": "Управлявайте фрагментите си с код или изтегляйте нови",
@@ -41,7 +41,7 @@
         "Description[zh_CN]": "管理您的代码片段或下载新代码片段",
         "Description[zh_TW]": "管理您的程式碼片段,或下載新的",
         "Icon": "document-new",
-        "Name": "Snippets",
+        "Name": "Scripts & Snippets",
         "Name[ar]": "القصاصات",
         "Name[az]": "Fraqmentlər",
         "Name[bg]": "Снипети",
diff --git a/doc/kate/plugins.docbook b/doc/kate/plugins.docbook
index 17b1654ddf..8bef100270 100644
--- a/doc/kate/plugins.docbook
+++ b/doc/kate/plugins.docbook
@@ -93,7 +93,7 @@ simple &gdb; frontend</para>
 Search and replace in documents, folders, or projects</para>
 </listitem>
 <listitem>
-<para><link linkend="kate-application-plugin-snippets">Snippets tool view</link> - Tool view embedding the snippets management</para>
+<para><link linkend="kate-application-plugin-snippets">Scripts & Snippets tool view</link> - Create or download code snippets and editor scripts</para>
 </listitem>
 <listitem>
 <para><link linkend="kate-application-plugin-keyboardmacros">Keyboard Macros</link>
@@ -3328,13 +3328,20 @@ plugin.</para>
 <author>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
 </authorgroup>
 </sect1info>
-<title>&kate; Snippets</title>
+<title>&kate; Scripts & Snippets</title>
 
 <sect2 id="snippets-intro">
 <title>Introduction</title>
-<para>&kate; Snippets is a plugin used to save you some time by adding support for
-so-called <quote>snippets</quote> (re-usable source code, machine code or text). The plugin
-also supports code completion and &javascript;.</para>
+<para>The &kate; Scripts & Snippets plugin allows you to add, and manage your own bits of
+automation. This can range from static re-useable pieces of plain text, over sophisticated templates with
+custom automated and scriptable fields, to fully custom &javascript; scripts to modify the contents of your
+document.</para>
+<para>For ease of reading, and because these types of content are mananged in exactly the same way, for the
+most part, the following discussion does not make a distinction between static snippets, scripted snippets,
+and scripts. Rather, the term <quote>snippet</quote> is be used to refer to all of them.</para>
+<para>The plugin also supports assigning keyboard shortcuts, and inserting snippets via
+code completion. Further you can download collections of snippets (so-called
+repositories) from the internet.</para>
 </sect2>
 
 <sect2 id="snippets-menu">



More information about the kde-doc-english mailing list