summaryrefslogtreecommitdiff
path: root/odk
diff options
context:
space:
mode:
authorMichael Stahl <mstahl@redhat.com>2017-09-19 17:43:55 +0200
committerMichael Stahl <mstahl@redhat.com>2017-09-19 17:49:18 +0200
commit055456b075c0c953cd6216d518b5a92e8f5b54bf (patch)
tree4c4582bd5c9656a1fa53d04b5f7b06af9e9db472 /odk
parent98e69875f91fb4d44659b8e48388364ac6f27147 (diff)
odk: document what doxygen means by "Protected Member" in IDL
Interfaces and services that are marked as "optional" in IDL are deliberately tagged as "Protected" by doxygen, while everything else is "Public", so that in the inheritance diagrams dashed lines are drawn for "optional" bases and solid lines for non-optional bases. Unfortunately this also causes doxygen to produce the text "Protected Members", which appears hard to change, so just document it for now. Change-Id: Ice878981bac5bbb7a8a33a10f2b5f68c394e4340
Diffstat (limited to 'odk')
-rw-r--r--odk/docs/idl/main.dox9
1 files changed, 9 insertions, 0 deletions
diff --git a/odk/docs/idl/main.dox b/odk/docs/idl/main.dox
index b5d1d755ed0a..5e9a6c8f953b 100644
--- a/odk/docs/idl/main.dox
+++ b/odk/docs/idl/main.dox
@@ -9,3 +9,12 @@
/// \mainpage
///
/// This is a reference documentation for the UNO IDL API.
+///
+/// \remark
+/// UNO IDL has no concept of "public" or "protected".
+/// "Protected Member" or "Protected Attribute" in the context
+/// of this IDL documentation actually means
+/// "members inherited from optional service or interface",
+/// i.e., not every implementation supports these members
+/// or attributes.
+