[jira] [Created] (STORM-3937) Fix errors/warnings found while generating javadoc in storm-starter

2023-07-14 Thread Bipin Prasad (Jira)
Bipin Prasad created STORM-3937:
---

 Summary: Fix errors/warnings found while generating javadoc in 
storm-starter
 Key: STORM-3937
 URL: https://issues.apache.org/jira/browse/STORM-3937
 Project: Apache Storm
  Issue Type: Task
  Components: storm-starter
Reporter: Bipin Prasad
Assignee: Bipin Prasad


[INFO] [WARNING] Javadoc Warnings
[INFO] [WARNING] 
./storm/examples/storm-starter/src/jvm/org/apache/storm/starter/tools/SlidingWindowCounter.java:63:
 warning - Tag @link: reference not found: PeriodicSlidingWindowCounter



--
This message was sent by Atlassian Jira
(v8.20.10#820010)


[jira] [Created] (STORM-3936) Fix errors/warnings found while generating javadoc in storm-kafka-client

2023-07-14 Thread Bipin Prasad (Jira)
Bipin Prasad created STORM-3936:
---

 Summary: Fix errors/warnings found while generating javadoc in 
storm-kafka-client
 Key: STORM-3936
 URL: https://issues.apache.org/jira/browse/STORM-3936
 Project: Apache Storm
  Issue Type: Task
  Components: storm-kafka-client
Reporter: Bipin Prasad
Assignee: Bipin Prasad


{code:java}
[INFO] [WARNING] Javadoc Warnings
[INFO] [WARNING] 
./storm/external/storm-kafka-client/src/main/java/org/apache/storm/kafka/spout/KafkaTuple.java:27:
 warning - Tag @see cannot be used in inline documentation.  It can only be 
used in the following types of documentation: overview, package, 
class/interface, constructor, field, method.
[INFO] [WARNING] 
./storm/external/storm-kafka-client/src/main/java/org/apache/storm/kafka/spout/KafkaTuple.java:27:
 warning - Tag @see cannot be used in inline documentation.  It can only be 
used in the following types of documentation: overview, package, 
class/interface, constructor, field, method.
[INFO] [WARNING] 
./storm/external/storm-kafka-client/src/main/java/org/apache/storm/kafka/spout/subscription/TopicAssigner.java:40:
 warning - @param argument "K" is not a parameter name.
[INFO] [WARNING] 
./storm/external/storm-kafka-client/src/main/java/org/apache/storm/kafka/spout/subscription/TopicAssigner.java:40:
 warning - @param argument "V" is not a parameter name.
[INFO] [WARNING] 
./storm/external/storm-kafka-client/src/main/java/org/apache/storm/kafka/bolt/KafkaBolt.java:71:
 warning - Tag @see cannot be used in inline documentation.  It can only be 
used in the following types of documentation: overview, package, 
class/interface, constructor, field, method.
[INFO] [WARNING] 
./storm/external/storm-kafka-client/src/main/java/org/apache/storm/kafka/bolt/KafkaBolt.java:71:
 warning - Tag @see cannot be used in inline documentation.  It can only be 
used in the following types of documentation: overview, package, 
class/interface, constructor, field, method.
[INFO] [WARNING] 
./storm/external/storm-kafka-client/src/main/java/org/apache/storm/kafka/bolt/KafkaBolt.java:75:
 warning - Tag @see cannot be used in inline documentation.  It can only be 
used in the following types of documentation: overview, package, 
class/interface, constructor, field, method.
[INFO] [WARNING] 
./storm/external/storm-kafka-client/src/main/java/org/apache/storm/kafka/bolt/KafkaBolt.java:75:
 warning - Tag @see cannot be used in inline documentation.  It can only be 
used in the following types of documentation: overview, package, 
class/interface, constructor, field, method.
 {code}



--
This message was sent by Atlassian Jira
(v8.20.10#820010)


[jira] [Created] (STORM-3935) Fix errors/warnings found while generating javadoc in storm-cassandra

2023-07-14 Thread Bipin Prasad (Jira)
Bipin Prasad created STORM-3935:
---

 Summary: Fix errors/warnings found while generating javadoc in 
storm-cassandra
 Key: STORM-3935
 URL: https://issues.apache.org/jira/browse/STORM-3935
 Project: Apache Storm
  Issue Type: Task
  Components: storm-cassandra
Reporter: Bipin Prasad
Assignee: Bipin Prasad


{code:java}
[INFO] [WARNING] Javadoc Warnings
[INFO] [WARNING] 
./storm/external/storm-cassandra/src/main/java/org/apache/storm/cassandra/context/WorkerCtx.java:73:
 warning - Tag @link: reference not found: T
[INFO] [WARNING] 
./storm/external/storm-cassandra/src/main/java/org/apache/storm/cassandra/query/impl/ObjectMapperCqlStatementMapper.java:40:
 warning - Tag @link: reference not found: 
com.datastax.driver.mapping.annotations.Table
[INFO] [WARNING] 
./storm/external/storm-cassandra/src/main/java/org/apache/storm/cassandra/query/builder/ObjectMapperCqlStatementMapperBuilder.java:33:
 warning - Tag @link: reference not found: 
com.datastax.driver.mapping.annotations.Table
[INFO] [WARNING] 
./storm/external/storm-cassandra/src/main/java/org/apache/storm/cassandra/query/builder/ObjectMapperCqlStatementMapperBuilder.java:33:
 warning - Tag @link: reference not found: 
com.datastax.driver.mapping.annotations.Table
[INFO] [WARNING] 
./storm/external/storm-cassandra/src/main/java/org/apache/storm/cassandra/query/impl/ObjectMapperCqlStatementMapper.java:40:
 warning - Tag @link: reference not found: 
com.datastax.driver.mapping.annotations.Table
[INFO] [WARNING] 
./storm/external/storm-cassandra/src/main/java/org/apache/storm/cassandra/query/impl/ObjectMapperCqlStatementMapper.java:40:
 warning - Tag @link: reference not found: 
com.datastax.driver.mapping.annotations.Table
[INFO] [WARNING] 
./storm/external/storm-cassandra/src/main/java/org/apache/storm/cassandra/query/builder/ObjectMapperCqlStatementMapperBuilder.java:33:
 warning - Tag @link: reference not found: 
com.datastax.driver.mapping.annotations.Table
[INFO] [WARNING] 
./storm/external/storm-cassandra/src/main/java/org/apache/storm/cassandra/query/builder/ObjectMapperCqlStatementMapperBuilder.java:33:
 warning - Tag @link: reference not found: 
com.datastax.driver.mapping.annotations.Table
[INFO] [WARNING] 
./storm/external/storm-cassandra/src/main/java/org/apache/storm/cassandra/query/impl/ObjectMapperCqlStatementMapper.java:40:
 warning - Tag @link: reference not found: 
com.datastax.driver.mapping.annotations.Table
[INFO] [WARNING] 
./storm/external/storm-cassandra/src/main/java/org/apache/storm/cassandra/query/impl/ObjectMapperCqlStatementMapper.java:40:
 warning - Tag @link: reference not found: 
com.datastax.driver.mapping.annotations.Table
[INFO] [WARNING] 
./storm/external/storm-cassandra/src/main/java/org/apache/storm/cassandra/query/builder/ObjectMapperCqlStatementMapperBuilder.java:33:
 warning - Tag @link: reference not found: 
com.datastax.driver.mapping.annotations.Table
 {code}



--
This message was sent by Atlassian Jira
(v8.20.10#820010)


[jira] [Created] (STORM-3934) Fix errors/warnings found while generating javadoc in storm-webapps

2023-07-14 Thread Bipin Prasad (Jira)
Bipin Prasad created STORM-3934:
---

 Summary: Fix errors/warnings found while generating javadoc in 
storm-webapps
 Key: STORM-3934
 URL: https://issues.apache.org/jira/browse/STORM-3934
 Project: Apache Storm
  Issue Type: Task
  Components: storm-webapp
Reporter: Bipin Prasad
Assignee: Bipin Prasad


{code:java}
[INFO] [WARNING] Javadoc Warnings
[INFO] [WARNING] javadoc: warning - Multiple sources of package comments found 
for package "javax.servlet"
[INFO] [WARNING] javadoc: warning - Multiple sources of package comments found 
for package "javax.servlet.http"
[INFO] [WARNING] 
./storm/storm-webapp/src/main/java/org/apache/storm/daemon/utils/StreamUtil.java:40:
 warning - Tag @see:illegal character: "123" in "{@link 
java.io.FileInputStream#skip(long)}"
[INFO] [WARNING] 
./storm/storm-webapp/src/main/java/org/apache/storm/daemon/utils/StreamUtil.java:40:
 warning - Tag @see:illegal character: "64" in "{@link 
java.io.FileInputStream#skip(long)}"
[INFO] [WARNING] 
./storm/storm-webapp/src/main/java/org/apache/storm/daemon/utils/ListFunctionalSupport.java:104:
 warning - Tag @see:illegal character: "123" in "{@link 
ListFunctionalSupport#drop(List, int)}"
[INFO] [WARNING] 
./storm/storm-webapp/src/main/java/org/apache/storm/daemon/utils/ListFunctionalSupport.java:104:
 warning - Tag @see:illegal character: "64" in "{@link 
ListFunctionalSupport#drop(List, int)}"
[INFO] [WARNING] 
./storm/storm-webapp/src/main/java/org/apache/storm/daemon/logviewer/handler/LogviewerProfileHandler.java:112:
 warning - Tag @see:illegal character: "123" in "{@link 
org.apache.storm.daemon.logviewer.utils.LogFileDownloader#downloadFile(String, 
String, String, boolean)}"
[INFO] [WARNING] 
./storm/storm-webapp/src/main/java/org/apache/storm/daemon/logviewer/handler/LogviewerProfileHandler.java:112:
 warning - Tag @see:illegal character: "64" in "{@link 
org.apache.storm.daemon.logviewer.utils.LogFileDownloader#downloadFile(String, 
String, String, boolean)}"
[INFO] [WARNING] 
./storm/storm-webapp/src/main/java/org/apache/storm/daemon/logviewer/handler/LogviewerLogDownloadHandler.java:58:
 warning - Tag @see:illegal character: "123" in "{@link 
LogFileDownloader#downloadFile(String, String, String, boolean)}"
[INFO] [WARNING] 
./storm/storm-webapp/src/main/java/org/apache/storm/daemon/logviewer/handler/LogviewerLogDownloadHandler.java:58:
 warning - Tag @see:illegal character: "64" in "{@link 
LogFileDownloader#downloadFile(String, String, String, boolean)}"
[INFO] [WARNING] 
./storm/storm-webapp/src/main/java/org/apache/storm/daemon/logviewer/handler/LogviewerLogDownloadHandler.java:72:
 warning - Tag @see:illegal character: "123" in "{@link 
LogFileDownloader#downloadFile(String, String, String, boolean)}"
[INFO] [WARNING] 
./storm/storm-webapp/src/main/java/org/apache/storm/daemon/logviewer/handler/LogviewerLogDownloadHandler.java:72:
 warning - Tag @see:illegal character: "64" in "{@link 
LogFileDownloader#downloadFile(String, String, String, boolean)}"
[INFO] [WARNING] 
./storm/storm-webapp/src/main/java/org/apache/storm/daemon/logviewer/utils/LogviewerResponseBuilder.java:70:
 warning - Tag @see:illegal character: "123" in "{@link JsonResponseBuilder}"
[INFO] [WARNING] 
./storm/storm-webapp/src/main/java/org/apache/storm/daemon/logviewer/utils/LogviewerResponseBuilder.java:70:
 warning - Tag @see:illegal character: "64" in "{@link JsonResponseBuilder}"
[INFO] [WARNING] 
./storm/storm-webapp/src/main/java/org/apache/storm/daemon/utils/ListFunctionalSupport.java:104:
 warning - Tag @see:illegal character: "123" in "{@link 
ListFunctionalSupport#drop(List, int)}"
[INFO] [WARNING] 
./storm/storm-webapp/src/main/java/org/apache/storm/daemon/utils/ListFunctionalSupport.java:104:
 warning - Tag @see:illegal character: "64" in "{@link 
ListFunctionalSupport#drop(List, int)}"
[INFO] [WARNING] 
./storm/storm-webapp/src/main/java/org/apache/storm/daemon/utils/ListFunctionalSupport.java:104:
 warning - Tag @see: reference not found: {@link 
ListFunctionalSupport#drop(List, int)}
[INFO] [WARNING] 
./storm/storm-webapp/src/main/java/org/apache/storm/daemon/utils/StreamUtil.java:40:
 warning - Tag @see:illegal character: "123" in "{@link 
java.io.FileInputStream#skip(long)}"
[INFO] [WARNING] 
./storm/storm-webapp/src/main/java/org/apache/storm/daemon/utils/StreamUtil.java:40:
 warning - Tag @see:illegal character: "64" in "{@link 
java.io.FileInputStream#skip(long)}"
[INFO] [WARNING] 
./storm/storm-webapp/src/main/java/org/apache/storm/daemon/utils/StreamUtil.java:40:
 warning - Tag @see: reference not found: {@link 
java.io.FileInputStream#skip(long)}
[INFO] [WARNING] 
./storm/storm-webapp/src/main/java/org/apache/storm/daemon/logviewer/handler/LogviewerLogDownloadHandler.java:58:
 warning - Tag @see:illegal character: "123" in "{@li

[jira] [Assigned] (STORM-3931) @see tags that are followed by {@link...}

2023-07-14 Thread Bipin Prasad (Jira)


 [ 
https://issues.apache.org/jira/browse/STORM-3931?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Bipin Prasad reassigned STORM-3931:
---

Assignee: Bipin Prasad

> @see tags that are followed by {@link...}
> -
>
> Key: STORM-3931
> URL: https://issues.apache.org/jira/browse/STORM-3931
> Project: Apache Storm
>  Issue Type: Task
>  Components: documentation
>Reporter: Bipin Prasad
>Assignee: Bipin Prasad
>Priority: Major
>
> @see tags have been deprected in JDK9 in favor of @link tags.
> In Storm, several source files contain improperly formatted '@see' tags. This 
> tag expects class name otherwise generates error for unexpected "{" - 
> character code 123 and "@", character code 64. When generating javadoc.
> {code:java}
> [INFO] [WARNING] 
> .../storm/storm-client/src/jvm/org/apache/storm/utils/DefaultShellLogHandler.java:51:
>  warning - Tag @see:illegal character: "123" in "{@link 
> ShellLogHandler#setUpContext}"
> [INFO] [WARNING] 
> .../storm/storm-client/src/jvm/org/apache/storm/utils/DefaultShellLogHandler.java:51:
>  warning - Tag @see:illegal character: "64" in "{@link 
> ShellLogHandler#setUpContext}"
> [INFO] [WARNING] 
> .../storm/storm-client/src/jvm/org/apache/storm/utils/DefaultShellLogHandler.java:51:
>  warning - Tag @see: reference not found: "{@link 
> ShellLogHandler#setUpContext}"
> {code}
> For example
> storm-client/src/jvm/org/apache/storm/utils/DefaultShellLogHandler.java#setUpContext
> {code:java}
> /**
>  * This default implementation saves the {@link ShellProcess} so it can 
> output the process info string later.
>  *
>  * @param ownerCls - the class which instantiated this ShellLogHandler.
>  * @param process  - the current {@link ShellProcess}.
>  * @param context  - the current {@link TopologyContext}.
>  * @see {@link ShellLogHandler#setUpContext}
>  */
>  {code}
> Should just be rolled into the documentation thusly:
> {code:java}
> /**
>  * This default implementation saves the {@link ShellProcess} so it can 
> output the process info string later. See {@link 
> ShellLogHandler#setUpContext}.
>  *
>  * @param ownerCls - the class which instantiated this ShellLogHandler.
>  * @param process  - the current {@link ShellProcess}.
>  * @param context  - the current {@link TopologyContext}.
>  */
>  {code}
> or
> {code:java}
> /**
>  * This default implementation saves the {@link ShellProcess} so it can 
> output the process info string later.
>  *
>  * @param ownerCls - the class which instantiated this ShellLogHandler.
>  * @param process  - the current {@link ShellProcess}.
>  * @param context  - the current {@link TopologyContext}.
>  * @see ShellLogHandler#setUpContext
>  */
>  {code}



--
This message was sent by Atlassian Jira
(v8.20.10#820010)


[jira] [Assigned] (STORM-3932) Fix errors/warnings found while generating javadoc

2023-07-14 Thread Bipin Prasad (Jira)


 [ 
https://issues.apache.org/jira/browse/STORM-3932?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Bipin Prasad reassigned STORM-3932:
---

Assignee: Bipin Prasad

> Fix errors/warnings found while generating javadoc
> --
>
> Key: STORM-3932
> URL: https://issues.apache.org/jira/browse/STORM-3932
> Project: Apache Storm
>  Issue Type: Task
>  Components: storm-client
>Reporter: Bipin Prasad
>Assignee: Bipin Prasad
>Priority: Minor
>
> In Storm-client
> {code:java}
> [INFO] [WARNING] Javadoc Warnings
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/utils/DefaultShellLogHandler.java:51:
>  warning - Tag @see:illegal character: "123" in "{@link 
> ShellLogHandler#setUpContext}"
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/utils/DefaultShellLogHandler.java:51:
>  warning - Tag @see:illegal character: "64" in "{@link 
> ShellLogHandler#setUpContext}"
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/utils/DefaultShellLogHandler.java:66:
>  warning - Tag @see:illegal character: "123" in "{@link ShellLogHandler#log}"
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/utils/DefaultShellLogHandler.java:66:
>  warning - Tag @see:illegal character: "64" in "{@link ShellLogHandler#log}"
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/Config.java:139: warning - 
> @deprecated: is an unknown tag.
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/Config.java:875: warning - 
> Tag @link: reference not found: 
> org.apache.storm.scheduler.multitenant.MultitenantScheduler
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/Config.java:875: warning - 
> Tag @link: reference not found: 
> org.apache.storm.scheduler.multitenant.MultitenantScheduler
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/Config.java:875: warning - 
> Tag @link: reference not found: 
> org.apache.storm.scheduler.resource.ResourceAwareScheduler
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/Config.java:875: warning - 
> Tag @link: reference not found: 
> org.apache.storm.scheduler.resource.strategies.scheduling.RoundRobinResourceAwareStrategy
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/Config.java:1275: warning - 
> @Deprecated is an unknown tag -- same as a known tag except for case.
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/Config.java:1282: warning - 
> @Deprecated is an unknown tag -- same as a known tag except for case.
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/ILocalCluster.java:82: 
> warning - @param argument "topologyName" is not a parameter name.
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/ILocalCluster.java:206: 
> warning - @param argument "steps" is not a parameter name.
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/topology/TopologyBuilder.java:319:
>  warning - @param argument "T" is not a parameter name.
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/topology/TopologyBuilder.java:339:
>  warning - @param argument "T" is not a parameter name.
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/cluster/IStateStorage.java:69:
>  warning - @return tag cannot be used in method with void return type.
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:68:
>  warning - Tag @link: reference not found: LeaderListenerCallback
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:68:
>  warning - Tag @link: reference not found: LeaderListenerCallback
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:156:
>  warning - @deprecated: is an unknown tag.
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:184:
>  warning - @deprecated: is an unknown tag.
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:191:
>  warning - @deprecated: is an unknown tag.
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:198:
>  warning - @deprecated: is an unknown tag.
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:205:
>  warning - @deprecated: is an unknown tag.
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:68:
>  warning - Tag @link: reference not found: LeaderListenerCallback
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/cluster

[jira] [Assigned] (STORM-3933) Fix errors/warnings found while generating javadoc in storm-server

2023-07-14 Thread Bipin Prasad (Jira)


 [ 
https://issues.apache.org/jira/browse/STORM-3933?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Bipin Prasad reassigned STORM-3933:
---

Assignee: Bipin Prasad

> Fix errors/warnings found while generating javadoc in storm-server
> --
>
> Key: STORM-3933
> URL: https://issues.apache.org/jira/browse/STORM-3933
> Project: Apache Storm
>  Issue Type: Task
>  Components: storm-server
>Reporter: Bipin Prasad
>Assignee: Bipin Prasad
>Priority: Minor
>
> {code:java}
> [INFO] [WARNING] Javadoc Warnings
> [INFO] [WARNING] 
> ./storm/storm-server/src/main/java/org/apache/storm/scheduler/resource/strategies/scheduling/BaseResourceAwareStrategy.java:61:
>  warning - Tag @link: can't find NodeSorter(Cluster, TopologyDetails, 
> NodeSortType) in 
> org.apache.storm.scheduler.resource.strategies.scheduling.sorter.NodeSorter
> [INFO] [WARNING] 
> ./storm/storm-server/src/main/java/org/apache/storm/scheduler/resource/strategies/scheduling/ObjectResourcesItem.java:42:
>  warning - Tag @link: reference not found: 
> NodeSorter#sortObjectResourcesCommon(ObjectResourcesSummary, ExecutorDetails, 
> NodeSorter.ExistingScheduleFunc)
> [INFO] [WARNING] 
> ./storm/storm-server/src/main/java/org/apache/storm/scheduler/resource/strategies/scheduling/ObjectResourcesItem.java:55:
>  warning - Tag @link: reference not found: 
> NodeSorter#sortObjectResourcesCommon(ObjectResourcesSummary, ExecutorDetails, 
> NodeSorter.ExistingScheduleFunc)
> [INFO] [WARNING] 
> ./storm/storm-server/src/main/java/org/apache/storm/scheduler/resource/strategies/scheduling/sorter/NodeSorter.java:92:
>  warning - Tag @link: reference not found: 
> BaseResourceAwareStrategy.NodeSortType#GENERIC_RAS
> [INFO] [WARNING] 
> ./storm/storm-server/src/main/java/org/apache/storm/scheduler/resource/strategies/scheduling/sorter/NodeSorter.java:92:
>  warning - Tag @link: reference not found: 
> BaseResourceAwareStrategy.NodeSortType#DEFAULT_RAS
> [INFO] [WARNING] 
> ./storm/storm-server/src/main/java/org/apache/storm/scheduler/resource/strategies/scheduling/sorter/NodeSorter.java:92:
>  warning - Tag @link: reference not found: 
> BaseResourceAwareStrategy.NodeSortType#COMMON
> [INFO] [WARNING] 
> ./storm/storm-server/src/main/java/org/apache/storm/scheduler/resource/strategies/scheduling/sorter/NodeSorter.java:92:
>  warning - Tag @link: reference not found: 
> BaseResourceAwareStrategy.NodeSortType
> [INFO] [WARNING] 
> ./storm/storm-server/src/main/java/org/apache/storm/scheduler/resource/strategies/scheduling/sorter/NodeSorterHostProximity.java:97:
>  warning - Tag @link: reference not found: 
> BaseResourceAwareStrategy.NodeSortType#GENERIC_RAS
> [INFO] [WARNING] 
> ./storm/storm-server/src/main/java/org/apache/storm/scheduler/resource/strategies/scheduling/sorter/NodeSorterHostProximity.java:97:
>  warning - Tag @link: reference not found: 
> BaseResourceAwareStrategy.NodeSortType#DEFAULT_RAS
> [INFO] [WARNING] 
> ./storm/storm-server/src/main/java/org/apache/storm/scheduler/resource/strategies/scheduling/sorter/NodeSorterHostProximity.java:97:
>  warning - Tag @link: reference not found: 
> BaseResourceAwareStrategy.NodeSortType#COMMON
> [INFO] [WARNING] 
> ./storm/storm-server/src/main/java/org/apache/storm/scheduler/resource/strategies/scheduling/sorter/NodeSorterHostProximity.java:97:
>  warning - Tag @link: reference not found: 
> BaseResourceAwareStrategy.NodeSortType
> [INFO] [WARNING] 
> ./storm/storm-server/src/main/java/org/apache/storm/utils/EnumUtil.java:33:
>  warning - @param argument "T" is not a parameter name.
> [INFO] [WARNING] 
> ./storm/storm-server/src/main/java/org/apache/storm/utils/EnumUtil.java:33:
>  warning - @param argument "U" is not a parameter name.
> [INFO] [WARNING] 
> ./storm/storm-server/src/main/java/org/apache/storm/nimbus/AssignmentDistributionService.java:112:
>  warning - @param argument "callback" is not a parameter name.
> [INFO] [WARNING] 
> ./storm/storm-server/src/main/java/org/apache/storm/nimbus/AssignmentDistributionService.java:200:
>  warning - Tag @link: reference not found: NodeAssignments
> [INFO] [WARNING] 
> ./storm/storm-server/src/main/java/org/apache/storm/nimbus/LeaderListenerCallback.java:81:
>  warning - @LeaderListenerCallback is an unknown tag.
> [INFO] [WARNING] 
> ./storm/storm-server/src/main/java/org/apache/storm/nimbus/LeaderListenerCallback.java:81:
>  warning - @LeaderListenerCallback is an unknown tag.
> [INFO] [WARNING] 
> ./storm/storm-server/src/main/java/org/apache/storm/nimbus/LeaderListenerCallback.java:81:
>  warning - @LeaderListenerCallback is an unknown tag.
> [INFO] [WARNING] 
> ./storm/storm-server/src/main/java/org/apache/storm/metric/timed/TimerDecorated.java:30:
>  warning - Tag 

[jira] [Updated] (STORM-3933) Fix errors/warnings found while generating javadoc in storm-server

2023-07-14 Thread Bipin Prasad (Jira)


 [ 
https://issues.apache.org/jira/browse/STORM-3933?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Bipin Prasad updated STORM-3933:

Description: 
{code:java}
[INFO] [WARNING] Javadoc Warnings
[INFO] [WARNING] 
./storm/storm-server/src/main/java/org/apache/storm/scheduler/resource/strategies/scheduling/BaseResourceAwareStrategy.java:61:
 warning - Tag @link: can't find NodeSorter(Cluster, TopologyDetails, 
NodeSortType) in 
org.apache.storm.scheduler.resource.strategies.scheduling.sorter.NodeSorter
[INFO] [WARNING] 
./storm/storm-server/src/main/java/org/apache/storm/scheduler/resource/strategies/scheduling/ObjectResourcesItem.java:42:
 warning - Tag @link: reference not found: 
NodeSorter#sortObjectResourcesCommon(ObjectResourcesSummary, ExecutorDetails, 
NodeSorter.ExistingScheduleFunc)
[INFO] [WARNING] 
./storm/storm-server/src/main/java/org/apache/storm/scheduler/resource/strategies/scheduling/ObjectResourcesItem.java:55:
 warning - Tag @link: reference not found: 
NodeSorter#sortObjectResourcesCommon(ObjectResourcesSummary, ExecutorDetails, 
NodeSorter.ExistingScheduleFunc)
[INFO] [WARNING] 
./storm/storm-server/src/main/java/org/apache/storm/scheduler/resource/strategies/scheduling/sorter/NodeSorter.java:92:
 warning - Tag @link: reference not found: 
BaseResourceAwareStrategy.NodeSortType#GENERIC_RAS
[INFO] [WARNING] 
./storm/storm-server/src/main/java/org/apache/storm/scheduler/resource/strategies/scheduling/sorter/NodeSorter.java:92:
 warning - Tag @link: reference not found: 
BaseResourceAwareStrategy.NodeSortType#DEFAULT_RAS
[INFO] [WARNING] 
./storm/storm-server/src/main/java/org/apache/storm/scheduler/resource/strategies/scheduling/sorter/NodeSorter.java:92:
 warning - Tag @link: reference not found: 
BaseResourceAwareStrategy.NodeSortType#COMMON
[INFO] [WARNING] 
./storm/storm-server/src/main/java/org/apache/storm/scheduler/resource/strategies/scheduling/sorter/NodeSorter.java:92:
 warning - Tag @link: reference not found: 
BaseResourceAwareStrategy.NodeSortType
[INFO] [WARNING] 
./storm/storm-server/src/main/java/org/apache/storm/scheduler/resource/strategies/scheduling/sorter/NodeSorterHostProximity.java:97:
 warning - Tag @link: reference not found: 
BaseResourceAwareStrategy.NodeSortType#GENERIC_RAS
[INFO] [WARNING] 
./storm/storm-server/src/main/java/org/apache/storm/scheduler/resource/strategies/scheduling/sorter/NodeSorterHostProximity.java:97:
 warning - Tag @link: reference not found: 
BaseResourceAwareStrategy.NodeSortType#DEFAULT_RAS
[INFO] [WARNING] 
./storm/storm-server/src/main/java/org/apache/storm/scheduler/resource/strategies/scheduling/sorter/NodeSorterHostProximity.java:97:
 warning - Tag @link: reference not found: 
BaseResourceAwareStrategy.NodeSortType#COMMON
[INFO] [WARNING] 
./storm/storm-server/src/main/java/org/apache/storm/scheduler/resource/strategies/scheduling/sorter/NodeSorterHostProximity.java:97:
 warning - Tag @link: reference not found: 
BaseResourceAwareStrategy.NodeSortType
[INFO] [WARNING] 
./storm/storm-server/src/main/java/org/apache/storm/utils/EnumUtil.java:33: 
warning - @param argument "T" is not a parameter name.
[INFO] [WARNING] 
./storm/storm-server/src/main/java/org/apache/storm/utils/EnumUtil.java:33: 
warning - @param argument "U" is not a parameter name.
[INFO] [WARNING] 
./storm/storm-server/src/main/java/org/apache/storm/nimbus/AssignmentDistributionService.java:112:
 warning - @param argument "callback" is not a parameter name.
[INFO] [WARNING] 
./storm/storm-server/src/main/java/org/apache/storm/nimbus/AssignmentDistributionService.java:200:
 warning - Tag @link: reference not found: NodeAssignments
[INFO] [WARNING] 
./storm/storm-server/src/main/java/org/apache/storm/nimbus/LeaderListenerCallback.java:81:
 warning - @LeaderListenerCallback is an unknown tag.
[INFO] [WARNING] 
./storm/storm-server/src/main/java/org/apache/storm/nimbus/LeaderListenerCallback.java:81:
 warning - @LeaderListenerCallback is an unknown tag.
[INFO] [WARNING] 
./storm/storm-server/src/main/java/org/apache/storm/nimbus/LeaderListenerCallback.java:81:
 warning - @LeaderListenerCallback is an unknown tag.
[INFO] [WARNING] 
./storm/storm-server/src/main/java/org/apache/storm/metric/timed/TimerDecorated.java:30:
 warning - Tag @link: reference not found: Timer.Context#stop()
[INFO] [WARNING] 
./storm/storm-server/src/main/java/org/apache/storm/nimbus/LeaderListenerCallback.java:81:
 warning - @LeaderListenerCallback is an unknown tag.
[INFO] [WARNING] 
./storm/storm-server/src/main/java/org/apache/storm/nimbus/LeaderListenerCallback.java:81:
 warning - @LeaderListenerCallback is an unknown tag.
[INFO] [WARNING] 
./storm/storm-server/src/main/java/org/apache/storm/nimbus/LeaderListenerCallback.java:81:
 warning - @LeaderListenerCallback is an unknown tag.
 {code}

> Fix errors/warnings found while generating javadoc 

[jira] [Created] (STORM-3933) Fix errors/warnings found while generating javadoc in storm-server

2023-07-14 Thread Bipin Prasad (Jira)
Bipin Prasad created STORM-3933:
---

 Summary: Fix errors/warnings found while generating javadoc in 
storm-server
 Key: STORM-3933
 URL: https://issues.apache.org/jira/browse/STORM-3933
 Project: Apache Storm
  Issue Type: Task
  Components: storm-server
Reporter: Bipin Prasad






--
This message was sent by Atlassian Jira
(v8.20.10#820010)


[jira] [Updated] (STORM-3932) Fix errors/warnings found while generating javadoc

2023-07-14 Thread Bipin Prasad (Jira)


 [ 
https://issues.apache.org/jira/browse/STORM-3932?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Bipin Prasad updated STORM-3932:

Component/s: storm-client

> Fix errors/warnings found while generating javadoc
> --
>
> Key: STORM-3932
> URL: https://issues.apache.org/jira/browse/STORM-3932
> Project: Apache Storm
>  Issue Type: Task
>  Components: storm-client
>Reporter: Bipin Prasad
>Priority: Minor
>
> In Storm-client
> {code:java}
> [INFO] [WARNING] Javadoc Warnings
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/utils/DefaultShellLogHandler.java:51:
>  warning - Tag @see:illegal character: "123" in "{@link 
> ShellLogHandler#setUpContext}"
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/utils/DefaultShellLogHandler.java:51:
>  warning - Tag @see:illegal character: "64" in "{@link 
> ShellLogHandler#setUpContext}"
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/utils/DefaultShellLogHandler.java:66:
>  warning - Tag @see:illegal character: "123" in "{@link ShellLogHandler#log}"
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/utils/DefaultShellLogHandler.java:66:
>  warning - Tag @see:illegal character: "64" in "{@link ShellLogHandler#log}"
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/Config.java:139: warning - 
> @deprecated: is an unknown tag.
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/Config.java:875: warning - 
> Tag @link: reference not found: 
> org.apache.storm.scheduler.multitenant.MultitenantScheduler
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/Config.java:875: warning - 
> Tag @link: reference not found: 
> org.apache.storm.scheduler.multitenant.MultitenantScheduler
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/Config.java:875: warning - 
> Tag @link: reference not found: 
> org.apache.storm.scheduler.resource.ResourceAwareScheduler
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/Config.java:875: warning - 
> Tag @link: reference not found: 
> org.apache.storm.scheduler.resource.strategies.scheduling.RoundRobinResourceAwareStrategy
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/Config.java:1275: warning - 
> @Deprecated is an unknown tag -- same as a known tag except for case.
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/Config.java:1282: warning - 
> @Deprecated is an unknown tag -- same as a known tag except for case.
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/ILocalCluster.java:82: 
> warning - @param argument "topologyName" is not a parameter name.
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/ILocalCluster.java:206: 
> warning - @param argument "steps" is not a parameter name.
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/topology/TopologyBuilder.java:319:
>  warning - @param argument "T" is not a parameter name.
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/topology/TopologyBuilder.java:339:
>  warning - @param argument "T" is not a parameter name.
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/cluster/IStateStorage.java:69:
>  warning - @return tag cannot be used in method with void return type.
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:68:
>  warning - Tag @link: reference not found: LeaderListenerCallback
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:68:
>  warning - Tag @link: reference not found: LeaderListenerCallback
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:156:
>  warning - @deprecated: is an unknown tag.
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:184:
>  warning - @deprecated: is an unknown tag.
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:191:
>  warning - @deprecated: is an unknown tag.
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:198:
>  warning - @deprecated: is an unknown tag.
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:205:
>  warning - @deprecated: is an unknown tag.
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:68:
>  warning - Tag @link: reference not found: LeaderListenerCallback
> [INFO] [WARNING] 
> ./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:68:
>  warning 

[jira] [Updated] (STORM-3932) Fix errors/warnings found while generating javadoc

2023-07-14 Thread Bipin Prasad (Jira)


 [ 
https://issues.apache.org/jira/browse/STORM-3932?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Bipin Prasad updated STORM-3932:

Description: 
In Storm-client
{code:java}
[INFO] [WARNING] Javadoc Warnings
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/utils/DefaultShellLogHandler.java:51:
 warning - Tag @see:illegal character: "123" in "{@link 
ShellLogHandler#setUpContext}"
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/utils/DefaultShellLogHandler.java:51:
 warning - Tag @see:illegal character: "64" in "{@link 
ShellLogHandler#setUpContext}"
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/utils/DefaultShellLogHandler.java:66:
 warning - Tag @see:illegal character: "123" in "{@link ShellLogHandler#log}"
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/utils/DefaultShellLogHandler.java:66:
 warning - Tag @see:illegal character: "64" in "{@link ShellLogHandler#log}"
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/Config.java:139: warning - 
@deprecated: is an unknown tag.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/Config.java:875: warning - 
Tag @link: reference not found: 
org.apache.storm.scheduler.multitenant.MultitenantScheduler
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/Config.java:875: warning - 
Tag @link: reference not found: 
org.apache.storm.scheduler.multitenant.MultitenantScheduler
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/Config.java:875: warning - 
Tag @link: reference not found: 
org.apache.storm.scheduler.resource.ResourceAwareScheduler
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/Config.java:875: warning - 
Tag @link: reference not found: 
org.apache.storm.scheduler.resource.strategies.scheduling.RoundRobinResourceAwareStrategy
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/Config.java:1275: warning - 
@Deprecated is an unknown tag -- same as a known tag except for case.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/Config.java:1282: warning - 
@Deprecated is an unknown tag -- same as a known tag except for case.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/ILocalCluster.java:82: 
warning - @param argument "topologyName" is not a parameter name.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/ILocalCluster.java:206: 
warning - @param argument "steps" is not a parameter name.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/topology/TopologyBuilder.java:319:
 warning - @param argument "T" is not a parameter name.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/topology/TopologyBuilder.java:339:
 warning - @param argument "T" is not a parameter name.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/cluster/IStateStorage.java:69:
 warning - @return tag cannot be used in method with void return type.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:68:
 warning - Tag @link: reference not found: LeaderListenerCallback
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:68:
 warning - Tag @link: reference not found: LeaderListenerCallback
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:156:
 warning - @deprecated: is an unknown tag.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:184:
 warning - @deprecated: is an unknown tag.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:191:
 warning - @deprecated: is an unknown tag.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:198:
 warning - @deprecated: is an unknown tag.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:205:
 warning - @deprecated: is an unknown tag.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:68:
 warning - Tag @link: reference not found: LeaderListenerCallback
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:68:
 warning - Tag @link: reference not found: LeaderListenerCallback
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/blobstore/BlobStore.java:262: 
warning - @param argument "R" is not a parameter name.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/streams/Pair.java:53: warning 
- @param argument "T1" is not a parameter name.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/streams/Pair.java:53: warning 
- @param argument "T2" is not a parameter name.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/ap

[jira] [Updated] (STORM-3932) Fix errors/warnings found while generating javadoc

2023-07-14 Thread Bipin Prasad (Jira)


 [ 
https://issues.apache.org/jira/browse/STORM-3932?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
 ]

Bipin Prasad updated STORM-3932:

Description: 
 
{code:java}
[INFO] [WARNING] Javadoc Warnings
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/utils/DefaultShellLogHandler.java:51:
 warning - Tag @see:illegal character: "123" in "{@link 
ShellLogHandler#setUpContext}"
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/utils/DefaultShellLogHandler.java:51:
 warning - Tag @see:illegal character: "64" in "{@link 
ShellLogHandler#setUpContext}"
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/utils/DefaultShellLogHandler.java:66:
 warning - Tag @see:illegal character: "123" in "{@link ShellLogHandler#log}"
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/utils/DefaultShellLogHandler.java:66:
 warning - Tag @see:illegal character: "64" in "{@link ShellLogHandler#log}"
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/Config.java:139: warning - 
@deprecated: is an unknown tag.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/Config.java:875: warning - 
Tag @link: reference not found: 
org.apache.storm.scheduler.multitenant.MultitenantScheduler
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/Config.java:875: warning - 
Tag @link: reference not found: 
org.apache.storm.scheduler.multitenant.MultitenantScheduler
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/Config.java:875: warning - 
Tag @link: reference not found: 
org.apache.storm.scheduler.resource.ResourceAwareScheduler
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/Config.java:875: warning - 
Tag @link: reference not found: 
org.apache.storm.scheduler.resource.strategies.scheduling.RoundRobinResourceAwareStrategy
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/Config.java:1275: warning - 
@Deprecated is an unknown tag -- same as a known tag except for case.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/Config.java:1282: warning - 
@Deprecated is an unknown tag -- same as a known tag except for case.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/ILocalCluster.java:82: 
warning - @param argument "topologyName" is not a parameter name.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/ILocalCluster.java:206: 
warning - @param argument "steps" is not a parameter name.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/topology/TopologyBuilder.java:319:
 warning - @param argument "T" is not a parameter name.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/topology/TopologyBuilder.java:339:
 warning - @param argument "T" is not a parameter name.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/cluster/IStateStorage.java:69:
 warning - @return tag cannot be used in method with void return type.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:68:
 warning - Tag @link: reference not found: LeaderListenerCallback
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:68:
 warning - Tag @link: reference not found: LeaderListenerCallback
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:156:
 warning - @deprecated: is an unknown tag.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:184:
 warning - @deprecated: is an unknown tag.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:191:
 warning - @deprecated: is an unknown tag.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:198:
 warning - @deprecated: is an unknown tag.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:205:
 warning - @deprecated: is an unknown tag.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:68:
 warning - Tag @link: reference not found: LeaderListenerCallback
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:68:
 warning - Tag @link: reference not found: LeaderListenerCallback
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/blobstore/BlobStore.java:262: 
warning - @param argument "R" is not a parameter name.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/streams/Pair.java:53: warning 
- @param argument "T1" is not a parameter name.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/streams/Pair.java:53: warning 
- @param argument "T2" is not a parameter name.
[INFO] [WARNING] 
./storm/storm-client/src/jvm/org/apache/storm/str

[jira] [Created] (STORM-3932) Fix errors/warnings found while generating javadoc

2023-07-14 Thread Bipin Prasad (Jira)
Bipin Prasad created STORM-3932:
---

 Summary: Fix errors/warnings found while generating javadoc
 Key: STORM-3932
 URL: https://issues.apache.org/jira/browse/STORM-3932
 Project: Apache Storm
  Issue Type: Task
Reporter: Bipin Prasad


 
{code:java}
[INFO] [WARNING] Javadoc Warnings
[INFO] [WARNING] 
/Users/bprasad/sources/community/bipinprasad/storm/storm-client/src/jvm/org/apache/storm/utils/DefaultShellLogHandler.java:51:
 warning - Tag @see:illegal character: "123" in "{@link 
ShellLogHandler#setUpContext}"
[INFO] [WARNING] 
/Users/bprasad/sources/community/bipinprasad/storm/storm-client/src/jvm/org/apache/storm/utils/DefaultShellLogHandler.java:51:
 warning - Tag @see:illegal character: "64" in "{@link 
ShellLogHandler#setUpContext}"
[INFO] [WARNING] 
/Users/bprasad/sources/community/bipinprasad/storm/storm-client/src/jvm/org/apache/storm/utils/DefaultShellLogHandler.java:66:
 warning - Tag @see:illegal character: "123" in "{@link ShellLogHandler#log}"
[INFO] [WARNING] 
/Users/bprasad/sources/community/bipinprasad/storm/storm-client/src/jvm/org/apache/storm/utils/DefaultShellLogHandler.java:66:
 warning - Tag @see:illegal character: "64" in "{@link ShellLogHandler#log}"
[INFO] [WARNING] 
/Users/bprasad/sources/community/bipinprasad/storm/storm-client/src/jvm/org/apache/storm/Config.java:139:
 warning - @deprecated: is an unknown tag.
[INFO] [WARNING] 
/Users/bprasad/sources/community/bipinprasad/storm/storm-client/src/jvm/org/apache/storm/Config.java:875:
 warning - Tag @link: reference not found: 
org.apache.storm.scheduler.multitenant.MultitenantScheduler
[INFO] [WARNING] 
/Users/bprasad/sources/community/bipinprasad/storm/storm-client/src/jvm/org/apache/storm/Config.java:875:
 warning - Tag @link: reference not found: 
org.apache.storm.scheduler.multitenant.MultitenantScheduler
[INFO] [WARNING] 
/Users/bprasad/sources/community/bipinprasad/storm/storm-client/src/jvm/org/apache/storm/Config.java:875:
 warning - Tag @link: reference not found: 
org.apache.storm.scheduler.resource.ResourceAwareScheduler
[INFO] [WARNING] 
/Users/bprasad/sources/community/bipinprasad/storm/storm-client/src/jvm/org/apache/storm/Config.java:875:
 warning - Tag @link: reference not found: 
org.apache.storm.scheduler.resource.strategies.scheduling.RoundRobinResourceAwareStrategy
[INFO] [WARNING] 
/Users/bprasad/sources/community/bipinprasad/storm/storm-client/src/jvm/org/apache/storm/Config.java:1275:
 warning - @Deprecated is an unknown tag -- same as a known tag except for case.
[INFO] [WARNING] 
/Users/bprasad/sources/community/bipinprasad/storm/storm-client/src/jvm/org/apache/storm/Config.java:1282:
 warning - @Deprecated is an unknown tag -- same as a known tag except for case.
[INFO] [WARNING] 
/Users/bprasad/sources/community/bipinprasad/storm/storm-client/src/jvm/org/apache/storm/ILocalCluster.java:82:
 warning - @param argument "topologyName" is not a parameter name.
[INFO] [WARNING] 
/Users/bprasad/sources/community/bipinprasad/storm/storm-client/src/jvm/org/apache/storm/ILocalCluster.java:206:
 warning - @param argument "steps" is not a parameter name.
[INFO] [WARNING] 
/Users/bprasad/sources/community/bipinprasad/storm/storm-client/src/jvm/org/apache/storm/topology/TopologyBuilder.java:319:
 warning - @param argument "T" is not a parameter name.
[INFO] [WARNING] 
/Users/bprasad/sources/community/bipinprasad/storm/storm-client/src/jvm/org/apache/storm/topology/TopologyBuilder.java:339:
 warning - @param argument "T" is not a parameter name.
[INFO] [WARNING] 
/Users/bprasad/sources/community/bipinprasad/storm/storm-client/src/jvm/org/apache/storm/cluster/IStateStorage.java:69:
 warning - @return tag cannot be used in method with void return type.
[INFO] [WARNING] 
/Users/bprasad/sources/community/bipinprasad/storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:68:
 warning - Tag @link: reference not found: LeaderListenerCallback
[INFO] [WARNING] 
/Users/bprasad/sources/community/bipinprasad/storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:68:
 warning - Tag @link: reference not found: LeaderListenerCallback
[INFO] [WARNING] 
/Users/bprasad/sources/community/bipinprasad/storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:156:
 warning - @deprecated: is an unknown tag.
[INFO] [WARNING] 
/Users/bprasad/sources/community/bipinprasad/storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:184:
 warning - @deprecated: is an unknown tag.
[INFO] [WARNING] 
/Users/bprasad/sources/community/bipinprasad/storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:191:
 warning - @deprecated: is an unknown tag.
[INFO] [WARNING] 
/Users/bprasad/sources/community/bipinprasad/storm/storm-client/src/jvm/org/apache/storm/cluster/IStormClusterState.java:198:
 warning - @deprecated: is an unknown tag.
[INFO] [WARNING]

[jira] [Created] (STORM-3931) @see tags that are followed by {@link...}

2023-07-14 Thread Bipin Prasad (Jira)
Bipin Prasad created STORM-3931:
---

 Summary: @see tags that are followed by {@link...}
 Key: STORM-3931
 URL: https://issues.apache.org/jira/browse/STORM-3931
 Project: Apache Storm
  Issue Type: Task
  Components: documentation
Reporter: Bipin Prasad


@see tags have been deprected in JDK9 in favor of @link tags.

In Storm, several source files contain improperly formatted '@see' tags. This 
tag expects class name otherwise generates error for unexpected "{" - character 
code 123 and "@", character code 64. When generating javadoc.
{code:java}
[INFO] [WARNING] 
.../storm/storm-client/src/jvm/org/apache/storm/utils/DefaultShellLogHandler.java:51:
 warning - Tag @see:illegal character: "123" in "{@link 
ShellLogHandler#setUpContext}"
[INFO] [WARNING] 
.../storm/storm-client/src/jvm/org/apache/storm/utils/DefaultShellLogHandler.java:51:
 warning - Tag @see:illegal character: "64" in "{@link 
ShellLogHandler#setUpContext}"
[INFO] [WARNING] 
.../storm/storm-client/src/jvm/org/apache/storm/utils/DefaultShellLogHandler.java:51:
 warning - Tag @see: reference not found: "{@link ShellLogHandler#setUpContext}"

{code}
For example

storm-client/src/jvm/org/apache/storm/utils/DefaultShellLogHandler.java#setUpContext
{code:java}
/**
 * This default implementation saves the {@link ShellProcess} so it can output 
the process info string later.
 *
 * @param ownerCls - the class which instantiated this ShellLogHandler.
 * @param process  - the current {@link ShellProcess}.
 * @param context  - the current {@link TopologyContext}.
 * @see {@link ShellLogHandler#setUpContext}
 */
 {code}
Should just be rolled into the documentation thusly:
{code:java}
/**
 * This default implementation saves the {@link ShellProcess} so it can output 
the process info string later. See {@link ShellLogHandler#setUpContext}.
 *
 * @param ownerCls - the class which instantiated this ShellLogHandler.
 * @param process  - the current {@link ShellProcess}.
 * @param context  - the current {@link TopologyContext}.
 */
 {code}
or
{code:java}
/**
 * This default implementation saves the {@link ShellProcess} so it can output 
the process info string later.
 *
 * @param ownerCls - the class which instantiated this ShellLogHandler.
 * @param process  - the current {@link ShellProcess}.
 * @param context  - the current {@link TopologyContext}.
 * @see ShellLogHandler#setUpContext
 */
 {code}



--
This message was sent by Atlassian Jira
(v8.20.10#820010)