docs: clarify trace2 version invariants
authorJosh Steadmon <steadmon@google.com>
Thu, 3 Oct 2019 23:32:57 +0000 (16:32 -0700)
committerJunio C Hamano <gitster@pobox.com>
Fri, 4 Oct 2019 00:26:42 +0000 (09:26 +0900)
commit22541013d00bc457fe1fbdc8ac8b79edc069fd7e
treedd462d67d786ea701dc0a32e4657a907636ab851
parent3d4548e7e29177b6a5e21c73009bc40c63c8ce62
docs: clarify trace2 version invariants

Make it explicit that we always want trace2 "version" events to be the
first event of any trace session. Also list the changes that would or
would not cause the EVENT format version field to be incremented.

Signed-off-by: Josh Steadmon <steadmon@google.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/technical/api-trace2.txt