From 3b9f0064088146b996e8571f492aa45ae639dbe7 Mon Sep 17 00:00:00 2001
From: buczekp <buczekp>
Date: Tue, 29 Mar 2011 12:50:24 +0000
Subject: [PATCH] minor: changed javadoc - moved notes out of the public
 javadoc

SVN: 20542
---
 .../shared/basic/dto/api/IManagedInputWidgetDescription.java   | 3 +--
 .../basic/dto/api/IManagedInputWidgetDescriptionFactory.java   | 3 +--
 .../shared/basic/dto/api/IManagedOutputWidgetDescription.java  | 3 +--
 .../openbis/generic/shared/basic/dto/api/IManagedProperty.java | 3 +--
 .../openbis/generic/shared/basic/dto/api/IManagedUiAction.java | 3 +--
 .../generic/shared/basic/dto/api/IManagedUiDescription.java    | 1 +
 .../generic/shared/basic/dto/api/IManagedUiTableAction.java    | 3 +--
 .../cisd/openbis/generic/shared/basic/dto/api/IPerson.java     | 3 +--
 .../cisd/openbis/generic/shared/basic/dto/api/ITableModel.java | 3 +--
 .../generic/shared/basic/dto/api/ManagedInputFieldType.java    | 3 +--
 .../generic/shared/basic/dto/api/ManagedOutputWidgetType.java  | 3 +--
 .../basic/dto/api/ManagedTableActionRowSelectionType.java      | 3 +--
 .../shared/managed_property/api/EntityLinkElementKind.java     | 3 +--
 .../openbis/generic/shared/managed_property/api/IElement.java  | 3 +--
 .../generic/shared/managed_property/api/IElementFactory.java   | 3 +--
 .../managed_property/api/IEntityInformationProvider.java       | 3 +--
 .../shared/managed_property/api/IEntityLinkElement.java        | 3 +--
 .../shared/managed_property/api/IRowBuilderAdaptor.java        | 3 +--
 .../managed_property/api/ISimpleTableModelBuilderAdaptor.java  | 3 +--
 .../managed_property/api/IStructuredPropertyConverter.java     | 3 +--
 20 files changed, 20 insertions(+), 38 deletions(-)

diff --git a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedInputWidgetDescription.java b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedInputWidgetDescription.java
index 911ed5d8644..2cbd184ca81 100644
--- a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedInputWidgetDescription.java
+++ b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedInputWidgetDescription.java
@@ -20,11 +20,10 @@ import ch.systemsx.cisd.openbis.generic.shared.basic.ISerializable;
 
 /**
  * Interface implemented by objects describing an input UI element (text field, combo box).
- * <p>
- * All methods of this interface are part of the Managed Properties API.
  * 
  * @author Piotr Buczek
  */
+// NOTE: All methods of this interface are part of the Managed Properties API.
 public interface IManagedInputWidgetDescription extends ISerializable
 {
 
diff --git a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedInputWidgetDescriptionFactory.java b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedInputWidgetDescriptionFactory.java
index e08874838ed..c56a8259716 100644
--- a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedInputWidgetDescriptionFactory.java
+++ b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedInputWidgetDescriptionFactory.java
@@ -20,11 +20,10 @@ import ch.systemsx.cisd.openbis.generic.shared.basic.ISerializable;
 
 /**
  * Factory for creation of instances of {@link IManagedInputWidgetDescription}.
- * <p>
- * All methods of this interface are part of the Managed Properties API.
  * 
  * @author Piotr Buczek
  */
+// NOTE: All methods of this interface are part of the Managed Properties API.
 public interface IManagedInputWidgetDescriptionFactory extends ISerializable
 {
 
diff --git a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedOutputWidgetDescription.java b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedOutputWidgetDescription.java
index 4a45a9f3aae..e647d91deb0 100644
--- a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedOutputWidgetDescription.java
+++ b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedOutputWidgetDescription.java
@@ -20,11 +20,10 @@ import ch.systemsx.cisd.openbis.generic.shared.basic.ISerializable;
 
 /**
  * Interface implemented by objects describing an output UI element (table, label).
- * <p>
- * All methods of this interface are part of the Managed Properties API.
  * 
  * @author Piotr Buczek
  */
+// NOTE: All methods of this interface are part of the Managed Properties API.
 public interface IManagedOutputWidgetDescription extends ISerializable
 {
     /**
diff --git a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedProperty.java b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedProperty.java
index e88c2d92a43..0d8c5e5e2c1 100644
--- a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedProperty.java
+++ b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedProperty.java
@@ -20,11 +20,10 @@ import ch.systemsx.cisd.openbis.generic.shared.basic.ISerializable;
 
 /**
  * Interface implemented by managed property.
- * <p>
- * All methods of this interface are part of the Managed Properties API.
  * 
  * @author Piotr Buczek
  */
+// NOTE: All methods of this interface are part of the Managed Properties API.
 public interface IManagedProperty extends ISerializable
 {
 
diff --git a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedUiAction.java b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedUiAction.java
index e2a0bdd3f67..31371e43845 100644
--- a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedUiAction.java
+++ b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedUiAction.java
@@ -22,11 +22,10 @@ import ch.systemsx.cisd.openbis.generic.shared.basic.ISerializable;
 
 /**
  * Description of action that a user can perform on the client side.
- * <p>
- * All methods of this interface are part of the Managed Properties API.
  * 
  * @author Piotr Buczek
  */
+// NOTE: All methods of this interface are part of the Managed Properties API.
 public interface IManagedUiAction extends ISerializable
 {
     /** Returns string identifier of the action. */
diff --git a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedUiDescription.java b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedUiDescription.java
index df89db8dec4..1e189d3c475 100644
--- a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedUiDescription.java
+++ b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedUiDescription.java
@@ -25,6 +25,7 @@ import ch.systemsx.cisd.openbis.generic.shared.basic.ISerializable;
  * 
  * @author Chandrasekhar Ramakrishnan
  */
+// NOTE: All methods of this interface are part of the Managed Properties API.
 public interface IManagedUiDescription extends ISerializable
 {
     /**
diff --git a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedUiTableAction.java b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedUiTableAction.java
index 6810a8e23e1..e63839c5da8 100644
--- a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedUiTableAction.java
+++ b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IManagedUiTableAction.java
@@ -27,12 +27,11 @@ import java.util.Map;
  * <p>
  * For actions that require single row to be selected it is possible to bind values of selected
  * row's columns with input fields (e.g. useful in edit actions).
- * <p>
- * All methods of this interface are part of the Managed Properties API.
  * 
  * @see ManagedTableActionRowSelectionType
  * @author Piotr Buczek
  */
+// NOTE: All methods of this interface are part of the Managed Properties API.
 public interface IManagedUiTableAction extends IManagedUiAction
 {
     /** Returns selection type specifying when the action should be enabled. */
diff --git a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IPerson.java b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IPerson.java
index 593c44a8a6f..7837acf7a49 100644
--- a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IPerson.java
+++ b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/IPerson.java
@@ -20,11 +20,10 @@ import ch.systemsx.cisd.openbis.generic.shared.basic.ISerializable;
 
 /**
  * Representation of a user, e.g. one who modifies a property.
- * <p>
- * <b>All methods of this interface are part of the Managed Properties API.</b>
  * 
  * @author Piotr Buczek
  */
+// NOTE: All methods of this interface are part of the Managed Properties API.
 public interface IPerson extends ISerializable
 {
     /** @return id of the user */
diff --git a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/ITableModel.java b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/ITableModel.java
index c9d232c672f..882014a3aca 100644
--- a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/ITableModel.java
+++ b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/ITableModel.java
@@ -20,11 +20,10 @@ import ch.systemsx.cisd.openbis.generic.shared.basic.ISerializable;
 
 /**
  * Interface implemented by table models.
- * <p>
- * NOTE: For now the interface is empty. It was introduced not to expose internal API.
  * 
  * @author Piotr Buczek
  */
+// NOTE: For now the interface is empty. It was introduced not to expose internal API
 public interface ITableModel extends ISerializable
 {
 
diff --git a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/ManagedInputFieldType.java b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/ManagedInputFieldType.java
index 69956c101c1..6d472aa58b2 100644
--- a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/ManagedInputFieldType.java
+++ b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/ManagedInputFieldType.java
@@ -19,10 +19,9 @@ package ch.systemsx.cisd.openbis.generic.shared.basic.dto.api;
 import ch.systemsx.cisd.openbis.generic.shared.basic.ISerializable;
 
 /**
- * NOTE: This enumeration is part of the Managed Properties API.
- * 
  * @author Chandrasekhar Ramakrishnan
  */
+// NOTE: This enumeration is part of the Managed Properties API.
 public enum ManagedInputFieldType implements ISerializable
 {
     TEXT, MULTILINE_TEXT, COMBO_BOX
diff --git a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/ManagedOutputWidgetType.java b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/ManagedOutputWidgetType.java
index fb2d438dca9..60187549004 100644
--- a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/ManagedOutputWidgetType.java
+++ b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/ManagedOutputWidgetType.java
@@ -19,10 +19,9 @@ package ch.systemsx.cisd.openbis.generic.shared.basic.dto.api;
 import ch.systemsx.cisd.openbis.generic.shared.basic.ISerializable;
 
 /**
- * NOTE: This enumeration is part of the Managed Properties API.
- * 
  * @author Piotr Buczek
  */
+// NOTE: This enumeration is part of the Managed Properties API.
 public enum ManagedOutputWidgetType implements ISerializable
 {
     TABLE, LABEL;
diff --git a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/ManagedTableActionRowSelectionType.java b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/ManagedTableActionRowSelectionType.java
index 1f8fdccddbc..26e139bb033 100644
--- a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/ManagedTableActionRowSelectionType.java
+++ b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/basic/dto/api/ManagedTableActionRowSelectionType.java
@@ -20,11 +20,10 @@ import ch.systemsx.cisd.openbis.generic.shared.basic.ISerializable;
 
 /**
  * Selection modes of table actions.
- * <p>
- * NOTE: This enumeration is part of the Managed Properties API.
  * 
  * @author Piotr Buczek
  */
+// NOTE: This enumeration is part of the Managed Properties API.
 public enum ManagedTableActionRowSelectionType implements ISerializable
 {
     /** e.g. create/add action */
diff --git a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/EntityLinkElementKind.java b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/EntityLinkElementKind.java
index 637a59ab57d..1cc88d3e6d7 100644
--- a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/EntityLinkElementKind.java
+++ b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/EntityLinkElementKind.java
@@ -18,11 +18,10 @@ package ch.systemsx.cisd.openbis.generic.shared.managed_property.api;
 
 /**
  * The type of an entity link.
- * <p>
- * NOTE: This enumeration is part of the Managed Properties API.
  * 
  * @author Kaloyan Enimanev
  */
+// NOTE: This enum is part of the Managed Properties API.
 public enum EntityLinkElementKind
 {
 
diff --git a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/IElement.java b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/IElement.java
index f5c35b29838..3fb13c82324 100644
--- a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/IElement.java
+++ b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/IElement.java
@@ -26,12 +26,11 @@ import java.util.Map;
  * <p>
  * {@link IElement}-s are meant to be used as a convenient, hierarchical property-value persistence
  * technique for managed properties.
- * <p>
- * <b>All methods of this interface are part of the Managed Properties API.</b>
  * 
  * @author Piotr Buczek
  * @author Kaloyan Enimanev
  */
+// NOTE: All methods of this interface are part of the Managed Properties API.
 public interface IElement
 {
 
diff --git a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/IElementFactory.java b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/IElementFactory.java
index d78be893ad8..ca1ea3bb521 100644
--- a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/IElementFactory.java
+++ b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/IElementFactory.java
@@ -18,11 +18,10 @@ package ch.systemsx.cisd.openbis.generic.shared.managed_property.api;
 
 /**
  * Contains helper method to construct {@link IElement} instances.
- * <p>
- * <b>All methods of this enum are part of the Managed Properties API.</b>
  * 
  * @author Kaloyan Enimanev
  */
+// NOTE: All methods of this interface are part of the Managed Properties API.
 public interface IElementFactory
 {
 
diff --git a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/IEntityInformationProvider.java b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/IEntityInformationProvider.java
index 75f64702669..347af160395 100644
--- a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/IEntityInformationProvider.java
+++ b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/IEntityInformationProvider.java
@@ -18,11 +18,10 @@ package ch.systemsx.cisd.openbis.generic.shared.managed_property.api;
 
 /**
  * Provides required information about entities.
- * <p>
- * <b>All methods of this enum are part of the Managed Properties API.</b>
  * 
  * @author Piotr Buczek
  */
+// NOTE: All methods of this interface are part of the Managed Properties API.
 public interface IEntityInformationProvider
 {
     /**
diff --git a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/IEntityLinkElement.java b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/IEntityLinkElement.java
index 391ceef7d68..9aed6a98b70 100644
--- a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/IEntityLinkElement.java
+++ b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/IEntityLinkElement.java
@@ -18,11 +18,10 @@ package ch.systemsx.cisd.openbis.generic.shared.managed_property.api;
 
 /**
  * Denotes a link to an entity in the openBIS database.
- * <p>
- * <b>All methods of this enum are part of the Managed Properties API.</b>
  * 
  * @author Kaloyan Enimanev
  */
+// NOTE: All methods of this interface are part of the Managed Properties API.
 public interface IEntityLinkElement extends IElement
 {
     /**
diff --git a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/IRowBuilderAdaptor.java b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/IRowBuilderAdaptor.java
index 591de197394..19a7d8d3dde 100644
--- a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/IRowBuilderAdaptor.java
+++ b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/IRowBuilderAdaptor.java
@@ -20,12 +20,11 @@ import java.util.Date;
 
 /**
  * Builder of a row of a simple table.
- * <p>
- * <b>All methods of this enum are part of the Managed Properties API.</b>
  * 
  * @see ISimpleTableModelBuilderAdaptor
  * @author Piotr Buczek
  */
+// NOTE: All methods of this interface are part of the Managed Properties API.
 public interface IRowBuilderAdaptor
 {
 
diff --git a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/ISimpleTableModelBuilderAdaptor.java b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/ISimpleTableModelBuilderAdaptor.java
index 0ab800943b7..540fe223c71 100644
--- a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/ISimpleTableModelBuilderAdaptor.java
+++ b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/ISimpleTableModelBuilderAdaptor.java
@@ -21,11 +21,10 @@ import ch.systemsx.cisd.openbis.generic.shared.basic.dto.api.ITableModel;
 
 /**
  * Builder of simple table models. All column titles should be unique.
- * <p>
- * <b>All methods of this enum are part of the Managed Properties API.</b>
  * 
  * @author Piotr Buczek
  */
+// NOTE: All methods of this interface are part of the Managed Properties API.
 public interface ISimpleTableModelBuilderAdaptor
 {
 
diff --git a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/IStructuredPropertyConverter.java b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/IStructuredPropertyConverter.java
index a7c63ee69c3..04bb8861f6a 100644
--- a/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/IStructuredPropertyConverter.java
+++ b/openbis/source/java/ch/systemsx/cisd/openbis/generic/shared/managed_property/api/IStructuredPropertyConverter.java
@@ -23,11 +23,10 @@ import ch.systemsx.cisd.openbis.generic.shared.managed_property.structured.Eleme
 
 /**
  * Abstracts the conversion of {@link Element} objects to/from database strings.
- * <p>
- * <b>All methods of this enum are part of the Managed Properties API.</b>
  * 
  * @author Kaloyan Enimanev
  */
+// NOTE: All methods of this interface are part of the Managed Properties API.
 public interface IStructuredPropertyConverter
 {
     /**
-- 
GitLab