Clarify javadoc for OSGi related interfaces

diff --git a/shared/src/main/java/com/vaadin/osgi/resources/OSGiVaadinTheme.java b/shared/src/main/java/com/vaadin/osgi/resources/OSGiVaadinTheme.java
index 9507dfe6f4b711f7f9d5280e0f2bc7680d6cf4e7..852dd93294badf9b9fd07011b36a072303dd0d51 100644 (file)
--- a/shared/src/main/java/com/vaadin/osgi/resources/OSGiVaadinTheme.java
+++ b/shared/src/main/java/com/vaadin/osgi/resources/OSGiVaadinTheme.java
@@ -20,6 +20,11 @@ package com.vaadin.osgi.resources;
  * in the same OSGi bundle as the class implementing this interface, under the
  * path "/VAADIN/themes/{themeName}" where {themeName} is what is returned by
  * {@link OSGiVaadinTheme#getName()}.
+ * <p>
+ * To publish a theme, an implementation of this interface needs to be
+ * registered as an OSGi service, which makes
+ * <code>VaadinResourceTrackerComponent</code> automatically publish the theme
+ * with the given name.
  *
  * @author Vaadin Ltd.
  *

diff --git a/shared/src/main/java/com/vaadin/osgi/resources/OSGiVaadinWidgetset.java b/shared/src/main/java/com/vaadin/osgi/resources/OSGiVaadinWidgetset.java
index 45bf0c4f6a1526c559d34ca9c51617411ae50231..c59444368751a2e73bb92b625921e9ecdb1e80d0 100644 (file)
--- a/shared/src/main/java/com/vaadin/osgi/resources/OSGiVaadinWidgetset.java
+++ b/shared/src/main/java/com/vaadin/osgi/resources/OSGiVaadinWidgetset.java
@@ -20,6 +20,11 @@ package com.vaadin.osgi.resources;
  * to be in the same OSGi bundle as the class implementing this interface, under
  * the path "/VAADIN/widgetsets/{widgetsetName}" where {widgetsetName} is what
  * is returned by {@link OSGiVaadinWidgetset#getName()}.
+ * <p>
+ * To publish a widgetset, an implementation of this interface needs to be
+ * registered as an OSGi service, which makes
+ * <code>VaadinResourceTrackerComponent</code> automatically publish the
+ * widgetset with the given name.
  *
  * @author Vaadin Ltd.
  *