diff --git a/docs/ChangeLog b/docs/ChangeLog index 62ffc10..9d68f90 100644 --- a/docs/ChangeLog +++ b/docs/ChangeLog @@ -1,3 +1,8 @@ +Thu Sep 02 01:19:07 PDT 2004 Christian Hammond + + * notification-spec.xml: + - Wrote the section about hints. + Thu Sep 02 01:05:01 PDT 2004 Christian Hammond * notification-spec.xml: diff --git a/docs/notification-spec.xml b/docs/notification-spec.xml index cb15eeb..6debff4 100644 --- a/docs/notification-spec.xml +++ b/docs/notification-spec.xml @@ -443,7 +443,61 @@ Hints - Write me! + + Hints are a way to provide extra data to a notification server that + the server may be able to make use of. Such examples may be the + application's PID or the window ID. + + + Neither clients nor notification servers are required to support any + hints. Both sides should assume that hints are not passed, and should + ignore any hints they do not understand. + + + The following table lists the standard hints as defined by this + specification. Future hints may be proposed and added to this list + over time. Once again, implementations are not required to support these. + + + Standard Hints + + + + Name + Value Type + Description + + + + + "pid" + UINT32 + + The Process ID of the application that sent the notification. + + + + "winid" + UINT32 + + The Window ID that sent the notification. This may be used, + for example, to flash the window. + + + + +
+ + Third parties, when defining their own hints, should discuss the + possibilty of standardizing on the hint with other parties, preferably + in a place such as the + xdg + mailing list at + freedesktop.org. If it + warrants a standard, it will be added to the table above. If no + consensus is reached, the hint name should be in the form of + "x-vendor-name." +
@@ -532,7 +586,7 @@ New vendor-specific caps may be specified as long as they start with - "x-vendorname". For instance, + "x-vendor". For instance, "x-gnome-foo-cap". Capability names must not contain spaces. They are limited to alpha-numeric characters and dashes ("-").