Re: [cairo-commit] NEWS

On Wed, Apr 16, 2014 at 05:28:05PM -0700, Bryce Harrington wrote:
>  NEWS |   88 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
>  1 file changed, 88 insertions(+)
> 
> New commits:
> commit 457597e2dc6fac6c879ba51da892cf31a3c432eb
> Author: Bryce W. Harrington <[email protected]>
> Date:   Fri Mar 14 20:24:51 2014 +0000
> 
>     NEWS: Summarize recent changes
>     
>     This updates NEWS with items shown by `git log --stat 1.12.8..`
>     Hopefully I haven't misrepresented any of the work done.  For sake of
>     brevity where there were several changes in one area, I've given a
>     single general entry to summarize those changes.  The division between
>     features and bug fixes is quite rough.
> 
> diff --git a/NEWS b/NEWS
> index 030eacc..7ad26f7 100644
> --- a/NEWS
> +++ b/NEWS
> @@ -1,3 +1,91 @@
> +Release 1.??.?? (??)
> +====================
> +intro text...
> +
> +
> +Features
> +--------

For features, try to explain why they are useful and when users might see
a difference or would want to enable them. A useful techinique is to
group them by core/backend, so that you can describe all the fabulous
must-have improvements in a paragraph.

If there are API changes, put those into a separate section and be
explicit.

> +  Update our requirements to glib 2.14 and pixman 0.30.

Not a feature.

> +  Use Pixman's convolution filters for image downscaling.  Include a
> +  downscaling test.

Improved image quality when viewing large images on low resolution
devices. Similar techniques are already used by firefox and chromium, for
example.

> +  Improve handling of device transformation and scaling.  New public
> +  functions cairo_surface_set_device_scale and
> +  cairo_surface_get_device_scale are available.

Implementation details masquerading as a feature. The feature is that we
now support scaling at a device level such that toolkits can hide
resolution independent scaling from canvas actors, i.e. easier, more
transparent HiDPI support.

> +  Support JBIG2 mime data in PDF.

Allow embedding of more compressed JPEG formats within PDF, rather than
including the full uncompressed image.

> +  If the group contains only a combination of clear and opaque alpha and
> +  only OPERATOR_OVER is used in the group and to paint the group, a
> +  transparency group is not required when generating pdf.

Reduce the number of transparency groups used by PDF to keep the file
size small and viewing/printing of the PDF fast.

> +  Add support for stencil masks with jpeg/jpx/jbig2 embedding in PDFs.

Expand the embedding section to include stencil mask support.

> +  Optimize PDF images where the source and mask are both images with the
> +  same extents.

Again, the same PDF image embedded feature.

> +  Reorder font declarations to be in natural order
> +
> +  Alter the rounding algorithm for converting floating point numbers to
> +  integers to incur less error

I thought it was to more evenly distribute the error... Not a high leve
feature.

> +  In matrix transformations, round extremely small values to zero

User impact? 

> +Bug fixes
> +---------

For bug fixes, always try to reference the bugzilla discussion or
original bug report. Try to include how the bug manifests, so that
people can scan the NEWS and see if contains the fix for their issue.
-Chris

-- 
Chris Wilson, Intel Open Source Technology Centre
-- 
cairo mailing list
[email protected]
http://lists.cairographics.org/mailman/listinfo/cairo