[gnome-panel/wip/gnome-3.10+: 62/75] libpanel-applet: update documentation

[Alberts Muktupāvels <muktupavels src gnome org>]

commit 3f0be9bb1b090aab8940cb82d850bfbf5c5201d5
Author: Alberts Muktupāvels <alberts muktupavels gmail com>
Date:   Wed Sep 3 23:41:49 2014 +0300

    libpanel-applet: update documentation

 .../panel-applet/panel-applet-sections.txt         |    4 +-
 doc/reference/panel-applet/tmpl/applet.sgml        |   57 ++++---------------
 libpanel-applet/panel-applet.c                     |   15 +++--
 3 files changed, 22 insertions(+), 54 deletions(-)
---
diff --git a/doc/reference/panel-applet/panel-applet-sections.txt 
b/doc/reference/panel-applet/panel-applet-sections.txt
index 409b547..daa21d5 100644
--- a/doc/reference/panel-applet/panel-applet-sections.txt
+++ b/doc/reference/panel-applet/panel-applet-sections.txt
@@ -7,7 +7,6 @@ PanelApplet
 PanelAppletOrient
 PanelAppletFlags
 panel_applet_get_orient
-panel_applet_get_size
 panel_applet_set_size_hints
 panel_applet_get_background
 panel_applet_set_background_widget
@@ -15,11 +14,10 @@ panel_applet_get_flags
 panel_applet_set_flags
 panel_applet_get_locked_down
 panel_applet_settings_new
-panel_applet_add_preferences
-panel_applet_get_preferences_key
 panel_applet_request_focus
 panel_applet_setup_menu
 panel_applet_setup_menu_from_file
+panel_applet_setup_menu_from_resource
 <SUBSECTION Standard>
 PANEL_APPLET
 PANEL_IS_APPLET
diff --git a/doc/reference/panel-applet/tmpl/applet.sgml b/doc/reference/panel-applet/tmpl/applet.sgml
index 7f635f2..ee171e8 100644
--- a/doc/reference/panel-applet/tmpl/applet.sgml
+++ b/doc/reference/panel-applet/tmpl/applet.sgml
@@ -42,14 +42,6 @@ Panel Applet
 @panelapplet: the object which received the signal.
 @arg1: 
 
-<!-- ##### SIGNAL PanelApplet::change-size ##### -->
-<para>
-
-</para>
-
- panelapplet: the object which received the signal.
- arg1: 
-
 <!-- ##### SIGNAL PanelApplet::move-focus-out-of-applet ##### -->
 <para>
 
@@ -93,21 +85,11 @@ Panel Applet
 
 </para>
 
-<!-- ##### ARG PanelApplet:prefs-key ##### -->
-<para>
-
-</para>
-
 <!-- ##### ARG PanelApplet:settings-path ##### -->
 <para>
 
 </para>
 
-<!-- ##### ARG PanelApplet:size ##### -->
-<para>
-
-</para>
-
 <!-- ##### ARG PanelApplet:size-hints ##### -->
 <para>
 
@@ -142,15 +124,6 @@ Panel Applet
 @Returns: 
 
 
-<!-- ##### FUNCTION panel_applet_get_size ##### -->
-<para>
-
-</para>
-
- applet: 
- Returns: 
-
-
 <!-- ##### FUNCTION panel_applet_set_size_hints ##### -->
 <para>
 
@@ -217,51 +190,45 @@ Panel Applet
 @Returns: 
 
 
-<!-- ##### FUNCTION panel_applet_add_preferences ##### -->
-<para>
-
-</para>
-
- applet: 
- schema_dir: 
- error: 
-
-
-<!-- ##### FUNCTION panel_applet_get_preferences_key ##### -->
+<!-- ##### FUNCTION panel_applet_request_focus ##### -->
 <para>
 
 </para>
 
 @applet: 
- Returns: 
+ timestamp: 
 
 
-<!-- ##### FUNCTION panel_applet_request_focus ##### -->
+<!-- ##### FUNCTION panel_applet_setup_menu ##### -->
 <para>
 
 </para>
 
 @applet: 
- timestamp: 
+ xml: 
+ action_group: 
+ translation_domain: 
 
 
-<!-- ##### FUNCTION panel_applet_setup_menu ##### -->
+<!-- ##### FUNCTION panel_applet_setup_menu_from_file ##### -->
 <para>
 
 </para>
 
 @applet: 
- xml: 
+ filename: 
 @action_group: 
+ translation_domain: 
 
 
-<!-- ##### FUNCTION panel_applet_setup_menu_from_file ##### -->
+<!-- ##### FUNCTION panel_applet_setup_menu_from_resource ##### -->
 <para>
 
 </para>
 
 @applet: 
- filename: 
+ resource_path: 
 @action_group: 
+ translation_domain: 
 
 
diff --git a/libpanel-applet/panel-applet.c b/libpanel-applet/panel-applet.c
index 0fa62d9..b4c9372 100644
--- a/libpanel-applet/panel-applet.c
+++ b/libpanel-applet/panel-applet.c
@@ -691,11 +691,12 @@ panel_applet_menu_cmd_move (GSimpleAction *action,
  * panel_applet_setup_menu:
  * @applet: a #PanelApplet.
  * @xml: a menu XML string.
- * @action_group: a #GtkActionGroup.
+ * @action_group: a #GSimpleActionGroup.
+ * @translation_domain: gettext translation domain
  *
  * Sets up the context menu of @applet. @xml is a #GtkUIManager UI definition,
  * describing how to display the menu items. @action_group contains the
- * various #GtkAction that are referenced in @xml.
+ * various #GSimpleAction that are referenced in @xml.
  *
  * See also the <link linkend="getting-started.context-menu">Context
  * Menu</link> section.
@@ -733,11 +734,12 @@ panel_applet_setup_menu (PanelApplet    *applet,
  * panel_applet_setup_menu_from_file:
  * @applet: a #PanelApplet.
  * @filename: path to a menu XML file.
- * @action_group: a #GtkActionGroup.
+ * @action_group: a #GSimpleActionGroup.
+ * @translation_domain: gettext translation domain
  *
  * Sets up the context menu of @applet. @filename is the path to a menu XML
  * file, containing a #GtkUIManager UI definition that describes how to display
- * the menu items. @action_group contains the various #GtkAction that
+ * the menu items. @action_group contains the various #GSimpleAction that
  * are referenced in @xml.
  *
  * See also the <link linkend="getting-started.context-menu">Context
@@ -766,11 +768,12 @@ panel_applet_setup_menu_from_file (PanelApplet    *applet,
  * panel_applet_setup_menu_from_resource:
  * @applet: a #PanelApplet.
  * @resource_path: a resource path
- * @action_group: a #GtkActionGroup.
+ * @action_group: a #GSimpleActionGroup.
+ * @translation_domain: gettext translation domain
  *
  * Sets up the context menu of @applet. @filename is a resource path to a menu
  * XML file, containing a #GtkUIManager UI definition that describes how to
- * display the menu items. @action_group contains the various #GtkAction that
+ * display the menu items. @action_group contains the various #GSimpleAction that
  * are referenced in @xml.
  *
  * See also the <link linkend="getting-started.context-menu">Context