[gtk+] toolbutton: improve docs wrt stock deprecation

[Stefan Kost <stefkost src gnome org>]

commit 658a1ef06989b0a02ca6d056bd1f90889c25a52d
Author: Stefan Sauer <ensonic users sf net>
Date:   Tue Jul 21 20:16:15 2015 +0200

    toolbutton: improve docs wrt stock deprecation
    
    Docuemnt where to get the images from.

 gtk/gtktoolbutton.c |    5 +++--
 1 files changed, 3 insertions(+), 2 deletions(-)
---
diff --git a/gtk/gtktoolbutton.c b/gtk/gtktoolbutton.c
index 07344cd..6a71c66 100644
--- a/gtk/gtktoolbutton.c
+++ b/gtk/gtktoolbutton.c
@@ -1115,7 +1115,8 @@ gtk_tool_button_sync_action_properties (GtkActivatable *activatable,
  * 
  * Since: 2.4
  *
- * Deprecated: 3.10: Use gtk_tool_button_new() instead.
+ * Deprecated: 3.10: Use gtk_tool_button_new() together with
+ * gtk_image_new_from_icon_name() instead.
  **/
 GtkToolItem *
 gtk_tool_button_new_from_stock (const gchar *stock_id)
@@ -1136,7 +1137,7 @@ gtk_tool_button_new_from_stock (const gchar *stock_id)
  * @label: (allow-none): a string that will be used as label, or %NULL
  * @icon_widget: (allow-none): a widget that will be used as the button contents, or %NULL
  *
- * Creates a new %GtkToolButton using @icon_widget as contents and @label as
+ * Creates a new #GtkToolButton using @icon_widget as contents and @label as
  * label.
  *
  * Returns: A new #GtkToolButton