Review: Approve
Looks good to me!

  review approve

On Sun, 2010-05-23 at 10:48 +0000, Sense Hofstede wrote:
> Sense Hofstede has proposed merging 
> lp:~qense/indicator-application/doc-intro-fixes into lp:indicator-application.
> 
> Requested reviews:
>   Indicator Applet Developers (indicator-applet-developers)
> 
> differences between files attachment (review-diff.txt)
> === modified file 'bindings/mono/Makefile.am'
> --- bindings/mono/Makefile.am 2010-04-14 16:07:23 +0000
> +++ bindings/mono/Makefile.am 2010-05-23 10:48:29 +0000
> @@ -12,7 +12,7 @@
>  ASSEMBLY_NAME = appindicator-sharp
>  ASSEMBLY = appindicator-sharp.dll
>  TARGET = $(ASSEMBLY) $(ASSEMBLY).config
> -assemblydir = $(libdir)/appindicator-sharp-0.1
> +assemblydir = $(libdir)/cli/appindicator-sharp-0.1
>  assembly_DATA = $(TARGET)
>  CLEANFILES = $(ASSEMBLY) $(ASSEMBLY).mdb generated-stamp generated/*.cs 
> $(API) $(MIDDLE_API) $(RAW_API) $(TEST)
>  DISTCLEANFILES = $(ASSEMBLY).config
> @@ -45,21 +45,13 @@
>       fi
>  
>  $(API): $(MIDDLE_API) Makefile..am
> -     sed -e "s|PROP_ID_S|ID|" \
> -             -e "s|PROP_ID_S|id|" \
> -             -e "s|PROP_STATUS_S|Status|" \
> +     sed -e "s|PROP_ID_S|id|" \
>               -e "s|PROP_STATUS_S|status|" \
> -             -e "s|PROP_CATEGORY_S|Category|" \
>               -e "s|PROP_CATEGORY_S|category|" \
> -             -e "s|PROP_ICON_NAME_S|IconName|" \
>               -e "s|PROP_ICON_NAME_S|icon-name|" \
> -             -e "s|PROP_ATTENTION_ICON_NAME_S|AttentionIconName|" \
>               -e "s|PROP_ATTENTION_ICON_NAME_S|attention-icon-name|" \
> -             -e "s|PROP_ICON_THEME_PATH_S|IconThemePath|" \
>               -e "s|PROP_ICON_THEME_PATH_S|icon-theme-path|" \
> -             -e "s|PROP_MENU_S|Menu|" \
>               -e "s|PROP_MENU_S|menu|" \
> -             -e "s|PROP_CONNECTED_S|Connected|" \
>               -e "s|PROP_CONNECTED_S|connected|" \
>               $< > $@
>  
> 
> === modified file 'bindings/mono/appindicator-sharp-0.1.pc.in'
> --- bindings/mono/appindicator-sharp-0.1.pc.in        2009-12-16 21:15:52 
> +0000
> +++ bindings/mono/appindicator-sharp-0.1.pc.in        2010-05-23 10:48:29 
> +0000
> @@ -1,7 +1,7 @@
>  pref...@prefix@
>  exec_pref...@exec_prefix@
>  libd...@libdir@
> -assemblies_dir=${libdir}/appindicator-sharp-0.1
> +assemblies_dir=${libdir}/cli/appindicator-sharp-0.1
>  
>  Name: appindicator-sharp
>  Description: application indicators for .NET
> 
> === modified file 'bindings/mono/libappindicator-api.metadata'
> --- bindings/mono/libappindicator-api.metadata        2010-02-25 14:23:23 
> +0000
> +++ bindings/mono/libappindicator-api.metadata        2010-05-23 10:48:29 
> +0000
> @@ -9,27 +9,33 @@
>       <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/sign...@field_name='connection_changed']"
>  name="cname">connection-changed</attr>
>       <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/sign...@field_name='new_icon']"
>  name="name">NewIcon</attr>
>       <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/sign...@field_name='new_icon']"
>  name="cname">new-icon</attr>
> -     <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/proper...@cname='id']" 
> name="name">ID</attr>
> -     <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/proper...@cname='PROP_CATEGORY_S']"
>  name="hidden"></attr>
> -     <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/proper...@cname='PROP_CATEGORY_S']"
>  name="hidden"></attr>
> -     <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/proper...@cname='PROP_STATUS_S']"
>  name="hidden"></attr>
> -     <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/proper...@cname='PROP_STATUS_S']"
>  name="hidden"></attr>
> -     <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/proper...@cname='icon-name']"
>  name="name">IconName</attr>
> -     <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/proper...@cname='attention-icon-name']"
>  name="name">AttentionIconName</attr>
> -     <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/proper...@cname='menu']" 
> name="name">Menu</attr>
> -     <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/proper...@cname='menu']" 
> name="type">GtkMenu*</attr>
> -     <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/proper...@cname='connected']"
>  name="name">Connected</attr>
> -        <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/meth...@name='SetMenu']" 
> name="name">SetMenu</attr>
> -
> -        <remove-node 
> path="/api/namespace/object/meth...@cname='app_indicator_get_id']" />
> -        <remove-node 
> path="/api/namespace/object/meth...@cname='app_indicator_get_status']" />
> -        <remove-node 
> path="/api/namespace/object/meth...@cname='app_indicator_get_icon']" />
> -        <remove-node 
> path="/api/namespace/object/meth...@cname='app_indicator_get_category']" />
> -        <remove-node 
> path="/api/namespace/object/meth...@cname='app_indicator_get_attention_icon']"
>  />
> +    <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/proper...@cname='PROP_ID_S']"
>  name="name">ID</attr>
> +    <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/proper...@cname='PROP_CATEGORY_S']"
>  name="hidden">true</attr>
> +    <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/proper...@cname='PROP_STATUS_S']"
>  name="hidden">true</attr>
> +    <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/proper...@cname='PROP_ICON_NAME_S']"
>  name="name">IconName</attr>
> +    <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/proper...@cname='PROP_ATTENTION_ICON_NAME_S']"
>  name="name">AttentionIconName</attr>
> +    <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/proper...@cname='PROP_ICON_THEME_PATH_S']"
>  name="name">IconThemePath</attr>
> +    <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/proper...@cname='PROP_MENU_S']"
>  name="name">Menu</attr>
> +    <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/proper...@cname='PROP_MENU_S']"
>  name="type">GtkMenu*</attr>
> +    <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/proper...@cname='PROP_CONNECTED_S']"
>  name="name">Connected</attr>
> +    <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/meth...@name='SetMenu']" 
> name="name">SetMenu</attr>
> +
> +    <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/construct...@cname='app_indicator_new']/*/*...@name='id']"
>  name="property_name">id</attr>
> +    <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/construct...@cname='app_indicator_new']/*/*...@name='icon_name']"
>  name="property_name">icon-name</attr>
> +    <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/construct...@cname='app_indicator_new']/*/*...@name='category']"
>  name="property_name">category</attr>
> +    <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/construct...@cname='app_indicator_new_with_path']/*/*...@name='id']"
>  name="property_name">id</attr>
> +    <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/construct...@cname='app_indicator_new_with_path']/*/*...@name='icon_name']"
>  name="property_name">icon-name</attr>
> +    <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/construct...@cname='app_indicator_new_with_path']/*/*...@name='category']"
>  name="property_name">category</attr>
> +    <attr 
> path="/api/namespace/obje...@cname='AppIndicator']/construct...@cname='app_indicator_new_with_path']/*/*...@name='icon_path']"
>  name="property_name">icon-theme-path</attr>
> +
> +    <remove-node 
> path="/api/namespace/object/meth...@cname='app_indicator_get_id']" />
> +    <remove-node 
> path="/api/namespace/object/meth...@cname='app_indicator_get_status']" />
> +    <remove-node 
> path="/api/namespace/object/meth...@cname='app_indicator_get_icon']" />
> +    <remove-node 
> path="/api/namespace/object/meth...@cname='app_indicator_get_category']" />
> +    <remove-node 
> path="/api/namespace/object/meth...@cname='app_indicator_get_attention_icon']"
>  />
>  
>       <remove-node 
> path="/api/namespace/object/meth...@cname='app_indicator_set_id']" />
> -        <remove-node 
> path="/api/namespace/object/meth...@cname='app_indicator_set_status']" />
> -        <remove-node 
> path="/api/namespace/object/meth...@cname='app_indicator_set_icon']" />
> -        <remove-node 
> path="/api/namespace/object/meth...@cname='app_indicator_set_category']" />
> -        <remove-node 
> path="/api/namespace/object/meth...@cname='app_indicator_set_attention_icon']"
>  />
> +    <remove-node 
> path="/api/namespace/object/meth...@cname='app_indicator_set_status']" />
> +    <remove-node 
> path="/api/namespace/object/meth...@cname='app_indicator_set_icon']" />
> +    <remove-node 
> path="/api/namespace/object/meth...@cname='app_indicator_set_attention_icon']"
>  />
>  </metadata>
> 
> === modified file 'src/Makefile.am'
> --- src/Makefile.am   2010-04-29 17:07:21 +0000
> +++ src/Makefile.am   2010-05-23 10:48:29 +0000
> @@ -52,7 +52,8 @@
>       -Wall -Werror \
>       -DG_LOG_DOMAIN=\"indicator-application-service\"
>  indicator_application_service_LDADD = \
> -     $(INDICATOR_LIBS)
> +     $(INDICATOR_LIBS) \
> +     libappindicator.la
>  
>  glib_marshal_list = application-service-marshal.list
>  glib_marshal_prefix = _application_service_marshal
> @@ -65,19 +66,9 @@
>  pkgconfigdir = $(libdir)/pkgconfig
>  
>  glib_enum_h = app-indicator-enum-types.h
> -glib_enum_c = app-indicator-enum-types.gen.c
> +glib_enum_c = app-indicator-enum-types.c
>  glib_enum_headers = $(libappindicator_headers)
>  
> -app-indicator-enum-types.c: app-indicator-enum-types.gen.c
> -     sed -e "s|\"passive\"|\"Passive\"|" \
> -         -e "s|\"active\"|\"Active\"|" \
> -         -e "s|\"attention\"|\"NeedsAttention\"|" \
> -         -e "s|\"application-status\"|\"ApplicationStatus\"|" \
> -         -e "s|\"communications\"|\"Communications\"|" \
> -         -e "s|\"system-services\"|\"SystemServices\"|" \
> -         -e "s|\"hardware\"|\"Hardware\"|" \
> -         -e "s|\"other\"|\"Other\"|" \
> -            $< > $@
>  DISTCLEANFILES += app-indicator-enum-types.c
>  
>  lib_LTLIBRARIES = \
> 
> === renamed file 'src/app-indicator-enum-types.gen.c.in' => 
> 'src/app-indicator-enum-types.c.in'
> --- src/app-indicator-enum-types.gen.c.in     2010-04-29 16:31:36 +0000
> +++ src/app-indicator-enum-types.c.in 2010-05-23 10:48:29 +0000
> @@ -36,6 +36,13 @@
>  /*** END file-production ***/
>  
>  /*** BEGIN value-header ***/
> +/**
> +     @enum_n...@_get_type:
> +
> +     Builds a GLib type for the #...@enumname@ enumeration.
> +
> +     Return value: A unique #GType for the #...@enumname@ enum.
> +*/
>  GType
>  @enum_n...@_get_type (void)
>  {
> 
> === modified file 'src/app-indicator-enum-types.h.in'
> --- src/app-indicator-enum-types.h.in 2010-04-29 16:31:36 +0000
> +++ src/app-indicator-enum-types.h.in 2010-05-23 10:48:29 +0000
> @@ -48,13 +48,6 @@
>  /*** END file-production ***/
>  
>  /*** BEGIN value-header ***/
> -/**
> -     @enum_n...@_get_type:
> -
> -     Builds a glib type for the @EnumName@ enumeration.
> -
> -     Return value: A registered type for the enum
> -*/
>  GType @enum_n...@_get_type (void) G_GNUC_CONST;
>  #define app_indicator_ty...@enumshort@ (@enum_n...@_get_type())
>  
> 
> === modified file 'src/app-indicator.c'
> --- src/app-indicator.c       2010-05-20 19:39:17 +0000
> +++ src/app-indicator.c       2010-05-23 10:48:29 +0000
> @@ -52,13 +52,13 @@
>       application indicator.
>  */
>  /*  Private Fields
> -     @id: The ID of the indicator.  Maps to AppIndicator::id.
> -     @category: Which category the indicator is.  Maps to 
> AppIndicator::category.
> -     @status: The status of the indicator.  Maps to AppIndicator::status.
> -     @icon_name: The name of the icon to use.  Maps to 
> AppIndicator::icon-name.
> -     @attention_icon_name: The name of the attention icon to use.  Maps to 
> AppIndicator::attention-icon-name.
> -     @menu: The menu for this indicator.  Maps to AppIndicator::menu
> -     @watcher_proxy: The proxy connection to the watcher we're connected to. 
>  If we're not connected to one this will be #NULL.
> +     @id: The ID of the indicator.  Maps to AppIndicator:id.
> +     @category: Which category the indicator is.  Maps to 
> AppIndicator:category.
> +     @status: The status of the indicator.  Maps to AppIndicator:status.
> +     @icon_name: The name of the icon to use.  Maps to 
> AppIndicator:icon-name.
> +     @attention_icon_name: The name of the attention icon to use.  Maps to 
> AppIndicator:attention-icon-name.
> +     @menu: The menu for this indicator.  Maps to AppIndicator:menu
> +     @watcher_proxy: The proxy connection to the watcher we're connected to. 
>  If we're not connected to one this will be %NULL.
>  */
>  struct _AppIndicatorPrivate {
>       /*< Private >*/
> @@ -175,38 +175,68 @@
>       klass->unfallback = unfallback;
>  
>       /* Properties */
> +
> +     /**
> +             AppIndicator:id:
> +             
> +             The ID for this indicator, which should be unique, but used 
> consistently
> +             by this program and its indicator.
> +     */
>       g_object_class_install_property (object_class,
>                                           PROP_ID,
>                                           g_param_spec_string(PROP_ID_S,
>                                                               "The ID for 
> this indicator",
> -                                                             "An ID that 
> should be unique, but used consistently by this program and it's indicator.",
> +                                                             "An ID that 
> should be unique, but used consistently by this program and its indicator.",
>                                                               NULL,
>                                                               
> G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS | G_PARAM_CONSTRUCT_ONLY));
>  
> +     /**
> +             AppIndicator:category:
> +             
> +             The type of indicator that this represents.  Please don't use 
> 'Other'.. 
> +             Defaults to 'ApplicationStatus'.
> +     */
>       g_object_class_install_property (object_class,
>                                           PROP_CATEGORY,
>                                           g_param_spec_string 
> (PROP_CATEGORY_S,
>                                                                "Indicator 
> Category",
> -                                                              "The type of 
> indicator that this represents.  Please don't use 'other'.  Defaults to 
> 'Application Status'.",
> +                                                              "The type of 
> indicator that this represents.  Please don't use 'other'. Defaults to 
> 'ApplicationStatus'.",
>                                                                NULL,
>                                                                
> G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS | G_PARAM_CONSTRUCT_ONLY));
>  
> +     /**
> +             AppIndicator:status:
> +             
> +             Whether the indicator is shown or requests attention. Defaults 
> to
> +             'Passive'.
> +     */
>       g_object_class_install_property (object_class,
>                                           PROP_STATUS,
>                                           g_param_spec_string (PROP_STATUS_S,
>                                                                "Indicator 
> Status",
> -                                                              "Whether the 
> indicator is shown or requests attention.  Defaults to 'off'.",
> +                                                              "Whether the 
> indicator is shown or requests attention. Defaults to 'Passive'.",
>                                                                NULL,
>                                                                
> G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
>  
> +     /**
> +             AppIndicator:icon-name:
> +             
> +             The name of the regular icon that is shown for the indicator.
> +     */
>       g_object_class_install_property(object_class,
> -                                        PROP_ICON_NAME,
> +                                    PROP_ICON_NAME,
>                                       g_param_spec_string (PROP_ICON_NAME_S,
>                                                               "An icon for 
> the indicator",
>                                                               "The default 
> icon that is shown for the indicator.",
>                                                               NULL,
> -                                                             
> G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
> +                                                             
> G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS | G_PARAM_CONSTRUCT));
>  
> +     /**
> +             AppIndicator:attention-icon-name:
> +             
> +             If the indicator sets it's status to 
> %APP_INDICATOR_STATUS_ATTENTION
> +             then this icon is shown.
> +     */
>       g_object_class_install_property (object_class,
>                                           PROP_ATTENTION_ICON_NAME,
>                                           g_param_spec_string 
> (PROP_ATTENTION_ICON_NAME_S,
> @@ -214,7 +244,12 @@
>                                                                "If the 
> indicator sets it's status to 'attention' then this icon is shown.",
>                                                                NULL,
>                                                                
> G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));
> -
> +     /**
> +             AppIndicator:icon-theme-path:
> +             
> +             An additional place to look for icon names that may be 
> installed by the
> +             application.
> +     */
>       g_object_class_install_property(object_class,
>                                       PROP_ICON_THEME_PATH,
>                                       g_param_spec_string 
> (PROP_ICON_THEME_PATH_S,
> @@ -222,8 +257,13 @@
>                                                               "An additional 
> place to look for icon names that may be installed by the application.",
>                                                               NULL,
>                                                               
> G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS | G_PARAM_CONSTRUCT_ONLY));
> -
> -        g_object_class_install_property(object_class,
> +     
> +     /**
> +             AppIndicator:menu:
> +             
> +             A method for getting the menu path as a string for DBus.
> +     */
> +    g_object_class_install_property(object_class,
>                                          PROP_MENU,
>                                          g_param_spec_boxed (PROP_MENU_S,
>                                                               "The object 
> path of the menu on DBus.",
> @@ -231,6 +271,12 @@
>                                                               
> DBUS_TYPE_G_OBJECT_PATH,
>                                                               
> G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));
>  
> +     /**
> +             AppIndicator:connected:
> +             
> +             Pretty simple, %TRUE if we have a reasonable expectation of 
> being 
> +             displayed through this object. You should hide your TrayIcon if 
> so.
> +     */
>       g_object_class_install_property (object_class,
>                                           PROP_CONNECTED,
>                                           g_param_spec_boolean 
> (PROP_CONNECTED_S,
> @@ -246,8 +292,7 @@
>               AppIndicator::new-icon:
>               @arg0: The #AppIndicator object
>  
> -             Signaled when there is a new icon set for the
> -             object.
> +             Emitted when #AppIndicator:icon-name is changed
>       */
>       signals[NEW_ICON] = g_signal_new (APP_INDICATOR_SIGNAL_NEW_ICON,
>                                         G_TYPE_FROM_CLASS(klass),
> @@ -261,8 +306,7 @@
>               AppIndicator::new-attention-icon:
>               @arg0: The #AppIndicator object
>  
> -             Signaled when there is a new attention icon set for the
> -             object.
> +             Emitted when #AppIndicator:attention-icon-name is changed
>       */
>       signals[NEW_ATTENTION_ICON] = g_signal_new 
> (APP_INDICATOR_SIGNAL_NEW_ATTENTION_ICON,
>                                                   G_TYPE_FROM_CLASS(klass),
> @@ -277,7 +321,7 @@
>               @arg0: The #AppIndicator object
>               @arg1: The string value of the #AppIndicatorStatus enum.
>  
> -             Signaled when the status of the indicator changes.
> +             Emitted when #AppIndicator:status is changed
>       */
>       signals[NEW_STATUS] = g_signal_new (APP_INDICATOR_SIGNAL_NEW_STATUS,
>                                           G_TYPE_FROM_CLASS(klass),
> @@ -293,8 +337,7 @@
>               @arg0: The #AppIndicator object
>               @arg1: Whether we're connected or not
>  
> -             Signaled when we connect to a watcher, or when it drops
> -             away.
> +             Signaled when we connect to a watcher, or when it drops away.
>       */
>       signals[CONNECTION_CHANGED] = g_signal_new 
> (APP_INDICATOR_SIGNAL_CONNECTION_CHANGED,
>                                                   G_TYPE_FROM_CLASS(klass),
> @@ -957,8 +1000,8 @@
>          @category: The category of indicator.
>  
>               Creates a new #AppIndicator setting the properties:
> -             #AppIndicator::id with @id, #AppIndicator::category
> -             with @category and #AppIndicator::icon-name with
> +             #AppIndicator:id with @id, #AppIndicator:category
> +             with @category and #AppIndicator:icon-name with
>               @icon_name.
>  
>          Return value: A pointer to a new #AppIndicator object.
> @@ -985,9 +1028,9 @@
>          @icon_path: A custom path for finding icons.
>  
>               Creates a new #AppIndicator setting the properties:
> -             #AppIndicator::id with @id, #AppIndicator::category
> -             with @category, #AppIndicator::icon-name with
> -             @icon_name and #AppIndicator::icon-theme-path with @icon_path.
> +             #AppIndicator:id with @id, #AppIndicator:category
> +             with @category, #AppIndicator:icon-name with
> +             @icon_name and #AppIndicator:icon-theme-path with @icon_path.
>  
>          Return value: A pointer to a new #AppIndicator object.
>   */
> @@ -1020,7 +1063,7 @@
>       @self: The #AppIndicator object to use
>       @status: The status to set for this indicator
>  
> -     Wrapper function for property #AppIndicator::status.
> +     Wrapper function for property #AppIndicator:status.
>  */
>  void
>  app_indicator_set_status (AppIndicator *self, AppIndicatorStatus status)
> @@ -1041,7 +1084,7 @@
>       @self: The #AppIndicator object to use
>       @icon_name: The name of the attention icon to set for this indicator
>  
> -     Wrapper function for property #AppIndicator::attention-icon.
> +     Wrapper function for property #AppIndicator:attention-icon-name.
>  */
>  void
>  app_indicator_set_attention_icon (AppIndicator *self, const gchar *icon_name)
> @@ -1070,6 +1113,7 @@
>               Sets the default icon to use when the status is active but
>               not set to attention.  In most cases, this should be the
>               application icon for the program.
> +             Wrapper function for property #AppIndicator:icon-name.
>  **/
>  void
>  app_indicator_set_icon (AppIndicator *self, const gchar *icon_name)
> @@ -1481,6 +1525,8 @@
>          Sets the menu that should be shown when the Application Indicator
>          is clicked on in the panel.  An application indicator will not
>          be rendered unless it has a menu.
> +        
> +        Wrapper function for property #AppIndicator:menu.
>  **/
>  void
>  app_indicator_set_menu (AppIndicator *self, GtkMenu *menu)
> @@ -1519,7 +1565,7 @@
>       app_indicator_get_id:
>       @self: The #AppIndicator object to use
>  
> -     Wrapper function for property #AppIndicator::id.
> +     Wrapper function for property #AppIndicator:id.
>  
>       Return value: The current ID
>  */
> @@ -1535,7 +1581,7 @@
>       app_indicator_get_category:
>       @self: The #AppIndicator object to use
>  
> -     Wrapper function for property #AppIndicator::category.
> +     Wrapper function for property #AppIndicator:category.
>  
>       Return value: The current category.
>  */
> @@ -1551,7 +1597,7 @@
>       app_indicator_get_status:
>       @self: The #AppIndicator object to use
>  
> -     Wrapper function for property #AppIndicator::status.
> +     Wrapper function for property #AppIndicator:status.
>  
>       Return value: The current status.
>  */
> @@ -1567,7 +1613,7 @@
>       app_indicator_get_icon:
>       @self: The #AppIndicator object to use
>  
> -     Wrapper function for property #AppIndicator::icon-name.
> +     Wrapper function for property #AppIndicator:icon-name.
>  
>       Return value: The current icon name.
>  */
> @@ -1583,7 +1629,7 @@
>       app_indicator_get_attention_icon:
>       @self: The #AppIndicator object to use
>  
> -     Wrapper function for property #AppIndicator::attention-icon-name.
> +     Wrapper function for property #AppIndicator:attention-icon-name.
>  
>       Return value: The current attention icon name.
>  */
> @@ -1600,8 +1646,9 @@
>       @self: The #AppIndicator object to use
>  
>       Gets the menu being used for this application indicator.
> +     Wrapper function for property #AppIndicator:menu.
>  
> -     Return value: A menu object or #NULL if one hasn't been set.
> +     Return value: A #GtkMenu object or %NULL if one hasn't been set.
>  */
>  GtkMenu *
>  app_indicator_get_menu (AppIndicator *self)
> 
> === modified file 'src/app-indicator.h'
> --- src/app-indicator.h       2010-04-29 16:31:36 +0000
> +++ src/app-indicator.h       2010-05-23 10:48:29 +0000
> @@ -113,11 +113,11 @@
>       users can find indicators that are similar together.
>  */
>  typedef enum { /*< prefix=APP_INDICATOR_CATEGORY >*/
> -     APP_INDICATOR_CATEGORY_APPLICATION_STATUS,
> -     APP_INDICATOR_CATEGORY_COMMUNICATIONS,
> -     APP_INDICATOR_CATEGORY_SYSTEM_SERVICES,
> -     APP_INDICATOR_CATEGORY_HARDWARE,
> -     APP_INDICATOR_CATEGORY_OTHER
> +     APP_INDICATOR_CATEGORY_APPLICATION_STATUS, /*< nick=ApplicationStatus 
> >*/
> +     APP_INDICATOR_CATEGORY_COMMUNICATIONS, /*< nick=Communications >*/
> +     APP_INDICATOR_CATEGORY_SYSTEM_SERVICES, /*< nick=SystemServices >*/
> +     APP_INDICATOR_CATEGORY_HARDWARE, /*< nick=Hardware >*/
> +     APP_INDICATOR_CATEGORY_OTHER /*< nick=Other >*/
>  } AppIndicatorCategory;
>  
>  /**
> @@ -132,9 +132,9 @@
>       shown by setting it to @APP_INDICATOR_STATUS_ACTIVE.
>  */
>  typedef enum { /*< prefix=APP_INDICATOR_STATUS >*/
> -     APP_INDICATOR_STATUS_PASSIVE,
> -     APP_INDICATOR_STATUS_ACTIVE,
> -     APP_INDICATOR_STATUS_ATTENTION
> +     APP_INDICATOR_STATUS_PASSIVE, /*< nick=Passive >*/
> +     APP_INDICATOR_STATUS_ACTIVE, /*< nick=Active >*/
> +     APP_INDICATOR_STATUS_ATTENTION /*< nick=NeedsAttention >*/
>  } AppIndicatorStatus;
>  
>  typedef struct _AppIndicator        AppIndicator;
> 
> === modified file 'src/application-service-appstore.c'
> --- src/application-service-appstore.c        2010-02-19 17:02:18 +0000
> +++ src/application-service-appstore.c        2010-05-23 10:48:29 +0000
> @@ -25,6 +25,8 @@
>  #endif
>  
>  #include <dbus/dbus-glib.h>
> +#include "app-indicator.h"
> +#include "app-indicator-enum-types.h"
>  #include "application-service-appstore.h"
>  #include "application-service-marshal.h"
>  #include "dbus-properties-client.h"
> @@ -55,17 +57,6 @@
>       AppLruFile * lrufile;
>  };
>  
> -#define APP_STATUS_PASSIVE_STR    "Passive"
> -#define APP_STATUS_ACTIVE_STR     "Active"
> -#define APP_STATUS_ATTENTION_STR  "NeedsAttention"
> -
> -typedef enum _ApplicationStatus ApplicationStatus;
> -enum _ApplicationStatus {
> -     APP_STATUS_PASSIVE,
> -     APP_STATUS_ACTIVE,
> -     APP_STATUS_ATTENTION
> -};
> -
>  typedef struct _Application Application;
>  struct _Application {
>       gchar * id;
> @@ -76,7 +67,7 @@
>       DBusGProxy * dbus_proxy;
>       DBusGProxy * prop_proxy;
>       gboolean validated; /* Whether we've gotten all the parameters and they 
> look good. */
> -     ApplicationStatus status;
> +     AppIndicatorStatus status;
>       gchar * icon;
>       gchar * aicon;
>       gchar * menu;
> @@ -102,8 +93,8 @@
>  static void application_service_appstore_init       
> (ApplicationServiceAppstore *self);
>  static void application_service_appstore_dispose    (GObject *object);
>  static void application_service_appstore_finalize   (GObject *object);
> -static ApplicationStatus string_to_status(const gchar * status_string);
> -static void apply_status (Application * app, ApplicationStatus status);
> +static AppIndicatorStatus string_to_status(const gchar * status_string);
> +static void apply_status (Application * app, AppIndicatorStatus status);
>  
>  G_DEFINE_TYPE (ApplicationServiceAppstore, application_service_appstore, 
> G_TYPE_OBJECT);
>  
> @@ -249,14 +240,10 @@
>  }
>  
>  /* Simple translation function -- could be optimized */
> -static ApplicationStatus
> +static AppIndicatorStatus
>  string_to_status(const gchar * status_string)
>  {
> -     if (!g_strcmp0(status_string, APP_STATUS_ACTIVE_STR))
> -             return APP_STATUS_ACTIVE;
> -     if (!g_strcmp0(status_string, APP_STATUS_ATTENTION_STR))
> -             return APP_STATUS_ATTENTION;
> -     return APP_STATUS_PASSIVE;
> +     return (AppIndicatorStatus) g_enum_get_value_by_nick((GEnumClass 
> *)g_type_class_ref (APP_INDICATOR_TYPE_INDICATOR_STATUS), status_string);
>  }
>  
>  /* A small helper function to get the position of an application
> @@ -330,7 +317,7 @@
>       Application * app = (Application *)userdata;
>  
>       /* Remove from the panel */
> -     apply_status(app, APP_STATUS_PASSIVE);
> +     apply_status(app, APP_INDICATOR_STATUS_PASSIVE);
>  
>       /* Destroy the data */
>       application_free(app);
> @@ -375,7 +362,7 @@
>     it removes it from the panel.  If we're coming online, then
>     it add it to the panel.  Otherwise it changes the icon. */
>  static void
> -apply_status (Application * app, ApplicationStatus status)
> +apply_status (Application * app, AppIndicatorStatus status)
>  {
>       if (app->status == status) {
>               return;
> @@ -386,7 +373,7 @@
>       ApplicationServiceAppstorePrivate * priv = 
> APPLICATION_SERVICE_APPSTORE_GET_PRIVATE(appstore);
>  
>       /* This means we're going off line */
> -     if (status == APP_STATUS_PASSIVE) {
> +     if (status == APP_INDICATOR_STATUS_PASSIVE) {
>               gint position = get_position(app);
>               if (position == -1) return;
>  
> @@ -397,12 +384,12 @@
>       } else {
>               /* Figure out which icon we should be using */
>               gchar * newicon = app->icon;
> -             if (status == APP_STATUS_ATTENTION && app->aicon != NULL && 
> app->aicon[0] != '\0') {
> +             if (status == APP_INDICATOR_STATUS_ATTENTION && app->aicon != 
> NULL && app->aicon[0] != '\0') {
>                       newicon = app->aicon;
>               }
>  
>               /* Determine whether we're already shown or not */
> -             if (app->status == APP_STATUS_PASSIVE) {
> +             if (app->status == APP_INDICATOR_STATUS_PASSIVE) {
>                          if (can_add_application (priv->applications, app)) {
>                                  /* Put on panel */
>                                  priv->applications = 
> g_list_insert_sorted_with_data (priv->applications, app, app_sort_func, 
> priv->lrufile);
> @@ -457,7 +444,7 @@
>               if (app->icon != NULL) g_free(app->icon);
>               app->icon = g_strdup(newicon);
>  
> -             if (app->status == APP_STATUS_ACTIVE) {
> +             if (app->status == APP_INDICATOR_STATUS_ACTIVE) {
>                       gint position = get_position(app);
>                       if (position == -1) return;
>  
> @@ -495,7 +482,7 @@
>               if (app->aicon != NULL) g_free(app->aicon);
>               app->aicon = g_strdup(newicon);
>  
> -             if (app->status == APP_STATUS_ATTENTION) {
> +             if (app->status == APP_INDICATOR_STATUS_ATTENTION) {
>                       gint position = get_position(app);
>                       if (position == -1) return;
>  
> @@ -576,7 +563,7 @@
>       app->dbus_name = g_strdup(dbus_name);
>       app->dbus_object = g_strdup(dbus_object);
>       app->appstore = appstore;
> -     app->status = APP_STATUS_PASSIVE;
> +     app->status = APP_INDICATOR_STATUS_PASSIVE;
>       app->icon = NULL;
>       app->aicon = NULL;
>       app->menu = NULL;
> 


-- 
https://code.launchpad.net/~qense/indicator-application/doc-intro-fixes/+merge/25835
Your team ayatana-commits is subscribed to branch lp:indicator-application.

_______________________________________________
Mailing list: https://launchpad.net/~ayatana-commits
Post to     : [email protected]
Unsubscribe : https://launchpad.net/~ayatana-commits
More help   : https://help.launchpad.net/ListHelp

Reply via email to