From: José Fonseca Date: Fri, 14 Jun 2013 10:14:06 +0000 (+0100) Subject: Cleanup known issues. X-Git-Url: https://git.cworth.org/git?a=commitdiff_plain;h=2cca1ad5d2cdd192b69eee09f5f3b63f0fd939b6;p=apitrace Cleanup known issues. --- diff --git a/BUGS.markdown b/BUGS.markdown index 0c963f1..56049c1 100644 --- a/BUGS.markdown +++ b/BUGS.markdown @@ -27,12 +27,11 @@ is no immediate plan to address them, because either: That said, feel free to file an issue and/or send an email to the mailing list if: -* send an email to the mailing list if you want discuss the rationale, propose - your ideas on how to address it, or volunteer to work on it; +* you want discuss the rationale, propose your ideas on how to address it, or + volunteer to work on it; -* file the issue in the issue tracker (or comment to it if it already exists) - if it is important for you and you would like to see it addressed sooner - rather than later. +* a known issue is important for you and you would like to see it addressed + sooner rather than later. Tracing @@ -52,7 +51,11 @@ Tracing * Huge traces will be generated for applications that make extensive use of immediate mode drawing (ie., glBegin/glEnd), use vertex/element arrays in - user memory, or generate a lot of dynamic vertex data per frame. + user memory, or generate a lot of dynamic vertex data per frame. This is + because large quantities of (often redundant) data will be recorded over and + over; and although the traces are compressed, the compression algorithms used + aim a good performance/compression balance, hence fail to identify and remove + the redundancy at this scale. However, this should not be a problem for modern OpenGL applications that make an efficient use of VBOs and vertex shaders. @@ -88,10 +91,8 @@ Retracing a standard 32bit RGBA, 24bit depth, 8bit alpha, double buffer visual. Unless overridden on command line. -* Multi-threaded OpenGL is not yet supported. - -* OpenGL context sharing is not fully respected -- all contexts are expected to - share state, and most likely there +* OpenGL context sharing is not fully respected -- all contexts are assumed to + share state. This is by far the most common case though. GUI @@ -136,7 +137,7 @@ github issue tracker doesn't support attachments. Please attach long logs to https://gist.github.com/ and paste the URL into the issue description. -For big attachments, such as traces, please upload it temporarily to a web +For big attachments, such as traces, please upload them temporarily to a web server you control, or use a file upload service such as http://dropbox.com/ and paste the URL into the issue description.