summaryrefslogtreecommitdiffstats
path: root/ipc/chromium/src/third_party/libevent/extra/abi-check/README.md
blob: 77fdd94128db705619d5b8f41d5304cd5d8cc19f (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
## libevent ABI/API changes


This script is used to generate information about changes in libevent ABI/API
between various versions using [LVC tools](https://github.com/lvc). Such an
overview can help developers migrate from one version to another.

Here is the `abi_check.sh`, which is used to generate ABI/API timeline for
libevent.

You can limit the number of included libevent versions via a number given
as a parameter to the script. For example

```shell
$ ./abi_check.sh 3
```

generates overview for the last 3 versions and the current version.
If no parameter given, it will generate overview for the last 2 versions and
the current version by default.

But this script requires some tools that are available in the following docker image:

```
docker.pkg.github.com/azat/docker-images/lvc-debian
```

And the full command looks like:

```shell
  docker run --rm -it -v $PWD:/src:ro -w /src -v tmp/le-abi-check-root:/abi-root -e ABI_CHECK_ROOT=/abi-root docker.pkg.github.com/azat/docker-images/lvc-debian /src/extra/abi-check/abi_check.sh
```

'timeline/libevent/index.html' is the final result and can be viewed
[here](https://libevent.org/abi)