warning in ODK / API headers (?)

Hi Stephan,

On 05/10/18 08:19, Stephan Bergmann wrote:
> On 04/10/2018 18:03, Michael Meeks wrote:
> >     Neither can be part of our public UNO API since they're not
> > isJavaNamed() - so I think you're fine.
>
> A more precise check is the list of include files generated by
> odk/CustomTarget_allheaders.mk at
> workdir/CustomTarget/odk/allheaders/allheaders.hxx.  :)

        Ooh - that is useful =)

        I wonder though - if we should add a:

/**
 * WARNING: this header is part of the frozen API & API of LibreOffice
 *          while all improvements are welcome, changes here require
 *          particularly close inspection and concern for backwards
 *          compatibility.
 */

        Or some similar blurb - that is at least not too negative on change -
but actually tags all those files in a helpful & easy-to-find way (?)

        Hopefully that'd make it clearer to people that the rest of LibreOffice
is more 'fair game' for rampant re-factoring =)

        Thoughts ?

                Michael.

-- 
michael.meeks@collabora.com <><, GM Collabora Productivity
Hangout: mejmeeks@gmail.com, Skype: mmeeks
(M) +44 7795 666 147 - timezone usually UK / Europe