Add new "apitrace diff-state" command

Which is simply a convenient way to invoke the existing jsondiff.py script,
(which is now installed by "make install" to support this command).

doc: Prefer `apitrace diff` over tracediff.sh.

cli: Pass apitrace path to tracediff.sh.

So that it works automatically from the build directory too.

cli: Add a new "apitrace diff" command.

This command simply provides a more consistent way of getting access
to the existing tracediff.sh command, (which is now installed to
<prefix>/lib/apitrace/scripts for the "apitrace diff" command to
invoke, but not necessarily for users to invoke directly).

Separate wrappers/ and scripts/ under <prefix>/lib/apitrace

We now define a new APITRACE_SCRIPTS_INSTALL_DIR:

<prefix>/lib/apitrace/scripts

where scripts will soon be installed (as needed).

Meanwhile, APITRACE_WRAPPER_INSTALL_DIR is updated to:

<prefix>/lib/apitrace/$arch/wrappers

(where before it didn't have the final "wrappers" directory).

Fix "apitrace trace" when running from installed location.

A missing path separator was causing the wrapper library to fail to be found.

gui: Handle incomplete calls.

Should fix issue 48.

Only re-allocate if the snappy cache buffer when it is not big enough.

Update glxtrace.so path in docs.

Fix typo.

Make findFile non-static, given it will be necessary for other commands.

Split common functionality out of cli.

Make file_exists as os::Path method.

Keep info on how to manually retrace in a separate section.

Add a new "apitrace trace" command to the command-line interface.

There is no code to support Windows yet, but there is specific code
for both Linux and Mac OS X. The documentation is also updated to
reflect the new command.

Signed-off-by: José Fonseca <jose.r.fonseca@gmail.com>

Put glxtrace.so also in the wrappers directory.

For consistency among all platforms, per Carl Worth's suggestion,
but the wrappers DLLs must remain in a directory of their own to
avoid interfering with other executables.

Give CLI command names a _command prefix

This is just to set things up for a trace_command command, (which
cannot be named "trace" since that would conflict with "namespace
trace").

Add os::Path.trimFilename function.

This is the counterpart to trimDirectory. This function trims the
final filename component from the path leaving just the containing
directory.

TODO: Add some notes on additions we want to the command-line interface

These come from some recent dicussion on the mailing list.

Minor typo correction of code comment

Without this, the sentence is not gramatically well-formed.

Mac OS X: Fix getProcessName() to avoid assertion failure in truncate

Apparently _NSGetExecutablePath doesn't actually set the len field in
the case of successfully copying a value to buf. In this case, the
value in buf is properly terminated, so we can just use strlen to find
a legal value to use when calling truncate.

Expose build/install dirs as a define.

Also, pick a wrapper install dir that varies with architecture, to allow
tracing of multiple binaries on multiarch.

Fix typos in _vscprintf comment.

Change non-executable install directories to include an "apitrace" component

It's just more polite to put documentation into
<prefix>/share/doc/apitrace rather than just dumping it into the
top-level <prefix>/doc.

Similarly, since glxtrace.so is not a conventional library, it doesn't
belong in <prefix>/lib but is well-suited for <prefix>/lib/apitrace.

Merge branch 'os-path'

More os::Path fixes.

Fix os::Path::format on MinwGW.

Include sys/syslimits.h for PATH_MAX on MacOSX.

Update docs / scripts for tracedump -> apitrace dump change.

Drop first_arg_command.

Unnecessary.

Better isolation of CLI source files.

Tweak help output.

* accept "apitrace dump --help" as help.
* list commands in "apitrace help" too.
* tweak whitespace.

Use a slightly different naming convention for cli source files.

Cleanup headers.

Eliminate unused & unix specific headers.

apitrace: Replace tracedump program with new "apitrace dump" command

The code just copies right over so should work exactly as before, but
with our nice, new, unified command-line syntax.

Add a top-level apitrace program.

This is intended to eventually be a program which will provide access
to all apitrace functionality (tracing, trimming, replaying,
analyzing, launch the gui, etc.).

To start with it implements only the stub "apitrace help" command so
there's not any real functionality here yet.

Move os::Path to a separate header.

Much less re-compiles.

Also eliminate wide-spread use of PATH_MAX.

Have selected call always match the current call.

The current call (highlighted with single-click or keyboard navigation)
was serving no purpose, and this make navigation much more effective.

Only jump to errors when the error item is activated.

Because currentItemChanged signal is too frequent/random, happening even
at times where errors window is invisible, when switching between tabs of
the current state pane, causing the current call to go out of focus.

Many fixes to os::Path.

Add a path manipulating class.

More tweaks/cleanups to D3D9 spec.

Minor tweaks to d3d9 spec.

Some state is a mixture of enum/flags

Define GLhandleARB as unsigned long on MacOSX.

Retrace applications with mix ARB and core uniform calls correctly.

A bit of an hack.

Fix buffer overflow when manipulating extensions string.

Switch os functions to camelcase.

Lower case namespaces.

Rename trace writer files to group nicely.

Re-organize the Trace::File code.

This should allow stop linking the zlib code from the wrappers.

Document coding syntax, and other development practices.

Add --color option when pipeing traceoutput to less.

Cleanup X11 event handling.

Fixes an infinite loop on GlxDrawable::show() in certain traces.

Improve the indention in emacs just a bit.

By default emacs offsets both the inline and in-namespaces, lets
fix that.

Replace .emacs-dirvars with .dir-locals.el

Just basic whitespace formatting settings for all file types for now.
(And let the emacs pros do the rest later)

Document known issues.

Issue 47.

Emit a warning when the window size cannot be inferred.

Issue 47.

tracedump: Add tri-state --color option (auto, always, or never)

This follows a pattern similar to that provided by other tools, (such
as grep). The default auto mode colorizes if stdout is a tty. The always
and never modes explicit enable or disable colorizing.

The old --no-color and --no-colour options are deprecated, (no longer
documented but still supported to avoid any regressions of scripts).

Signed-off-by: José Fonseca <jose.r.fonseca@gmail.com>

Be more concise about DXSDK requirements.

retracediff: More helpful error message when glretrace is not found.

Trace glXCreateGLXPixmapMESA.

Generated code formatting improvements.

Cleanup Literal class.

Distinguish between tags and ids.

Remove dead base parameter to literal types.

Unnecessary given we encode it in binary form anyway.

Specify constant array lengths as integers.

Bring some of the virtual-memory-regions

Tracking user memory by querying virtual memory subsystem is not reboust
enough for master, but works in many cases, yielding much smaller and
efficient traces.

This change brings the ability of retracing traces generated by the
virtual-memory-regions branch.

It also brings more efficient tracing of glFlushMappedBufferRange calls.

The trace file version is bumped as a result.

Factor out polymorphic type generated code into functions.

Generate more compact switch statements for polymorphic types.

More polymorphic types in D3D9.

Allow basic specification of polymorphic types.

Unfortunately quite common in GL/D3D APIs.  And this will help hanlding
better without less hand written code.

Just D3D9 for now as guinea pig.

Handle GLenums disguised as GLdoubles too.

Add comment about SetUnhandledExceptionFilter

Fix retracing of wglShareLists for currently bound contexts.

Handle null strings in json writer.

Avoid depending on MinGW runtime DLLs.

Add a few comments/links to Cocoa development resources.

Fix dumb typo.

Ignore several harmless CGL calls when rectracing.

Use Cocoa on Mac OS X.

It will enable better control for OpenGL context creation.

s/unknown/unsupported.

Fix MacOSX build.

More GL api spec cleanups.

Cleanup param size computation.

Create contexts with DEBUG_BIT when not benchmarking.

Fix public/private GL symbols.

According to the ABI.

Tweak GLX specs.

Remove the GL_KTX_buffer_region entry points with EXT suffix.

It was a glew bug, fixed in 1.7.0.

Simplify glws class hierarchy.

Fix retracing of several older extensions.

Fix retracing of glGetSeparableFilter w/ pack buffer.

Handle glDraw*BaseInstance.

Uniformize warning output.

Refactor more common retracing code.

Hide retrace_unknown().

Fix MSVC build.

Ignore unexpected end of file in gzread.

zlib-1.2.4 onwards makes it is impossible to read the last block of
incomplete gzip traces without this modification.

Upgrade bundled zlib to 1.2.5 again.

Universal config.h for snappy.

Should (hopefully) work on all platforms that apitrace builds.

And this will make my life easier, as it will allow mixed in/out of
source builds flawlessly.

Fix mixed in/out of source builds.

Mixing in/out of source builds is not really a good policy, but
something I do quite often due to convenience.