Fix a/an typos (#3181)

* Typos a/an
* Fix typo generation in generateTagClasses.groovy

Signed-off-by: Wouter Born <github@maindrain.net>

bundles/org.openhab.core.addon.marketplace/src/main/java/org/openhab/core/addon/marketplace/internal/community/CommunityMarketplaceAddonService.java

@@ -323,7 +323,7 @@ public class CommunityMarketplaceAddonService extends AbstractRemoteAddonService
                 "posts_count", postsCount, //
                 "tags", tags.toArray(String[]::new));
 
-        // try to use an handler to determine if the add-on is installed
+        // try to use a handler to determine if the add-on is installed
         boolean installed = addonHandlers.stream()
                 .anyMatch(handler -> handler.supports(type, contentType) && handler.isInstalled(id));
 

bundles/org.openhab.core.audio/src/main/java/org/openhab/core/audio/URLAudioStream.java

@@ -32,8 +32,8 @@ import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
 /**
- * This is an AudioStream from an URL. Note that some sinks, like Sonos, can directly handle URL
+ * This is an AudioStream from a URL. Note that some sinks, like Sonos, can directly handle URL
- * based streams, and therefore can/should call getURL() to get an direct reference to the URL.
+ * based streams, and therefore can/should call getURL() to get a direct reference to the URL.
  *
  * @author Karel Goderis - Initial contribution
  * @author Kai Kreuzer - Refactored to not require a source

bundles/org.openhab.core.audio/src/main/java/org/openhab/core/audio/internal/javasound/AudioPlayer.java

@@ -116,7 +116,7 @@ public class AudioPlayer extends Thread {
     }
 
     /**
-     * Converts a org.openhab.core.audio.AudioFormat
+     * Converts an org.openhab.core.audio.AudioFormat
      * to a javax.sound.sampled.AudioFormat
      *
      * @param audioFormat The AudioFormat to convert

bundles/org.openhab.core.audio/src/main/java/org/openhab/core/audio/internal/webaudio/PlayURLEvent.java

@@ -16,7 +16,7 @@ import org.eclipse.jdt.annotation.NonNullByDefault;
 import org.openhab.core.events.AbstractEvent;
 
 /**
- * This is an {@link Event} that is sent when a web client should play an audio stream from an url.
+ * This is an {@link Event} that is sent when a web client should play an audio stream from a url.
  *
  * @author Kai Kreuzer - Initial contribution and API
  */

bundles/org.openhab.core.automation.module.media/src/main/java/org/openhab/core/automation/module/media/internal/PlayActionHandler.java

@@ -26,7 +26,7 @@ import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
 /**
- * This is an ModuleHandler implementation for Actions that play a sound file from the file system.
+ * This is a ModuleHandler implementation for Actions that play a sound file from the file system.
  *
  * @author Kai Kreuzer - Initial contribution
  * @author Christoph Weitkamp - Added parameter volume

bundles/org.openhab.core.automation.module.media/src/main/java/org/openhab/core/automation/module/media/internal/SayActionHandler.java

@@ -23,7 +23,7 @@ import org.openhab.core.library.types.PercentType;
 import org.openhab.core.voice.VoiceManager;
 
 /**
- * This is an ModuleHandler implementation for Actions that trigger a TTS output through "say".
+ * This is a ModuleHandler implementation for Actions that trigger a TTS output through "say".
  *
  * @author Kai Kreuzer - Initial contribution
  * @author Christoph Weitkamp - Added parameter volume

bundles/org.openhab.core.automation.module.script.rulesupport/src/main/java/org/openhab/core/automation/module/script/rulesupport/shared/simple/SimpleRule.java

@@ -35,7 +35,7 @@ import org.openhab.core.config.core.ConfigDescriptionParameter;
 import org.openhab.core.config.core.Configuration;
 
 /**
- * convenience Rule class with an action handler. This allows to define Rules which have a execution block.
+ * convenience Rule class with an action handler. This allows to define Rules which have an execution block.
  *
  * @author Simon Merschjohann - Initial contribution
  * @author Kai Kreuzer - made it implement Rule

bundles/org.openhab.core.automation/src/main/java/org/openhab/core/automation/ModuleHandlerCallback.java

@@ -19,7 +19,7 @@ import org.eclipse.jdt.annotation.Nullable;
 import org.openhab.core.common.registry.RegistryChangeListener;
 
 /**
- * This class is responsible to provide a {@link RegistryChangeListener} logic. A instance of it is added to
+ * This class is responsible to provide a {@link RegistryChangeListener} logic. An instance of it is added to
  * {@link RuleRegistry} service, to listen for changes when a single {@link Rule} has been added, updated, enabled,
  * disabled or removed and to involve Rule Engine to process these changes. Also to send a {@code run} command
  * for a single {@link Rule} to the Rule Engine.

bundles/org.openhab.core.automation/src/main/java/org/openhab/core/automation/RuleExecution.java

@@ -28,7 +28,7 @@ public final class RuleExecution implements Comparable<RuleExecution> {
     private final Rule rule;
 
     /**
-     * Creates an new {@link RuleExecution}.
+     * Creates a new {@link RuleExecution}.
      *
      * @param date The time when the rule will be executed.
      * @param rule The rule that will be executed.

bundles/org.openhab.core.automation/src/main/java/org/openhab/core/automation/RuleManager.java

@@ -21,7 +21,7 @@ import org.eclipse.jdt.annotation.Nullable;
 import org.openhab.core.common.registry.RegistryChangeListener;
 
 /**
- * This class is responsible to provide a {@link RegistryChangeListener} logic. A instance of it is added to
+ * This class is responsible to provide a {@link RegistryChangeListener} logic. An instance of it is added to
  * {@link RuleRegistry} service, to listen for changes when a single {@link Rule} has been added, updated, enabled,
  * disabled or removed and to involve Rule Engine to process these changes. Also to send a {@code run} command
  * for a single {@link Rule} to the Rule Engine.

bundles/org.openhab.core.automation/src/main/java/org/openhab/core/automation/handler/TimeBasedConditionHandler.java

@@ -17,7 +17,7 @@ import java.time.ZonedDateTime;
 import org.eclipse.jdt.annotation.NonNullByDefault;
 
 /**
- * {@link ConditionHandler} that evaluates, if the current time satisfies an specified condition.
+ * {@link ConditionHandler} that evaluates, if the current time satisfies a specified condition.
  *
  * @author Sönke Küper - Initial contribution
  */

bundles/org.openhab.core.automation/src/main/java/org/openhab/core/automation/internal/Connection.java

@@ -42,7 +42,7 @@ public final class Connection {
     /**
      * This constructor is responsible for creation of connections between modules in the rule.
      *
-     * @param inputName is an unique id of the {@code Input} in scope of the {@link Module}.
+     * @param inputName is a unique id of the {@code Input} in scope of the {@link Module}.
      * @param reference the reference tokens of this connection
      */
     public Connection(String inputName, String reference) {
@@ -52,9 +52,9 @@ public final class Connection {
     /**
      * This constructor is responsible for creation of connections between modules in the rule.
      *
-     * @param inputName is an unique name of the {@code Input} in scope of the {@link Module}.
+     * @param inputName is a unique name of the {@code Input} in scope of the {@link Module}.
-     * @param outputModuleId is an unique id of the {@code Module} in scope of the {@link Rule}.
+     * @param outputModuleId is a unique id of the {@code Module} in scope of the {@link Rule}.
-     * @param outputName is an unique name of the {@code Output} in scope of the {@link Module}.
+     * @param outputName is a unique name of the {@code Output} in scope of the {@link Module}.
      * @param reference the reference tokens of this connection
      */
     public Connection(String inputName, @Nullable String outputModuleId, @Nullable String outputName,

bundles/org.openhab.core.automation/src/main/java/org/openhab/core/automation/internal/RuleExecutionSimulator.java

@@ -52,7 +52,7 @@ final class RuleExecutionSimulator {
     private final RuleEngineImpl ruleEngine;
 
     /**
-     * Constructs an new {@link RuleExecutionSimulator}.
+     * Constructs a new {@link RuleExecutionSimulator}.
      */
     public RuleExecutionSimulator(RuleRegistry ruleRegistry, RuleEngineImpl ruleEngine) {
         this.ruleRegistry = ruleRegistry;

bundles/org.openhab.core.automation/src/main/java/org/openhab/core/automation/internal/commands/AutomationCommandImport.java

@@ -94,7 +94,7 @@ public class AutomationCommandImport extends AutomationCommand {
      * This method serves to create an {@link URL} object or {@link File} object from a string that is passed as
      * a parameter of the command. From the {@link File} object the URL is constructed.
      *
-     * @param parameterValue is a string that is passed as parameter of the command and it supposed to be an URL
+     * @param parameterValue is a string that is passed as parameter of the command and it supposed to be a URL
      *            representation.
      * @return an {@link URL} object created from the string that is passed as parameter of the command or <b>null</b>
      *         if either no legal protocol could be found in the specified string or the string could not be parsed.

bundles/org.openhab.core.automation/src/main/java/org/openhab/core/automation/internal/commands/AutomationCommandRemove.java

@@ -89,7 +89,7 @@ public class AutomationCommandRemove extends AutomationCommand {
      * This method serves to create an {@link URL} object or {@link File} object from a string that is passed as
      * a parameter of the command. From the {@link File} object the URL is constructed.
      *
-     * @param parameterValue is a string that is passed as parameter of the command and it supposed to be an URL
+     * @param parameterValue is a string that is passed as parameter of the command and it supposed to be a URL
      *            representation.
      * @return an {@link URL} object created from the string that is passed as parameter of the command or <b>null</b>
      *         if either no legal protocol could be found in the specified string or the string could not be parsed.

bundles/org.openhab.core.automation/src/main/java/org/openhab/core/automation/internal/module/handler/ChannelEventTriggerHandler.java

@@ -34,7 +34,7 @@ import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
 /**
- * This is an ModuleHandler implementation for trigger channels with specific events
+ * This is a ModuleHandler implementation for trigger channels with specific events
  *
  * @author Stefan Triller - Initial contribution
  */

bundles/org.openhab.core.automation/src/main/java/org/openhab/core/automation/internal/module/handler/DateTimeTriggerHandler.java

@@ -47,7 +47,7 @@ import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
 /**
- * This is an ModuleHandler implementation for Triggers which trigger the rule
+ * This is a ModuleHandler implementation for Triggers which trigger the rule
  * based on a {@link org.openhab.core.library.types.DateTimeType} stored in an item
  *
  * @author Jan N. Klug - Initial contribution

bundles/org.openhab.core.automation/src/main/java/org/openhab/core/automation/internal/module/handler/GenericCronTriggerHandler.java

@@ -27,7 +27,7 @@ import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
 /**
- * This is an ModuleHandler implementation for Triggers which trigger the rule
+ * This is a ModuleHandler implementation for Triggers which trigger the rule
  * based on a cron expression. The cron expression can be set with the
  * configuration.
  *

bundles/org.openhab.core.automation/src/main/java/org/openhab/core/automation/internal/module/handler/GenericEventConditionHandler.java

@@ -23,7 +23,7 @@ import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
 /**
- * This is the implementation of a event condition which checks if inputs matches configured values.
+ * This is the implementation of an event condition which checks if inputs matches configured values.
  *
  * @author Benedikt Niehues - Initial contribution
  * @author Kai Kreuzer - refactored and simplified customized module handling

bundles/org.openhab.core.automation/src/main/java/org/openhab/core/automation/internal/module/handler/GenericEventTriggerHandler.java

@@ -33,9 +33,9 @@ import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
 /**
- * This is an ModuleHandler implementation for Triggers which trigger the rule
+ * This is a ModuleHandler implementation for Triggers which trigger the rule
  * if an event occurs. The eventType, eventSource and topic can be set with the
- * configuration. It is an generic approach which makes it easier to specify
+ * configuration. It is a generic approach which makes it easier to specify
  * more concrete event based triggers with the composite module approach of the
  * automation component. Each GenericTriggerHandler instance registers as
  * EventSubscriber, so the dispose method must be called for unregistering the

bundles/org.openhab.core.automation/src/main/java/org/openhab/core/automation/internal/module/handler/GroupCommandTriggerHandler.java

@@ -38,7 +38,7 @@ import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
 /**
- * This is an ModuleHandler implementation for Triggers which trigger the rule
+ * This is a ModuleHandler implementation for Triggers which trigger the rule
  * if a member of an item group receives a command.
  * The group name and command value can be set with the configuration.
  *

bundles/org.openhab.core.automation/src/main/java/org/openhab/core/automation/internal/module/handler/GroupStateTriggerHandler.java

@@ -40,7 +40,7 @@ import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
 /**
- * This is an ModuleHandler implementation for Triggers which trigger the rule
+ * This is a ModuleHandler implementation for Triggers which trigger the rule
  * if state event of a member of an item group occurs.
  * The group name and state value can be set with the configuration.
  *

bundles/org.openhab.core.automation/src/main/java/org/openhab/core/automation/internal/module/handler/ItemCommandTriggerHandler.java

@@ -38,7 +38,7 @@ import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
 /**
- * This is an ModuleHandler implementation for Triggers which trigger the rule
+ * This is a ModuleHandler implementation for Triggers which trigger the rule
  * if an item receives a command. The eventType and command value can be set with the
  * configuration.
  *

bundles/org.openhab.core.automation/src/main/java/org/openhab/core/automation/internal/module/handler/ItemStateTriggerHandler.java

@@ -40,7 +40,7 @@ import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
 /**
- * This is an ModuleHandler implementation for Triggers which trigger the rule
+ * This is a ModuleHandler implementation for Triggers which trigger the rule
  * if an item state event occurs. The eventType and state value can be set with the
  * configuration.
  *

bundles/org.openhab.core.automation/src/main/java/org/openhab/core/automation/internal/module/handler/TimeOfDayTriggerHandler.java

@@ -29,7 +29,7 @@ import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
 /**
- * This is an ModuleHandler implementation for Triggers which trigger the rule
+ * This is a ModuleHandler implementation for Triggers which trigger the rule
  * at a specific time (format 'hh:mm').
  *
  * @author Kai Kreuzer - Initial contribution
@@ -57,7 +57,7 @@ public class TimeOfDayTriggerHandler extends BaseTriggerModuleHandler
     }
 
     /**
-     * Creates an cron-Expression from the configured time.
+     * Creates a cron-Expression from the configured time.
      */
     private static String buildExpressionFromConfigurationTime(String time) {
         try {

bundles/org.openhab.core.automation/src/main/java/org/openhab/core/automation/type/Input.java

@@ -135,7 +135,7 @@ public class Input {
     /**
      * Gets the name of Input. It must be unique in scope of the {@link Rule}.
      *
-     * @return name is an unique identifier of the Input.
+     * @return name is a unique identifier of the Input.
      */
     public String getName() {
         return name;

bundles/org.openhab.core.automation/src/main/java/org/openhab/core/automation/type/ModuleType.java

@@ -30,7 +30,7 @@ import org.openhab.core.config.core.ConfigDescriptionParameter;
  * defines the meta-information needed for creation of a {@link Module} instance which is a building block for a
  * {@link Rule}. The meta-information describes the {@link Configuration} of a {@link Module} providing list with
  * {@link ConfigDescriptionParameter}s, {@link Input}s and {@link Output}s of a {@link Module}. Each {@link ModuleType}
- * instance owns an unique id which is used as reference in the {@link Module}s, to find their meta-information.
+ * instance owns a unique id which is used as reference in the {@link Module}s, to find their meta-information.
  * <p>
  * Whether the {@link ModuleType}s can be used by anyone, depends from their {@link Visibility} value, but they can be
  * modified only by their creator.

bundles/org.openhab.core.automation/src/main/java/org/openhab/core/automation/type/ModuleTypeRegistry.java

@@ -34,7 +34,7 @@ public interface ModuleTypeRegistry extends Registry<ModuleType, String> {
     /**
      * Gets the localized {@link ModuleType} by specified UID and locale.
      *
-     * @param moduleTypeUID the an unique id in scope of registered {@link ModuleType}s.
+     * @param moduleTypeUID the a unique id in scope of registered {@link ModuleType}s.
      * @param locale used for localization of the {@link ModuleType}.
      * @param <T> the type of the required object.
      * @return the desired {@link ModuleType} instance or {@code null} if a module type with such UID does not exist or

bundles/org.openhab.core.automation/src/main/java/org/openhab/core/automation/type/Output.java

@@ -46,7 +46,7 @@ import org.openhab.core.automation.Rule;
 public class Output {
 
     /**
-     * is an unique name of the {@code Output} in scope of the {@link Module}.
+     * is a unique name of the {@code Output} in scope of the {@link Module}.
      */
     private String name;
 
@@ -112,7 +112,7 @@ public class Output {
      * @param name a unique name of the {@code Output}.
      * @param type the type of the output data.
      * @param label a single word description of the {@code Output}.
-     * @param description is an user friendly description of the {@code Output}.
+     * @param description is a user friendly description of the {@code Output}.
      * @param tags are associated with the {@code Output}. The tags add additional restrictions to connections
      *            between {@link Input}s and {@link Output}s. The {@link Input}'s tags must be subset of the
      *            {@code Output}'s tags to succeed the connection.<br>
@@ -147,7 +147,7 @@ public class Output {
      * This method is used for getting the name of {@code Output}. It must be unique in
      * scope of {@link Rule}.
      *
-     * @return name is an unique identifier of the {@code Output}.
+     * @return name is a unique identifier of the {@code Output}.
      */
     public String getName() {
         return name;

bundles/org.openhab.core.automation/src/main/java/org/openhab/core/automation/util/ReferenceResolver.java

@@ -324,7 +324,7 @@ public class ReferenceResolver {
      *             {@link SecurityManager#checkPackageAccess s.checkPackageAccess()} denies
      *             access to the package of this class</li>
      *             </ul>
-     * @throws ArrayIndexOutOfBoundsException if one of the tokens represent a invalid index in the list.
+     * @throws ArrayIndexOutOfBoundsException if one of the tokens represent an invalid index in the list.
      * @throws NullPointerException if the path references something in a non existing map entry.
      * @throws NumberFormatException if one of the tokens is accessing a list and the token that represent the
      *             index can't be converted to integer.

bundles/org.openhab.core.config.core/src/main/java/org/openhab/core/config/core/ConfigUtil.java

@@ -174,7 +174,7 @@ public class ConfigUtil {
      * @param value the value to return as normalized type
      * @param configDescriptionParameter the parameter that needs to be normalized
      * @return corresponding value as a valid type
-     * @throws IllegalArgumentException if a invalid type has been given
+     * @throws IllegalArgumentException if an invalid type has been given
      */
     public static Object normalizeType(Object value, @Nullable ConfigDescriptionParameter configDescriptionParameter) {
         if (configDescriptionParameter != null) {

bundles/org.openhab.core.config.discovery/src/main/java/org/openhab/core/config/discovery/DiscoveryResult.java

@@ -86,7 +86,7 @@ public interface DiscoveryResult {
     /**
      * Returns the representation property of this result object.
      * <p>
-     * The representation property represents an unique human and/or machine readable identifier of the thing that was
+     * The representation property represents a unique human and/or machine readable identifier of the thing that was
      * discovered. Its actual value can be retrieved from the {@link DiscoveryResult#getProperties()} map. Such unique
      * identifiers are typically the <code>ipAddress</code>, the <code>macAddress</code> or the
      * <code>serialNumber</code> of the discovered thing.

bundles/org.openhab.core.config.discovery/src/main/java/org/openhab/core/config/discovery/DiscoveryServiceRegistry.java

@@ -60,7 +60,7 @@ public interface DiscoveryServiceRegistry {
      * Forces the associated {@link DiscoveryService}s to start a discovery for
      * all thing types of the given binding id.
      * <p>
-     * Returns {@code true}, if a at least one {@link DiscoveryService} could be found and forced to start a discovery,
+     * Returns {@code true}, if at least one {@link DiscoveryService} could be found and forced to start a discovery,
      * otherwise {@code false}.
      *
      * @param bindingId the binding id pointing to one or more discovery services to

bundles/org.openhab.core.config.discovery/src/main/java/org/openhab/core/config/discovery/dto/DiscoveryResultDTOMapper.java

@@ -19,7 +19,7 @@ import org.openhab.core.thing.ThingTypeUID;
 import org.openhab.core.thing.ThingUID;
 
 /**
- * The {@link DiscoveryResultDTOMapper} is an utility class to map discovery results into discovery result transfer
+ * The {@link DiscoveryResultDTOMapper} is a utility class to map discovery results into discovery result transfer
  * objects.
  *
  * @author Stefan Bussweiler - Initial contribution

bundles/org.openhab.core.io.net/src/main/java/org/openhab/core/io/net/http/HttpUtil.java

@@ -347,7 +347,7 @@ public class HttpUtil {
     }
 
     /**
-     * Download the image data from an URL.
+     * Download the image data from a URL.
      *
      * If content type is not found in the headers, the data is scanned to determine the content type.
      *
@@ -360,7 +360,7 @@ public class HttpUtil {
     }
 
     /**
-     * Download the image data from an URL.
+     * Download the image data from a URL.
      *
      * If content type is not found in the headers, the data is scanned to determine the content type.
      *
@@ -374,7 +374,7 @@ public class HttpUtil {
     }
 
     /**
-     * Download the image data from an URL.
+     * Download the image data from a URL.
      *
      * @param url the URL of the image to be downloaded
      * @param scanTypeInContent true to allow the scan of data to determine the content type if not found in the headers
@@ -388,7 +388,7 @@ public class HttpUtil {
     }
 
     /**
-     * Download the image data from an URL.
+     * Download the image data from a URL.
      *
      * @param url the URL of the image to be downloaded
      * @param scanTypeInContent true to allow the scan of data to determine the content type if not found in the headers
@@ -403,7 +403,7 @@ public class HttpUtil {
     }
 
     /**
-     * Download the data from an URL.
+     * Download the data from a URL.
      *
      * @param url the URL of the data to be downloaded
      * @param contentTypeRegex the REGEX the content type must match; null to ignore the content type
@@ -419,7 +419,7 @@ public class HttpUtil {
     }
 
     /**
-     * Download the data from an URL.
+     * Download the data from a URL.
      *
      * @param url the URL of the data to be downloaded
      * @param contentTypeRegex the REGEX the content type must match; null to ignore the content type

bundles/org.openhab.core.io.rest.auth/src/main/java/org/openhab/core/io/rest/auth/internal/TokenResource.java

@@ -377,7 +377,7 @@ public class TokenResource implements RESTResource {
             throw new TokenEndpointException(ErrorType.INVALID_REQUEST);
         }
 
-        // find an user associated with the provided refresh token
+        // find a user associated with the provided refresh token
         Optional<User> refreshTokenUser = userRegistry.getAll().stream().filter(
                 u -> ((ManagedUser) u).getSessions().stream().anyMatch(s -> refreshToken.equals(s.getRefreshToken())))
                 .findAny();

bundles/org.openhab.core.io.rest.core/src/main/java/org/openhab/core/io/rest/core/thing/EnrichedThingDTOMapper.java

@@ -26,7 +26,7 @@ import org.openhab.core.thing.dto.ThingDTOMapper;
 import org.openhab.core.thing.firmware.dto.FirmwareStatusDTO;
 
 /**
- * The {@link EnrichedThingDTOMapper} is an utility class to map things into enriched thing data transfer objects
+ * The {@link EnrichedThingDTOMapper} is a utility class to map things into enriched thing data transfer objects
  * (DTOs).
  *
  * @author Dennis Nobel - Initial contribution

bundles/org.openhab.core.io.rest.sse/src/main/java/org/openhab/core/io/rest/sse/SseResource.java

@@ -195,7 +195,7 @@ public class SseResource implements RESTResource, SsePublisher {
     }
 
     /**
-     * Subscribes the connecting client for state updates. It will initially only send a "ready" event with an unique
+     * Subscribes the connecting client for state updates. It will initially only send a "ready" event with a unique
      * connectionId that the client can use to dynamically alter the list of tracked items.
      *
      * @return {@link EventOutput} object associated with the incoming connection.

bundles/org.openhab.core.io.rest.swagger/src/main/java/org/openhab/core/io/rest/swagger/impl/OpenApiResource.java

@@ -56,7 +56,7 @@ import io.swagger.v3.oas.models.security.SecurityScheme;
 import io.swagger.v3.oas.models.servers.Server;
 
 /**
- * An endpoint to generate and provide a OpenAPI description.
+ * An endpoint to generate and provide an OpenAPI description.
  *
  * @author Markus Rathgeb - Initial contribution
  * @author Kai Kreuzer - made it a RESTResource to register in the root bean
@@ -93,7 +93,7 @@ public class OpenApiResource implements RESTResource {
     /**
      * Gets the current JAX-RS Whiteboard provided endpoint information by OpenAPI.
      *
-     * @return a OpenAPI description of the endpoints
+     * @return an OpenAPI description of the endpoints
      */
     @GET
     @Produces(MediaType.APPLICATION_JSON)

bundles/org.openhab.core.io.rest.ui/src/main/java/org/openhab/core/io/rest/ui/TileDTO.java

@@ -16,7 +16,7 @@ import org.eclipse.jdt.annotation.NonNullByDefault;
 import org.eclipse.jdt.annotation.Nullable;
 
 /**
- * This is an data transfer object for a UI tile.
+ * This is a data transfer object for a UI tile.
  *
  * @author Yannick Schaus - Initial contribution
  */

bundles/org.openhab.core.io.rest.ui/src/main/java/org/openhab/core/io/rest/ui/internal/UIResource.java

@@ -151,7 +151,7 @@ public class UIResource implements RESTResource {
     @Path("/components/{namespace}")
     @Consumes(MediaType.APPLICATION_JSON)
     @Produces({ MediaType.APPLICATION_JSON })
-    @Operation(operationId = "addUIComponentToNamespace", summary = "Add an UI component in the specified namespace.", security = {
+    @Operation(operationId = "addUIComponentToNamespace", summary = "Add a UI component in the specified namespace.", security = {
             @SecurityRequirement(name = "oauth2", scopes = { "admin" }) }, responses = {
                     @ApiResponse(responseCode = "200", description = "OK", content = @Content(schema = @Schema(implementation = RootUIComponent.class))) })
     public Response addComponent(@PathParam("namespace") String namespace, RootUIComponent component) {

bundles/org.openhab.core.io.rest/src/main/java/org/openhab/core/io/rest/JSONResponse.java

@@ -183,7 +183,7 @@ public class JSONResponse {
     }
 
     /**
-     * An piped input stream that is marked to produce JSON string.
+     * A piped input stream that is marked to produce JSON string.
      *
      * @author Markus Rathgeb - Initial contribution
      */

bundles/org.openhab.core.io.transport.mqtt/src/main/java/org/openhab/core/io/transport/mqtt/MqttActionCallback.java

@@ -15,7 +15,7 @@ package org.openhab.core.io.transport.mqtt;
 import org.eclipse.jdt.annotation.NonNullByDefault;
 
 /**
- * Implement this to be notified of the success or error of a any method in {@link MqttBrokerConnection} that takes a
+ * Implement this to be notified of the success or error of any method in {@link MqttBrokerConnection} that takes a
  * callback.
  *
  * @author David Graeff - Initial contribution

bundles/org.openhab.core.io.transport.serial.javacomm/src/main/java/org/openhab/core/io/transport/serial/internal/SerialPortIdentifierImpl.java

@@ -54,7 +54,7 @@ public class SerialPortIdentifierImpl implements SerialPortIdentifier {
                 return new SerialPortImpl((javax.comm.SerialPort) cp);
             } else {
                 throw new IllegalStateException(
-                        String.format("We expect an serial port instead of '%s'", cp.getClass()));
+                        String.format("We expect a serial port instead of '%s'", cp.getClass()));
             }
         } catch (javax.comm.PortInUseException e) {
             String message = e.getMessage();

bundles/org.openhab.core.io.transport.serial.rxtx/src/main/java/org/openhab/core/io/transport/serial/internal/SerialPortIdentifierImpl.java

@@ -55,7 +55,7 @@ public class SerialPortIdentifierImpl implements SerialPortIdentifier {
                 return new RxTxSerialPort((gnu.io.SerialPort) cp);
             } else {
                 throw new IllegalStateException(
-                        String.format("We expect an serial port instead of '%s'", cp.getClass()));
+                        String.format("We expect a serial port instead of '%s'", cp.getClass()));
             }
         } catch (gnu.io.PortInUseException e) {
             String message = e.getMessage();

bundles/org.openhab.core.io.transport.serial/src/main/java/org/openhab/core/io/transport/serial/SerialPortManager.java

@@ -26,7 +26,7 @@ import org.eclipse.jdt.annotation.Nullable;
 @NonNullByDefault
 public interface SerialPortManager {
     /**
-     * Gets an serial port identifier for a given name.
+     * Gets a serial port identifier for a given name.
      *
      * @param name the name
      * @return a serial port identifier or null

bundles/org.openhab.core.io.transport.upnp/src/main/java/org/openhab/core/io/transport/upnp/UpnpIOParticipant.java

@@ -37,7 +37,7 @@ public interface UpnpIOParticipant {
 
     /**
      * Called when the UPNP IO service is unable to poll the UDN of the participant, given that
-     * a addStatusListener is registered.
+     * an addStatusListener is registered.
      *
      * @param status false, if the poll fails when the polling was previously successful; true if the poll succeeds
      *            when the polling was previously failing

bundles/org.openhab.core.model.script/src/org/openhab/core/model/script/actions/Audio.java

@@ -76,7 +76,7 @@ public class Audio {
         }
     }
 
-    @ActionDoc(text = "plays an audio stream from an url to the default sink")
+    @ActionDoc(text = "plays an audio stream from a url to the default sink")
     public static synchronized void playStream(
             @ParamDoc(name = "url", text = "the url of the audio stream") String url) {
         try {
@@ -86,7 +86,7 @@ public class Audio {
         }
     }
 
-    @ActionDoc(text = "plays an audio stream from an url to the given sink(s)")
+    @ActionDoc(text = "plays an audio stream from a url to the given sink(s)")
     public static synchronized void playStream(@ParamDoc(name = "sink", text = "the id of the sink") String sink,
             @ParamDoc(name = "url", text = "the url of the audio stream") String url) {
         try {

bundles/org.openhab.core.model.script/src/org/openhab/core/model/script/interpreter/ScriptInterpreter.xtend

@@ -69,7 +69,7 @@ public class ScriptInterpreter extends XbaseInterpreter {
             val value = context.getValue(QualifiedName.create(jvmField.simpleName))
             value ?: {
 
-                // Looks like we have an state, command or item field
+                // Looks like we have a state, command or item field
                 val fieldName = jvmField.simpleName
                 fieldName.stateOrCommand ?: fieldName.item
             }

bundles/org.openhab.core.semantics/model/generateTagClasses.groovy

@@ -69,6 +69,8 @@ def createTagSetClass(def line, String tagSet) {
     def parent = line.Parent
     def parentClass = parent ? parent : type
     def pkg = type.toLowerCase()
+    def ch = label.toLowerCase().charAt(0)
+    def article = ch == 'a' || ch == 'e' || ch == 'i' || ch == 'o' || ch == 'u' ? "an" : "a"
     def file = new FileWriter("${baseDir}/src/main/java/org/openhab/core/semantics/model/${pkg}/${tag}.java")
     file.write(header)
     file.write("package org.openhab.core.semantics.model." + pkg + ";\n\n")
@@ -79,7 +81,7 @@ def createTagSetClass(def line, String tagSet) {
     file.write("""import org.openhab.core.semantics.TagInfo;
 
 /**
- * This class defines a ${label}.
+ * This class defines ${article} ${label}.
  *
  * @author Generated from generateTagClasses.groovy - Initial contribution
  */

bundles/org.openhab.core.semantics/src/main/java/org/openhab/core/semantics/Point.java

@@ -16,7 +16,7 @@ import org.eclipse.jdt.annotation.NonNullByDefault;
 import org.eclipse.jdt.annotation.Nullable;
 
 /**
- * This is the super interface for all types that represent an Point.
+ * This is the super interface for all types that represent a Point.
  * The interface describes the relations to other entity types.
  *
  * @author Kai Kreuzer - Initial contribution

bundles/org.openhab.core.semantics/src/main/java/org/openhab/core/semantics/SemanticTags.java

@@ -151,7 +151,7 @@ public class SemanticTags {
      * Determines the semantic {@link Point} type of an {@link Item}.
      *
      * @param item the Item to get the Point for
-     * @return a sub-type of a {@link Point}if the Item represents an Point, otherwise null
+     * @return a sub-type of a {@link Point}if the Item represents a Point, otherwise null
      */
     @SuppressWarnings("unchecked")
     public static @Nullable Class<? extends Point> getPoint(Item item) {

bundles/org.openhab.core.semantics/src/main/java/org/openhab/core/semantics/model/equipment/AlarmSystem.java

@@ -17,7 +17,7 @@ import org.openhab.core.semantics.Equipment;
 import org.openhab.core.semantics.TagInfo;
 
 /**
- * This class defines a Alarm System.
+ * This class defines an Alarm System.
  *
  * @author Generated from generateTagClasses.groovy - Initial contribution
  */

bundles/org.openhab.core.semantics/src/main/java/org/openhab/core/semantics/model/equipment/InnerDoor.java

@@ -16,7 +16,7 @@ import org.eclipse.jdt.annotation.NonNullByDefault;
 import org.openhab.core.semantics.TagInfo;
 
 /**
- * This class defines a Inner Door.
+ * This class defines an Inner Door.
  *
  * @author Generated from generateTagClasses.groovy - Initial contribution
  */

bundles/org.openhab.core.semantics/src/main/java/org/openhab/core/semantics/model/equipment/Inverter.java

@@ -17,7 +17,7 @@ import org.openhab.core.semantics.Equipment;
 import org.openhab.core.semantics.TagInfo;
 
 /**
- * This class defines a Inverter.
+ * This class defines an Inverter.
  *
  * @author Generated from generateTagClasses.groovy - Initial contribution
  */

bundles/org.openhab.core.semantics/src/main/java/org/openhab/core/semantics/model/equipment/Oven.java

@@ -16,7 +16,7 @@ import org.eclipse.jdt.annotation.NonNullByDefault;
 import org.openhab.core.semantics.TagInfo;
 
 /**
- * This class defines a Oven.
+ * This class defines an Oven.
  *
  * @author Generated from generateTagClasses.groovy - Initial contribution
  */

bundles/org.openhab.core.semantics/src/main/java/org/openhab/core/semantics/model/location/Apartment.java

@@ -16,7 +16,7 @@ import org.eclipse.jdt.annotation.NonNullByDefault;
 import org.openhab.core.semantics.TagInfo;
 
 /**
- * This class defines a Apartment.
+ * This class defines an Apartment.
  *
  * @author Generated from generateTagClasses.groovy - Initial contribution
  */

bundles/org.openhab.core.semantics/src/main/java/org/openhab/core/semantics/model/location/Attic.java

@@ -16,7 +16,7 @@ import org.eclipse.jdt.annotation.NonNullByDefault;
 import org.openhab.core.semantics.TagInfo;
 
 /**
- * This class defines a Attic.
+ * This class defines an Attic.
  *
  * @author Generated from generateTagClasses.groovy - Initial contribution
  */

bundles/org.openhab.core.semantics/src/main/java/org/openhab/core/semantics/model/location/Entry.java

@@ -16,7 +16,7 @@ import org.eclipse.jdt.annotation.NonNullByDefault;
 import org.openhab.core.semantics.TagInfo;
 
 /**
- * This class defines a Entry.
+ * This class defines an Entry.
  *
  * @author Generated from generateTagClasses.groovy - Initial contribution
  */

bundles/org.openhab.core.semantics/src/main/java/org/openhab/core/semantics/model/location/Indoor.java

@@ -17,7 +17,7 @@ import org.openhab.core.semantics.Location;
 import org.openhab.core.semantics.TagInfo;
 
 /**
- * This class defines a Indoor.
+ * This class defines an Indoor.
  *
  * @author Generated from generateTagClasses.groovy - Initial contribution
  */

bundles/org.openhab.core.semantics/src/main/java/org/openhab/core/semantics/model/location/Office.java

@@ -16,7 +16,7 @@ import org.eclipse.jdt.annotation.NonNullByDefault;
 import org.openhab.core.semantics.TagInfo;
 
 /**
- * This class defines a Office.
+ * This class defines an Office.
  *
  * @author Generated from generateTagClasses.groovy - Initial contribution
  */

bundles/org.openhab.core.semantics/src/main/java/org/openhab/core/semantics/model/location/Outdoor.java

@@ -17,7 +17,7 @@ import org.openhab.core.semantics.Location;
 import org.openhab.core.semantics.TagInfo;
 
 /**
- * This class defines a Outdoor.
+ * This class defines an Outdoor.
  *
  * @author Generated from generateTagClasses.groovy - Initial contribution
  */

bundles/org.openhab.core.semantics/src/main/java/org/openhab/core/semantics/model/point/Alarm.java

@@ -17,7 +17,7 @@ import org.openhab.core.semantics.Point;
 import org.openhab.core.semantics.TagInfo;
 
 /**
- * This class defines a Alarm.
+ * This class defines an Alarm.
  *
  * @author Generated from generateTagClasses.groovy - Initial contribution
  */

bundles/org.openhab.core.semantics/src/main/java/org/openhab/core/semantics/model/point/OpenLevel.java

@@ -16,7 +16,7 @@ import org.eclipse.jdt.annotation.NonNullByDefault;
 import org.openhab.core.semantics.TagInfo;
 
 /**
- * This class defines a OpenLevel.
+ * This class defines an OpenLevel.
  *
  * @author Generated from generateTagClasses.groovy - Initial contribution
  */

bundles/org.openhab.core.semantics/src/main/java/org/openhab/core/semantics/model/point/OpenState.java

@@ -16,7 +16,7 @@ import org.eclipse.jdt.annotation.NonNullByDefault;
 import org.openhab.core.semantics.TagInfo;
 
 /**
- * This class defines a OpenState.
+ * This class defines an OpenState.
  *
  * @author Generated from generateTagClasses.groovy - Initial contribution
  */

bundles/org.openhab.core.semantics/src/main/java/org/openhab/core/semantics/model/property/Energy.java

@@ -17,7 +17,7 @@ import org.openhab.core.semantics.Property;
 import org.openhab.core.semantics.TagInfo;
 
 /**
- * This class defines a Energy.
+ * This class defines an Energy.
  *
  * @author Generated from generateTagClasses.groovy - Initial contribution
  */

bundles/org.openhab.core.semantics/src/main/java/org/openhab/core/semantics/model/property/Oil.java

@@ -17,7 +17,7 @@ import org.openhab.core.semantics.Property;
 import org.openhab.core.semantics.TagInfo;
 
 /**
- * This class defines a Oil.
+ * This class defines an Oil.
  *
  * @author Generated from generateTagClasses.groovy - Initial contribution
  */

bundles/org.openhab.core.semantics/src/main/java/org/openhab/core/semantics/model/property/Opening.java

@@ -17,7 +17,7 @@ import org.openhab.core.semantics.Property;
 import org.openhab.core.semantics.TagInfo;
 
 /**
- * This class defines a Opening.
+ * This class defines an Opening.
  *
  * @author Generated from generateTagClasses.groovy - Initial contribution
  */

bundles/org.openhab.core.semantics/src/main/java/org/openhab/core/semantics/model/property/Ultraviolet.java

@@ -17,7 +17,7 @@ import org.openhab.core.semantics.Property;
 import org.openhab.core.semantics.TagInfo;
 
 /**
- * This class defines a Ultraviolet.
+ * This class defines an Ultraviolet.
  *
  * @author Generated from generateTagClasses.groovy - Initial contribution
  */

bundles/org.openhab.core.test.magic/src/main/resources/OH-INF/i18n/magic.properties

@@ -42,7 +42,7 @@ thing-type.magic.magic-bridge2.description = The 2nd magic bridge
 thing-type.magic.online-offline.label = Magic Online Offline
 thing-type.magic.online-offline.description = An online/offline toggle thing
 thing-type.magic.onoff-light.label = Magic Light - On/Off
-thing-type.magic.onoff-light.description = A on/off light
+thing-type.magic.onoff-light.description = An on/off light
 thing-type.magic.player.label = Magic Player Thing
 thing-type.magic.player.description = A media player
 thing-type.magic.rollershutter.label = Magic Rollershutter Thing

bundles/org.openhab.core.test.magic/src/main/resources/OH-INF/thing/thing-types.xml

@@ -24,7 +24,7 @@
 
 	<thing-type id="onoff-light" extensible="alert">
 		<label>Magic Light - On/Off</label>
-		<description>A on/off light</description>
+		<description>An on/off light</description>
 
 		<channels>
 			<channel id="switch" typeId="switch"/>

bundles/org.openhab.core.thing/src/main/java/org/openhab/core/thing/dto/ChannelDTOMapper.java

@@ -22,7 +22,7 @@ import org.openhab.core.thing.type.ChannelKind;
 import org.openhab.core.thing.type.ChannelTypeUID;
 
 /**
- * The {@link ChannelDTOMapper} is an utility class to map channels into channel data transfer objects (DTOs).
+ * The {@link ChannelDTOMapper} is a utility class to map channels into channel data transfer objects (DTOs).
  *
  * @author Stefan Bußweiler - Initial contribution
  * @author Kai Kreuzer - added DTO to channel mapping

bundles/org.openhab.core.thing/src/main/java/org/openhab/core/thing/dto/StrippedThingTypeDTOMapper.java

@@ -19,7 +19,7 @@ import org.openhab.core.thing.type.BridgeType;
 import org.openhab.core.thing.type.ThingType;
 
 /**
- * The {@link StrippedThingTypeDTOMapper} is an utility class to map things into stripped thing type data transfer
+ * The {@link StrippedThingTypeDTOMapper} is a utility class to map things into stripped thing type data transfer
  * objects (DTOs).
  *
  * @author Miki Jankov - Initial contribution

bundles/org.openhab.core.thing/src/main/java/org/openhab/core/thing/dto/ThingDTOMapper.java

@@ -28,7 +28,7 @@ import org.openhab.core.thing.binding.builder.ThingBuilder;
 import org.openhab.core.thing.util.ThingHelper;
 
 /**
- * The {@link ThingDTOMapper} is an utility class to map things into data transfer objects (DTO).
+ * The {@link ThingDTOMapper} is a utility class to map things into data transfer objects (DTO).
  *
  * @author Stefan Bußweiler - Initial contribution
  * @author Kai Kreuzer - Added DTO to Thing mapping

bundles/org.openhab.core.thing/src/main/java/org/openhab/core/thing/profiles/dto/ProfileTypeDTOMapper.java

@@ -17,7 +17,7 @@ import org.openhab.core.thing.profiles.ProfileType;
 import org.openhab.core.thing.profiles.TriggerProfileType;
 
 /**
- * The {@link ProfileTypeDTOMapper} is an utility class to map profile-types into profile-type data transfer
+ * The {@link ProfileTypeDTOMapper} is a utility class to map profile-types into profile-type data transfer
  * objects (DTOs).
  *
  * @author Stefan Triller - Initial contribution

bundles/org.openhab.core.ui/src/main/java/org/openhab/core/ui/components/UIComponent.java

@@ -18,7 +18,7 @@ import java.util.List;
 import java.util.Map;
 
 /**
- * An UIComponent represents a piece of UI element for a client frontend to render; it is kept very simple and delegates
+ * A UIComponent represents a piece of UI element for a client frontend to render; it is kept very simple and delegates
  * the actual rendering and behavior to the frontend.
  *
  * It has a reference to a component's name as defined by the frontend, a map of configuration parameters, and several

bundles/org.openhab.core.ui/src/main/java/org/openhab/core/ui/internal/items/ItemUIRegistryImpl.java

@@ -504,7 +504,7 @@ public class ItemUIRegistryImpl implements ItemUIRegistry {
     }
 
     /**
-     * Takes the given <code>formatPattern</code> and replaces it with a analog
+     * Takes the given <code>formatPattern</code> and replaces it with an analog
      * String-based pattern to replace all value Occurrences with a dash ("-")
      *
      * @param formatPattern the original pattern which will be replaces by a

bundles/org.openhab.core.ui/src/main/java/org/openhab/core/ui/tiles/Tile.java

@@ -16,7 +16,7 @@ import org.eclipse.jdt.annotation.NonNullByDefault;
 import org.eclipse.jdt.annotation.Nullable;
 
 /**
- * A tile can be registered by an UI as a service in order to appear on the main openHAB UI.
+ * A tile can be registered by a UI as a service in order to appear on the main openHAB UI.
  *
  * @author Kai Kreuzer - initial contribution
  * @author Yannick Schaus - refactored into core, remove references to dashboard

bundles/org.openhab.core.voice/src/main/java/org/openhab/core/voice/KSServiceHandle.java

@@ -15,7 +15,7 @@ package org.openhab.core.voice;
 import org.eclipse.jdt.annotation.NonNullByDefault;
 
 /**
- * An handle to a {@link KSService}
+ * A handle to a {@link KSService}
  *
  * @author Kelly Davis - Initial contribution
  */

bundles/org.openhab.core.voice/src/main/java/org/openhab/core/voice/STTServiceHandle.java

@@ -15,7 +15,7 @@ package org.openhab.core.voice;
 import org.eclipse.jdt.annotation.NonNullByDefault;
 
 /**
- * An handle to a {@link STTService}
+ * A handle to a {@link STTService}
  *
  * @author Kelly Davis - Initial contribution
  */

bundles/org.openhab.core.voice/src/main/java/org/openhab/core/voice/internal/VoiceManagerImpl.java

@@ -71,7 +71,7 @@ import org.slf4j.LoggerFactory;
  * This service provides functionality around voice services and is the central service to be used directly by others.
  *
  * @author Kai Kreuzer - Initial contribution
- * @author Yannick Schaus - Added ability to provide a item for feedback during listening phases
+ * @author Yannick Schaus - Added ability to provide an item for feedback during listening phases
  * @author Christoph Weitkamp - Added getSupportedStreams() and UnsupportedAudioStreamException
  * @author Christoph Weitkamp - Added parameter to adjust the volume
  * @author Wouter Born - Sort TTS options

bundles/org.openhab.core/src/main/java/org/openhab/core/addon/AddonService.java

@@ -22,7 +22,7 @@ import org.eclipse.jdt.annotation.Nullable;
 /**
  * Classes implementing this interface can be registered as an OSGi service in order to provide functionality for
  * managing add-ons, such as listing, installing and uninstalling them.
- * The REST API offers an uri that exposes this functionality.
+ * The REST API offers a uri that exposes this functionality.
  *
  * @author Kai Kreuzer - Initial contribution
  * @author Yannick Schaus - Add id, name and refreshSource

bundles/org.openhab.core/src/main/java/org/openhab/core/auth/PendingToken.java

@@ -16,9 +16,9 @@ import org.eclipse.jdt.annotation.NonNullByDefault;
 import org.eclipse.jdt.annotation.Nullable;
 
 /**
- * The pending information used in a OAuth2 authorization flow, set after the user has authorized the client to access
+ * The pending information used in an OAuth2 authorization flow, set after the user has authorized the client to access
  * resources, and has been redirected to the callback URI with an authorization code. The information will be used when
- * it calls the token endpoint to exchange the authorization code for a access token and a refresh token.
+ * it calls the token endpoint to exchange the authorization code for an access token and a refresh token.
  *
  * The authorization code for a token is sensible information while it is valid, therefore the client is supposed to
  * call the token endpoint to perform the exchange it immediately after receiving it. The information should remain in

bundles/org.openhab.core/src/main/java/org/openhab/core/auth/UserProvider.java

@@ -16,7 +16,7 @@ import org.eclipse.jdt.annotation.NonNullByDefault;
 import org.openhab.core.common.registry.Provider;
 
 /**
- * A interface for a {@link Provider} of {@link User} entities
+ * An interface for a {@link Provider} of {@link User} entities
  *
  * @author Yannick Schaus - initial contribution
  *

bundles/org.openhab.core/src/main/java/org/openhab/core/auth/UserSession.java

@@ -37,7 +37,7 @@ public class UserSession {
     /**
      * Constructs a new session.
      *
-     * @param sessionId an unique ID for the session
+     * @param sessionId a unique ID for the session
      * @param refreshToken the refresh token associated to the session
      * @param clientId the client ID associated to the session
      * @param redirectUri the callback URI provided when the client was authorized by the user

bundles/org.openhab.core/src/main/java/org/openhab/core/auth/client/oauth2/OAuthClientService.java

@@ -20,7 +20,7 @@ import org.eclipse.jdt.annotation.Nullable;
 import com.google.gson.JsonDeserializer;
 
 /**
- * This is the service factory to produce a OAuth2 service client that authenticates using OAUTH2.
+ * This is the service factory to produce an OAuth2 service client that authenticates using OAUTH2.
  * This is a service factory pattern; the OAuthe2 service client is not shared between bundles.
  *
  * <p>
@@ -104,7 +104,7 @@ public interface OAuthClientService extends AutoCloseable {
      *            If the state is null, a random UUID will be generated and added state=<random UUID>,
      *            the state will be assigned to the requestParams in this case.
      * @return An authorization URL during the Authorization Code Grant with http request parameters filled in.
-     *         e.g Produces an URL string like this:
+     *         e.g Produces a URL string like this:
      *         https://oauth.provider?response_type=code&client_id=myClientId&redirect_uri=redirectURI&scope=myScope&state=mySecureRandomState
      * @throws OAuthException if authorizationUrl or clientId were not previously provided (null)
      */

bundles/org.openhab.core/src/main/java/org/openhab/core/common/AbstractUID.java

@@ -51,7 +51,7 @@ public abstract class AbstractUID {
     }
 
     /**
-     * Creates a AbstractUID for a list of segments.
+     * Creates an AbstractUID for a list of segments.
      *
      * @param segments the id segments
      */

bundles/org.openhab.core/src/main/java/org/openhab/core/items/dto/ItemDTOMapper.java

@@ -27,7 +27,7 @@ import org.openhab.core.items.ItemUtil;
 import org.openhab.core.types.State;
 
 /**
- * The {@link ItemDTOMapper} is an utility class to map items into item data transfer objects (DTOs).
+ * The {@link ItemDTOMapper} is a utility class to map items into item data transfer objects (DTOs).
  *
  * @author Kai Kreuzer - Initial contribution
  * @author Stefan Bußweiler - Moved to core and renamed class to DTO mapper

bundles/org.openhab.core/src/main/java/org/openhab/core/types/UnDefType.java

@@ -17,7 +17,7 @@ import org.eclipse.jdt.annotation.NonNullByDefault;
 /**
  * There are situations when item states do not have any defined value.
  * This might be because they have not been initialized yet (never
- * received an state update so far) or because their state is ambiguous
+ * received a state update so far) or because their state is ambiguous
  * (e.g. a dimmed light that is treated as a switch (ON/OFF) will have
  * an undefined state if it is dimmed to 50%).
  *

bundles/org.openhab.core/src/main/java/org/openhab/core/util/UIDUtils.java

@@ -25,7 +25,7 @@ import org.eclipse.jdt.annotation.NonNullByDefault;
 public class UIDUtils {
 
     /**
-     * Encodes a given string to an UID using only allowed characters.
+     * Encodes a given string to a UID using only allowed characters.
      *
      * <p>
      * The generated UID can be given to the {@link #decode(String)} function and it will result into the given value.
@@ -58,7 +58,7 @@ public class UIDUtils {
     }
 
     /**
-     * Decodes an UID that has been generated by the {@link #encode(String)} function.
+     * Decodes a UID that has been generated by the {@link #encode(String)} function.
      *
      * <p>
      * This function should only be used for UIDs generated by the {@link #encode(String)} function. For every other UID

bundles/org.openhab.core/src/test/java/org/openhab/core/internal/scheduler/SchedulerImplTest.java

@@ -99,7 +99,7 @@ public class SchedulerImplTest extends JavaTest {
     @Timeout(value = 15, unit = TimeUnit.SECONDS)
     public void testAfterResolvedWithException() throws InterruptedException {
         Callable<Void> callable = () -> {
-            // Pass a exception not very likely thrown by the scheduler it self to avoid missing real exceptions.
+            // Pass an exception not very likely thrown by the scheduler it self to avoid missing real exceptions.
             throw new FileNotFoundException("testBeforeTimeoutException");
         };
         ScheduledCompletableFuture<Void> after = scheduler.after(callable, Duration.ofMillis(100));

itests/org.openhab.core.automation.integration.tests/src/main/java/org/openhab/core/automation/integration/test/RuleSimulationTest.java

@@ -177,7 +177,7 @@ public class RuleSimulationTest extends JavaOSGiTest {
     }
 
     /**
-     * creates a rule with an cron expression trigger, that fires Wednesday and Friday at 10:30. Has one
+     * creates a rule with a cron expression trigger, that fires Wednesday and Friday at 10:30. Has one
      * condition that it should only run between 8:00 and 11:00.
      */
     private static Rule createRuleWithCronExpressionTrigger() {
@@ -206,7 +206,7 @@ public class RuleSimulationTest extends JavaOSGiTest {
     }
 
     /**
-     * creates a rule with an day of time trigger at 16:00, that has an side condition to fire only
+     * creates a rule with a day of time trigger at 16:00, that has a side condition to fire only
      * on Monday and Wednesday.
      */
     private static Rule createRuleWithTimeOfDayTrigger() {
@@ -234,7 +234,7 @@ public class RuleSimulationTest extends JavaOSGiTest {
     }
 
     /**
-     * creates a rule with an day of time trigger at 10:00, that has an side condition to fire only
+     * creates a rule with a day of time trigger at 10:00, that has a side condition to fire only
      * on the weekend.
      */
     private static Rule createRuleWithEphemerisCondition() {

itests/org.openhab.core.config.dispatch.tests/src/main/java/org/openhab/core/config/dispatch/internal/ConfigDispatcherOSGiTest.java

@@ -1004,7 +1004,7 @@ public class ConfigDispatcherOSGiTest extends JavaOSGiTest {
          * If a property is not present in the configuration's properties,
          * configuration.getProperties().get(property) should return null.
          *
-         * Sending events, related to modification of file, is a OS specific action.
+         * Sending events, related to modification of file, is an OS specific action.
          * So when we check if a configuration is updated, we use separate waitForAssert-s
          * in order to be sure that the events are processed before the assertion.
          */
@@ -1025,7 +1025,7 @@ public class ConfigDispatcherOSGiTest extends JavaOSGiTest {
          * If a property is not present in the configuration's properties,
          * configuration.getProperties().get(property) should return null.
          *
-         * Sending events, related to modification of file, is a OS specific action.
+         * Sending events, related to modification of file, is an OS specific action.
          * So when we check if a configuration is updated, we use separate waitForAssert-s
          * in order to be sure that the events are processed before the assertion.
          */