X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=common%2Ftrace_format.hpp;h=cdabeb7d4668934b69afcf6593d656abae917fc3;hb=46a4839cd1b65981bec9f33b1d7978b821866a51;hp=a8ee5eb8bab0347ce2a691691783d6c6939f6d22;hpb=c636b9d7041f5046dd5bdc1b459b06979915dc79;p=apitrace

diff --git a/common/trace_format.hpp b/common/trace_format.hpp
index a8ee5eb..cdabeb7 100644
--- a/common/trace_format.hpp
+++ b/common/trace_format.hpp
@@ -72,7 +72,36 @@
 
 namespace Trace {
 
-#define TRACE_VERSION 1
+/*
+ * Trace file version number.
+ *
+ * We keep backwards compatability reading old traces, i.e., it should always be
+ * possible to parse and retrace old trace files.
+ *
+ * So the trace version number refers not only to changes in the binary format
+ * representation, but also semantic changes in the way certain functions
+ * should be retraced.
+ *
+ * Writing/editing old traces will not be supported however.  An older version
+ * of apitrace should be used in such circunstances.
+ *
+ * Changelog:
+ *
+ * - version 0:
+ *   - initial implementation
+ *
+ * - version 1:
+ *   - support for GL user arrays -- a blob is provided whenever an user memory
+ *   is referred (whereas before calls that operate wit user memory instead of
+ *   VBOs should be ignore)
+ *
+ * - version 2:
+ *   - malloc/free memory calls -- allow to pass user memory as malloc memory
+ *   as opposed to blobs
+ *   - glFlushMappedBufferRange will emit a memcpy only for the flushed range
+ *   (whereas previously it would emit a memcpy for the whole mapped range)
+ */
+#define TRACE_VERSION 2
 
 enum Event {
     EVENT_ENTER = 0,