Make short descriptions a bit more consistent.

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.

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>

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>

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>

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>

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>

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>

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>

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>

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>

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>

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
+input, e.g. to display a message, ask a question, or anything else that does 
-require extensive effort on the user's part.
+not require extensive effort on the user's part.
 </para>
 
 <para>

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>

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>

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>

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>

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>

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>

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>

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>

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>

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
+a horizontal slider. To create one, use gtk_hscale_new_with_range().
-gtk_hscale_new_with_range().
 </para>
 <para>
 The position to show the current value, and the number of decimal places

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>

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>

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>

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>

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>

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>

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>

docs/reference/gtk/tmpl/gtkmessagedialog.sgml

@@ -2,8 +2,7 @@
 GtkMessageDialog
 
 <!-- ##### SECTION Short_Description ##### -->
-
+A convenient message window
-convenient message window
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>

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>

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>

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>

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>

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>

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>

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>

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>

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>

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>
 

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>

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>

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>

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>

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>

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
+The base class of widgets that can be added to GtkToolbar
-#GtkToolbar.
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>

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>

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>

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.
+a vertical slider. To create one, use gtk_hscale_new_with_range().
-To create one, use gtk_hscale_new_with_range().
 </para>
 <para>
 The position to show the current value, and the number of decimal places