From 1b95fec601a3d006ba6b99e1dea3f61c3c8318fc Mon Sep 17 00:00:00 2001 From: Michael Drake Date: Fri, 13 Dec 2013 20:16:52 +0000 Subject: Various changes which modify API and ABI: - Remove client allocation function. - Change node_classes callback not to yield array ownership to libcss. - Node bloom filters now built by, during selection libcss. - Added selection callbacks to get and set data on document nodes. Test suite, example, and documentation updated to match. --- docs/API-ABI-Changes | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 docs/API-ABI-Changes (limited to 'docs/API-ABI-Changes') diff --git a/docs/API-ABI-Changes b/docs/API-ABI-Changes new file mode 100644 index 0000000..c70c6f0 --- /dev/null +++ b/docs/API-ABI-Changes @@ -0,0 +1,37 @@ +LibCSS API & ABI Changes +======================== + + This document explains how to upgrade clients to use new versions of LibCSS. + + +LibCSS 0.2.0 --> LibCSS 0.3.0 +----------------------------- + + Both the API and ABI are changed. + + LibCSS nolonger lets clients provide a memory allocator function. + This change affects the following functions: + + From include/libcss/computed.h -- css_computed_style_create() + + From include/libcss/select.h -- css_select_ctx_create() + + From incluce/libcss/stylesheet.h -- css_stylesheet_create() + + + There are changes to selection handler callback table: + + node_classes + LibCSS nolonger frees the any array of classes passed to the + node_classes callback. It does still unref the individual strings. + This means clients need not allocate a new array each call, but can + keep the array cached on the node. + + set_libcss_node_data + New selection handler function used to store a private cache belonging + to libcss on document element nodes. When the node is deleted or + modified, clients should call css_libcss_node_data_handler(). + + get_libcss_node_data + New selection handler function used to retrieve private cache belonging + to libcss from document element nodes. -- cgit v1.2.1