Make short descriptions a bit more consistent.

49 files changed, 56 insertions, 58 deletions

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index b167945b9..17ba22de3 100644
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,5 +1,8 @@
 2004-10-11  Matthias Clasen  <matthias@localhost.localdomain>
 
+	* gtk/tmpl/*.sgml: Make the short descriptions a bit more
+	consistent.
+
 	* gtk/images/image.png:
 	* gtk/images/scales.png:
 	* gtk/images/statusbar.png: New images.
diff --git a/docs/reference/gtk/tmpl/gtkaction.sgml b/docs/reference/gtk/tmpl/gtkaction.sgml
index 0ce3f627d..6c04d0c66 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 6ec1b5fea..da3030322 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 433c40c9b..b4f1bc15e 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 eab4c42f1..7866e80c8 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 2f6a954f2..4846f123e 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 f6494c3db..e13816afc 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 844fd5c01..22bd05707 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 3ef7f7a5c..56d4f2134 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 d06e873a5..7421d29b8 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 1151680ee..42e637f2d 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 e2fa9f0b0..812116776 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 ac0b950f2..9304ad23f 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 61976ba52..1fa8fb3cf 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 4074befe4..e8786602b 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 0272a9b7c..296c55f0b 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 dac3203e9..706490b13 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 9f559a136..add7e43ed 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 f00da8b8b..a3243327f 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 c5a70f401..7847656ad 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 5e15d6e6b..b97ff929d 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 42efdb657..f4c9782ed 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 91aa18eeb..6650a4b8e 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 bf5210516..9411028f8 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 c34b8641a..9d4a61c66 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 1853bbaa7..a58a43fbe 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 d01553f29..1c8f72f8d 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 90b8c7ff9..14e0cd4db 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 6ce095e33..343011991 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 7ba8f801a..f1bab03d0 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 c86e50ef9..7f871f943 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 9f1f607dd..73198b2eb 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 8d33d0761..2bf1893c2 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 0c6e4d057..b404e8c48 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 732a4a29e..9ab4bdd83 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 13ba858d5..71dcc402c 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 5234f34e7..08b98faad 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 a9fba3992..e9bd2c984 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 f6f490857..b8d0f64b2 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 b155db59c..822c887c1 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 356bc22bd..fff7e752d 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 c1ed0a54b..b4ef1019e 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 d95ad9116..e318457ce 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 f31982145..b37dfea71 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 3f4da88b3..817170c0a 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 9fc2b5d91..125806ae1 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 7cad5580d..f3a127eba 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 dffa7303e..9f82abf6d 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 7727cb74c..cbc1c3f43 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