Clean up short descriptions

svn path=/trunk/; revision=18098

diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog
index 3c588e06bdf3e17c3f6bd6c6592357edddf3d74d..50fa1e0235415a1bc15e2398de5afd89f8a430a7 100644 (file)
--- a/docs/reference/ChangeLog
+++ b/docs/reference/ChangeLog
@@ -1,3 +1,30 @@
+2007-06-09  Matthias Clasen  <mclasen@redhat.com>
+
+       * gtk/gtk-update-icon-cache.xml: Document --validate
+
+2007-06-09  Matthias Clasen  <mclasen@redhat.com>
+
+       * gtk/text_widget.sgml:
+       * gtk/tree_widget.sgml:
+       * gtk/tmpl/gtkscalebutton.sgml:
+       * gtk/tmpl/gtktextbuffer.sgml:
+       * gtk/tmpl/gtktexttag.sgml:
+       * gtk/tmpl/gtktextview.sgml:
+       * gtk/tmpl/gtktreemodel.sgml:
+       * gtk/tmpl/gtktreeselection.sgml:
+       * gtk/tmpl/gtktreeviewcolumn.sgml:
+       * gtk/tmpl/gtkcellrenderer.sgml:
+       * gtk/tmpl/gtkliststore.sgml:
+       * gtk/tmpl/gtktreestore.sgml:
+       * gtk/tmpl/gtkmenubar.sgml:
+       * gtk/tmpl/gtkbbox.sgml:
+       * gtk/tmpl/gtkseparator.sgml:
+       * gtk/tmpl/gtkgamma.sgml:
+       * gtk/tmpl/gtkhruler.sgml:
+       * gtk/tmpl/gtkvruler.sgml:
+       * gtk/tmpl/gtkrecentchooser.sgml:
+       * gtk/tmpl/gtkvolumebutton.sgml: Clean up short descriptions
+
 2007-06-09  Matthias Clasen  <mclasen@redhat.com>
 
        * gtk/tmpl/gtkbindings.sgml:

diff --git a/docs/reference/gtk/gtk-update-icon-cache.xml b/docs/reference/gtk/gtk-update-icon-cache.xml
index 6568d5d5f2ab8997292d829897e15cb1eb07d611..58c5a28a8d81cef729c046d0d02cf701a5465ce9 100644 (file)
--- a/docs/reference/gtk/gtk-update-icon-cache.xml
+++ b/docs/reference/gtk/gtk-update-icon-cache.xml
@@ -18,6 +18,7 @@
 <arg choice="opt">--index-only</arg>
 <arg choice="opt">--source<arg>name</arg></arg>
 <arg choice="opt">--quiet</arg>
+<arg choice="opt">--validate</arg>
 <arg choice="req">iconpath</arg>
 </cmdsynopsis>
 </refsynopsisdiv>
@@ -80,6 +81,13 @@ multiple applications, the overall memory consumption is reduced as well.
     <listitem><para>Turn off verbose output. 
     </para></listitem>
   </varlistentry>
+
+  <varlistentry>
+    <term>--validate</term>
+    <term>-v</term>
+    <listitem><para>Validate existing icon cache.
+    </para></listitem>
+  </varlistentry>
 </variablelist>
 </refsect1>
 

diff --git a/docs/reference/gtk/text_widget.sgml b/docs/reference/gtk/text_widget.sgml
index da31a8ee17b52eade3a6f1350837fbe49a40bf8a..2e7d3c3080770612e6981f36bce7da8ecd512887 100644 (file)
--- a/docs/reference/gtk/text_widget.sgml
+++ b/docs/reference/gtk/text_widget.sgml
@@ -7,7 +7,7 @@
 
 <refnamediv>
 <refname>Text Widget Overview</refname>
-<refpurpose>Overview of #GtkTextBuffer, #GtkTextView, and friends</refpurpose>
+<refpurpose>Overview of GtkTextBuffer, GtkTextView, and friends</refpurpose>
 </refnamediv>
 
 <refsect1>

diff --git a/docs/reference/gtk/tmpl/gtkbbox.sgml b/docs/reference/gtk/tmpl/gtkbbox.sgml
index 4037e3b15848f9751fc969205e6fb49b965b9d5f..53dcbb99affbe689094419b78d8248e8407aa35b 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkbbox.sgml
+++ b/docs/reference/gtk/tmpl/gtkbbox.sgml
@@ -2,7 +2,7 @@
 GtkButtonBox
 
 <!-- ##### SECTION Short_Description ##### -->
-Base class for #GtkHButtonBox and #GtkVButtonBox
+Base class for GtkHButtonBox and GtkVButtonBox
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>

diff --git a/docs/reference/gtk/tmpl/gtkcellrenderer.sgml b/docs/reference/gtk/tmpl/gtkcellrenderer.sgml
index 90a32b48af7ad033ca84d536a0dd0ac5de697e49..a44b350bdfd29d81d61c6cc248f7a385abb8b06c 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkcellrenderer.sgml
+++ b/docs/reference/gtk/tmpl/gtkcellrenderer.sgml
@@ -2,7 +2,7 @@
 GtkCellRenderer
 
 <!-- ##### SECTION Short_Description ##### -->
-An object for rendering a single cell on a #GdkDrawable
+An object for rendering a single cell on a GdkDrawable
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>

diff --git a/docs/reference/gtk/tmpl/gtkgamma.sgml b/docs/reference/gtk/tmpl/gtkgamma.sgml
index 6d061fcff9c79ce10f7c7308218ba7377f5fea17..35719a719a32a6db124b038b80360186c90426fd 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkgamma.sgml
+++ b/docs/reference/gtk/tmpl/gtkgamma.sgml
@@ -2,7 +2,7 @@
 GtkGammaCurve
 
 <!-- ##### SECTION Short_Description ##### -->
-a subclass of #GtkCurve for editing gamma curves.
+A subclass of GtkCurve for editing gamma curves
 
 <!-- ##### SECTION Long_Description ##### -->
 <note>

diff --git a/docs/reference/gtk/tmpl/gtkhruler.sgml b/docs/reference/gtk/tmpl/gtkhruler.sgml
index 16de20049a71fbfdca5084611499794bbaacdae6..ea2cd508fd4f138d5672c4bbf0be610fa13fa99d 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkhruler.sgml
+++ b/docs/reference/gtk/tmpl/gtkhruler.sgml
@@ -2,7 +2,7 @@
 GtkHRuler
 
 <!-- ##### SECTION Short_Description ##### -->
-A horizontal ruler.
+A horizontal ruler
 
 <!-- ##### SECTION Long_Description ##### -->
 <note>

diff --git a/docs/reference/gtk/tmpl/gtkliststore.sgml b/docs/reference/gtk/tmpl/gtkliststore.sgml
index 8a66f439995eb6f854c9e3085a012b6373a5afbe..b5b8a716d7d0a76882f2a6b11624d15142845323 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkliststore.sgml
+++ b/docs/reference/gtk/tmpl/gtkliststore.sgml
@@ -2,7 +2,7 @@
 GtkListStore
 
 <!-- ##### SECTION Short_Description ##### -->
-A list-like data structure that can be used with the #GtkTreeView
+A list-like data structure that can be used with the GtkTreeView
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
@@ -181,6 +181,18 @@ will cause the #GtkTreeModelFilterVisibleFunc to be visited with an empty row fi
 @value: 
 
 
+<!-- ##### FUNCTION gtk_list_store_set_valuesv ##### -->
+<para>
+
+</para>
+
+@list_store: 
+@iter: 
+@columns: 
+@values: 
+@n_values: 
+
+
 <!-- ##### FUNCTION gtk_list_store_remove ##### -->
 <para>
 

diff --git a/docs/reference/gtk/tmpl/gtkmenubar.sgml b/docs/reference/gtk/tmpl/gtkmenubar.sgml
index 7396daaf58b2be021c610583d91cf2bfbc1c4bb8..cce36731626bee31d03f9b5af00f4e154c462fdd 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkmenubar.sgml
+++ b/docs/reference/gtk/tmpl/gtkmenubar.sgml
@@ -2,7 +2,7 @@
 GtkMenuBar
 
 <!-- ##### SECTION Short_Description ##### -->
-A subclass widget for #GtkMenuShell which holds #GtkMenuItem widgets
+A subclass widget for GtkMenuShell which holds GtkMenuItem widgets
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>

diff --git a/docs/reference/gtk/tmpl/gtkrecentchooser.sgml b/docs/reference/gtk/tmpl/gtkrecentchooser.sgml
index 1fa7b35a423776b0462ec17c27f843de30aaf06f..85013ba6f80ee4bbad8adcf6858e2721be5e1958 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkrecentchooser.sgml
+++ b/docs/reference/gtk/tmpl/gtkrecentchooser.sgml
@@ -2,7 +2,7 @@
 GtkRecentChooser
 
 <!-- ##### SECTION Short_Description ##### -->
-Interface implemented by GtkRecentChooserWidget, GtkRecentChooserMenu and GtkRecentChooserDialog
+Interface implemented by widgets displaying recently used files
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
@@ -45,6 +45,56 @@ Recently used files are supported since GTK+ 2.10.
 
 @recentchooser: the object which received the signal.
 
+<!-- ##### ARG GtkRecentChooser:filter ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkRecentChooser:limit ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkRecentChooser:local-only ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkRecentChooser:recent-manager ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkRecentChooser:select-multiple ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkRecentChooser:show-icons ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkRecentChooser:show-not-found ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkRecentChooser:show-private ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkRecentChooser:show-tips ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GtkRecentChooser:sort-type ##### -->
+<para>
+
+</para>
+
 <!-- ##### STRUCT GtkRecentChooserIface ##### -->
 <para>
 

diff --git a/docs/reference/gtk/tmpl/gtkscalebutton.sgml b/docs/reference/gtk/tmpl/gtkscalebutton.sgml
index e44e63aa786af56c3a5121fcdd4a2b10add91190..df23b8d32084a83ba05343af3574e2950fbd1738 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkscalebutton.sgml
+++ b/docs/reference/gtk/tmpl/gtkscalebutton.sgml
@@ -2,7 +2,7 @@
 GtkScaleButton
 
 <!-- ##### SECTION Short_Description ##### -->
-
+A button which pops up a scale
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
@@ -50,6 +50,11 @@ GtkScaleButton
 
 </para>
 
+<!-- ##### ARG GtkScaleButton:icons ##### -->
+<para>
+
+</para>
+
 <!-- ##### ARG GtkScaleButton:size ##### -->
 <para>
 

diff --git a/docs/reference/gtk/tmpl/gtkseparator.sgml b/docs/reference/gtk/tmpl/gtkseparator.sgml
index e4d4935b5b760e08d83e57d9ae9d02e549526300..2bff699cd89c76247d24f4fa555033ecd76d9e6c 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkseparator.sgml
+++ b/docs/reference/gtk/tmpl/gtkseparator.sgml
@@ -2,7 +2,7 @@
 GtkSeparator
 
 <!-- ##### SECTION Short_Description ##### -->
-Base class for #GtkHSeparator and #GtkVSeparator
+Base class for GtkHSeparator and GtkVSeparator
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>

diff --git a/docs/reference/gtk/tmpl/gtktextbuffer.sgml b/docs/reference/gtk/tmpl/gtktextbuffer.sgml
index 56e783c5eee65ff34bcb7507fe00a8b44be0304f..9b52e8a7925d97049d057aa805a43ca5b2964ff6 100644 (file)
--- a/docs/reference/gtk/tmpl/gtktextbuffer.sgml
+++ b/docs/reference/gtk/tmpl/gtktextbuffer.sgml
@@ -2,9 +2,7 @@
 GtkTextBuffer
 
 <!-- ##### SECTION Short_Description ##### -->
-
-Stores attributed text for display in a <link
-linkend="GtkTextView">GtkTextView</link>
+Stores attributed text for display in a GtkTextView
 
 <!-- ##### SECTION Long_Description ##### -->
 

diff --git a/docs/reference/gtk/tmpl/gtktexttag.sgml b/docs/reference/gtk/tmpl/gtktexttag.sgml
index cf134d502dc3d77406d2a5c0334eedcc2d3b1b76..ff66730859ab7042accb3fad89856398ad49d72d 100644 (file)
--- a/docs/reference/gtk/tmpl/gtktexttag.sgml
+++ b/docs/reference/gtk/tmpl/gtktexttag.sgml
@@ -2,8 +2,7 @@
 GtkTextTag
 
 <!-- ##### SECTION Short_Description ##### -->
-
-A tag that can be applied to text in a <link linkend="GtkTextBuffer">GtkTextBuffer</link>
+A tag that can be applied to text in a GtkTextBuffer
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>

diff --git a/docs/reference/gtk/tmpl/gtktextview.sgml b/docs/reference/gtk/tmpl/gtktextview.sgml
index bbc058401bc9db4458597a441d81533907638396..5479e15f3986f2a884d5e6f70cbaae2fdd5605e4 100644 (file)
--- a/docs/reference/gtk/tmpl/gtktextview.sgml
+++ b/docs/reference/gtk/tmpl/gtktextview.sgml
@@ -2,7 +2,7 @@
 GtkTextView
 
 <!-- ##### SECTION Short_Description ##### -->
-Widget that displays a <link linkend="GtkTextBuffer">GtkTextBuffer</link>
+Widget that displays a GtkTextBuffer
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>

diff --git a/docs/reference/gtk/tmpl/gtktreemodel.sgml b/docs/reference/gtk/tmpl/gtktreemodel.sgml
index 1bc63fb9443b20b2542cf74bd72990911fb72a37..3bd3dfcc22ea2b1648eaef4be8ffc9113069b359 100644 (file)
--- a/docs/reference/gtk/tmpl/gtktreemodel.sgml
+++ b/docs/reference/gtk/tmpl/gtktreemodel.sgml
@@ -2,7 +2,7 @@
 GtkTreeModel
 
 <!-- ##### SECTION Short_Description ##### -->
-The tree interface used by #GtkTreeView
+The tree interface used by GtkTreeView
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>

diff --git a/docs/reference/gtk/tmpl/gtktreeselection.sgml b/docs/reference/gtk/tmpl/gtktreeselection.sgml
index d3bb888146dd1a4ccb795ea9486004d202494595..1bb4275b6b17b6b2b38448ec8a7545a7f833d17b 100644 (file)
--- a/docs/reference/gtk/tmpl/gtktreeselection.sgml
+++ b/docs/reference/gtk/tmpl/gtktreeselection.sgml
@@ -2,7 +2,7 @@
 GtkTreeSelection
 
 <!-- ##### SECTION Short_Description ##### -->
-The selection object for #GtkTreeView
+The selection object for GtkTreeView
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>

diff --git a/docs/reference/gtk/tmpl/gtktreestore.sgml b/docs/reference/gtk/tmpl/gtktreestore.sgml
index 1127c47e15a91d18d456fa0e73d5a80bf6e43024..95b450f229ff9a57718102d41280442a3d3db318 100644 (file)
--- a/docs/reference/gtk/tmpl/gtktreestore.sgml
+++ b/docs/reference/gtk/tmpl/gtktreestore.sgml
@@ -2,7 +2,7 @@
 GtkTreeStore
 
 <!-- ##### SECTION Short_Description ##### -->
-A tree-like data structure that can be used with the #GtkTreeView
+A tree-like data structure that can be used with the GtkTreeView
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
@@ -90,6 +90,18 @@ drop</link> interfaces.
 @var_args: 
 
 
+<!-- ##### FUNCTION gtk_tree_store_set_valuesv ##### -->
+<para>
+
+</para>
+
+@tree_store: 
+@iter: 
+@columns: 
+@values: 
+@n_values: 
+
+
 <!-- ##### FUNCTION gtk_tree_store_remove ##### -->
 <para>
 

diff --git a/docs/reference/gtk/tmpl/gtktreeviewcolumn.sgml b/docs/reference/gtk/tmpl/gtktreeviewcolumn.sgml
index e7ccb7ec6cfc8a33bdb5413793ff6e0c6279f562..74127071060c891ebf75ffa80e3f0ebb8467b5c3 100644 (file)
--- a/docs/reference/gtk/tmpl/gtktreeviewcolumn.sgml
+++ b/docs/reference/gtk/tmpl/gtktreeviewcolumn.sgml
@@ -2,7 +2,7 @@
 GtkTreeViewColumn
 
 <!-- ##### SECTION Short_Description ##### -->
-A visible column in a #GtkTreeView widget
+A visible column in a GtkTreeView widget
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
@@ -613,3 +613,12 @@ calling gtk_tree_view_column_set_cell_data_func()
 @tree_column: 
 
 
+<!-- ##### FUNCTION gtk_tree_view_column_get_tree_view ##### -->
+<para>
+
+</para>
+
+@tree_column: 
+@Returns: 
+
+

diff --git a/docs/reference/gtk/tmpl/gtkvolumebutton.sgml b/docs/reference/gtk/tmpl/gtkvolumebutton.sgml
index cf7e49e915ce186f3053f9812ff979825685143f..a4c3fb643cb3c91524b1e01374ae9d2d9126a4d2 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkvolumebutton.sgml
+++ b/docs/reference/gtk/tmpl/gtkvolumebutton.sgml
@@ -2,7 +2,7 @@
 GtkVolumeButton
 
 <!-- ##### SECTION Short_Description ##### -->
-
+A button which pops up a volume control
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>

diff --git a/docs/reference/gtk/tmpl/gtkvruler.sgml b/docs/reference/gtk/tmpl/gtkvruler.sgml
index 77f1513609fb18c00b96f6f3a6d2373211a0626c..89b8af90f7f31c7e8e5fa0b7e8ff9a5f4600d64a 100644 (file)
--- a/docs/reference/gtk/tmpl/gtkvruler.sgml
+++ b/docs/reference/gtk/tmpl/gtkvruler.sgml
@@ -2,7 +2,7 @@
 GtkVRuler
 
 <!-- ##### SECTION Short_Description ##### -->
-A vertical ruler.
+A vertical ruler
 
 <!-- ##### SECTION Long_Description ##### -->
 <note>

diff --git a/docs/reference/gtk/tree_widget.sgml b/docs/reference/gtk/tree_widget.sgml
index 4dee9c0897b2aae2a4efdfcd11e2c9133ba9bc98..8e42929769ed6b2c7d7a2aaa6dd273f91e798106 100644 (file)
--- a/docs/reference/gtk/tree_widget.sgml
+++ b/docs/reference/gtk/tree_widget.sgml
@@ -7,8 +7,7 @@
 
   <refnamediv>
     <refname>Tree and List Widget Overview</refname>
-    <refpurpose>Overview of #GtkTreeModel, #GtkTreeView, and other 
-    associated widgets</refpurpose>
+    <refpurpose>Overview of GtkTreeModel, GtkTreeView, and friends</refpurpose>
   </refnamediv>
 
   <refsect1>