summaryrefslogtreecommitdiff
path: root/docs/API-ABI-Changes
blob: 0216234566ad685184509759d6643ba88f17edef (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
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.


LibCSS 0.3.0 --> LibCSS 0.4.0
-----------------------------

  The API is changed.

  Due to the change from CSS2 overflow to CSS3 overflow properties, the
  computed style access functions for overflow properties have changed.
  The overflow property is removed.  Added are overflow-x and overflow-y
  properties.  (The overflow shorthand property now sets overflow-x and
  overflow-y.)

  This change affects the following functions:

    Removed from   include/libcss/computed.h    --  css_computed_overflow()

    Added to       include/libcss/computed.h    --  css_computed_overflow_x()

    Added to       include/libcss/computed.h    --  css_computed_overflow_y()