warning in ODK / API headers (?)

[Michael Meeks]

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 at collabora.com <><, GM Collabora Productivity
Hangout: mejmeeks at gmail.com, Skype: mmeeks
(M) +44 7795 666 147 - timezone usually UK / Europe