[PATCH 2/2] doc: Add a section on interface and protocol object versioning

[Jason Ekstrand]

On Sun, Aug 18, 2013 at 1:28 AM, Bardur Arantsson <spam at scientician.net>wrote:

> On 2013-08-18 00:31, Jason Ekstrand wrote:
> > There have been a lot of questions asked lately about versioning of
> > interfaces and protocol objects.  This addition to the documentation
> should
> > clear up some of those questions.
> >
> > +    <para>
> > +      In order to keep things sane, this has a few implications for
> > +      interface versions:
> > +      <itemizedlist>
> > +     <listitem>
> > +       <para>
> > +         The object creation hierarchy must be a tree.  Otherwise,
> > +         infering object versions fro the parent object becomes much
>
> Typo: "from"
>
> > +         more difficult to properly track.
> > +       </para>
> > +     </listitem>
> > +     <listitem>
> > +       <para>
> > +         When the version of an interface increases, so does the version
> > +         of its parent (recursively until you get to a global interface)
> > +       </para>
> > +     </listitem>
> > +     <listitem>
> > +       <para>
> > +         A global interface's version number acts like a counter for all
> > +         of its child interfaces.  Whenever a child interface gets
> > +         modified, the global parent's interface version number also
> > +         increases (see above).  The child interface then takes on the
> > +         same version number as the new version of its parent global.
>
> Missing word "interface" at the end of the last sentence?
>
> Regards,
>

Thanks for catching those.
--Jason Ekstrand
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.freedesktop.org/archives/wayland-devel/attachments/20130818/7536ffe6/attachment.html>