Introduce com.sun.star.beans.theIntrospection singleton

...deprecating com.sun.star.beans.Introspection (single-instance) service.

Change-Id: Ica2e3a3541c7dcb1aab79222c5abf40d6988c882

3 files changed, 38 insertions, 7 deletions

diff --git a/udkapi/UnoApi_udkapi.mk b/udkapi/UnoApi_udkapi.mk
index 2eaee045bfed..7e54736af02d 100644
--- a/udkapi/UnoApi_udkapi.mk
+++ b/udkapi/UnoApi_udkapi.mk
@@ -80,6 +80,7 @@ $(eval $(call gb_UnoApi_add_idlfiles_noheader,udkapi,com/sun/star/util,\
 $(eval $(call gb_UnoApi_add_idlfiles_nohdl,udkapi,com/sun/star/beans,\
 	PropertyBag \
 	Introspection \
+	theIntrospection \
 ))
 $(eval $(call gb_UnoApi_add_idlfiles_nohdl,udkapi,com/sun/star/bridge,\
 	BridgeFactory \
diff --git a/udkapi/com/sun/star/beans/Introspection.idl b/udkapi/com/sun/star/beans/Introspection.idl
index 45b33ce83e84..1904d601dfc9 100644
--- a/udkapi/com/sun/star/beans/Introspection.idl
+++ b/udkapi/com/sun/star/beans/Introspection.idl
@@ -25,14 +25,10 @@
 
  module com {  module sun {  module star {  module beans {
 
-/** provides functionality to get information about an object's
-    properties and methods.
-    <p><strong>Important note:</strong>An object can only be
-    inspected completely if it supports the
-    com::sun::star::lang::XTypeProvider interface.</p>
+/** A legacy (single-instance) service variant of theIntrospection singleton.
 
-    <p>For details see method XIntrospection::inspect() .</p>
- */
+    @deprecated Use theIntrospection instead.
+*/
 published service Introspection : com::sun::star::beans::XIntrospection;
 
 
diff --git a/udkapi/com/sun/star/beans/theIntrospection.idl b/udkapi/com/sun/star/beans/theIntrospection.idl
new file mode 100644
index 000000000000..ba100f4b6b7f
--- /dev/null
+++ b/udkapi/com/sun/star/beans/theIntrospection.idl
@@ -0,0 +1,34 @@
+/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
+/*
+ * This file is part of the LibreOffice project.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ */
+
+#ifndef INCLUDED_com_sun_star_beans_theIntrospection_idl
+#define INCLUDED_com_sun_star_beans_theIntrospection_idl
+
+module com {  module sun {  module star {  module beans {
+
+published interface XIntrospection;
+
+/** provides functionality to get information about an object's
+    properties and methods.
+
+    <p><strong>Important note:</strong>An object can only be inspected
+    completely if it supports the com::sun::star::lang::XTypeProvider
+    interface.</p>
+
+    <p>For details, see method XIntrospection::inspect().</p>
+
+    @since LibreOffice 4.3
+*/
+published singleton theIntrospection: XIntrospection;
+
+}; }; }; };
+
+#endif
+
+/* vim:set shiftwidth=4 softtabstop=4 expandtab: */