Just a reminder, as occasion demands:

On 10/10/13 09:41, Stephan Bergmann wrote:
The *.idl (formerly *.rdb) files in {udkapi,offapi}/type_reference/ are meant to represent the status of our (published) UNO API as previously released, to allow detecting inadvertent incompatible changes.

Therefore, these files should generally be left unchanged.  The only time to change them is when a deliberate incompatible change (with a commit message containing "[API CHANGE]") would otherwise break the compatibility checks when building udkapi or offapi.  (And in the past, when those type_references were binary *.rdb files, that was a somewhat tricky task.  Now that they are textual *.idl files it has become (too?) trivial.)

(So, if there are any git-hook aficionados out there, maybe there's a way to prevent commits that change {udkapi,offapi}/type_reference/{udkapi,offapi}.idl but do not contain "[API CHANGE]" in the commit message.)
LibreOffice mailing list

Reply via email to