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

[Bardur Arantsson]

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,