[kate] doc/katepart: Highlighting Doc: expand explanation about XML files directory

[Christoph Cullmann]

Git commit ba23be52ba3a8ae91c21dab35fb9ae7ace042e0d by Christoph Cullmann, on behalf of Nibaldo González.
Committed on 09/05/2020 at 11:14.
Pushed by cullmann into branch 'master'.

Highlighting Doc: expand explanation about XML files directory

M  +17   -10   doc/katepart/development.docbook

https://invent.kde.org/kde/kate/commit/ba23be52ba3a8ae91c21dab35fb9ae7ace042e0d

diff --git a/doc/katepart/development.docbook b/doc/katepart/development.docbook
index 62fe1d235..4d011ace9 100644
--- a/doc/katepart/development.docbook
+++ b/doc/katepart/development.docbook
@@ -229,20 +229,27 @@ Highlighting repository</ulink> in the file <filename>language.xsd</filename>
 
 <para>Custom <filename class="extension">.xml</filename> highlight definition files are
 located in <filename class="directory">org.kde.syntax-highlighting/syntax/</filename> in
-your user folder found with <userinput><command>qtpaths</command><option>--paths
-GenericDataLocation</option></userinput> which usually is
-<filename class="directory"><envar>$HOME</envar>/.local/share/</filename>.
-</para>
-
-<para>On &Windows; these files are located <filename>%USERPROFILE%/AppData/Local/org.kde.syntax-highlighting/syntax</filename>.
-<replaceable>%USERPROFILE%</replaceable> usually expands to <filename>C:\\Users\\<replaceable>user</replaceable></filename>.</para>
-
-<para>For <ulink url="https://flathub.org/apps/details/org.kde.kate">Kate's Flatpak package</ulink>,
-these files are located <filename class="directory"><envar>$HOME</envar>/.var/app/org.kde.kate/data/org.kde.syntax-highlighting/syntax/</filename>
+your user folder found with <userinput><command>qtpaths</command><option> --paths
+GenericDataLocation</option></userinput> which usually are
+<filename class="directory"><envar>$HOME</envar>/.local/share/</filename>
+and <filename class="directory">/usr/share/</filename>.
+</para>
+
+<para>For Flatpak and Snap packages, the data location is different
+for each application. In a Flatpak application, usually is
+<filename class="directory"><envar>$HOME</envar>/.var/app/<replaceable>package-name</replaceable>/data/</filename>
+and in a Snap application is
+<filename class="directory"><envar>$HOME</envar>/snap/<replaceable>package-name</replaceable>/current/.local/share/</filename>.
+For example, for <ulink url="https://flathub.org/apps/details/org.kde.kate">Kate's Flatpak package</ulink>,
+the custom &XML; files are located in
+<filename class="directory"><envar>$HOME</envar>/.var/app/org.kde.kate/data/org.kde.syntax-highlighting/syntax/</filename>
 and for <ulink url="https://snapcraft.io/kate">Kate's Snap package</ulink>,
 it is <filename class="directory"><envar>$HOME</envar>/snap/kate/current/.local/share/org.kde.syntax-highlighting/syntax/</filename>.
 </para>
 
+<para>On &Windows; these files are located <filename>%USERPROFILE%\AppData\Local\org.kde.syntax-highlighting\syntax</filename>.
+<replaceable>%USERPROFILE%</replaceable> usually expands to <filename>C:\Users\<replaceable>user</replaceable></filename>.</para>
+
 <para>If multiple files exist for the same language, the file with the highest <userinput>version</userinput> attribute in the <userinput>language</userinput> element will be loaded.</para>
 
 <variablelist>