[cairo-commit] 4 commits - build/Makefile.am.gtk-doc NEWS

Thu Jun 11 14:54:04 PDT 2009

NEWS                      |   84 ++++++++++++++++++++++++++++++----------------
 build/Makefile.am.gtk-doc |    4 +-
 2 files changed, 57 insertions(+), 31 deletions(-)

New commits:
commit a4f023ef2eb041fecba5f3fd2d5a1594975ca211
Author: Carl Worth <cworth at cworth.org>
Date:   Thu Jun 11 14:51:14 2009 -0700

    NEWS: Update date for snapshot planned for today.

diff --git a/NEWS b/NEWS
index c18b78e..8d683d7 100644
--- a/NEWS
+++ b/NEWS
@@ -1,4 +1,4 @@
-Release 1.9.2 (2008-11-??)
+Release 1.9.2 (2009-06-11)
 ==========================
 API additions:
 
commit 82139b42919be1acf6bade733bb2ff489e50812d
Author: Carl Worth <cworth at cworth.org>
Date:   Thu Jun 11 14:51:10 2009 -0700

    NEWS: Explain bovine polaroids a bit more.
    
    It's a fun joke, but the COW snapshots feature is important enough
    that we should actually tell users what it is.

diff --git a/NEWS b/NEWS
index 8ca7922..c18b78e 100644
--- a/NEWS
+++ b/NEWS
@@ -78,8 +78,15 @@ Optimisations:
   polygon rasterisation! Joonas implemented the Tor polygon scan converter,
   on typical geometry is about 30% faster for the image backend.
 
-  Bovine Polaroids! Though Adrian said that the PDF is not quite working as
-  well as it should.
+  Bovine Polaroids! For those not in on the joke, this is the long
+  awaited "copy-on-write snapshot" or "COW snapshot" support. The
+  user-visible feature is that including the same image multiple times
+  into a PDF file should result in only a single instance of that
+  image in the final output. This is unlike previous versions of cairo
+  which would generate very large PDF files with multiple copies of
+  the same image. Adrian says that the PDF is not quite working as
+  well as it should yet, so we hope for futher improvements before
+  cairo 1.10.
 
 Bug fixes:
 
commit 4d5f66d5b1f243e58d43dc89568be9240262fd5c
Author: Carl Worth <cworth at cworth.org>
Date:   Thu Jun 11 14:42:11 2009 -0700

    NEWS: Cleanup in preparation for 1.9.2 snapshot
    
    Mostly just wrapping to a reasonable line length, and some minor
    wording changes.

diff --git a/NEWS b/NEWS
index 0f57302..8ca7922 100644
--- a/NEWS
+++ b/NEWS
@@ -18,13 +18,14 @@ API additions:
   cairo_pdf_surface_restrict_to_version()
   cairo_pdf_get_versions()
   cairo_pdf_version_to_string()
-    Similar to restrict to version and level found in SVG and PS, these
-    limit the features used in the output to comply with the PDF specification
-    for that version.
+
+    Similar to restrict to version and level found in SVG and PS,
+    these limit the features used in the output to comply with the PDF
+    specification for that version.
 
   CAIRO_STATUS_INVALID_SIZE
-    Indicates that the request surface size is not supported by the backend.
-    This generally indicates that the request is too large.
+    Indicates that the request surface size is not supported by the
+    backend.  This generally indicates that the request is too large.
 
   CAIRO_STATUS_USER_FONT_NOT_IMPLEMENTED
     Indicates that a required callback for a user-font was not implemented.
@@ -44,23 +45,31 @@ New experimental backends:
 
 New utility:
 
-  cairo-trace
+  cairo-trace and cairo-perf-trace
 
-    Generates a human-readable, replayable, compact(-ish!) representation of
-    the sequences of drawing commands made by an application.
+    cairo-trace generates a human-readable, replayable, compact(-ish!)
+    representation of the sequences of drawing commands made by an
+    application.
 
     Under the util/cairo-script directory is a library to replay traces.
 
-    perf/cairo-perf-trace contains a benchmarking tool for traces, integrated
-    with 'make perf' (needs the external trace repository
-    git://anongit.freedesktop.org/cairo-traces under perf/cairo-traces).
+    perf/cairo-perf-trace replays traces against multiple backends
+    and makes useful benchmark reports. This is integrated with
+    'make perf'. You may collect your own traces or take advantage
+    of traces collected by the community:
+
+      git://git.cairographics.org/git/cairo-traces
+
+    (Put this into perf/cairo-traces to run these as part of "make perf".)
 
     There is additional WIP in building a debugging tool for cairo applications
     based on CairoScript (currently very preliminary, mostly serves to show
     that GtkSourceView is too slow) :
+
       people.freedesktop.org:~ickle/sphinx
 
 Test suite overhaul:
+
   The test suite is undergoing an overhaul, primarily to improve its speed
   and utility. (Expect more changes in the near future to improve XFAIL
   handling.)
@@ -72,26 +81,36 @@ Optimisations:
   Bovine Polaroids! Though Adrian said that the PDF is not quite working as
   well as it should.
 
-Tweaks to tessellator, allocations of patterns, delayed initialisation of
-the xlib backend (reduce the cairo overhead of render_bench by ~80%).
-
 Bug fixes:
-EXTEND_PAD.
-Better handling of large scale-factors on image patterns.
-Emit /Interpolate for PS,PDF images.
-Global glyph cache - cap on the total number of inactive glyphs, should prove
-fairer for fonts with larger glyph sets.
-Compilation without fontconfig
-Improved handling of low-bitdepth sources (e.g. copying the contents of
-16-bit xserver windows)
+
+  EXTEND_PAD.
+
+  Better handling of large scale-factors on image patterns.
+
+  Emit /Interpolate for PS,PDF images.
+
+  Global glyph cache - cap on the total number of inactive glyphs,
+  should prove fairer for fonts with larger glyph sets.
+
+  Compilation without fontconfig
+
+  Improved handling of low-bitdepth sources (e.g. copying the contents
+  of 16-bit xserver windows)
 
 Regressions:
-cairo_traps_extract_region >10x slower. Fix pending.
+
+  cairo_traps_extract_region >10x slower. Fix pending.
 
 Still to come:
-Region tracking API (ssp) for damage tracking, hit testing etc
-mime-surface
-An expiremental OpenGL backend?
+
+  Region tracking API (ssp) for damage tracking, hit testing etc
+  mime-surface
+
+  An expiremental OpenGL backend?
+
+  Tweaks to tessellator, allocations of patterns, delayed
+  initialisation of the xlib backend (reduce the cairo overhead of
+  render_bench by ~80%).
 
 Release 1.8.6 (2008-12-13 Chris Wilson <chris at chris-wilson.co.uk>)
 =========================================================
commit 19630f4b73a4fdfb9855ececd6614493e68d3b95
Author: Carl Worth <cworth at cworth.org>
Date:   Wed Jun 10 17:39:48 2009 -0700

    Make the warning about the need to --enable-gtk-doc more explicit.
    
    I must have read it three times and kept thinking, "but I *did*
    just install gtk-doc", before I finally understood what it was
    trying to tell me.

diff --git a/build/Makefile.am.gtk-doc b/build/Makefile.am.gtk-doc
index 50cd627..b52fdfa 100644
--- a/build/Makefile.am.gtk-doc
+++ b/build/Makefile.am.gtk-doc
@@ -54,7 +54,7 @@ if ENABLE_GTK_DOC
 doc: html-build.stamp
 else
 doc:
-	@echo "*** gtk-doc must be installed and enabled in order to make doc"
+	@echo "*** gtk-doc must be installed (and --enable-gtk-doc) in order to make doc"
 	@false
 endif
 
@@ -161,7 +161,7 @@ if ENABLE_GTK_DOC
 dist-check-gtkdoc:
 else
 dist-check-gtkdoc:
-	@echo "*** gtk-doc must be installed and enabled in order to make dist"
+	@echo "*** gtk-doc must be installed (and --enable-gtk-doc) in order to make dist"
 	@false
 endif
 
