You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@nlpcraft.apache.org by ar...@apache.org on 2022/08/23 18:51:11 UTC

[incubator-nlpcraft] branch master updated: Update NCEntity.scala

This is an automated email from the ASF dual-hosted git repository.

aradzinski pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/incubator-nlpcraft.git


The following commit(s) were added to refs/heads/master by this push:
     new 3591a085 Update NCEntity.scala
3591a085 is described below

commit 3591a08502932016cd1455c1faeaecb16c9aeb4f
Author: Aaron Radzinski <ar...@datalingvo.com>
AuthorDate: Tue Aug 23 11:51:06 2022 -0700

    Update NCEntity.scala
---
 .../main/scala/org/apache/nlpcraft/NCEntity.scala  | 43 ++++++++++++----------
 1 file changed, 24 insertions(+), 19 deletions(-)

diff --git a/nlpcraft/src/main/scala/org/apache/nlpcraft/NCEntity.scala b/nlpcraft/src/main/scala/org/apache/nlpcraft/NCEntity.scala
index f3b27426..96c77bd1 100644
--- a/nlpcraft/src/main/scala/org/apache/nlpcraft/NCEntity.scala
+++ b/nlpcraft/src/main/scala/org/apache/nlpcraft/NCEntity.scala
@@ -18,57 +18,62 @@
 package org.apache.nlpcraft
 
 /**
-  * An entity is a collection if one or more {@link NCToken tokens}. An entity typically has a
+  * An entity is a collection if one or more [[NCToken tokens]]. An entity typically has a
   * consistent semantic meaning and usually denotes a real-world object, such as persons, locations, number,
   * date and time, organizations, products, etc. - where such objects can be abstract or have a physical existence.
-  * Entities are produced by {@link NCEntityParser}. See {@link NCPipeline} for documentation on the entities in the
+  * Entities are produced by [[NCEntityParser]]. See [[NCPipeline]] for documentation on the entities in the
   * overall processing pipeline.
   *
-  * <span class="hdr">Metadata</span>
-  * Note that both {@link NCToken} and {@link NCEntity} interfaces extend {@link NCPropertyMap} interface
+  * Note that both [[NCToken]] and [[NCEntity]] interfaces extend [[NCPropertyMap]] trait
   * that allows them to store custom metadata properties. Parser, enrichers and validators for tokens
   * and entities use this capability to store and check their properties in tokens and entities.
   *
-  * @see NCEntity
-  * @see NCToken
-  * @see NCTokenParser
-  * @see NCTokenEnricher
-  * @see NCTokenValidator
-  * @see NCEntityParser
-  * @see NCEntityEnricher
-  * @see NCEntityValidator
-  * @see NCEntityMapper */
+  * @see [[NCEntity]]
+  * @see [[NCToken]]
+  * @see [[NCTokenParser]]
+  * @see [[NCTokenEnricher]]
+  * @see [[NCTokenValidator]]
+  * @see [[NCEntityParser]]
+  * @see [[NCEntityEnricher]]
+  * @see [[NCEntityValidator]]
+  * @see [[NCEntityMapper]]
+  */
 trait NCEntity extends NCPropertyMap:
 
     /**
       * Gets the list of tokens this entity is comprised of. Returned list is never empty or `null`.
       *
-      * @return List of tokens that are part of this entity. */
+      * @return List of tokens that are part of this entity.
+      */
     def getTokens: List[NCToken]
 
     /**
       * Joins all tokens' text with trimming using space as a delimiter. This function does not cache the
       * result and performs text construction on each call. Make sure to cache the result to avoid
-      * unnecessary parasitic workload if and when method {@link # getTokens ( )} does not change.
+      * unnecessary parasitic workload if and when method [[getTokens]] does not change.
       *
       * @return Constructed text value representation of this entity. Note that returned value is not
-      * cached and created anew every time this method is called. */
+      *     cached and created anew every time this method is called.
+      */
     def mkText: String = getTokens.map(_.getText.trim).mkString(" ").trim
 
     /**
       * Gets ID of the request this entity is part of.
       *
-      * @return ID of the request this entity is part of. */
+      * @return ID of the request this entity is part of.
+      */
     def getRequestId: String
 
     /**
       * Gets optional set of groups this entity belongs to.
       *
-      * @return Optional set of groups this entity belongs to. Returned set can be empty but never `null`. */
+      * @return Optional set of groups this entity belongs to. Returned set can be empty but never `null`.
+      */
     def getGroups: Set[String] = Set(getId)
 
     /**
       * Gets globally unique ID of this entity.
       *
-      * @return Globally unique ID of this entity. */
+      * @return Globally unique ID of this entity.
+      */
     def getId: String