Lines Matching refs:protocol

4 available in the Wayland core protocol. Such protocols either add
6 protocol either in Wayland core, or some other protocol in
9 A protocol in wayland-protocols consists of a directory containing a set
10 of XML files containing the protocol specification, and a README file
16 and protocol names as well as place in the directory tree will reflect
19 A stable protocol is a protocol which has been declared stable by
23 An unstable protocol is a protocol currently under development and this
24 will be reflected in the protocol and interface names. See [Unstable
27 A deprecated protocol is a protocol that has either been replaced by some
28 other protocol, or declared undesirable for some other reason. No more
29 changes will be made to a deprecated protocol.
31 Depending on which of the above states the protocol is in, the protocol
39 To propose a new protocol, create a GitLab merge request adding the
46 If the new protocol is just an idea, open an issue on the GitLab issue
47 tracker. If the protocol isn't ready for complete review yet and is an
52 If the changes are backward incompatible changes to an unstable protocol,
53 see [Unstable protocol changes](#unstable-protocol-changes).
58 the protocol interface names in order to minimize risk that the generated
64 should be used on all interfaces in the protocol.
74 ](GOVERNANCE.md#21-protocol-namespaces).
81 An unstable protocol has at least two versions: the major version, which
83 represents backward compatible changes to the interfaces in the protocol.
85 The major version is part of the XML file name, the protocol name in the
86 XML, and interface names in the protocol.
89 There may be more than one minor version per protocol, if there are more
92 The XML file and protocol name also has the word 'unstable' in them, and
93 all of the interfaces in the protocol are prefixed with `z` and
96 For example, an unstable protocol called `foo-bar` with major version 2
103 ## Unstable protocol changes
105 During the development of a new protocol it is possible that backward
107 in the major and minor versions of the protocol.
113 - Increase the major version number in the protocol XML by 1.
122 ## Declaring a protocol stable
124 Once it is decided that a protocol should be declared stable, meaning no
131   same name as the protocol directory in the `unstable/` directory.
134   should be the same name as the protocol directory but with the `.xml`
136 - Rename the name of the protocol in the XML by removing the
139   of the interfaces in the protocol.
144 There are other requirements for declaring a protocol stable, see
159 ~"New Protocol" - For a new protocol being added. If it's an amendment to
160 an existing protocol, apply the label of the corresponding protocol
163 ~"Needs acks" - If the protocol needs one or more acknowledgements.
166 protocol.
168 ~"Needs review" - If the protocol is in need of review.
170 ~"In 30 day discussion period" - If the protocol needs a 30 day discussion