its: Improve comments in *.its files.

* gettext-tools/its/glade2.its: Improve comments.
* gettext-tools/its/gtkbuilder.its: Likewise.
* gettext-tools/its/gsettings.its: Likewise.
* gettext-tools/its/metainfo.its: Likewise.

diff --git a/gettext-tools/its/glade2.its b/gettext-tools/its/glade2.its
index 48220f302683939e616ece6c8a970c137c885794..8b38db7509476355b8482948981b7e874a83bfe9 100644 (file)
--- a/gettext-tools/its/glade2.its
+++ b/gettext-tools/its/glade2.its
@@ -19,6 +19,12 @@
 <its:rules xmlns:its="http://www.w3.org/2005/11/its"
            xmlns:gt="https://www.gnu.org/s/gettext/ns/its/extensions/1.0"
            version="2.0">
+
+  <!-- Documentation of the Glade 2 XML file format:
+       https://download.gnome.org/sources/libglade/2.6/libglade-2.6.4.tar.gz
+       file libglade-2.6.4/doc/html/libglade-dtd.html
+  -->
+
   <its:translateRule selector="/glade-interface" translate="no"/>
   <its:translateRule
       selector="/glade-interface//property[@translatable = 'yes'] |

diff --git a/gettext-tools/its/gsettings.its b/gettext-tools/its/gsettings.its
index c69f1d2f477827514453ce5356e321dbf9bb921a..fe963846b50ed3183ac0ff16dcfd2e982026a1db 100644 (file)
--- a/gettext-tools/its/gsettings.its
+++ b/gettext-tools/its/gsettings.its
@@ -19,6 +19,11 @@
 <its:rules xmlns:its="http://www.w3.org/2005/11/its"
            xmlns:gt="https://www.gnu.org/s/gettext/ns/its/extensions/1.0"
            version="2.0">
+
+  <!-- Documentation of the GSettings XML file format:
+       https://docs.gtk.org/gio/class.Settings.html
+  -->
+
   <its:translateRule selector="/schemalist" translate="no"/>
 
   <its:translateRule selector="//summary | //description" translate="yes"/>

diff --git a/gettext-tools/its/gtkbuilder.its b/gettext-tools/its/gtkbuilder.its
index a984511d5f96792d91c0c00bd477fd7cd8d19eb5..9d28531a78e578f896eba324e576f15306f11ccd 100644 (file)
--- a/gettext-tools/its/gtkbuilder.its
+++ b/gettext-tools/its/gtkbuilder.its
@@ -19,8 +19,16 @@
 <its:rules xmlns:its="http://www.w3.org/2005/11/its"
            xmlns:gt="https://www.gnu.org/s/gettext/ns/its/extensions/1.0"
            version="2.0">
+
+  <!-- Documentation of the GtkBuilder XML file format:
+       https://docs.gtk.org/gtk3/class.Builder.html
+       https://docs.gtk.org/gtk4/class.Builder.html
+       A better documentation does not exist; see
+       https://gitlab.gnome.org/GNOME/gtk/-/issues/4039 .
+  -->
+
   <its:translateRule selector="/interface" translate="no"/>
-  <!-- https://developer-old.gnome.org/gtk4/stable/GtkBuilder.html says about
+  <!-- https://docs.gtk.org/gtk4/class.Builder.html says about
        boolean attribute values:
        "strings like “TRUE”, “t”, “yes”, “y”, “1” are interpreted as TRUE,
         strings like “FALSE”, “f”, “no”, “n”, “0” are interpreted as FALSE"

diff --git a/gettext-tools/its/metainfo.its b/gettext-tools/its/metainfo.its
index 466c250a3736748836c89f858fce63c2f55ca532..ec0fb7df6687488b923d8e6a0bd412265b59a8dc 100644 (file)
--- a/gettext-tools/its/metainfo.its
+++ b/gettext-tools/its/metainfo.its
@@ -19,6 +19,11 @@
 <its:rules xmlns:its="http://www.w3.org/2005/11/its"
            xmlns:gt="https://www.gnu.org/s/gettext/ns/its/extensions/1.0"
            version="2.0">
+
+  <!-- Documentation of the *.metainfo.xml file format:
+       https://www.freedesktop.org/software/appstream/docs/chap-Quickstart.html
+  -->
+
   <its:translateRule selector="/component" translate="no"/>
   <its:translateRule selector="/component/name |
                                /component/summary |