From 862e7850ad3f46e792956915ee7c0f014e81b123 Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Sun, 3 Aug 2014 17:04:53 +0200 Subject: update todo + add tray protocol MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- doc/protocols | 75 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 75 insertions(+) (limited to 'doc/protocols') diff --git a/doc/protocols b/doc/protocols index 1a251af..c013dd1 100644 --- a/doc/protocols +++ b/doc/protocols @@ -182,6 +182,8 @@ Conditionally optional header: Time to live thread or an alarm an pop when when SIGARLM is received. +Message: The content to add to the clipboard + Purpose: Enable the user to duplicate content from one process into another process without requiring those processes to be aware of eathother to any extent @@ -217,3 +219,76 @@ Reference implementation: mds-clipboard --------------------------------------------------------------------- +Command: add-tray-icon + Add a status icons to the status icon tray + The client should keep in mind that there can be any number of + trays available on the system: zero, one, two or three, ..., + and that it will get a response once from every tray + +Required header: Client ID + Your ID, provided by `ID assignment` + in response to `Command: assign-id` + +Required header: Package + The name of the package to which the program announced the icon + belongs + +Required header: Icon ID + An ID of the icon that can be used identify the icon, icon ID:s + are not unique, but the combination of a package and a icon ID + should be unque and can be used to ignore already added icons + and hide icons that the user has been configured to be hidden + +Required header: Title + A title describing the icon for the user, used to configured + when icons should be hidden and shown among other configuration + +Required header: Icon + The name or pathname of an icon to use together with the title + +Response: + To: + In response to: + Message ID: + Socket: + Will send update: <`yes` if this message will be followed by + `Command: tray-update`, otherwise `no`> + +Purpose: Enable clients to add a small icon that displays the status + of programs, particularly minimised programs and services + +Compulsivity: optional + +--------------------------------------------------------------------- + +Command: update-tray-icon + Change the status of a status icon + +Purpose: Enable status trays to automatically hide inactive icons +Purpose: Hide icons without actually removing them + +Compulsivity: optional + +--------------------------------------------------------------------- + +Command: tray-update + Send updates about the status tray to the status icon + +Purpose: Enable clients to be aware of the appearance of the tray, + such as colours, transparency and background image + +Compulsivity: optional + +--------------------------------------------------------------------- + +Command: new-tray + Announce the existence of a new status icon trays + +Purpose: Allow clients to add their status icons to status icon + trays that have been added to the display after those + programs have started and attempted to add their icons + +Compulsivity: required if supporting `Command: add-tray-icon` + +--------------------------------------------------------------------- + -- cgit v1.2.3-70-g09d2