offapi/README

   1 Contains all of the IDL files except those in [[udkapi]]
   2
   3 i.e. the interfaces that are specific to the LibreOffice application.
   4 An artificial (?) separation.
   5
   6 The reference offapi/type_reference/offapi.idl and
   7 udkapi/type_reference/udkapi.idl (formerly combined into a single
   8 offapi/type_reference/types.rdb) are used to detect inadvertent incompatible
   9 changes.  They are plain-text .idl files (not stricly lexicographically sorted,
  10 though, so they satisfy the .idl file requirements for no forward dependencies),
  11 so in cases where we deliberately /do/ become incompatible they can be modified
  12 manually.
  13
  14 Old such cases of deliberately becoming incompatible are listed in
  15 offapi/type_reference/typelibrary_history.txt, newer such cases are recorded in
  16 the git logs of (now superseded) offapi/type_reference/types.rdb,
  17 offapi/type_reference/offapi.rdb, and udkapi/type_reference/udkapi.rdb, new such
  18 cases are recorded in the git logs of offapi/type_reference/offapi.idl and
  19 udkapi/type_reference/udkapi.idl.