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.

25 files changed, 134 insertions, 117 deletions

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>