diff --git a/protocol/river-options-unstable-v1.xml b/protocol/river-options-unstable-v1.xml index 87274e9..9e393ba 100644 --- a/protocol/river-options-unstable-v1.xml +++ b/protocol/river-options-unstable-v1.xml @@ -110,27 +110,38 @@ - If the option is either unset or set to a value of type int, - this request sets the value of the option as well as the type if - previously unset. Otherwise the request is ignored. + If the option is either unset or set to a value of type int, this + request asks the compositor to set the value of the option as well + as the type if previously unset. The compositor is not required to + honor this request. + + If the option is already set and is not of type int, this request does nothing. - If the option is either unset or set to a value of type uint, - this request sets the value of the option as well as the type if - previously unset. Otherwise the request is ignored. + If the option is either unset or set to a value of type uint, this + request asks the compositor to set the value of the option as well + as the type if previously unset. The compositor is not required to + honor this request. + + If the option is already set and is not of type uint, this request + does nothing. - If the option is either unset or set to a value of type fixed, - this request sets the value of the option as well as the type if - previously unset. Otherwise the request is ignored. + If the option is either unset or set to a value of type fixed, this + request asks the compositor to set the value of the option as well + as the type if previously unset. The compositor is not required to + honor this request. + + If the option is already set and is not of type fixed, this request + does nothing. @@ -138,8 +149,12 @@ If the option is either unset or set to a value of type string, - this request sets the value of the option as well as the type if - previously unset. Otherwise the request is ignored. + this request asks the compositor to set the value of the option as + well as the type if previously unset. The compositor is not required + to honor this request. + + If the option is already set and is not of type string, this request + does nothing.