From 267c6f2ac71f92999e969232431ba04678e7437e Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Mon, 15 Apr 2024 07:54:39 +0200 Subject: Adding upstream version 4:24.2.0. Signed-off-by: Daniel Baumann --- offapi/README.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 offapi/README.md (limited to 'offapi/README.md') diff --git a/offapi/README.md b/offapi/README.md new file mode 100644 index 0000000000..1d35bd2ca5 --- /dev/null +++ b/offapi/README.md @@ -0,0 +1,21 @@ +# LibreOffice API IDL Files Except UDK API + +Contains all of the IDL files except those in `udkapi`. + +i.e. the interfaces that are specific to the LibreOffice application. +An artificial (?) separation. + +The reference `offapi/type_reference/offapi.idl` and +`udkapi/type_reference/udkapi.idl` (formerly combined into a single +`offapi/type_reference/types.rdb`) are used to detect inadvertent incompatible +changes. They are plain-text `.idl` files (not strictly lexicographically sorted, +though, so they satisfy the `.idl` file requirements for no forward dependencies), +so in cases where we deliberately /do/ become incompatible they can be modified +manually. + +Old such cases of deliberately becoming incompatible are listed in +`offapi/type_reference/typelibrary_history.txt`, newer such cases are recorded in +the `git log`s of (now superseded) `offapi/type_reference/types.rdb`, +`offapi/type_reference/offapi.rdb`, and `udkapi/type_reference/udkapi.rdb`, new such +cases are recorded in the `git log`s of `offapi/type_reference/offapi.idl` and +`udkapi/type_reference/udkapi.idl`. -- cgit v1.2.3