Cosmetic improvements to man pages

3 files changed, 54 insertions, 30 deletions

diff --git a/docs/reference/gtk/gtk-launch.xml b/docs/reference/gtk/gtk-launch.xml
index 17fc540cfd..1b2ba7b7c2 100644
--- a/docs/reference/gtk/gtk-launch.xml
+++ b/docs/reference/gtk/gtk-launch.xml
@@ -6,7 +6,7 @@
 
 <refentryinfo>
   <title>gtk-launch</title>
-  <productname>gtk+</productname>
+  <productname>GTK+</productname>
   <authorgroup>
     <author>
       <contrib>Developer</contrib>
@@ -48,8 +48,9 @@ the application to launch. The name should match application desktop file name,
 as residing in /usr/share/application, with or without the '.desktop' suffix.
 </para>
 <para>
-If called with more than one argument, the rest of them besides the application name
-are considered URI locations and are passed as arguments to the launched application.
+If called with more than one argument, the rest of them besides the application
+name are considered URI locations and are passed as arguments to the launched
+application.
 </para>
 </refsect1>
 
@@ -63,10 +64,4 @@ are considered URI locations and are passed as arguments to the launched applica
   </variablelist>
 </refsect1>
 
-<refsect1><title>Bugs</title>
-<para>
-None known yet.
-</para>
-</refsect1>
-
 </refentry>
diff --git a/docs/reference/gtk/gtk-query-immodules-3.0.xml b/docs/reference/gtk/gtk-query-immodules-3.0.xml
index 97af84df11..5ebaac7a81 100644
--- a/docs/reference/gtk/gtk-query-immodules-3.0.xml
+++ b/docs/reference/gtk/gtk-query-immodules-3.0.xml
@@ -4,6 +4,18 @@
 ]>
 <refentry id="gtk-query-immodules-3.0">
 
+<refentryinfo>
+  <title>gtk-query-immodules-3.0</title>
+  <productname>GTK+</productname>
+  <authorgroup>
+    <author>
+      <contrib>Developer</contrib>
+      <firstname>Matthias</firstname>
+      <surname>Clasen</surname>
+    </author>
+  </authorgroup>
+</refentryinfo>
+
 <refmeta>
   <refentrytitle>gtk-query-immodules-3.0</refentrytitle>
   <manvolnum>1</manvolnum>
@@ -19,7 +31,7 @@
 <cmdsynopsis>
 <command>gtk-query-immodules-3.0</command>
 <arg choice="opt">--update-cache</arg>
-<arg choice="opt" rep="repeat">module</arg>
+<arg choice="opt" rep="repeat">MODULE</arg>
 </cmdsynopsis>
 </refsynopsisdiv>
 
@@ -37,11 +49,13 @@ module path.
 If called with arguments, it looks for the specified modules. The arguments
 may be absolute or relative paths.
 </para>
+
 <para>
 Normally, the output of <command>gtk-query-immodules-3.0</command> is written
-to <filename><replaceable>libdir</replaceable>/gtk-3.0/3.0.0/immodules.cache</filename>, where GTK+ looks for it by default. If it is written to some other
-location, the environment variable <link linkend="gtk-im-module-file"><envar>GTK_IM_MODULE_FILE</envar></link>
-can be set to point GTK+ at the file.
+to <filename><replaceable>libdir</replaceable>/gtk-3.0/3.0.0/immodules.cache</filename>,
+where GTK+ looks for it by default. If it is written to some other location,
+the <envar>GTK_IM_MODULE_FILE</envar> environment variable can be set to point
+GTK+ at the file.
 </para>
 </refsect1>
 
@@ -55,19 +69,28 @@ can be set to point GTK+ at the file.
 </variablelist>
 </refsect1>
 
-<refsect1><title>Environment</title>
-<para>
-The environment variable <link linkend="gtk-path"><envar>GTK_PATH</envar></link>
-can be used to prepend directories to the input method module path.
-</para>
+<refsect1><title>Files</title>
+<variablelist>
+  <varlistentry>
+    <term><filename><replaceable>libdir</replaceable>/gtk-3.0/3.0.0/immodules.cache</filename></term>
+    <listitem><para>The default im cache file used by GTK+ applications</para></listitem>
+  </varlistentry>
+</variablelist>
+
 </refsect1>
 
-<refsect1><title>Bugs</title>
-<para>
-None known yet.
-</para>
+<refsect1><title>Environment</title>
+<variablelist>
+  <varlistentry>
+    <term><link linkend="gtk-path"><envar>GTK_PATH</envar></link></term>
+    <listitem><para>Prepends directories to the input method module path</para></listitem>
+  </varlistentry>
+  <varlistentry>
+    <term><link linkend="gtk-im-module-file"><envar>GTK_IM_MODULE_FILE</envar></link></term>
+    <listitem><para>Specifies an alternative im module cache for GTK+
+    applications</para></listitem>
+  </varlistentry>
+</variablelist>
 </refsect1>
 
 </refentry>
-
-
diff --git a/docs/reference/gtk/gtk-update-icon-cache.xml b/docs/reference/gtk/gtk-update-icon-cache.xml
index d6f3ac850f..239a899f8d 100644
--- a/docs/reference/gtk/gtk-update-icon-cache.xml
+++ b/docs/reference/gtk/gtk-update-icon-cache.xml
@@ -4,6 +4,18 @@
 ]>
 <refentry id="gtk-update-icon-cache">
 
+<refentryinfo>
+  <title>gtk-update-icon-cache</title>
+  <productname>GTK+</productname>
+  <authorgroup>
+    <author>
+      <contrib>Developer</contrib>
+      <firstname>Matthias</firstname>
+      <surname>Clasen</surname>
+    </author>
+  </authorgroup>
+</refentryinfo>
+
 <refmeta>
   <refentrytitle>gtk-update-icon-cache</refentrytitle>
   <manvolnum>1</manvolnum>
@@ -99,10 +111,4 @@
 </variablelist>
 </refsect1>
 
-<refsect1><title>Bugs</title>
-<para>
-None known yet.
-</para>
-</refsect1>
-
 </refentry>