Fix a/an typos (openhab#3184)

bundles/org.openhab.core.addon.marketplace/src/main/java/org/openhab/core/addon/marketplace/AbstractRemoteAddonService.java

@@ -123,7 +123,7 @@ public void refreshSource() {
  }
 
  /**
- * Add an {@link MarketplaceAddonHandler) to this service
+ * Add a {@link MarketplaceAddonHandler) to this service
  *
  * This needs to be implemented by the addon-services because the handlers are references to OSGi services and
  * the @Reference annotation is not inherited.
@@ -134,7 +134,7 @@ public void refreshSource() {
  protected abstract void addAddonHandler(MarketplaceAddonHandler handler);
 
  /**
- * Remove an {@link MarketplaceAddonHandler) from this service
+ * Remove a {@link MarketplaceAddonHandler) from this service
  *
  * This needs to be implemented by the addon-services because the handlers are references to OSGi services and
  * unbind methods can't be inherited.

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

@@ -272,7 +272,7 @@ private String getContentType(@Nullable Integer category, List<String> tags) {
  }
 
  /**
- * Transforms a {@link DiscourseTopicItem} to a {@link Addon}
+ * Transforms a {@link DiscourseTopicItem} to an {@link Addon}
  *
  * @param topic the topic
  * @return the list item
@@ -344,7 +344,7 @@ private String unescapeEntities(String content) {
  }
 
  /**
- * Transforms a {@link DiscourseTopicResponseDTO} to a {@link Addon}
+ * Transforms a {@link DiscourseTopicResponseDTO} to an {@link Addon}
  *
  * @param topic the topic
  * @return the list item

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

@@ -53,7 +53,7 @@ public interface AudioSink {
  * If the passed {@link AudioStream} is not supported by this instance, an {@link UnsupportedAudioStreamException}
  * is thrown.
  *
- * If the passed {@link AudioStream} has a {@link AudioFormat} not supported by this instance,
+ * If the passed {@link AudioStream} has an {@link AudioFormat} not supported by this instance,
  * an {@link UnsupportedAudioFormatException} is thrown.
  *
  * In case the audioStream is null, this should be interpreted as a request to end any currently playing stream.

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

@@ -229,7 +229,7 @@ public String toString() {
  }
 
  /**
- * Converts a javax.sound.sampled.AudioFormat to a org.openhab.core.audio.AudioFormat
+ * Converts a javax.sound.sampled.AudioFormat to an org.openhab.core.audio.AudioFormat
  *
  * @param audioFormat the AudioFormat to convert
  * @return The converted AudioFormat

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

@@ -17,7 +17,7 @@
 import org.eclipse.jdt.annotation.NonNullByDefault;
 
 /**
- * Expected execution of an {@link Rule}.
+ * Expected execution of a {@link Rule}.
  *
  * @author Sönke Küper - Initial contribution
  */

bundles/org.openhab.core.config.xml/src/main/java/org/openhab/core/config/xml/ConfigDescriptionParameterGroupConverter.java

@@ -24,8 +24,7 @@
 
 /**
  * The {@link ConfigDescriptionParameterGroupConverter} creates a {@link ConfigDescriptionParameterGroup} instance from
- * a {@code option} XML
- * node.
+ * an {@code option} XML node.
  *
  * @author Chris Jackson - Initial contribution
  */

bundles/org.openhab.core.io.rest.audio/src/main/java/org/openhab/core/io/rest/audio/internal/AudioMapper.java

@@ -27,7 +27,7 @@
 public class AudioMapper {
 
  /**
- * Maps a {@link AudioSource} to an {@link AudioSourceDTO}.
+ * Maps an {@link AudioSource} to an {@link AudioSourceDTO}.
  *
  * @param source the audio source
  * @param locale the locale to use for the DTO
@@ -39,7 +39,7 @@ public static AudioSourceDTO map(AudioSource source, Locale locale) {
  }
 
  /**
- * Maps a {@link AudioSink} to an {@link AudioSinkDTO}.
+ * Maps an {@link AudioSink} to an {@link AudioSinkDTO}.
  *
  * @param sink the audio sink
  * @param locale the locale to use for the DTO

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

@@ -133,7 +133,7 @@ public String getJwtAccessToken(User user, String clientId, String scope, int to
  }
 
  /**
- * Performs verifications on a JWT token, then parses it into a {@link AuthenticationException} instance
+ * Performs verifications on a JWT token, then parses it into an {@link AuthenticationException} instance
  *
  * @param jwt the base64-encoded JWT token from the request
  * @return the {@link Authentication} derived from the information in the token

bundles/org.openhab.core.io.rest.voice/src/main/java/org/openhab/core/io/rest/voice/internal/HLIMapper.java

@@ -28,7 +28,7 @@
 public class HLIMapper {
 
  /**
- * Maps a {@link HumanLanguageInterpreter} to an {@link HumanLanguageInterpreterDTO}.
+ * Maps a {@link HumanLanguageInterpreter} to a {@link HumanLanguageInterpreterDTO}.
  *
  * @param hli the human language interpreter
  * @param locale the locale to use for the DTO

bundles/org.openhab.core.io.rest.voice/src/main/java/org/openhab/core/io/rest/voice/internal/VoiceMapper.java

@@ -24,7 +24,7 @@
 public class VoiceMapper {
 
  /**
- * Maps a {@link Voice} to an {@link VoiceDTO}.
+ * Maps a {@link Voice} to a {@link VoiceDTO}.
  *
  * @param voice the voice
  *

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

@@ -45,7 +45,7 @@ public static boolean isLocation(Item item) {
  }
 
  /**
- * Checks if the given {@link Item} is a {@link Equipment}.
+ * Checks if the given {@link Item} is an {@link Equipment}.
  *
  * @param item the Item to check
  * @return return true, if the given Item is an Equipment, false otherwise

bundles/org.openhab.core.storage.json/src/main/java/org/openhab/core/storage/json/internal/migration/RenamingTypeMigrator.java

@@ -15,7 +15,7 @@
 import org.eclipse.jdt.annotation.NonNullByDefault;
 
 /**
- * The {@link RenamingTypeMigrator} is an {@link TypeMigrator} for renaming types
+ * The {@link RenamingTypeMigrator} is a {@link TypeMigrator} for renaming types
  *
  * @author Jan N. Klug - Initial contribution
  */

bundles/org.openhab.core.thing.xml/src/main/java/org/openhab/core/thing/xml/internal/EventDescriptionConverter.java

@@ -32,7 +32,7 @@
 
 /**
  * The {@link EventDescriptionConverter} is a concrete implementation of the {@code XStream} {@link Converter} interface
- * used to convert a event description within an XML document into a {@link EventDescription} object.
+ * used to convert a event description within an XML document into an {@link EventDescription} object.
  * <p>
  * This converter converts {@code state} XML tags.
  *

bundles/org.openhab.core.thing/src/main/java/org/openhab/core/thing/link/events/ItemChannelLinkAddedEvent.java

@@ -16,7 +16,7 @@
 import org.openhab.core.thing.link.dto.ItemChannelLinkDTO;
 
 /**
- * A {@link ItemChannelLinkAddedEvent} notifies subscribers that an item channel link has been added.
+ * An {@link ItemChannelLinkAddedEvent} notifies subscribers that an item channel link has been added.
  * Events must be created with the {@link LinkEventFactory}.
  *
  * @author Dennis Nobel - Initial contribution

bundles/org.openhab.core.thing/src/main/java/org/openhab/core/thing/link/events/ItemChannelLinkRemovedEvent.java

@@ -16,7 +16,7 @@
 import org.openhab.core.thing.link.dto.ItemChannelLinkDTO;
 
 /**
- * A {@link ItemChannelLinkRemovedEvent} notifies subscribers that an item channel link has been removed.
+ * An {@link ItemChannelLinkRemovedEvent} notifies subscribers that an item channel link has been removed.
  * Events must be created with the {@link LinkEventFactory}.
  *
  * @author Dennis Nobel - Initial contribution

bundles/org.openhab.core.thing/src/main/java/org/openhab/core/thing/type/AutoUpdatePolicy.java

@@ -43,7 +43,7 @@ public enum AutoUpdatePolicy {
  RECOMMEND;
 
  /**
- * Parses the input string into a {@link AutoUpdatePolicy}.
+ * Parses the input string into an {@link AutoUpdatePolicy}.
  *
  * @param input the input string
  * @return the parsed AutoUpdatePolicy

bundles/org.openhab.core.transform/src/main/java/org/openhab/core/transform/TransformationService.java

@@ -38,7 +38,7 @@ public interface TransformationService {
  /**
  * Transforms the input <code>source</code> by means of the given <code>function</code> and returns the transformed
  * output. The transformation may return <code>null</code> to express its operation resulted in a <code>null</code>
- * output. In case of any error an {@link TransformationException} should be thrown.
+ * output. In case of any error a {@link TransformationException} should be thrown.
  *
  * @param function the function to be used to transform the input
  * @param source the input to be transformed

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

@@ -67,7 +67,7 @@ public interface KSService {
  * fired {@link KSEvent} events targeting the passed {@link KSListener}.
  *
  * The passed {@link AudioStream} must be of a supported {@link AudioFormat}.
- * In other words a {@link AudioFormat} compatible with one returned from
+ * In other words an {@link AudioFormat} compatible with one returned from
  * the {@code getSupportedFormats()} method.
  *
  * The passed {@code Locale} must be supported. That is to say it must be

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

@@ -67,7 +67,7 @@ public interface STTService {
  * fired {@link STTEvent} events targeting the passed {@link STTListener}.
  *
  * The passed {@link AudioStream} must be of a supported {@link AudioFormat}.
- * In other words a {@link AudioFormat} compatible with one returned from
+ * In other words an {@link AudioFormat} compatible with one returned from
  * the {@code getSupportedFormats()} method.
  *
  * The passed {@code Locale} must be supported. That is to say it must be

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

@@ -40,7 +40,7 @@ public interface UserRegistry extends Registry<User, String>, AuthenticationProv
  public User register(String username, String password, Set<String> roles);
 
  /**
- * Change the password for an {@link User} in this registry. The implementation receives the new password and is
+ * Change the password for a {@link User} in this registry. The implementation receives the new password and is
  * responsible for their secure storage (for instance by hashing the password).
  *
  * @param username the username of the existing user

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

@@ -277,7 +277,7 @@ AccessTokenResponse getAccessTokenByImplicit(@Nullable String redirectURI, @Null
  boolean isClosed();
 
  /**
- * Adds a {@link AccessTokenRefreshListener}.
+ * Adds an {@link AccessTokenRefreshListener}.
  *
  * @param listener the listener to add
  */

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

@@ -23,7 +23,7 @@ public final class EventOption {
  private String label;
 
  /**
- * Creates a {@link EventOption} object.
+ * Creates an {@link EventOption} object.
  *
  * @param value value of the event
  * @param label label