a few docs fixes

[Vitaly Tishkov <tvv sparc spb su>]

Hi,

Below is the patch that fixes a few trivial bugs in docs.


1), 2)  - removed duplicated docs from sgml template;
3) removed duplicated docs for gtk_toolbar_insert_element() from sgml template;
moved docs for gtk_toolbar_append/prepend_element from .sgml to .c
4) gtk_object_new() is marked as deprecated according to it's documentation.
5) typo fix

OK to commit?

Thanks,
    Vitaly.



1)
Index: docs/reference/gtk/tmpl/gtkaccellabel.sgml
===================================================================
RCS file: /cvs/gnome/gtk+/docs/reference/gtk/tmpl/gtkaccellabel.sgml,v
retrieving revision 1.10
diff -r1.10 gtkaccellabel.sgml
117c117
< Sets the widget whose accelerators are to be shown.
---
>
120,121c120,121
< @accel_label: a #GtkAccelLabel.
< @accel_widget: the widget whose accelerators are to be displayed.
---
> @accel_label:
> @accel_widget:



2)
Index: docs/reference/gtk/tmpl/gtkimage.sgml
===================================================================
RCS file: /cvs/gnome/gtk+/docs/reference/gtk/tmpl/gtkimage.sgml,v
retrieving revision 1.11
diff -r1.11 gtkimage.sgml
333c333
< Creates the new #GtkImage using the value and the mask.
---
>
336c336
< @Returns: the #GtkImage
---
> @Returns:



3)
Index: docs/reference/gtk/tmpl/gtktoolbar.sgml
===================================================================
RCS file: /cvs/gnome/gtk+/docs/reference/gtk/tmpl/gtktoolbar.sgml,v
retrieving revision 1.11
diff -r1.11 gtktoolbar.sgml
155c155
< Adds a new element to the end of a toolbar.
---
>
172c172
< Adds a new element to the beginning of a toolbar.
---
>

Index: gtk/gtktoolbar.c
===================================================================
RCS file: /cvs/gnome/gtk+/gtk/gtktoolbar.c,v
retrieving revision 1.68
diff -r1.68 gtktoolbar.c
1247a1248,1268
> /**
>  * gtk_toolbar_append_element:
>  * @toolbar: a #GtkToolbar.
>  * @type: a value of type #GtkToolbarChildType that determines what @widget
>  *   will be.
>  * @widget: a #GtkWidget, or %NULL.
>  * @text: the element's label.
>  * @tooltip_text: the element's tooltip.
>  * @tooltip_private_text: used for context-sensitive help about this toolbar
element.
>  * @icon: a #GtkWidget that provides pictorial representation of the element's
function.
>  * @callback: the function to be executed when the button is pressed.
>  * @user_data: any data you wish to pass to the callback.
>  *
>  * Adds a new element to the beginning of the toolbar. If
>  * @type == %GTK_TOOLBAR_CHILD_WIDGET, @widget is used as the new element.
>  * If @type == %GTK_TOOLBAR_CHILD_RADIOBUTTON, @widget is used to determine
>  * the radio group for the new element. In all other cases, @widget must
>  * be %NULL.
>  *
>  * Return value: the new toolbar element as a #GtkWidget.
>  **/
1264a1286,1306
> /**
>  * gtk_toolbar_prepend_element:
>  * @toolbar: a #GtkToolbar.
>  * @type: a value of type #GtkToolbarChildType that determines what @widget
>  *   will be.
>  * @widget: a #GtkWidget, or %NULL.
>  * @text: the element's label.
>  * @tooltip_text: the element's tooltip.
>  * @tooltip_private_text: used for context-sensitive help about this toolbar
element.
>  * @icon: a #GtkWidget that provides pictorial representation of the element's
function.
>  * @callback: the function to be executed when the button is pressed.
>  * @user_data: any data you wish to pass to the callback.
>  *
>  * Adds a new element to the end of the toolbar. If
>  * @type == %GTK_TOOLBAR_CHILD_WIDGET, @widget is used as the new element.
>  * If @type == %GTK_TOOLBAR_CHILD_RADIOBUTTON, @widget is used to determine
>  * the radio group for the new element. In all other cases, @widget must
>  * be %NULL.
>  *
>  * Return value: the new toolbar element as a #GtkWidget.
>  **/


4)
Index: gtk/gtkobject.h
===================================================================
RCS file: /cvs/gnome/gtk+/gtk/gtkobject.h,v
retrieving revision 1.59
diff -r1.59 gtkobject.h
131,134d130
< GtkObject* gtk_object_new    (GtkType        type,
<         const gchar       *first_property_name,
<         ...);
<
141a138,140
> GtkObject* gtk_object_new    (GtkType        type,
>         const gchar       *first_property_name,
>         ...);


5)
Index: docs/reference/gtk/tmpl/gtkstyle.sgml
===================================================================
RCS file: /cvs/gnome/gtk+/docs/reference/gtk/tmpl/gtkstyle.sgml,v
retrieving revision 1.14
diff -r1.14 gtkstyle.sgml
20c20
< Returns whether the styleis attached to a window.
---
> Returns whether the styles attached to a window.