From cd28d2d7a1c6c26356711879370f3fd7b2fd1dfd Mon Sep 17 00:00:00 2001
From: Matthias Clasen <matthiasc@src.gnome.org>
Date: Mon, 11 Oct 2004 20:10:52 +0000
Subject: [PATCH] More short description unification.

---
 docs/reference/gtk/tmpl/gtkarrow.sgml          | 2 +-
 docs/reference/gtk/tmpl/gtkaspectframe.sgml    | 2 +-
 docs/reference/gtk/tmpl/gtkbin.sgml            | 2 +-
 docs/reference/gtk/tmpl/gtkbox.sgml            | 2 +-
 docs/reference/gtk/tmpl/gtkcalendar.sgml       | 2 +-
 docs/reference/gtk/tmpl/gtkclist.sgml          | 2 +-
 docs/reference/gtk/tmpl/gtkcombo.sgml          | 2 +-
 docs/reference/gtk/tmpl/gtkctree.sgml          | 2 +-
 docs/reference/gtk/tmpl/gtkcurve.sgml          | 2 +-
 docs/reference/gtk/tmpl/gtkdrawingarea.sgml    | 2 +-
 docs/reference/gtk/tmpl/gtkeventbox.sgml       | 2 +-
 docs/reference/gtk/tmpl/gtkfixed.sgml          | 2 +-
 docs/reference/gtk/tmpl/gtkframe.sgml          | 2 +-
 docs/reference/gtk/tmpl/gtkhandlebox.sgml      | 2 +-
 docs/reference/gtk/tmpl/gtkhbbox.sgml          | 2 +-
 docs/reference/gtk/tmpl/gtkhbox.sgml           | 2 +-
 docs/reference/gtk/tmpl/gtkhpaned.sgml         | 2 +-
 docs/reference/gtk/tmpl/gtkhseparator.sgml     | 2 +-
 docs/reference/gtk/tmpl/gtkitem.sgml           | 2 +-
 docs/reference/gtk/tmpl/gtklist.sgml           | 2 +-
 docs/reference/gtk/tmpl/gtklistitem.sgml       | 2 +-
 docs/reference/gtk/tmpl/gtkmisc.sgml           | 2 +-
 docs/reference/gtk/tmpl/gtknotebook.sgml       | 2 +-
 docs/reference/gtk/tmpl/gtkobject.sgml         | 2 +-
 docs/reference/gtk/tmpl/gtkoptionmenu.sgml     | 2 +-
 docs/reference/gtk/tmpl/gtkpixmap.sgml         | 2 +-
 docs/reference/gtk/tmpl/gtkplug.sgml           | 2 +-
 docs/reference/gtk/tmpl/gtkpreview.sgml        | 2 +-
 docs/reference/gtk/tmpl/gtkprogress.sgml       | 2 +-
 docs/reference/gtk/tmpl/gtkscale.sgml          | 2 +-
 docs/reference/gtk/tmpl/gtkscrollbar.sgml      | 2 +-
 docs/reference/gtk/tmpl/gtkscrolledwindow.sgml | 3 +--
 docs/reference/gtk/tmpl/gtkseparator.sgml      | 2 +-
 docs/reference/gtk/tmpl/gtksocket.sgml         | 2 +-
 docs/reference/gtk/tmpl/gtktable.sgml          | 2 +-
 docs/reference/gtk/tmpl/gtktext.sgml           | 2 +-
 docs/reference/gtk/tmpl/gtktipsquery.sgml      | 2 +-
 docs/reference/gtk/tmpl/gtktooltips.sgml       | 2 +-
 docs/reference/gtk/tmpl/gtktree.sgml           | 2 +-
 docs/reference/gtk/tmpl/gtktreeitem.sgml       | 2 +-
 docs/reference/gtk/tmpl/gtkvbbox.sgml          | 2 +-
 docs/reference/gtk/tmpl/gtkvbox.sgml           | 2 +-
 docs/reference/gtk/tmpl/gtkvpaned.sgml         | 2 +-
 docs/reference/gtk/tmpl/gtkvseparator.sgml     | 2 +-
 44 files changed, 44 insertions(+), 45 deletions(-)

diff --git a/docs/reference/gtk/tmpl/gtkarrow.sgml b/docs/reference/gtk/tmpl/gtkarrow.sgml
index 8f7a05f575..ef49ae59a7 100644
--- a/docs/reference/gtk/tmpl/gtkarrow.sgml
+++ b/docs/reference/gtk/tmpl/gtkarrow.sgml
@@ -2,7 +2,7 @@
 GtkArrow
 
 <!-- ##### SECTION Short_Description ##### -->
-produces an arrow pointing in one of the four cardinal directions.
+Displays an arrow
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkaspectframe.sgml b/docs/reference/gtk/tmpl/gtkaspectframe.sgml
index 03b6aaccd8..ec7cb3e135 100644
--- a/docs/reference/gtk/tmpl/gtkaspectframe.sgml
+++ b/docs/reference/gtk/tmpl/gtkaspectframe.sgml
@@ -2,7 +2,7 @@
 GtkAspectFrame
 
 <!-- ##### SECTION Short_Description ##### -->
-A frame that constrains its child to a particular aspect ratio.
+A frame that constrains its child to a particular aspect ratio
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkbin.sgml b/docs/reference/gtk/tmpl/gtkbin.sgml
index 837202ba33..f5c85a309a 100644
--- a/docs/reference/gtk/tmpl/gtkbin.sgml
+++ b/docs/reference/gtk/tmpl/gtkbin.sgml
@@ -2,7 +2,7 @@
 GtkBin
 
 <!-- ##### SECTION Short_Description ##### -->
-a container with just one child.
+A container with just one child
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkbox.sgml b/docs/reference/gtk/tmpl/gtkbox.sgml
index 80dc6282b5..367f938363 100644
--- a/docs/reference/gtk/tmpl/gtkbox.sgml
+++ b/docs/reference/gtk/tmpl/gtkbox.sgml
@@ -2,7 +2,7 @@
 GtkBox
 
 <!-- ##### SECTION Short_Description ##### -->
-a base class for box containers
+Base class for box containers
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkcalendar.sgml b/docs/reference/gtk/tmpl/gtkcalendar.sgml
index f5a1552b72..05b3ba0042 100644
--- a/docs/reference/gtk/tmpl/gtkcalendar.sgml
+++ b/docs/reference/gtk/tmpl/gtkcalendar.sgml
@@ -2,7 +2,7 @@
 GtkCalendar
 
 <!-- ##### SECTION Short_Description ##### -->
-display a calendar and/or allow the user to select a date.
+Displays a calendar and allows the user to select a date
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkclist.sgml b/docs/reference/gtk/tmpl/gtkclist.sgml
index ba5316db87..3442e46275 100644
--- a/docs/reference/gtk/tmpl/gtkclist.sgml
+++ b/docs/reference/gtk/tmpl/gtkclist.sgml
@@ -2,7 +2,7 @@
 GtkCList
 
 <!-- ##### SECTION Short_Description ##### -->
-A multi-columned scrolling list widget.
+A multi-columned scrolling list widget
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkcombo.sgml b/docs/reference/gtk/tmpl/gtkcombo.sgml
index 5e8f6a21d7..b51a5ec3a1 100644
--- a/docs/reference/gtk/tmpl/gtkcombo.sgml
+++ b/docs/reference/gtk/tmpl/gtkcombo.sgml
@@ -2,7 +2,7 @@
 GtkCombo
 
 <!-- ##### SECTION Short_Description ##### -->
-a text entry field with a dropdown list.
+A text entry field with a dropdown list
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkctree.sgml b/docs/reference/gtk/tmpl/gtkctree.sgml
index ad3ec4f749..7830cbf078 100644
--- a/docs/reference/gtk/tmpl/gtkctree.sgml
+++ b/docs/reference/gtk/tmpl/gtkctree.sgml
@@ -2,7 +2,7 @@
 GtkCTree
 
 <!-- ##### SECTION Short_Description ##### -->
-a widget displaying a hierarchical tree.
+A widget displaying a hierarchical tree
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkcurve.sgml b/docs/reference/gtk/tmpl/gtkcurve.sgml
index 9395dcf8be..c0f853740d 100644
--- a/docs/reference/gtk/tmpl/gtkcurve.sgml
+++ b/docs/reference/gtk/tmpl/gtkcurve.sgml
@@ -2,7 +2,7 @@
 GtkCurve
 
 <!-- ##### SECTION Short_Description ##### -->
-allows direct editing of a curve.
+Allows direct editing of a curve
 
 <!-- ##### SECTION Long_Description ##### -->
 <note>
diff --git a/docs/reference/gtk/tmpl/gtkdrawingarea.sgml b/docs/reference/gtk/tmpl/gtkdrawingarea.sgml
index 653c27ccfa..0508368bae 100644
--- a/docs/reference/gtk/tmpl/gtkdrawingarea.sgml
+++ b/docs/reference/gtk/tmpl/gtkdrawingarea.sgml
@@ -2,7 +2,7 @@
 GtkDrawingArea
 
 <!-- ##### SECTION Short_Description ##### -->
-a widget for custom user interface elements.
+A widget for custom user interface elements
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkeventbox.sgml b/docs/reference/gtk/tmpl/gtkeventbox.sgml
index f5fc0dc4e3..6ebb986c56 100644
--- a/docs/reference/gtk/tmpl/gtkeventbox.sgml
+++ b/docs/reference/gtk/tmpl/gtkeventbox.sgml
@@ -2,7 +2,7 @@
 GtkEventBox
 
 <!-- ##### SECTION Short_Description ##### -->
-a widget used to catch events for widgets which do not have their own window.
+A widget used to catch events for widgets which do not have their own window
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkfixed.sgml b/docs/reference/gtk/tmpl/gtkfixed.sgml
index 28cba109fa..d38b7af862 100644
--- a/docs/reference/gtk/tmpl/gtkfixed.sgml
+++ b/docs/reference/gtk/tmpl/gtkfixed.sgml
@@ -2,7 +2,7 @@
 GtkFixed
 
 <!-- ##### SECTION Short_Description ##### -->
-a container which allows you to position widgets at fixed coordinates
+A container which allows you to position widgets at fixed coordinates
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkframe.sgml b/docs/reference/gtk/tmpl/gtkframe.sgml
index fbe0d1249f..efb3cf17de 100644
--- a/docs/reference/gtk/tmpl/gtkframe.sgml
+++ b/docs/reference/gtk/tmpl/gtkframe.sgml
@@ -2,7 +2,7 @@
 GtkFrame
 
 <!-- ##### SECTION Short_Description ##### -->
-A bin with a decorative frame and optional label.
+A bin with a decorative frame and optional label
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkhandlebox.sgml b/docs/reference/gtk/tmpl/gtkhandlebox.sgml
index 55a595c171..74eb19fc12 100644
--- a/docs/reference/gtk/tmpl/gtkhandlebox.sgml
+++ b/docs/reference/gtk/tmpl/gtkhandlebox.sgml
@@ -2,7 +2,7 @@
 GtkHandleBox
 
 <!-- ##### SECTION Short_Description ##### -->
-a widget for  detachable window portions.
+a widget for detachable window portions
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkhbbox.sgml b/docs/reference/gtk/tmpl/gtkhbbox.sgml
index 21f4d16437..c1ce601ebd 100644
--- a/docs/reference/gtk/tmpl/gtkhbbox.sgml
+++ b/docs/reference/gtk/tmpl/gtkhbbox.sgml
@@ -2,7 +2,7 @@
 GtkHButtonBox
 
 <!-- ##### SECTION Short_Description ##### -->
-a container for arranging buttons horizontally
+A container for arranging buttons horizontally
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkhbox.sgml b/docs/reference/gtk/tmpl/gtkhbox.sgml
index 49b359b763..e88b2dfa4b 100644
--- a/docs/reference/gtk/tmpl/gtkhbox.sgml
+++ b/docs/reference/gtk/tmpl/gtkhbox.sgml
@@ -2,7 +2,7 @@
 GtkHBox
 
 <!-- ##### SECTION Short_Description ##### -->
-horizontal container box
+A horizontal container box
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkhpaned.sgml b/docs/reference/gtk/tmpl/gtkhpaned.sgml
index 19f42a4101..0cba95a73c 100644
--- a/docs/reference/gtk/tmpl/gtkhpaned.sgml
+++ b/docs/reference/gtk/tmpl/gtkhpaned.sgml
@@ -2,7 +2,7 @@
 GtkHPaned
 
 <!-- ##### SECTION Short_Description ##### -->
-A container with two panes arranged horizontally.
+A container with two panes arranged horizontally
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkhseparator.sgml b/docs/reference/gtk/tmpl/gtkhseparator.sgml
index c2ecaaeb23..6f0efb57a3 100644
--- a/docs/reference/gtk/tmpl/gtkhseparator.sgml
+++ b/docs/reference/gtk/tmpl/gtkhseparator.sgml
@@ -2,7 +2,7 @@
 GtkHSeparator
 
 <!-- ##### SECTION Short_Description ##### -->
-a horizontal separator.
+A horizontal separator
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkitem.sgml b/docs/reference/gtk/tmpl/gtkitem.sgml
index 8964eb09bd..2f788161db 100644
--- a/docs/reference/gtk/tmpl/gtkitem.sgml
+++ b/docs/reference/gtk/tmpl/gtkitem.sgml
@@ -2,7 +2,7 @@
 GtkItem
 
 <!-- ##### SECTION Short_Description ##### -->
-abstract base class for #GtkMenuItem, #GtkListItem and #GtkTreeItem.
+Abstract base class for GtkMenuItem, GtkListItem and GtkTreeItem
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtklist.sgml b/docs/reference/gtk/tmpl/gtklist.sgml
index c6f3127c70..eb76c0c81e 100644
--- a/docs/reference/gtk/tmpl/gtklist.sgml
+++ b/docs/reference/gtk/tmpl/gtklist.sgml
@@ -2,7 +2,7 @@
 GtkList
 
 <!-- ##### SECTION Short_Description ##### -->
-Widget for packing a list of selectable items.
+Widget for packing a list of selectable items
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtklistitem.sgml b/docs/reference/gtk/tmpl/gtklistitem.sgml
index cf19feb412..c19753f480 100644
--- a/docs/reference/gtk/tmpl/gtklistitem.sgml
+++ b/docs/reference/gtk/tmpl/gtklistitem.sgml
@@ -2,7 +2,7 @@
 GtkListItem
 
 <!-- ##### SECTION Short_Description ##### -->
-an item in a #GtkList.
+An item in a GtkList
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkmisc.sgml b/docs/reference/gtk/tmpl/gtkmisc.sgml
index 5a7ac4cf53..ef8f1fb66a 100644
--- a/docs/reference/gtk/tmpl/gtkmisc.sgml
+++ b/docs/reference/gtk/tmpl/gtkmisc.sgml
@@ -2,7 +2,7 @@
 GtkMisc
 
 <!-- ##### SECTION Short_Description ##### -->
-a base class for widgets with alignments and padding.
+Base class for widgets with alignments and padding
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtknotebook.sgml b/docs/reference/gtk/tmpl/gtknotebook.sgml
index ddc2d5a32a..93a0814592 100644
--- a/docs/reference/gtk/tmpl/gtknotebook.sgml
+++ b/docs/reference/gtk/tmpl/gtknotebook.sgml
@@ -2,7 +2,7 @@
 GtkNotebook
 
 <!-- ##### SECTION Short_Description ##### -->
-A tabbed notebook container.
+A tabbed notebook container
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkobject.sgml b/docs/reference/gtk/tmpl/gtkobject.sgml
index 86df56db09..33167e0844 100644
--- a/docs/reference/gtk/tmpl/gtkobject.sgml
+++ b/docs/reference/gtk/tmpl/gtkobject.sgml
@@ -2,7 +2,7 @@
 GtkObject
 
 <!-- ##### SECTION Short_Description ##### -->
-The base class of the GTK+ type hierarchy.
+The base class of the GTK+ type hierarchy
 
 <!-- ##### SECTION Long_Description ##### -->
 <refsect2>
diff --git a/docs/reference/gtk/tmpl/gtkoptionmenu.sgml b/docs/reference/gtk/tmpl/gtkoptionmenu.sgml
index de5248e7af..9af38f4f5b 100644
--- a/docs/reference/gtk/tmpl/gtkoptionmenu.sgml
+++ b/docs/reference/gtk/tmpl/gtkoptionmenu.sgml
@@ -2,7 +2,7 @@
 GtkOptionMenu
 
 <!-- ##### SECTION Short_Description ##### -->
-a widget used to choose from a list of valid choices.
+A widget used to choose from a list of valid choices
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkpixmap.sgml b/docs/reference/gtk/tmpl/gtkpixmap.sgml
index a40a9159a5..7304fe5cc5 100644
--- a/docs/reference/gtk/tmpl/gtkpixmap.sgml
+++ b/docs/reference/gtk/tmpl/gtkpixmap.sgml
@@ -2,7 +2,7 @@
 GtkPixmap
 
 <!-- ##### SECTION Short_Description ##### -->
-a widget displaying a graphical image or icon.
+A widget displaying a graphical image or icon
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkplug.sgml b/docs/reference/gtk/tmpl/gtkplug.sgml
index 3f5d754c22..d294bcc68e 100644
--- a/docs/reference/gtk/tmpl/gtkplug.sgml
+++ b/docs/reference/gtk/tmpl/gtkplug.sgml
@@ -2,7 +2,7 @@
 GtkPlug
 
 <!-- ##### SECTION Short_Description ##### -->
-Toplevel for embedding into other processes.
+Toplevel for embedding into other processes
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkpreview.sgml b/docs/reference/gtk/tmpl/gtkpreview.sgml
index e0560a79cc..bc84fe792d 100644
--- a/docs/reference/gtk/tmpl/gtkpreview.sgml
+++ b/docs/reference/gtk/tmpl/gtkpreview.sgml
@@ -2,7 +2,7 @@
 GtkPreview
 
 <!-- ##### SECTION Short_Description ##### -->
-widget to display RGB or grayscale data.
+A widget to display RGB or grayscale data
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkprogress.sgml b/docs/reference/gtk/tmpl/gtkprogress.sgml
index 57dc846e11..5035809434 100644
--- a/docs/reference/gtk/tmpl/gtkprogress.sgml
+++ b/docs/reference/gtk/tmpl/gtkprogress.sgml
@@ -2,7 +2,7 @@
 GtkProgress
 
 <!-- ##### SECTION Short_Description ##### -->
-the base class for #GtkProgressBar.
+Base class for GtkProgressBar
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkscale.sgml b/docs/reference/gtk/tmpl/gtkscale.sgml
index dff8b0c0e5..5b2b893c6f 100644
--- a/docs/reference/gtk/tmpl/gtkscale.sgml
+++ b/docs/reference/gtk/tmpl/gtkscale.sgml
@@ -2,7 +2,7 @@
 GtkScale
 
 <!-- ##### SECTION Short_Description ##### -->
-a base class for #GtkHScale and #GtkVScale.
+Base class for GtkHScale and GtkVScale
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkscrollbar.sgml b/docs/reference/gtk/tmpl/gtkscrollbar.sgml
index 16c201e309..b0eba9e34c 100644
--- a/docs/reference/gtk/tmpl/gtkscrollbar.sgml
+++ b/docs/reference/gtk/tmpl/gtkscrollbar.sgml
@@ -2,7 +2,7 @@
 GtkScrollbar
 
 <!-- ##### SECTION Short_Description ##### -->
-base class for #GtkHScrollbar and GtkVScrollbar.
+Base class for GtkHScrollbar and GtkVScrollbar
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkscrolledwindow.sgml b/docs/reference/gtk/tmpl/gtkscrolledwindow.sgml
index ced33698c7..b241d70992 100644
--- a/docs/reference/gtk/tmpl/gtkscrolledwindow.sgml
+++ b/docs/reference/gtk/tmpl/gtkscrolledwindow.sgml
@@ -2,8 +2,7 @@
 GtkScrolledWindow
 
 <!-- ##### SECTION Short_Description ##### -->
-
-Adds scrollbars to its child widget.
+Adds scrollbars to its child widget
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkseparator.sgml b/docs/reference/gtk/tmpl/gtkseparator.sgml
index 546d9e9d59..9eaa530033 100644
--- a/docs/reference/gtk/tmpl/gtkseparator.sgml
+++ b/docs/reference/gtk/tmpl/gtkseparator.sgml
@@ -2,7 +2,7 @@
 GtkSeparator
 
 <!-- ##### SECTION Short_Description ##### -->
-a base class for #GtkHSeparator and #GtkVSeparator.
+Base class for #GtkHSeparator and #GtkVSeparator
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtksocket.sgml b/docs/reference/gtk/tmpl/gtksocket.sgml
index 01bc2e418d..b2c270e923 100644
--- a/docs/reference/gtk/tmpl/gtksocket.sgml
+++ b/docs/reference/gtk/tmpl/gtksocket.sgml
@@ -2,7 +2,7 @@
 GtkSocket
 
 <!-- ##### SECTION Short_Description ##### -->
-Container for widgets from other processes.
+Container for widgets from other processes
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtktable.sgml b/docs/reference/gtk/tmpl/gtktable.sgml
index 4f7867657a..4ae1c4d184 100644
--- a/docs/reference/gtk/tmpl/gtktable.sgml
+++ b/docs/reference/gtk/tmpl/gtktable.sgml
@@ -2,7 +2,7 @@
 GtkTable
 
 <!-- ##### SECTION Short_Description ##### -->
-Pack widgets in regular patterns.
+Pack widgets in regular patterns
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtktext.sgml b/docs/reference/gtk/tmpl/gtktext.sgml
index 3559a2513d..f3502de2f0 100644
--- a/docs/reference/gtk/tmpl/gtktext.sgml
+++ b/docs/reference/gtk/tmpl/gtktext.sgml
@@ -2,7 +2,7 @@
 GtkText
 
 <!-- ##### SECTION Short_Description ##### -->
-a text widget.
+A text widget
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtktipsquery.sgml b/docs/reference/gtk/tmpl/gtktipsquery.sgml
index 8934b3c178..a246420785 100644
--- a/docs/reference/gtk/tmpl/gtktipsquery.sgml
+++ b/docs/reference/gtk/tmpl/gtktipsquery.sgml
@@ -2,7 +2,7 @@
 GtkTipsQuery
 
 <!-- ##### SECTION Short_Description ##### -->
-displays help about widgets in the user interface.
+Displays help about widgets in the user interface
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtktooltips.sgml b/docs/reference/gtk/tmpl/gtktooltips.sgml
index b67a96a21e..c6c60c4167 100644
--- a/docs/reference/gtk/tmpl/gtktooltips.sgml
+++ b/docs/reference/gtk/tmpl/gtktooltips.sgml
@@ -2,7 +2,7 @@
 GtkTooltips
 
 <!-- ##### SECTION Short_Description ##### -->
-Add tips to your widgets.
+Add tips to your widgets
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtktree.sgml b/docs/reference/gtk/tmpl/gtktree.sgml
index 9f2a943a5f..10f4d9de74 100644
--- a/docs/reference/gtk/tmpl/gtktree.sgml
+++ b/docs/reference/gtk/tmpl/gtktree.sgml
@@ -2,7 +2,7 @@
 GtkTree
 
 <!-- ##### SECTION Short_Description ##### -->
-a tree widget.
+A tree widget
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtktreeitem.sgml b/docs/reference/gtk/tmpl/gtktreeitem.sgml
index 4719f5ad5b..0c41ea7e76 100644
--- a/docs/reference/gtk/tmpl/gtktreeitem.sgml
+++ b/docs/reference/gtk/tmpl/gtktreeitem.sgml
@@ -2,7 +2,7 @@
 GtkTreeItem
 
 <!-- ##### SECTION Short_Description ##### -->
-The widget used for items in a #GtkTree.
+The widget used for items in a GtkTree
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkvbbox.sgml b/docs/reference/gtk/tmpl/gtkvbbox.sgml
index 4882693c8e..0e975328ef 100644
--- a/docs/reference/gtk/tmpl/gtkvbbox.sgml
+++ b/docs/reference/gtk/tmpl/gtkvbbox.sgml
@@ -2,7 +2,7 @@
 GtkVButtonBox
 
 <!-- ##### SECTION Short_Description ##### -->
-a container for arranging buttons vertically
+A container for arranging buttons vertically
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkvbox.sgml b/docs/reference/gtk/tmpl/gtkvbox.sgml
index 5883016710..b7e422f963 100644
--- a/docs/reference/gtk/tmpl/gtkvbox.sgml
+++ b/docs/reference/gtk/tmpl/gtkvbox.sgml
@@ -2,7 +2,7 @@
 GtkVBox
 
 <!-- ##### SECTION Short_Description ##### -->
-vertical container box
+A vertical container box
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkvpaned.sgml b/docs/reference/gtk/tmpl/gtkvpaned.sgml
index edcff3251e..82ebf5c545 100644
--- a/docs/reference/gtk/tmpl/gtkvpaned.sgml
+++ b/docs/reference/gtk/tmpl/gtkvpaned.sgml
@@ -2,7 +2,7 @@
 GtkVPaned
 
 <!-- ##### SECTION Short_Description ##### -->
-A container with two panes arranged vertically.
+A container with two panes arranged vertically
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkvseparator.sgml b/docs/reference/gtk/tmpl/gtkvseparator.sgml
index dd4606d37e..4a04171471 100644
--- a/docs/reference/gtk/tmpl/gtkvseparator.sgml
+++ b/docs/reference/gtk/tmpl/gtkvseparator.sgml
@@ -2,7 +2,7 @@
 GtkVSeparator
 
 <!-- ##### SECTION Short_Description ##### -->
-a vertical separator.
+A vertical separator
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>