cairo/util
Uli Schlachter e6b0c58424 Remove cairo-sphinx
I tried to use cairo-sphinx do to something useful. I failed.

The cairo-sphinx binary was added in commit 6e0b3be903 in 2009 by ickle
with the explanation:

    Add cairo-sphinx utility for regression analysis

    sphinx is an alternate version of the current cairo-test-trace. It's
    purpose is to replay a live application (which may just be a replay of a
    trace) against a backend and its reference. The improvement over the
    original cairo-test-trace is that the reference backend may be from an
    older version of cairo.

Ever since this commit, there were only build fixes to this code (for
example to fix compilation on AIX or to fix compilation after
cairo-tee.h became optional). So, either this code was perfect from the
beginning or it was not much used.

Next, I tried to reverse-engineer a bit how to actually use this. The
non-existing documentation didn't help much. The result? Well...
something happened, but I am not quite sure what. Then the server
process just exited.

So, in this commit I am removing cairo-sphinx. The hope is that someone
speaks up and complains. That person then hopefully can provide some
explanation on how to use this. Alternatively, no one speaks up and we
no longer have to maintain this piece of code.

Signed-off-by: Uli Schlachter <psychon@znc.in>
2023-09-06 18:39:22 +02:00
..
cairo-fdr Build with hidden symbols by default 2023-08-16 16:33:04 +01:00
cairo-gobject Build with hidden symbols by default 2023-08-16 16:33:04 +01:00
cairo-missing Defining Windows version macros in meson.build 2023-01-13 05:47:03 +09:00
cairo-script Build with hidden symbols by default 2023-08-16 16:33:04 +01:00
cairo-trace Build with hidden symbols by default 2023-08-16 16:33:04 +01:00
.gitignore stroke: Convert the outlines into contour and then into a polygon 2011-08-15 10:31:47 +01:00
cairo-api-update Misc. typos 2019-01-31 17:37:15 -08:00
cairo-view [util] Fix pangram 2008-12-24 22:29:59 -05:00
cairo.modules Use HTTPS URLs for freedesktop.org domains 2018-10-16 10:03:07 -07:00
COPYING Add a COPYING file to each aux. source directory 2008-10-31 16:14:14 +00:00
font-view.c util/font-view: fix build error 2017-10-21 20:05:56 +10:30
malloc-stats.c [malloc-stats] Measure calloc 2023-01-26 14:20:12 -07:00
meson.build Remove cairo-sphinx 2023-09-06 18:39:22 +02:00
README Replace deprecated malloc_hook 2022-03-09 06:58:28 +10:30
show-contour.c Remove stray _GNU_SOURCE definitions 2021-05-01 16:58:15 +01:00
show-edges.c Remove stray _GNU_SOURCE definitions 2021-05-01 16:58:15 +01:00
show-events.c Remove stray _GNU_SOURCE definitions 2021-05-01 16:58:15 +01:00
show-polygon.c Remove stray _GNU_SOURCE definitions 2021-05-01 16:58:15 +01:00
show-traps.c Remove stray _GNU_SOURCE definitions 2021-05-01 16:58:15 +01:00
waterfall [util] Add waterfall 2008-12-26 16:38:26 -05:00
xr2cairo Fixed to not munge some internal cairot names, (such as cairo_traps_*) 2003-07-26 20:38:58 +00:00

Cairo Utilities
===============

There are a varieties of utilities we use with cairo.


malloc-stats
------------

This is a small shared library designed to be preloaded by the
linker and its purpose is to make the malloc_stats() function
of glibc produce more useful information.

Build by:

	make malloc-stats.so

and use by:

	LD_PRELOAD=$(blddir)/util/libmalloc-stats.so app-to-run

cairo-trace
-----------

This tool can be used to trace all the cairo function calls made by an
applications.  This is useful for either extracting a test case triggering
a bug from an application, or simply to get a general idea of how an
application is using cairo.


cairo-api-update and xr2cairo
-----------------------------

These two scripts were used to convert source code written for pre-1.0
cairo to newer API.  See $(top_srcdir)/PORTING_GUIDE for more information.

These files are obsolete now and may be removed in a future version.


cairo-view and waterfall
------------------------

These are two pycairo scripts useful for testing the toy font backend.