[cairo-commit] [cairo-www] src/FAQ.mdwn

Carl Worth cworth at freedesktop.org
Mon Jun 8 03:45:08 PDT 2009


 src/FAQ.mdwn |   22 +++++++++++++++-------
 1 file changed, 15 insertions(+), 7 deletions(-)

New commits:
commit 22a8734915806cbbc5aa42f72b626c28a0821c80
Author: ickle <ickle at web>
Date:   Mon Jun 8 03:45:07 2009 -0700

    Update information about cairo-trace

diff --git a/src/FAQ.mdwn b/src/FAQ.mdwn
index bcb6adf..8d94b92 100644
--- a/src/FAQ.mdwn
+++ b/src/FAQ.mdwn
@@ -361,18 +361,26 @@ a useful benchmark for improving Cairo.
 After installing Cairo from git, a 1.9 snapshot or a later release the cairo-trace utility will be available.
 
 	$ cairo-trace
-	usage: cairo-trace [--no-file|--verbose] command
+	usage: cairo-trace [--no-file] command
 	cairo-trace will generate a log of all calls made by command to
 	cairo. This log will be stored in a file in the local directory
-	called command.$pid.trace.
+	called command.pid.trace.
 	Whatever else happens is driven by its argument:
-	--flush      - Flush the output trace after every call.
-	--verbose    - Show the trace on stdout.
-	--no-file    - Disable the creation of an output file.
-	--no-callers - Do not lookup the caller address/symbol/line whilst tracing.
+	  --flush         - Flush the output trace after every call.
+	  --no-file       - Disable the creation of an output file. Outputs to the terminal instead.
+	  --no-callers    - Do not lookup the caller address/symbol/line whilst tracing.
+	  --mark-dirty    - Record image data for cairo_mark_dirty() [default]
+	  --no-mark-dirty - Do not record image data for cairo_mark_dirty()
+	  --compress      - Compress the output with LZMA
+	  --profile       - Combine --no-callers and --no-mark-dirty and --compress
+
 
 That is performing
 
 	$ cairo-trace /path/to/my/app arg1 arg2 ... argn
 
-will generate an output file called ./app.$pid.trace.
+will generate an output file called ./app.$pid.trace. If you want to simply record a trace to share, then use
+
+	$ cairo-trace --profile /path/to/my/app arg1 arg2 ... argn
+
+A compilation of "interesting" traces can be found [here](:http://cgit.freedesktop.org/cairo-traces), which are automatically run by the perf/cairo-perf-trace benchmarking tool.


More information about the cairo-commit mailing list