From 7fbd2b167e50ce5fbee46e562a8d184b9f5e8322 Mon Sep 17 00:00:00 2001 From: Bryce Harrington Date: Thu, 25 Jun 2015 17:00:57 -0700 Subject: [PATCH] csi: Note that there is not yet a stable interface Signed-off-by: Bryce Harrington --- configure.ac | 6 +++++- util/README | 8 ++++++++ util/cairo-script/cairo-script-interpreter.h | 5 +++++ 3 files changed, 18 insertions(+), 1 deletion(-) diff --git a/configure.ac b/configure.ac index 2ce1959..91615af 100644 --- a/configure.ac +++ b/configure.ac @@ -780,7 +780,11 @@ CAIRO_ENABLE(trace, cairo-trace, auto, [ fi ]) -CAIRO_ENABLE(interpreter, cairo-script-interpreter, yes, [ +dnl =========================================================================== +dnl CSI is intended as a private library for the internal analysis tools. +dnl It needs a lot more refinement for it to be suitable for more general use. +dnl It does not have a stable interface. +CAIRO_ENABLE(interpreter, cairo-script-interpreter, no, [ if test "x$have_libz" != "xyes"; then use_interpreter="no (requires zlib)" fi diff --git a/util/README b/util/README index 39560a8..20d56c6 100644 --- a/util/README +++ b/util/README @@ -65,3 +65,11 @@ cairo-view and waterfall These are two pycairo scripts useful for testing the toy font backend. + +cairo-script +------------ + +These tools allow replaying cairo scripts. Note that the library API is +not stable and is subject to change. For more details see: + + http://cairographics.org/manual/cairo-Script-Surfaces.html diff --git a/util/cairo-script/cairo-script-interpreter.h b/util/cairo-script/cairo-script-interpreter.h index 27fb986..0d18acf 100644 --- a/util/cairo-script/cairo-script-interpreter.h +++ b/util/cairo-script/cairo-script-interpreter.h @@ -33,6 +33,11 @@ * Chris Wilson */ +/** + * WARNING: The CSI library interface is not considered stable yet. + * Structure and function definitions may change release to release. + */ + #ifndef CAIRO_SCRIPT_INTERPRETER_H #define CAIRO_SCRIPT_INTERPRETER_H -- 1.9.1