API-incompatible changes to unpublished accessibility UNO API (was: Re: ESC meeting minutes: 2024-11-07)

[Michael Weghorn]

On 2024-11-07 17:00, Stephan Bergmann wrote:
> On 07.11.24 16:47, Miklos Vajna wrote:
> just to retroactively highlight the incompatible API CHANGE of 
> unpublished but `@since OOo 1.1.2` 
> css.accessibility.AccessibleRelationType constant group at <https:// 
> git.libreoffice.org/core/ 
> +/92a36bbd4f3e9ad5d2741f55fe4ac7f03f7e2531%5E%21> "[API CHANGE] a11y: 
> Switch AccessibleRelationType to enum", in case anybody sees issues with 
> that

Indeed, if anybody has concerns, please do speak up - ideally before the 
ESC call in 2 weeks, for which I plan to add this as an agenda item.

Otherwise, I plan to do more API-incompatible changes to the unpublished 
UNO accessibility API in the future, among others to simplify 
maintenance and improve the debugging experience.

For the record, UNO a11y API was explicitly unpublished in

     commit 70626249cd247d9acdad417b8eaf252bae22c059
     Date:   Thu Nov 29 00:27:03 2012 +0100

         API CHANGE a11y unpublishing and add/removeListener rename.

         The a11y API has never really been picked up by tools vendors, 
let's
         not tie ourselves up here for no good reason.

         This unpublishes all css::accessibility, and dependend API.

         With that, we can change the rather unfortunately-named add/
         removeEventListener to be add/removeAccessibleEventListener, thus
         not conflicting with the XComponent methods of the same name.

         Change-Id: I595598c3a8e46415f80b2780f333333174865fe4


and there have been previous API-breaking changes (by myself and others) 
in previous years, see the output of

     git log --grep="API CHANGE" -- offapi/com/sun/star/accessibility/
-------------- next part --------------
A non-text attachment was scrubbed...
Name: OpenPGP_signature.asc
Type: application/pgp-signature
Size: 840 bytes
Desc: OpenPGP digital signature
URL: <https://lists.freedesktop.org/archives/libreoffice/attachments/20241107/b103539f/attachment.sig>