From 703b33d94b3cc531f9c14f13e55a788f5d7d5372 Mon Sep 17 00:00:00 2001
From: Matthias Clasen <matthiasc@src.gnome.org>
Date: Fri, 29 Nov 2002 23:08:54 +0000
Subject: [PATCH] Minor tweaks and completions of shortdescs.

	* gtk/tmpl/gtkalignment.sgml:
	* gtk/tmpl/gtkadjustment.sgml:
	* gtk/tmpl/gtkaccellabel.sgml:
	* gtk/tmpl/gtkoldeditable.sgml:
	* gtk/tmpl/gtkwidget.sgml:
	* gtk/tmpl/gtkrange.sgml:
	* gtk/tmpl/gtkeditable.sgml:
	* gtk/tmpl/gtkwindowgroup.sgml:
	* gtk/tmpl/gtkwindow.sgml:
	* gtk/tmpl/gtktypeutils.sgml:
	* gtk/tmpl/gtksignal.sgml:
	* gtk/tmpl/gtkfeatures.sgml:
	* gtk/tmpl/gtkstyle.sgml:
	* gtk/tmpl/gtkselection.sgml:
	* gtk/tmpl/gtkgc.sgml:
	* gtk/tmpl/gtkenums.sgml:
	* gtk/tmpl/gtkbindings.sgml:
	* gtk/tmpl/gtksettings.sgml:
	* gtk/tmpl/gtkdnd.sgml:
	* gtk/tmpl/gtkclipboard.sgml:
	* gtk/tmpl/gtkaccelgroup.sgml:
	* gtk/tmpl/gtkaccelmap.sgml:
	Minor tweaks and completions of shortdescs.
---
 docs/reference/ChangeLog                    |  24 +++++
 docs/reference/gtk/gtk-docs.sgml            |   2 +-
 docs/reference/gtk/tmpl/gtk-unused.sgml     | 108 ++++++++++++++++++++
 docs/reference/gtk/tmpl/gtkaccelgroup.sgml  |   5 +-
 docs/reference/gtk/tmpl/gtkaccellabel.sgml  |   2 +-
 docs/reference/gtk/tmpl/gtkaccelmap.sgml    |   2 +-
 docs/reference/gtk/tmpl/gtkadjustment.sgml  |   2 +-
 docs/reference/gtk/tmpl/gtkalignment.sgml   |   2 +-
 docs/reference/gtk/tmpl/gtkbindings.sgml    |   2 +-
 docs/reference/gtk/tmpl/gtkclipboard.sgml   |   2 +-
 docs/reference/gtk/tmpl/gtkcontainer.sgml   |   2 +-
 docs/reference/gtk/tmpl/gtkdnd.sgml         |   2 +-
 docs/reference/gtk/tmpl/gtkeditable.sgml    |   2 +-
 docs/reference/gtk/tmpl/gtkenums.sgml       |   2 +-
 docs/reference/gtk/tmpl/gtkfeatures.sgml    |   2 +-
 docs/reference/gtk/tmpl/gtkgc.sgml          |   2 +-
 docs/reference/gtk/tmpl/gtkitemfactory.sgml |   2 +-
 docs/reference/gtk/tmpl/gtkoldeditable.sgml |   2 +-
 docs/reference/gtk/tmpl/gtkrange.sgml       |   2 +-
 docs/reference/gtk/tmpl/gtkselection.sgml   |   2 +-
 docs/reference/gtk/tmpl/gtksettings.sgml    |  94 +----------------
 docs/reference/gtk/tmpl/gtksignal.sgml      |   2 +-
 docs/reference/gtk/tmpl/gtkstyle.sgml       |   2 +-
 docs/reference/gtk/tmpl/gtktypeutils.sgml   |   2 +-
 docs/reference/gtk/tmpl/gtkwidget.sgml      |   2 +-
 docs/reference/gtk/tmpl/gtkwindow.sgml      |   2 +-
 docs/reference/gtk/tmpl/gtkwindowgroup.sgml |   2 +-
 27 files changed, 159 insertions(+), 118 deletions(-)

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 3115b22bd5..addac6a48e 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,5 +1,29 @@
 2002-11-29  Matthias Clasen  <maclas@gmx.de>
 
+	* gtk/tmpl/gtkalignment.sgml: 
+	* gtk/tmpl/gtkadjustment.sgml: 
+	* gtk/tmpl/gtkaccellabel.sgml: 
+	* gtk/tmpl/gtkoldeditable.sgml: 
+	* gtk/tmpl/gtkwidget.sgml: 
+	* gtk/tmpl/gtkrange.sgml: 
+	* gtk/tmpl/gtkeditable.sgml: 
+	* gtk/tmpl/gtkwindowgroup.sgml:
+	* gtk/tmpl/gtkwindow.sgml: 
+	* gtk/tmpl/gtktypeutils.sgml: 
+	* gtk/tmpl/gtksignal.sgml: 
+	* gtk/tmpl/gtkfeatures.sgml: 
+	* gtk/tmpl/gtkstyle.sgml: 
+	* gtk/tmpl/gtkselection.sgml: 
+	* gtk/tmpl/gtkgc.sgml: 
+	* gtk/tmpl/gtkenums.sgml: 
+	* gtk/tmpl/gtkbindings.sgml: 
+	* gtk/tmpl/gtksettings.sgml: 
+	* gtk/tmpl/gtkdnd.sgml: 
+	* gtk/tmpl/gtkclipboard.sgml: 
+	* gtk/tmpl/gtkaccelgroup.sgml: 
+	* gtk/tmpl/gtkaccelmap.sgml: 
+	Minor tweaks and completions of shortdescs.
+	
 	* gdk/tmpl/rgb.sgml: 
 	* gdk/tmpl/gcs.sgml: Minor tweaks.
 
diff --git a/docs/reference/gtk/gtk-docs.sgml b/docs/reference/gtk/gtk-docs.sgml
index 522072dbb2..75b40dcf02 100644
--- a/docs/reference/gtk/gtk-docs.sgml
+++ b/docs/reference/gtk/gtk-docs.sgml
@@ -262,7 +262,6 @@ that is, GUI components such as #GtkButton or #GtkTextView.
 
   <part  id="gtkbase">
     <title>GTK+ Core Reference</title>
-
     &gtk-General;
     &GtkAccelGroup;
     &gtk-accel-map;
@@ -280,6 +279,7 @@ that is, GUI components such as #GtkButton or #GtkTextView.
     &gtk-Feature-Test-Macros;
     &gtk-Signals;
     &gtk-Types;
+
   </part>
 
   <part id="gtkobjects">
diff --git a/docs/reference/gtk/tmpl/gtk-unused.sgml b/docs/reference/gtk/tmpl/gtk-unused.sgml
index f03b3deefb..df6231ff3c 100644
--- a/docs/reference/gtk/tmpl/gtk-unused.sgml
+++ b/docs/reference/gtk/tmpl/gtk-unused.sgml
@@ -1065,24 +1065,132 @@ after other user handlers and the default handler.
 </para>
 
 
+<!-- ##### ARG GtkSettings:gtk-can-change-accels ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-color-palette ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-cursor-blink ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-cursor-blink-time ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-dnd-drag-threshold ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-double-click-time ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-entry-select-on-focus ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-font-name ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-icon-sizes ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-key-theme-name ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-menu-bar-accel ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### ARG GtkSettings:gtk-menu-bar-popout-delay ##### -->
 <para>
 
 </para>
 
 
+<!-- ##### ARG GtkSettings:gtk-menu-bar-popup-delay ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-menu-popdown-delay ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### ARG GtkSettings:gtk-menu-popout-delay ##### -->
 <para>
 
 </para>
 
 
+<!-- ##### ARG GtkSettings:gtk-menu-popup-delay ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### ARG GtkSettings:gtk-menu-submenu-hysteresis ##### -->
 <para>
 
 </para>
 
 
+<!-- ##### ARG GtkSettings:gtk-split-cursor ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-theme-name ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-toolbar-icon-size ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GtkSettings:gtk-toolbar-style ##### -->
+<para>
+
+</para>
+
+
 <!-- ##### STRUCT GtkSettingsClass ##### -->
 <para>
 
diff --git a/docs/reference/gtk/tmpl/gtkaccelgroup.sgml b/docs/reference/gtk/tmpl/gtkaccelgroup.sgml
index 49e042ce16..6a503af878 100644
--- a/docs/reference/gtk/tmpl/gtkaccelgroup.sgml
+++ b/docs/reference/gtk/tmpl/gtkaccelgroup.sgml
@@ -1,9 +1,8 @@
 <!-- ##### SECTION Title ##### -->
-Keyboard Accelerator Groups
+Accelerator Groups
 
 <!-- ##### SECTION Short_Description ##### -->
-
-Groups of global keyboard accelerators for an entire #GtkWindow
+Groups of global keyboard accelerators for an entire GtkWindow
 
 <!-- ##### SECTION Long_Description ##### -->
 <para id="GtkAccelGroup">
diff --git a/docs/reference/gtk/tmpl/gtkaccellabel.sgml b/docs/reference/gtk/tmpl/gtkaccellabel.sgml
index e907572ef4..222c0ec661 100644
--- a/docs/reference/gtk/tmpl/gtkaccellabel.sgml
+++ b/docs/reference/gtk/tmpl/gtkaccellabel.sgml
@@ -2,7 +2,7 @@
 GtkAccelLabel
 
 <!-- ##### SECTION Short_Description ##### -->
-a label which displays an accelerator key on the right of the text.
+A label which displays an accelerator key on the right of the text
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkaccelmap.sgml b/docs/reference/gtk/tmpl/gtkaccelmap.sgml
index b69779bb8d..df9eec4c54 100644
--- a/docs/reference/gtk/tmpl/gtkaccelmap.sgml
+++ b/docs/reference/gtk/tmpl/gtkaccelmap.sgml
@@ -2,7 +2,7 @@
 Accelerator Maps
 
 <!-- ##### SECTION Short_Description ##### -->
-
+Loadable keyboard accelerator specifications
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkadjustment.sgml b/docs/reference/gtk/tmpl/gtkadjustment.sgml
index b038e3219e..aac7fc7949 100644
--- a/docs/reference/gtk/tmpl/gtkadjustment.sgml
+++ b/docs/reference/gtk/tmpl/gtkadjustment.sgml
@@ -2,7 +2,7 @@
 GtkAdjustment
 
 <!-- ##### SECTION Short_Description ##### -->
-a #GtkObject representing an adjustable bounded value.
+A GtkObject representing an adjustable bounded value
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkalignment.sgml b/docs/reference/gtk/tmpl/gtkalignment.sgml
index 8e8e196ada..2693f30ef7 100644
--- a/docs/reference/gtk/tmpl/gtkalignment.sgml
+++ b/docs/reference/gtk/tmpl/gtkalignment.sgml
@@ -2,7 +2,7 @@
 GtkAlignment
 
 <!-- ##### SECTION Short_Description ##### -->
-a widget which controls the alignment and size of its child.
+A widget which controls the alignment and size of its child
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkbindings.sgml b/docs/reference/gtk/tmpl/gtkbindings.sgml
index de8fd6af4f..5ed20ca975 100644
--- a/docs/reference/gtk/tmpl/gtkbindings.sgml
+++ b/docs/reference/gtk/tmpl/gtkbindings.sgml
@@ -2,7 +2,7 @@
 Bindings
 
 <!-- ##### SECTION Short_Description ##### -->
-
+Key bindings for individual widgets
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkclipboard.sgml b/docs/reference/gtk/tmpl/gtkclipboard.sgml
index c26b42d5eb..93fffa8be1 100644
--- a/docs/reference/gtk/tmpl/gtkclipboard.sgml
+++ b/docs/reference/gtk/tmpl/gtkclipboard.sgml
@@ -2,7 +2,7 @@
 Clipboards
 
 <!-- ##### SECTION Short_Description ##### -->
-Storing data on clipboards.
+Storing data on clipboards
 
 <!-- ##### SECTION Long_Description ##### -->
   <para>
diff --git a/docs/reference/gtk/tmpl/gtkcontainer.sgml b/docs/reference/gtk/tmpl/gtkcontainer.sgml
index 76c478992b..f87a9545a3 100644
--- a/docs/reference/gtk/tmpl/gtkcontainer.sgml
+++ b/docs/reference/gtk/tmpl/gtkcontainer.sgml
@@ -2,7 +2,7 @@
 GtkContainer
 
 <!-- ##### SECTION Short_Description ##### -->
-
+Base class for widgets which contain other widgets
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkdnd.sgml b/docs/reference/gtk/tmpl/gtkdnd.sgml
index abab9afaf5..28af208234 100644
--- a/docs/reference/gtk/tmpl/gtkdnd.sgml
+++ b/docs/reference/gtk/tmpl/gtkdnd.sgml
@@ -2,7 +2,7 @@
 Drag and Drop
 
 <!-- ##### SECTION Short_Description ##### -->
-Functions for controlling drag and drop handling.
+Functions for controlling drag and drop handling
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkeditable.sgml b/docs/reference/gtk/tmpl/gtkeditable.sgml
index e1016e97e2..0f988ac946 100644
--- a/docs/reference/gtk/tmpl/gtkeditable.sgml
+++ b/docs/reference/gtk/tmpl/gtkeditable.sgml
@@ -2,7 +2,7 @@
 GtkEditable
 
 <!-- ##### SECTION Short_Description ##### -->
-Base class for text-editing widgets.
+Interface for text-editing widgets.
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkenums.sgml b/docs/reference/gtk/tmpl/gtkenums.sgml
index a7d5089cd9..c372aca9da 100644
--- a/docs/reference/gtk/tmpl/gtkenums.sgml
+++ b/docs/reference/gtk/tmpl/gtkenums.sgml
@@ -2,7 +2,7 @@
 Standard Enumerations
 
 <!-- ##### SECTION Short_Description ##### -->
-Public enumerated types used throughout GTK+.
+Public enumerated types used throughout GTK+
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkfeatures.sgml b/docs/reference/gtk/tmpl/gtkfeatures.sgml
index 01e582fddd..3f0bcabe92 100644
--- a/docs/reference/gtk/tmpl/gtkfeatures.sgml
+++ b/docs/reference/gtk/tmpl/gtkfeatures.sgml
@@ -2,7 +2,7 @@
 Version Information
 
 <!-- ##### SECTION Short_Description ##### -->
-variables and functions to check the GTK+ version.
+Variables and functions to check the GTK+ version
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkgc.sgml b/docs/reference/gtk/tmpl/gtkgc.sgml
index e921ac628e..ac5a922c86 100644
--- a/docs/reference/gtk/tmpl/gtkgc.sgml
+++ b/docs/reference/gtk/tmpl/gtkgc.sgml
@@ -2,7 +2,7 @@
 Graphics Contexts
 
 <!-- ##### SECTION Short_Description ##### -->
-provides access to a shared pool of #GdkGC objects.
+A shared pool of GdkGC objects
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkitemfactory.sgml b/docs/reference/gtk/tmpl/gtkitemfactory.sgml
index f64ad3de0a..8b72751d80 100644
--- a/docs/reference/gtk/tmpl/gtkitemfactory.sgml
+++ b/docs/reference/gtk/tmpl/gtkitemfactory.sgml
@@ -2,7 +2,7 @@
 GtkItemFactory
 
 <!-- ##### SECTION Short_Description ##### -->
-
+A factory for menus
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkoldeditable.sgml b/docs/reference/gtk/tmpl/gtkoldeditable.sgml
index da12d9e4e2..5dbcaef198 100644
--- a/docs/reference/gtk/tmpl/gtkoldeditable.sgml
+++ b/docs/reference/gtk/tmpl/gtkoldeditable.sgml
@@ -2,7 +2,7 @@
 GtkOldEditable
 
 <!-- ##### SECTION Short_Description ##### -->
-
+Base class for text-editing widgets
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkrange.sgml b/docs/reference/gtk/tmpl/gtkrange.sgml
index af0d11f673..20a5ca4115 100644
--- a/docs/reference/gtk/tmpl/gtkrange.sgml
+++ b/docs/reference/gtk/tmpl/gtkrange.sgml
@@ -2,7 +2,7 @@
 GtkRange
 
 <!-- ##### SECTION Short_Description ##### -->
-
+Base class for widgets which visualize an adjustment
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkselection.sgml b/docs/reference/gtk/tmpl/gtkselection.sgml
index 4e007b0b81..8e17e2689c 100644
--- a/docs/reference/gtk/tmpl/gtkselection.sgml
+++ b/docs/reference/gtk/tmpl/gtkselection.sgml
@@ -2,7 +2,7 @@
 Selections
 
 <!-- ##### SECTION Short_Description ##### -->
-Functions for handling inter-process communication via selections.
+Functions for handling inter-process communication via selections
 
 <!-- ##### SECTION Long_Description ##### -->
 
diff --git a/docs/reference/gtk/tmpl/gtksettings.sgml b/docs/reference/gtk/tmpl/gtksettings.sgml
index 41f4120633..6cdd80f7fc 100644
--- a/docs/reference/gtk/tmpl/gtksettings.sgml
+++ b/docs/reference/gtk/tmpl/gtksettings.sgml
@@ -1,8 +1,8 @@
 <!-- ##### SECTION Title ##### -->
-GtkSettings
+Settings
 
 <!-- ##### SECTION Short_Description ##### -->
-
+Sharing settings between applications
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
@@ -164,93 +164,3 @@ GtkSettings
 @origin: 
 
 
-<!-- ##### ARG GtkSettings:gtk-can-change-accels ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-color-palette ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-cursor-blink ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-cursor-blink-time ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-dnd-drag-threshold ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-double-click-time ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-entry-select-on-focus ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-font-name ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-icon-sizes ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-key-theme-name ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-menu-bar-accel ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-menu-bar-popup-delay ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-menu-popdown-delay ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-menu-popup-delay ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-split-cursor ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-theme-name ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-toolbar-icon-size ##### -->
-<para>
-
-</para>
-
-<!-- ##### ARG GtkSettings:gtk-toolbar-style ##### -->
-<para>
-
-</para>
-
diff --git a/docs/reference/gtk/tmpl/gtksignal.sgml b/docs/reference/gtk/tmpl/gtksignal.sgml
index 744c9c3783..d84e1ab521 100644
--- a/docs/reference/gtk/tmpl/gtksignal.sgml
+++ b/docs/reference/gtk/tmpl/gtksignal.sgml
@@ -2,7 +2,7 @@
 Signals
 
 <!-- ##### SECTION Short_Description ##### -->
-Object methods and callbacks.
+Object methods and callbacks
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkstyle.sgml b/docs/reference/gtk/tmpl/gtkstyle.sgml
index eb13410895..b16e37950e 100644
--- a/docs/reference/gtk/tmpl/gtkstyle.sgml
+++ b/docs/reference/gtk/tmpl/gtkstyle.sgml
@@ -2,7 +2,7 @@
 Styles
 
 <!-- ##### SECTION Short_Description ##### -->
-
+Functions for drawing widget parts
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtktypeutils.sgml b/docs/reference/gtk/tmpl/gtktypeutils.sgml
index db9adbfde0..0915b3203b 100644
--- a/docs/reference/gtk/tmpl/gtktypeutils.sgml
+++ b/docs/reference/gtk/tmpl/gtktypeutils.sgml
@@ -2,7 +2,7 @@
 Types
 
 <!-- ##### SECTION Short_Description ##### -->
-Handle run-time type creation.
+Handle run-time type creation
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkwidget.sgml b/docs/reference/gtk/tmpl/gtkwidget.sgml
index c9d8e85df6..646f5dc379 100644
--- a/docs/reference/gtk/tmpl/gtkwidget.sgml
+++ b/docs/reference/gtk/tmpl/gtkwidget.sgml
@@ -2,7 +2,7 @@
 GtkWidget
 
 <!-- ##### SECTION Short_Description ##### -->
-
+Base class for all widgets
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkwindow.sgml b/docs/reference/gtk/tmpl/gtkwindow.sgml
index 4c6d77b91f..f56f84b026 100644
--- a/docs/reference/gtk/tmpl/gtkwindow.sgml
+++ b/docs/reference/gtk/tmpl/gtkwindow.sgml
@@ -2,7 +2,7 @@
 GtkWindow
 
 <!-- ##### SECTION Short_Description ##### -->
-
+Toplevel which can contain other widgets
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkwindowgroup.sgml b/docs/reference/gtk/tmpl/gtkwindowgroup.sgml
index 8c64fb1e4b..c8a632003e 100644
--- a/docs/reference/gtk/tmpl/gtkwindowgroup.sgml
+++ b/docs/reference/gtk/tmpl/gtkwindowgroup.sgml
@@ -2,7 +2,7 @@
 GtkWindowGroup
 
 <!-- ##### SECTION Short_Description ##### -->
-
+Limit the effect of grabs
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>