Add a FIXME to polkitprivate.h

See discussion in https://bugs.freedesktop.org/show_bug.cgi?id=63573 .

diff --git a/src/polkit/polkitprivate.h b/src/polkit/polkitprivate.h
index 3567cc0cbd402489841a5d41cc13b7328cfe2b3c..9f07063d99f6056293aaedf4b3f7030be327fc11 100644 (file)
--- a/src/polkit/polkitprivate.h
+++ b/src/polkit/polkitprivate.h
@@ -28,6 +28,16 @@
 #include "polkitauthorizationresult.h"
 #include "polkittemporaryauthorization.h"
 
+/* FIXME: This header file is currently installed among other public header
+   files, and the symbols are exported in the shared library.
+
+   For application writers: relying on any function here is strongly
+   discouraged.
+
+   For polkit maintainers: This should be made private if a large ABI break
+   were necessary in the future.  In the meantime, consider that there is
+   non-zero risk that changing these functions might break some applications. */
+
 PolkitActionDescription  *polkit_action_description_new_for_gvariant (GVariant *value);
 GVariant *polkit_action_description_to_gvariant (PolkitActionDescription *action_description);