[PATCH notification] spec: Add badge-number hint

Ted Gould ted at gould.cx
Tue Feb 17 06:31:13 PST 2015


I think there should actually be two values "show-badge-number" and
"badge-number". As it is a possible usage that someone would want to
show it as zero, but also that you'd want to send notifications that
didn't effect the badge number directly. I think that the lifecycle
should be mentioned in the doc, I don't think every notification that
goes by should have to have the number in it. It should only adjust when
requested.

I'm a little worried about using the notifications spec for this because
there's no way to get the current state of the count. So if an
application had a helper that wanted to "add one" to the count there's
no way to implement that. It might make more sense to move the Dock
Manager spec into something FD.o as there are a few docks that implement
versions of it already:

http://wiki.go-docky.com/index.php?title=Writing_Helpers#DockManager_DBus_Interface_Specification

Not sure how many of them are still being developed though.

Ted

On Mon, 2015-02-16 at 18:21 +0100, Bastien Nocera wrote:

> As discussed during the Wayland meeting at FOSDEM 2015.
> ---
>  docs/notification-spec.xml | 17 +++++++++++++++--
>  1 file changed, 15 insertions(+), 2 deletions(-)
> 
> diff --git a/docs/notification-spec.xml b/docs/notification-spec.xml
> index fa1da0b..3bc0292 100644
> --- a/docs/notification-spec.xml
> +++ b/docs/notification-spec.xml
> @@ -3,8 +3,8 @@
>  <article id="index">
>   <articleinfo>
>    <title>Desktop Notifications Specification</title>
> -  <releaseinfo>Version 1.2</releaseinfo>
> -  <date>28 October 2010</date>
> +  <releaseinfo>Version 1.3</releaseinfo>
> +  <date>16 February 2015</date>
>    <authorgroup>
>     <author>
>      <firstname>Mike</firstname>
> @@ -674,6 +674,19 @@
>        <entry>>= 1.2</entry>
>       </row>
>       <row>
> +      <entry><literal>"badge-number"</literal></entry>
> +      <entry>INT32</entry>
> +      <entry>
> +        When set, a server can use it to show the number attached to
> +        the notification on top of the application icon referenced by the
> +        "desktop-entry" hint.
> +        Note that servers can choose not to show the number, either because
> +        they do not implement the capability, or in response to user
> +        configuration to suppress its display.
> +      </entry>
> +      <entry>>= 1.3</entry>
> +     </row>
> +     <row>
>        <entry><literal>"category"</literal></entry>
>        <entry>STRING</entry>
>        <entry>
> 
> 
> _______________________________________________
> xdg mailing list
> xdg at lists.freedesktop.org
> http://lists.freedesktop.org/mailman/listinfo/xdg



-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.freedesktop.org/archives/xdg/attachments/20150217/f82c38d6/attachment.html>


More information about the xdg mailing list