Make short descriptions a bit more consistent.

48 files changed, 53 insertions, 58 deletions

diff --git a/docs/reference/gtk/tmpl/gtkaction.sgml b/docs/reference/gtk/tmpl/gtkaction.sgml
index 0ce3f627db..6c04d0c668 100644
--- a/docs/reference/gtk/tmpl/gtkaction.sgml
+++ b/docs/reference/gtk/tmpl/gtkaction.sgml
@@ -2,7 +2,7 @@
 GtkAction
 
 <!-- ##### SECTION Short_Description ##### -->
-an action which can be triggered by a menu or toolbar item
+An action which can be triggered by a menu or toolbar item
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkactiongroup.sgml b/docs/reference/gtk/tmpl/gtkactiongroup.sgml
index 6ec1b5fea0..da30303222 100644
--- a/docs/reference/gtk/tmpl/gtkactiongroup.sgml
+++ b/docs/reference/gtk/tmpl/gtkactiongroup.sgml
@@ -2,7 +2,7 @@
 GtkActionGroup
 
 <!-- ##### SECTION Short_Description ##### -->
-a group of actions
+A group of actions
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkbutton.sgml b/docs/reference/gtk/tmpl/gtkbutton.sgml
index 433c40c9b2..b4f1bc15e5 100644
--- a/docs/reference/gtk/tmpl/gtkbutton.sgml
+++ b/docs/reference/gtk/tmpl/gtkbutton.sgml
@@ -2,7 +2,7 @@
 GtkButton
 
 <!-- ##### SECTION Short_Description ##### -->
-A widget that creates a signal when clicked on.
+A widget that creates a signal when clicked on
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkcellview.sgml b/docs/reference/gtk/tmpl/gtkcellview.sgml
index eab4c42f12..7866e80c84 100644
--- a/docs/reference/gtk/tmpl/gtkcellview.sgml
+++ b/docs/reference/gtk/tmpl/gtkcellview.sgml
@@ -2,7 +2,7 @@
 GtkCellView
 
 <!-- ##### SECTION Short_Description ##### -->
-
+A widget displaying a single row of a GtkTreeModel
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkcheckbutton.sgml b/docs/reference/gtk/tmpl/gtkcheckbutton.sgml
index 2f6a954f2c..4846f123e5 100644
--- a/docs/reference/gtk/tmpl/gtkcheckbutton.sgml
+++ b/docs/reference/gtk/tmpl/gtkcheckbutton.sgml
@@ -2,7 +2,7 @@
 GtkCheckButton
 
 <!-- ##### SECTION Short_Description ##### -->
-create widgets with a discrete toggle button.
+Create widgets with a discrete toggle button
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkcheckmenuitem.sgml b/docs/reference/gtk/tmpl/gtkcheckmenuitem.sgml
index f6494c3dbf..e13816afc8 100644
--- a/docs/reference/gtk/tmpl/gtkcheckmenuitem.sgml
+++ b/docs/reference/gtk/tmpl/gtkcheckmenuitem.sgml
@@ -2,7 +2,7 @@
 GtkCheckMenuItem
 
 <!-- ##### SECTION Short_Description ##### -->
-a menu item with a check box.
+A menu item with a check box
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkcolorsel.sgml b/docs/reference/gtk/tmpl/gtkcolorsel.sgml
index 844fd5c016..22bd057074 100644
--- a/docs/reference/gtk/tmpl/gtkcolorsel.sgml
+++ b/docs/reference/gtk/tmpl/gtkcolorsel.sgml
@@ -2,7 +2,7 @@
 GtkColorSelection
 
 <!-- ##### SECTION Short_Description ##### -->
-a widget used to select a color.
+A widget used to select a color
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkcolorseldlg.sgml b/docs/reference/gtk/tmpl/gtkcolorseldlg.sgml
index 3ef7f7a5c0..56d4f21340 100644
--- a/docs/reference/gtk/tmpl/gtkcolorseldlg.sgml
+++ b/docs/reference/gtk/tmpl/gtkcolorseldlg.sgml
@@ -2,7 +2,7 @@
 GtkColorSelectionDialog
 
 <!-- ##### SECTION Short_Description ##### -->
-a standard dialog box for selecting a color.
+A standard dialog box for selecting a color
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkcombobox.sgml b/docs/reference/gtk/tmpl/gtkcombobox.sgml
index d06e873a56..7421d29b81 100644
--- a/docs/reference/gtk/tmpl/gtkcombobox.sgml
+++ b/docs/reference/gtk/tmpl/gtkcombobox.sgml
@@ -2,7 +2,7 @@
 GtkComboBox
 
 <!-- ##### SECTION Short_Description ##### -->
-a widget used to choose from a list of items.
+A widget used to choose from a list of items
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkcomboboxentry.sgml b/docs/reference/gtk/tmpl/gtkcomboboxentry.sgml
index 1151680ee2..42e637f2d8 100644
--- a/docs/reference/gtk/tmpl/gtkcomboboxentry.sgml
+++ b/docs/reference/gtk/tmpl/gtkcomboboxentry.sgml
@@ -2,7 +2,7 @@
 GtkComboBoxEntry
 
 <!-- ##### 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/gtkdialog.sgml b/docs/reference/gtk/tmpl/gtkdialog.sgml
index e2fa9f0b0c..8121167766 100644
--- a/docs/reference/gtk/tmpl/gtkdialog.sgml
+++ b/docs/reference/gtk/tmpl/gtkdialog.sgml
@@ -2,15 +2,14 @@
 GtkDialog
 
 <!-- ##### SECTION Short_Description ##### -->
-
-create popup windows.
+Create popup windows
 
 <!-- ##### SECTION Long_Description ##### -->
 
 <para>
 Dialog boxes are a convenient way to prompt the user for a small amount of
-input, eg. to display a message, ask a question, or anything else that does not
-require extensive effort on the user's part.
+input, e.g. to display a message, ask a question, or anything else that does 
+not require extensive effort on the user's part.
 </para>
 
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkeditable.sgml b/docs/reference/gtk/tmpl/gtkeditable.sgml
index ac0b950f2e..9304ad23f3 100644
--- a/docs/reference/gtk/tmpl/gtkeditable.sgml
+++ b/docs/reference/gtk/tmpl/gtkeditable.sgml
@@ -2,7 +2,7 @@
 GtkEditable
 
 <!-- ##### SECTION Short_Description ##### -->
-Interface for text-editing widgets.
+Interface for text-editing widgets
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkentry.sgml b/docs/reference/gtk/tmpl/gtkentry.sgml
index 61976ba524..1fa8fb3cf1 100644
--- a/docs/reference/gtk/tmpl/gtkentry.sgml
+++ b/docs/reference/gtk/tmpl/gtkentry.sgml
@@ -2,7 +2,7 @@
 GtkEntry
 
 <!-- ##### SECTION Short_Description ##### -->
-a single line text entry field.
+A single line text entry field
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkentrycompletion.sgml b/docs/reference/gtk/tmpl/gtkentrycompletion.sgml
index 4074befe4e..e8786602b5 100644
--- a/docs/reference/gtk/tmpl/gtkentrycompletion.sgml
+++ b/docs/reference/gtk/tmpl/gtkentrycompletion.sgml
@@ -2,7 +2,7 @@
 GtkEntryCompletion
 
 <!-- ##### SECTION Short_Description ##### -->
-completion functionality for GtkEntry
+Completion functionality for GtkEntry
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkfilechooser.sgml b/docs/reference/gtk/tmpl/gtkfilechooser.sgml
index 0272a9b7ca..296c55f0b5 100644
--- a/docs/reference/gtk/tmpl/gtkfilechooser.sgml
+++ b/docs/reference/gtk/tmpl/gtkfilechooser.sgml
@@ -2,7 +2,7 @@
 GtkFileChooser
 
 <!-- ##### SECTION Short_Description ##### -->
-File chooser interface used by #GtkFileChooserWidget and #GtkFileChooserDialog.
+File chooser interface used by GtkFileChooserWidget and GtkFileChooserDialog
 
 <!-- ##### SECTION Long_Description ##### -->
     <para>
diff --git a/docs/reference/gtk/tmpl/gtkfilechooserdialog.sgml b/docs/reference/gtk/tmpl/gtkfilechooserdialog.sgml
index dac3203e97..706490b13d 100644
--- a/docs/reference/gtk/tmpl/gtkfilechooserdialog.sgml
+++ b/docs/reference/gtk/tmpl/gtkfilechooserdialog.sgml
@@ -2,7 +2,7 @@
 GtkFileChooserDialog
 
 <!-- ##### SECTION Short_Description ##### -->
-A file chooser dialog, suitable for "File/Open" or "File/Save" commands.
+A file chooser dialog, suitable for "File/Open" or "File/Save" commands
 
 <!-- ##### SECTION Long_Description ##### -->
     <para>
diff --git a/docs/reference/gtk/tmpl/gtkfilechooserwidget.sgml b/docs/reference/gtk/tmpl/gtkfilechooserwidget.sgml
index 9f559a1363..add7e43ede 100644
--- a/docs/reference/gtk/tmpl/gtkfilechooserwidget.sgml
+++ b/docs/reference/gtk/tmpl/gtkfilechooserwidget.sgml
@@ -2,7 +2,7 @@
 GtkFileChooserWidget
 
 <!-- ##### SECTION Short_Description ##### -->
-File chooser widget that can be embedded in other widgets.
+File chooser widget that can be embedded in other widgets
 
 <!-- ##### SECTION Long_Description ##### -->
     <para>
diff --git a/docs/reference/gtk/tmpl/gtkfilesel.sgml b/docs/reference/gtk/tmpl/gtkfilesel.sgml
index f00da8b8b0..a3243327fc 100644
--- a/docs/reference/gtk/tmpl/gtkfilesel.sgml
+++ b/docs/reference/gtk/tmpl/gtkfilesel.sgml
@@ -2,7 +2,7 @@
 GtkFileSelection
 
 <!-- ##### SECTION Short_Description ##### -->
-prompt the user for a file or directory name.
+Prompt the user for a file or directory name
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkfontsel.sgml b/docs/reference/gtk/tmpl/gtkfontsel.sgml
index c5a70f4016..7847656ada 100644
--- a/docs/reference/gtk/tmpl/gtkfontsel.sgml
+++ b/docs/reference/gtk/tmpl/gtkfontsel.sgml
@@ -2,7 +2,7 @@
 GtkFontSelection
 
 <!-- ##### SECTION Short_Description ##### -->
-a widget for selecting fonts.
+A widget for selecting fonts
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkfontseldlg.sgml b/docs/reference/gtk/tmpl/gtkfontseldlg.sgml
index 5e15d6e6be..b97ff929d8 100644
--- a/docs/reference/gtk/tmpl/gtkfontseldlg.sgml
+++ b/docs/reference/gtk/tmpl/gtkfontseldlg.sgml
@@ -2,7 +2,7 @@
 GtkFontSelectionDialog
 
 <!-- ##### SECTION Short_Description ##### -->
-a dialog box for selecting fonts.
+A dialog box for selecting fonts
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkhscale.sgml b/docs/reference/gtk/tmpl/gtkhscale.sgml
index 42efdb6579..f4c9782ed3 100644
--- a/docs/reference/gtk/tmpl/gtkhscale.sgml
+++ b/docs/reference/gtk/tmpl/gtkhscale.sgml
@@ -2,13 +2,12 @@
 GtkHScale
 
 <!-- ##### SECTION Short_Description ##### -->
-a horizontal slider widget for selecting a value from a range.
+A horizontal slider widget for selecting a value from a range
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
 The #GtkHScale widget is used to allow the user to select a value using
-a horizontal slider. To create one, use
-gtk_hscale_new_with_range().
+a horizontal slider. To create one, use gtk_hscale_new_with_range().
 </para>
 <para>
 The position to show the current value, and the number of decimal places
diff --git a/docs/reference/gtk/tmpl/gtkimagemenuitem.sgml b/docs/reference/gtk/tmpl/gtkimagemenuitem.sgml
index 91aa18eeb2..6650a4b8e4 100644
--- a/docs/reference/gtk/tmpl/gtkimagemenuitem.sgml
+++ b/docs/reference/gtk/tmpl/gtkimagemenuitem.sgml
@@ -2,7 +2,7 @@
 GtkImageMenuItem
 
 <!-- ##### SECTION Short_Description ##### -->
-a menu item with an icon.
+A menu item with an icon
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkinputdialog.sgml b/docs/reference/gtk/tmpl/gtkinputdialog.sgml
index bf5210516a..9411028f8f 100644
--- a/docs/reference/gtk/tmpl/gtkinputdialog.sgml
+++ b/docs/reference/gtk/tmpl/gtkinputdialog.sgml
@@ -2,7 +2,7 @@
 GtkInputDialog
 
 <!-- ##### SECTION Short_Description ##### -->
-Configure devices for the XInput extension.
+Configure devices for the XInput extension
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkinvisible.sgml b/docs/reference/gtk/tmpl/gtkinvisible.sgml
index c34b8641a1..9d4a61c660 100644
--- a/docs/reference/gtk/tmpl/gtkinvisible.sgml
+++ b/docs/reference/gtk/tmpl/gtkinvisible.sgml
@@ -2,7 +2,7 @@
 GtkInvisible
 
 <!-- ##### SECTION Short_Description ##### -->
-a widget which is not displayed.
+A widget which is not displayed
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtklabel.sgml b/docs/reference/gtk/tmpl/gtklabel.sgml
index 1853bbaa75..a58a43fbe2 100644
--- a/docs/reference/gtk/tmpl/gtklabel.sgml
+++ b/docs/reference/gtk/tmpl/gtklabel.sgml
@@ -2,7 +2,7 @@
 GtkLabel
 
 <!-- ##### SECTION Short_Description ##### -->
-A widget that displays a small to medium amount of text.
+A widget that displays a small to medium amount of text
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkmenu.sgml b/docs/reference/gtk/tmpl/gtkmenu.sgml
index d01553f299..1c8f72f8d0 100644
--- a/docs/reference/gtk/tmpl/gtkmenu.sgml
+++ b/docs/reference/gtk/tmpl/gtkmenu.sgml
@@ -2,7 +2,7 @@
 GtkMenu
 
 <!-- ##### SECTION Short_Description ##### -->
-a drop down menu widget.
+A drop down menu widget
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkmenuitem.sgml b/docs/reference/gtk/tmpl/gtkmenuitem.sgml
index 90b8c7ff92..14e0cd4db5 100644
--- a/docs/reference/gtk/tmpl/gtkmenuitem.sgml
+++ b/docs/reference/gtk/tmpl/gtkmenuitem.sgml
@@ -2,7 +2,7 @@
 GtkMenuItem
 
 <!-- ##### SECTION Short_Description ##### -->
-the widget used for item in menus
+The widget used for item in menus
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkmenushell.sgml b/docs/reference/gtk/tmpl/gtkmenushell.sgml
index 6ce095e335..3430119914 100644
--- a/docs/reference/gtk/tmpl/gtkmenushell.sgml
+++ b/docs/reference/gtk/tmpl/gtkmenushell.sgml
@@ -2,7 +2,7 @@
 GtkMenuShell
 
 <!-- ##### SECTION Short_Description ##### -->
-a base class for menu objects.
+A base class for menu objects
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkmessagedialog.sgml b/docs/reference/gtk/tmpl/gtkmessagedialog.sgml
index 7ba8f801a1..f1bab03d0f 100644
--- a/docs/reference/gtk/tmpl/gtkmessagedialog.sgml
+++ b/docs/reference/gtk/tmpl/gtkmessagedialog.sgml
@@ -2,8 +2,7 @@
 GtkMessageDialog
 
 <!-- ##### SECTION Short_Description ##### -->
-
-convenient message window
+A convenient message window
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkprogressbar.sgml b/docs/reference/gtk/tmpl/gtkprogressbar.sgml
index c86e50ef9e..7f871f9433 100644
--- a/docs/reference/gtk/tmpl/gtkprogressbar.sgml
+++ b/docs/reference/gtk/tmpl/gtkprogressbar.sgml
@@ -2,7 +2,7 @@
 GtkProgressBar
 
 <!-- ##### SECTION Short_Description ##### -->
-a widget which indicates progress visually.
+A widget which indicates progress visually
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkradioaction.sgml b/docs/reference/gtk/tmpl/gtkradioaction.sgml
index 9f1f607ddf..73198b2eb8 100644
--- a/docs/reference/gtk/tmpl/gtkradioaction.sgml
+++ b/docs/reference/gtk/tmpl/gtkradioaction.sgml
@@ -2,7 +2,7 @@
 GtkRadioAction
 
 <!-- ##### SECTION Short_Description ##### -->
-an action of which only one in a group can be active
+An action of which only one in a group can be active
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkradiobutton.sgml b/docs/reference/gtk/tmpl/gtkradiobutton.sgml
index 8d33d0761e..2bf1893c20 100644
--- a/docs/reference/gtk/tmpl/gtkradiobutton.sgml
+++ b/docs/reference/gtk/tmpl/gtkradiobutton.sgml
@@ -2,7 +2,7 @@
 GtkRadioButton
 
 <!-- ##### SECTION Short_Description ##### -->
-A choice from multiple check buttons.
+A choice from multiple check buttons
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkradiomenuitem.sgml b/docs/reference/gtk/tmpl/gtkradiomenuitem.sgml
index 0c6e4d057c..b404e8c488 100644
--- a/docs/reference/gtk/tmpl/gtkradiomenuitem.sgml
+++ b/docs/reference/gtk/tmpl/gtkradiomenuitem.sgml
@@ -2,7 +2,7 @@
 GtkRadioMenuItem
 
 <!-- ##### SECTION Short_Description ##### -->
-A choice from multiple check menu items.
+A choice from multiple check menu items
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkradiotoolbutton.sgml b/docs/reference/gtk/tmpl/gtkradiotoolbutton.sgml
index 732a4a29ed..9ab4bdd833 100644
--- a/docs/reference/gtk/tmpl/gtkradiotoolbutton.sgml
+++ b/docs/reference/gtk/tmpl/gtkradiotoolbutton.sgml
@@ -2,7 +2,7 @@
 GtkRadioToolButton
 
 <!-- ##### SECTION Short_Description ##### -->
-A toolbar item that contains a radio button.
+A toolbar item that contains a radio button
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkseparatormenuitem.sgml b/docs/reference/gtk/tmpl/gtkseparatormenuitem.sgml
index 13ba858d5f..71dcc402cd 100644
--- a/docs/reference/gtk/tmpl/gtkseparatormenuitem.sgml
+++ b/docs/reference/gtk/tmpl/gtkseparatormenuitem.sgml
@@ -2,7 +2,7 @@
 GtkSeparatorMenuItem
 
 <!-- ##### SECTION Short_Description ##### -->
-a separator used in menus.
+A separator used in menus
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkseparatortoolitem.sgml b/docs/reference/gtk/tmpl/gtkseparatortoolitem.sgml
index 5234f34e75..08b98faad6 100644
--- a/docs/reference/gtk/tmpl/gtkseparatortoolitem.sgml
+++ b/docs/reference/gtk/tmpl/gtkseparatortoolitem.sgml
@@ -2,7 +2,7 @@
 GtkSeparatorToolItem
 
 <!-- ##### SECTION Short_Description ##### -->
-A toolbar item that separates groups of other toolbar items.
+A toolbar item that separates groups of other toolbar items
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkspinbutton.sgml b/docs/reference/gtk/tmpl/gtkspinbutton.sgml
index a9fba39929..e9bd2c9849 100644
--- a/docs/reference/gtk/tmpl/gtkspinbutton.sgml
+++ b/docs/reference/gtk/tmpl/gtkspinbutton.sgml
@@ -2,7 +2,7 @@
 GtkSpinButton
 
 <!-- ##### SECTION Short_Description ##### -->
-retrieve an integer or floating-point number from the user.
+Retrieve an integer or floating-point number from the user
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkstatusbar.sgml b/docs/reference/gtk/tmpl/gtkstatusbar.sgml
index f6f490857b..b8d0f64b22 100644
--- a/docs/reference/gtk/tmpl/gtkstatusbar.sgml
+++ b/docs/reference/gtk/tmpl/gtkstatusbar.sgml
@@ -2,7 +2,7 @@
 GtkStatusbar
 
 <!-- ##### SECTION Short_Description ##### -->
-report messages of minor importance to the user.
+Report messages of minor importance to the user
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtktearoffmenuitem.sgml b/docs/reference/gtk/tmpl/gtktearoffmenuitem.sgml
index b155db59cc..822c887c11 100644
--- a/docs/reference/gtk/tmpl/gtktearoffmenuitem.sgml
+++ b/docs/reference/gtk/tmpl/gtktearoffmenuitem.sgml
@@ -2,11 +2,11 @@
 GtkTearoffMenuItem
 
 <!-- ##### SECTION Short_Description ##### -->
-a menu item used to tear off and reattach its menu.
+A menu item used to tear off and reattach its menu
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-a #GtkTearoffMenuItem is a special #GtkMenuItem which is used to
+A #GtkTearoffMenuItem is a special #GtkMenuItem which is used to
 tear off and reattach its menu.
 </para>
 
diff --git a/docs/reference/gtk/tmpl/gtktoggleaction.sgml b/docs/reference/gtk/tmpl/gtktoggleaction.sgml
index 356bc22bdf..fff7e752d8 100644
--- a/docs/reference/gtk/tmpl/gtktoggleaction.sgml
+++ b/docs/reference/gtk/tmpl/gtktoggleaction.sgml
@@ -2,7 +2,7 @@
 GtkToggleAction
 
 <!-- ##### SECTION Short_Description ##### -->
-an action which can be toggled between two states
+An action which can be toggled between two states
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtktogglebutton.sgml b/docs/reference/gtk/tmpl/gtktogglebutton.sgml
index c1ed0a54b5..b4ef1019e2 100644
--- a/docs/reference/gtk/tmpl/gtktogglebutton.sgml
+++ b/docs/reference/gtk/tmpl/gtktogglebutton.sgml
@@ -2,7 +2,7 @@
 GtkToggleButton
 
 <!-- ##### SECTION Short_Description ##### -->
-create buttons which retain their state.
+Create buttons which retain their state
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtktoggletoolbutton.sgml b/docs/reference/gtk/tmpl/gtktoggletoolbutton.sgml
index d95ad91163..e318457cec 100644
--- a/docs/reference/gtk/tmpl/gtktoggletoolbutton.sgml
+++ b/docs/reference/gtk/tmpl/gtktoggletoolbutton.sgml
@@ -2,7 +2,7 @@
 GtkToggleToolButton
 
 <!-- ##### SECTION Short_Description ##### -->
-A #GtkToolItem containing a toggle button.
+A GtkToolItem containing a toggle button
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtktoolbar.sgml b/docs/reference/gtk/tmpl/gtktoolbar.sgml
index f319821459..b37dfea71c 100644
--- a/docs/reference/gtk/tmpl/gtktoolbar.sgml
+++ b/docs/reference/gtk/tmpl/gtktoolbar.sgml
@@ -2,7 +2,7 @@
 GtkToolbar
 
 <!-- ##### SECTION Short_Description ##### -->
-Create bars of buttons and other widgets.
+Create bars of buttons and other widgets
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtktoolbutton.sgml b/docs/reference/gtk/tmpl/gtktoolbutton.sgml
index 3f4da88b38..817170c0ab 100644
--- a/docs/reference/gtk/tmpl/gtktoolbutton.sgml
+++ b/docs/reference/gtk/tmpl/gtktoolbutton.sgml
@@ -2,7 +2,7 @@
 GtkToolButton
 
 <!-- ##### SECTION Short_Description ##### -->
-A #GtkToolItem subclass that displays buttons
+A GtkToolItem subclass that displays buttons
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtktoolitem.sgml b/docs/reference/gtk/tmpl/gtktoolitem.sgml
index 9fc2b5d914..125806ae12 100644
--- a/docs/reference/gtk/tmpl/gtktoolitem.sgml
+++ b/docs/reference/gtk/tmpl/gtktoolitem.sgml
@@ -2,8 +2,7 @@
 GtkToolItem
 
 <!-- ##### SECTION Short_Description ##### -->
-#GtkToolItem is the base class of widgets that can be added to
-#GtkToolbar.
+The base class of widgets that can be added to GtkToolbar
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtktreeview.sgml b/docs/reference/gtk/tmpl/gtktreeview.sgml
index 7cad5580de..f3a127eba5 100644
--- a/docs/reference/gtk/tmpl/gtktreeview.sgml
+++ b/docs/reference/gtk/tmpl/gtktreeview.sgml
@@ -2,7 +2,7 @@
 GtkTreeView
 
 <!-- ##### SECTION Short_Description ##### -->
-A widget for displaying both trees and lists.
+A widget for displaying both trees and lists
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkuimanager.sgml b/docs/reference/gtk/tmpl/gtkuimanager.sgml
index dffa7303e9..9f82abf6d9 100644
--- a/docs/reference/gtk/tmpl/gtkuimanager.sgml
+++ b/docs/reference/gtk/tmpl/gtkuimanager.sgml
@@ -2,7 +2,7 @@
 GtkUIManager
 
 <!-- ##### SECTION Short_Description ##### -->
-constructing menus and toolbars from an XML description
+Constructing menus and toolbars from an XML description
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
diff --git a/docs/reference/gtk/tmpl/gtkvscale.sgml b/docs/reference/gtk/tmpl/gtkvscale.sgml
index 7727cb74c8..cbc1c3f439 100644
--- a/docs/reference/gtk/tmpl/gtkvscale.sgml
+++ b/docs/reference/gtk/tmpl/gtkvscale.sgml
@@ -2,13 +2,12 @@
 GtkVScale
 
 <!-- ##### SECTION Short_Description ##### -->
-a vertical slider widget for selecting a value from a range.
+A vertical slider widget for selecting a value from a range
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
 The #GtkVScale widget is used to allow the user to select a value using
-a vertical slider.
-To create one, use gtk_hscale_new_with_range().
+a vertical slider. To create one, use gtk_hscale_new_with_range().
 </para>
 <para>
 The position to show the current value, and the number of decimal places