Typos a/an (#13812)

bundles/org.openhab.binding.ahawastecollection/README.md

@@ -71,7 +71,7 @@ DateTime collectionDay_paper "Next paper collection" {channel="ahawastecollectio
 ```
 
 
-Example for rule that sends an notification with collected waste types on day before collection
+Example for rule that sends a notification with collected waste types on day before collection
 
 ```
 triggers:

bundles/org.openhab.binding.ahawastecollection/src/main/java/org/openhab/binding/ahawastecollection/internal/AhaCollectionScheduleFactory.java

@@ -23,7 +23,7 @@ import org.eclipse.jdt.annotation.NonNullByDefault;
 public interface AhaCollectionScheduleFactory {
 
     /**
-     * Creates an new {@link AhaCollectionSchedule} for the given location.
+     * Creates a new {@link AhaCollectionSchedule} for the given location.
      */
     public AhaCollectionSchedule create(final String commune, final String street, final String houseNumber,
             final String houseNumberAddon, final String collectionPlace);

bundles/org.openhab.binding.ahawastecollection/src/main/java/org/openhab/binding/ahawastecollection/internal/AhaCollectionScheduleImpl.java

@@ -56,7 +56,7 @@ final class AhaCollectionScheduleImpl implements AhaCollectionSchedule {
     private final String collectionPlace;
 
     /**
-     * Creates an new {@link AhaCollectionScheduleImpl} for the given location.
+     * Creates a new {@link AhaCollectionScheduleImpl} for the given location.
      */
     public AhaCollectionScheduleImpl(final String commune, final String street, final String houseNumber,
             final String houseNumberAddon, final String collectionPlace) {
@@ -149,7 +149,7 @@ final class AhaCollectionScheduleImpl implements AhaCollectionSchedule {
     }
 
     /**
-     * Returns <code>true</code> if the row is an (empty) delimiter row or if its an row that contains the download
+     * Returns <code>true</code> if the row is an (empty) delimiter row or if its a row that contains the download
      * buttons for ical.
      */
     private boolean isDelimiterOrDownloadRow(Element currentRow) {

bundles/org.openhab.binding.ahawastecollection/src/main/java/org/openhab/binding/ahawastecollection/internal/AhaWasteCollectionHandler.java

@@ -125,7 +125,7 @@ public class AhaWasteCollectionHandler extends BaseThingHandler {
     }
 
     /**
-     * Schedules an job that updates the collection dates at midnight.
+     * Schedules a job that updates the collection dates at midnight.
      */
     private void restartJob() {
         this.logger.debug("Restarting jobs for thing {}", this.getThing().getUID());

bundles/org.openhab.binding.ahawastecollection/src/main/java/org/openhab/binding/ahawastecollection/internal/CollectionDate.java

@@ -19,7 +19,7 @@ import java.util.List;
 import org.eclipse.jdt.annotation.NonNullByDefault;
 
 /**
- * Contains the next collection dates for an given waste type.
+ * Contains the next collection dates for a given waste type.
  * 
  * @author Sönke Küper - Initial contribution
  */
@@ -70,7 +70,7 @@ final class CollectionDate {
     private final List<Date> dates;
 
     /**
-     * Creates an new {@link CollectionDate}.
+     * Creates a new {@link CollectionDate}.
      */
     public CollectionDate(final WasteType type, final List<Date> dates) {
         this.type = type;

bundles/org.openhab.binding.ahawastecollection/src/main/resources/OH-INF/thing/thing-types.xml

@@ -41,7 +41,7 @@
 		</config-description>
 	</thing-type>
 
-	<!-- Channel type that represents the collection time of an waste type. -->
+	<!-- Channel type that represents the collection time of a waste type. -->
 	<channel-type id="collectionDateGeneralWaste">
 		<item-type>DateTime</item-type>
 		<label>General Waste</label>

bundles/org.openhab.binding.ahawastecollection/src/test/java/org/openhab/binding/ahawastecollection/internal/AhaWasteCollectionHandlerTest.java

@@ -58,7 +58,7 @@ public class AhaWasteCollectionHandlerTest {
     }
 
     /**
-     * Exception indicating that the execution of an script within the stub-Scheduler failed.
+     * Exception indicating that the execution of a script within the stub-Scheduler failed.
      */
     private static class SchedulerRuntimeException extends RuntimeException {
 
@@ -70,7 +70,7 @@ public class AhaWasteCollectionHandlerTest {
     }
 
     /**
-     * Creates an {@link CronScheduler} that executes all commands synchronous.
+     * Creates a {@link CronScheduler} that executes all commands synchronous.
      */
     @SuppressWarnings("unchecked")
     private static CronScheduler createStubScheduler() {

bundles/org.openhab.binding.allplay/src/main/java/org/openhab/binding/allplay/internal/AllPlayAudioSink.java

@@ -32,7 +32,7 @@ import org.slf4j.LoggerFactory;
 import de.kaizencode.tchaikovsky.exception.SpeakerException;
 
 /**
- * The {@link AllPlayAudioSink} make AllPlay speakers available as a {@link AudioSink}.
+ * The {@link AllPlayAudioSink} make AllPlay speakers available as an {@link AudioSink}.
  *
  * @author Dominic Lerbs - Initial contribution
  */

bundles/org.openhab.binding.amazonechocontrol/README.md

@@ -599,7 +599,7 @@ then
 end
 ```
 
-## Playing an alarm sound for 15 seconds with an openHAB rule if an door contact was opened:
+## Playing an alarm sound for 15 seconds with an openHAB rule if a door contact was opened:
 
 1) Do get the ID of your sound, follow the steps in "How To Get IDs"
 2) Write down the text in the square brackets. e.g. ECHO:system_alerts_repetitive01 for the nightstand sound

bundles/org.openhab.binding.amazonechocontrol/src/main/java/org/openhab/binding/amazonechocontrol/internal/discovery/SmartHomeDevicesDiscovery.java

@@ -215,7 +215,7 @@ public class SmartHomeDevicesDiscovery extends AbstractDiscoveryService {
                 Set<SmartHomeDevice> supportedChildren = SmartHomeDeviceHandler.getSupportedSmartHomeDevices(shg,
                         deviceList);
                 if (supportedChildren.isEmpty()) {
-                    // No children with an supported interface
+                    // No children with a supported interface
                     continue;
                 }
                 thingUID = new ThingUID(THING_TYPE_SMART_HOME_DEVICE_GROUP, bridgeThingUID, id.replace(".", "-"));

bundles/org.openhab.binding.atlona/src/main/java/org/openhab/binding/atlona/internal/StatefulHandlerCallback.java

@@ -24,7 +24,7 @@ import org.openhab.core.types.State;
 
 /**
  * Defines an implementation of {@link AtlonaHandlerCallback} that will remember the last state
- * for an channelId and suppress the callback if the state hasn't changed
+ * for a channelId and suppress the callback if the state hasn't changed
  *
  * @author Tim Roberts - Initial contribution
  */

bundles/org.openhab.binding.bluetooth.bluegiga/README.md

@@ -22,7 +22,7 @@ Additionally, the parameter `backgroundDiscovery` can be set to true/false. When
 
 ## Example
 
-This is how an BlueGiga adapter can be configured textually in a *.things file:
+This is how a BlueGiga adapter can be configured textually in a *.things file:
 
 ```
 Bridge bluetooth:bluegiga:1 [ port="/dev/ttyS0", backgroundDiscovery=false ]

bundles/org.openhab.binding.bluetooth.bluegiga/src/main/java/org/openhab/binding/bluetooth/bluegiga/internal/BlueGigaTransactionManager.java

@@ -184,7 +184,7 @@ public class BlueGigaTransactionManager implements BlueGigaSerialEventListener {
     }
 
     /**
-     * Sends an BlueGiga request without waiting for the response.
+     * Sends a BlueGiga request without waiting for the response.
      *
      * @param bleCommand {@link BlueGigaCommand}
      * @return response {@link Future} {@link BlueGigaResponse}

bundles/org.openhab.binding.bluetooth.bluez/README.md

@@ -57,7 +57,7 @@ Additionally, the parameter `backgroundDiscovery` can be set to true/false.When
 
 ## Example
 
-This is how an BlueZ adapter can be configured textually in a *.things file:
+This is how a BlueZ adapter can be configured textually in a *.things file:
 
 ```
 Bridge bluetooth:bluez:hci0 [ address="12:34:56:78:90:AB", backgroundDiscovery=false ]

bundles/org.openhab.binding.bluetooth.roaming/README.md

@@ -35,7 +35,7 @@ The `backgroundDiscovery` parameter is true by default.
 
 ## Example
 
-This is how an Roaming adapter can be configured textually in a *.things file:
+This is how a Roaming adapter can be configured textually in a *.things file:
 
 ```
 Bridge bluetooth:roaming:ctrl "BLE Roaming Adapter" [ backgroundDiscovery=true]

bundles/org.openhab.binding.bluetooth/src/main/java/org/openhab/binding/bluetooth/BluetoothAdapter.java

@@ -19,7 +19,7 @@ import org.openhab.core.thing.ThingUID;
 
 /**
  * The {@link BluetoothAdapter} class defines the standard adapter API that must be implemented by bridge handlers,
- * which are then required to be registered as an BluetoothAdapter OSGi service.
+ * which are then required to be registered as a BluetoothAdapter OSGi service.
  * <p>
  * <b>Scanning</b>
  * The API assumes that the adapter is "always" scanning to enable beacons to be received.

bundles/org.openhab.binding.darksky/src/main/java/org/openhab/binding/darksky/internal/discovery/DarkSkyDiscoveryService.java

@@ -53,7 +53,7 @@ public class DarkSkyDiscoveryService extends AbstractDiscoveryService {
     private final DarkSkyAPIHandler bridgeHandler;
 
     /**
-     * Creates an DarkSkyLocationDiscoveryService.
+     * Creates a DarkSkyLocationDiscoveryService.
      */
     public DarkSkyDiscoveryService(DarkSkyAPIHandler bridgeHandler, LocationProvider locationProvider,
             LocaleProvider localeProvider, TranslationProvider i18nProvider) {

bundles/org.openhab.binding.darksky/src/main/java/org/openhab/binding/darksky/internal/model/DarkSkyCurrentlyData.java

@@ -13,7 +13,7 @@
 package org.openhab.binding.darksky.internal.model;
 
 /**
- * The {@link DarkSkyCurrentlyData} is the Java class used to map the JSON response to an Dark Sky request.
+ * The {@link DarkSkyCurrentlyData} is the Java class used to map the JSON response to a Dark Sky request.
  *
  * @author Christoph Weitkamp - Initial contribution
  */

bundles/org.openhab.binding.darksky/src/main/java/org/openhab/binding/darksky/internal/model/DarkSkyDailyData.java

@@ -17,7 +17,7 @@ import java.util.List;
 import org.eclipse.jdt.annotation.Nullable;
 
 /**
- * The {@link DarkSkyDailyData} is the Java class used to map the JSON response to an Dark Sky request.
+ * The {@link DarkSkyDailyData} is the Java class used to map the JSON response to a Dark Sky request.
  *
  * @author Christoph Weitkamp - Initial contribution
  */

bundles/org.openhab.binding.darksky/src/main/java/org/openhab/binding/darksky/internal/model/DarkSkyHourlyData.java

@@ -17,7 +17,7 @@ import java.util.List;
 import org.eclipse.jdt.annotation.Nullable;
 
 /**
- * The {@link DarkSkyHourlyData} is the Java class used to map the JSON response to an Dark Sky request.
+ * The {@link DarkSkyHourlyData} is the Java class used to map the JSON response to a Dark Sky request.
  *
  * @author Christoph Weitkamp - Initial contribution
  */

bundles/org.openhab.binding.darksky/src/main/java/org/openhab/binding/darksky/internal/model/DarkSkyJsonWeatherData.java

@@ -17,7 +17,7 @@ import java.util.List;
 import org.eclipse.jdt.annotation.Nullable;
 
 /**
- * The {@link DarkSkyJsonWeatherData} is the Java class used to map the JSON response to an Dark Sky request.
+ * The {@link DarkSkyJsonWeatherData} is the Java class used to map the JSON response to a Dark Sky request.
  *
  * @author Christoph Weitkamp - Initial contribution
  */

bundles/org.openhab.binding.deutschebahn/src/main/java/org/openhab/binding/deutschebahn/internal/AbstractDtoAttributeSelector.java

@@ -22,7 +22,7 @@ import org.openhab.binding.deutschebahn.internal.timetable.dto.JaxbEntity;
 import org.openhab.core.types.State;
 
 /**
- * Accessor for attribute value of an DTO-Object.
+ * Accessor for attribute value of a DTO-Object.
  * 
  * @author Sönke Küper - Initial contribution.
  *
@@ -41,7 +41,7 @@ public abstract class AbstractDtoAttributeSelector<DTO_TYPE extends JaxbEntity,
     private final Function<VALUE_TYPE, List<String>> valueToList;
 
     /**
-     * Creates an new {@link EventAttribute}.
+     * Creates a new {@link EventAttribute}.
      *
      * @param getter Function to get the raw value.
      * @param setter Function to set the raw value.

bundles/org.openhab.binding.deutschebahn/src/main/java/org/openhab/binding/deutschebahn/internal/AttributeSelection.java

@@ -20,7 +20,7 @@ import org.openhab.binding.deutschebahn.internal.timetable.dto.TimetableStop;
 import org.openhab.core.types.State;
 
 /**
- * Selection of an attribute within an {@link TimetableStop} that provides a channel {@link State}.
+ * Selection of an attribute within a {@link TimetableStop} that provides a channel {@link State}.
  * 
  * @author Sönke Küper - Initial contribution
  */

bundles/org.openhab.binding.deutschebahn/src/main/java/org/openhab/binding/deutschebahn/internal/DeutscheBahnTrainHandler.java

@@ -31,9 +31,9 @@ import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
 /**
- * Handler for an Train-Thing in DeutscheBahn Binding.
+ * Handler for a Train-Thing in DeutscheBahn Binding.
  *
- * Represents an Train that arrives / departs at the station selected by the DeutscheBahnTimetable-Bridge.
+ * Represents a Train that arrives / departs at the station selected by the DeutscheBahnTimetable-Bridge.
  *
  * @author Sönke Küper - Initial contribution
  */
@@ -49,7 +49,7 @@ public class DeutscheBahnTrainHandler extends BaseThingHandler {
         private final AttributeSelection attributeSelection;
 
         /**
-         * Creates an new ChannelWithConfig.
+         * Creates a new ChannelWithConfig.
          * 
          * @param channelUid The UID of the channel
          * @param attributeSelection The attribute that provides the state that will be displayed.
@@ -88,7 +88,7 @@ public class DeutscheBahnTrainHandler extends BaseThingHandler {
     private final List<ChannelWithConfig> configuredChannels = new ArrayList<>();
 
     /**
-     * Creates an new {@link DeutscheBahnTrainHandler}.
+     * Creates a new {@link DeutscheBahnTrainHandler}.
      */
     public DeutscheBahnTrainHandler(Thing thing) {
         super(thing);
@@ -123,7 +123,7 @@ public class DeutscheBahnTrainHandler extends BaseThingHandler {
     }
 
     /**
-     * Creates an {@link ChannelWithConfig} for an channel that represents an attribute of an
+     * Creates a {@link ChannelWithConfig} for a channel that represents an attribute of an
      * {@link org.openhab.binding.deutschebahn.internal.timetable.dto.TripLabel}.
      */
     private void createTripChannelConfiguration(Channel channel) {
@@ -141,7 +141,7 @@ public class DeutscheBahnTrainHandler extends BaseThingHandler {
     }
 
     /**
-     * Creates the {@link ChannelWithConfig} for an channel that represents an attribute of an
+     * Creates the {@link ChannelWithConfig} for a channel that represents an attribute of an
      * {@link org.openhab.binding.deutschebahn.internal.timetable.dto.Event}.}
      */
     private void createEventChannelConfiguration(EventType eventType, Channel channel) {

bundles/org.openhab.binding.deutschebahn/src/main/java/org/openhab/binding/deutschebahn/internal/EventAttribute.java

@@ -215,7 +215,7 @@ public final class EventAttribute<VALUE_TYPE, STATE_TYPE extends State>
     private static final SimpleDateFormat DATETIME_FORMAT = new SimpleDateFormat("yyMMddHHmm");
 
     /**
-     * Creates an new {@link EventAttribute}.
+     * Creates a new {@link EventAttribute}.
      *
      * @param getter Function to get the raw value.
      * @param setter Function to set the raw value.

bundles/org.openhab.binding.deutschebahn/src/main/java/org/openhab/binding/deutschebahn/internal/EventAttributeSelection.java

@@ -36,7 +36,7 @@ public final class EventAttributeSelection implements AttributeSelection {
     private final EventAttribute<?, ?> eventAttribute;
 
     /**
-     * Creates an new {@link EventAttributeSelection}.
+     * Creates a new {@link EventAttributeSelection}.
      */
     public EventAttributeSelection(EventType eventType, EventAttribute<?, ?> eventAttribute) {
         this.eventType = eventType;

bundles/org.openhab.binding.deutschebahn/src/main/java/org/openhab/binding/deutschebahn/internal/EventType.java

@@ -20,7 +20,7 @@ import org.openhab.binding.deutschebahn.internal.timetable.dto.Event;
 import org.openhab.binding.deutschebahn.internal.timetable.dto.TimetableStop;
 
 /**
- * Type of an {@link Event} within an {@link TimetableStop}.
+ * Type of an {@link Event} within a {@link TimetableStop}.
  * 
  * @author Sönke Küper - initial contribution
  */

bundles/org.openhab.binding.deutschebahn/src/main/java/org/openhab/binding/deutschebahn/internal/TripLabelAttribute.java

@@ -27,7 +27,7 @@ import org.openhab.core.types.State;
 import org.openhab.core.types.UnDefType;
 
 /**
- * Selection that returns the value of an {@link TripLabel}.
+ * Selection that returns the value of a {@link TripLabel}.
  * 
  * chapter "1.2.7 TripLabel" in Technical Interface Description for external Developers
  *
@@ -73,7 +73,7 @@ public final class TripLabelAttribute<VALUE_TYPE, STATE_TYPE extends State> exte
             TripLabel::setO, StringType::new, TripLabelAttribute::singletonList, StringType.class);
 
     /**
-     * Creates an new {@link TripLabelAttribute}.
+     * Creates a new {@link TripLabelAttribute}.
      *
      * @param getter Function to get the raw value.
      * @param setter Function to set the raw value.
@@ -133,7 +133,7 @@ public final class TripLabelAttribute<VALUE_TYPE, STATE_TYPE extends State> exte
     }
 
     /**
-     * Returns an {@link TripLabelAttribute} for the given channel-name.
+     * Returns a {@link TripLabelAttribute} for the given channel-name.
      */
     @Nullable
     public static TripLabelAttribute<?, ?> getByChannelName(final String channelName) {

bundles/org.openhab.binding.deutschebahn/src/main/java/org/openhab/binding/deutschebahn/internal/filter/AndPredicate.java

@@ -27,7 +27,7 @@ public final class AndPredicate implements TimetableStopPredicate {
     private final TimetableStopPredicate second;
 
     /**
-     * Creates an new {@link AndPredicate}.
+     * Creates a new {@link AndPredicate}.
      */
     public AndPredicate(TimetableStopPredicate first, TimetableStopPredicate second) {
         this.first = first;

bundles/org.openhab.binding.deutschebahn/src/main/java/org/openhab/binding/deutschebahn/internal/filter/ChannelNameEquals.java

@@ -34,7 +34,7 @@ public final class ChannelNameEquals extends FilterToken {
     private final String channelGroup;
 
     /**
-     * Creates an new {@link ChannelNameEquals}.
+     * Creates a new {@link ChannelNameEquals}.
      */
     public ChannelNameEquals(int position, String channelGroup, String channelName, Pattern filterPattern) {
         super(position);
@@ -75,7 +75,7 @@ public final class ChannelNameEquals extends FilterToken {
     }
 
     /**
-     * Maps this into an {@link TimetableStopByStringEventAttributeFilter}.
+     * Maps this into a {@link TimetableStopByStringEventAttributeFilter}.
      */
     public TimetableStopByStringEventAttributeFilter mapToPredicate() throws FilterParserException {
         return new TimetableStopByStringEventAttributeFilter(mapAttributeSelection(), filterValue);

bundles/org.openhab.binding.deutschebahn/src/main/java/org/openhab/binding/deutschebahn/internal/filter/FilterParser.java

@@ -18,7 +18,7 @@ import org.eclipse.jdt.annotation.NonNullByDefault;
 import org.eclipse.jdt.annotation.Nullable;
 
 /**
- * Parses an {@link FilterToken}-Sequence into a {@link TimetableStopPredicate}.
+ * Parses a {@link FilterToken}-Sequence into a {@link TimetableStopPredicate}.
  * 
  * @author Sönke Küper - Initial contribution.
  */
@@ -287,7 +287,7 @@ public final class FilterParser {
     }
 
     /**
-     * Parses the given {@link FilterToken} into an {@link TimetableStopPredicate}.
+     * Parses the given {@link FilterToken} into a {@link TimetableStopPredicate}.
      */
     public static TimetableStopPredicate parse(final List<FilterToken> tokens) throws FilterParserException {
         State state = new InitialState();

bundles/org.openhab.binding.deutschebahn/src/main/java/org/openhab/binding/deutschebahn/internal/filter/FilterParserException.java

@@ -25,7 +25,7 @@ public final class FilterParserException extends Exception {
     private static final long serialVersionUID = 3104578924298682889L;
 
     /**
-     * Creates an new {@link FilterParserException}.
+     * Creates a new {@link FilterParserException}.
      */
     public FilterParserException(String message) {
         super(message);

bundles/org.openhab.binding.deutschebahn/src/main/java/org/openhab/binding/deutschebahn/internal/filter/FilterScanner.java

@@ -149,7 +149,7 @@ public final class FilterScanner {
         private final String channelGroup;
 
         /**
-         * Creates an new {@link ExpectQuotesState}.
+         * Creates a new {@link ExpectQuotesState}.
          */
         public ExpectQuotesState(int startPosition, final String channelGroup, String channelName) {
             this.startPosition = startPosition;
@@ -182,7 +182,7 @@ public final class FilterScanner {
         private final StringBuilder filterValue;
 
         /**
-         * Creates an new {@link FilterValueState}.
+         * Creates a new {@link FilterValueState}.
          */
         public FilterValueState(int startPosition, String channelGroup, String channelName) {
             this.startPosition = startPosition;
@@ -216,7 +216,7 @@ public final class FilterScanner {
     private List<FilterToken> result;
 
     /**
-     * Creates an new {@link FilterScanner}.
+     * Creates a new {@link FilterScanner}.
      */
     public FilterScanner() {
         this.result = new ArrayList<>();

bundles/org.openhab.binding.deutschebahn/src/main/java/org/openhab/binding/deutschebahn/internal/filter/FilterToken.java

@@ -25,7 +25,7 @@ public abstract class FilterToken {
     private final int position;
 
     /**
-     * Creates an new {@link FilterToken}.
+     * Creates a new {@link FilterToken}.
      */
     public FilterToken(int position) {
         this.position = position;

bundles/org.openhab.binding.deutschebahn/src/main/java/org/openhab/binding/deutschebahn/internal/filter/OperatorToken.java

@@ -23,7 +23,7 @@ import org.eclipse.jdt.annotation.NonNullByDefault;
 public abstract class OperatorToken extends FilterToken {
 
     /**
-     * Creates an new {@link OperatorToken}.
+     * Creates a new {@link OperatorToken}.
      */
     public OperatorToken(int position) {
         super(position);

bundles/org.openhab.binding.deutschebahn/src/main/java/org/openhab/binding/deutschebahn/internal/filter/OrPredicate.java

@@ -27,7 +27,7 @@ final class OrPredicate implements TimetableStopPredicate {
     private final TimetableStopPredicate second;
 
     /**
-     * Creates an new {@link OrPredicate}.
+     * Creates a new {@link OrPredicate}.
      */
     public OrPredicate(TimetableStopPredicate first, TimetableStopPredicate second) {
         this.first = first;

bundles/org.openhab.binding.deutschebahn/src/main/java/org/openhab/binding/deutschebahn/internal/filter/TimetableStopByStringEventAttributeFilter.java

@@ -20,7 +20,7 @@ import org.openhab.binding.deutschebahn.internal.AttributeSelection;
 import org.openhab.binding.deutschebahn.internal.timetable.dto.TimetableStop;
 
 /**
- * Abstract predicate that filters timetable stops by an selected attribute of an {@link TimetableStop}.
+ * Abstract predicate that filters timetable stops by a selected attribute of a {@link TimetableStop}.
  * 
  * If value has multiple values (for example stations on the planned-path) the predicate will return <code>true</code>,
  * if at least one value matches the given filter.
@@ -34,7 +34,7 @@ public final class TimetableStopByStringEventAttributeFilter implements Timetabl
     private final Pattern filter;
 
     /**
-     * Creates an new {@link TimetableStopByStringEventAttributeFilter}.
+     * Creates a new {@link TimetableStopByStringEventAttributeFilter}.
      */
     TimetableStopByStringEventAttributeFilter(final AttributeSelection attributeSelection, final Pattern filter) {
         this.attributeSelection = attributeSelection;

bundles/org.openhab.binding.deutschebahn/src/main/java/org/openhab/binding/deutschebahn/internal/timetable/TimetableLoader.java

@@ -38,7 +38,7 @@ import org.openhab.binding.deutschebahn.internal.timetable.dto.TimetableStop;
 import org.openhab.core.library.types.DateTimeType;
 
 /**
- * Helper for loading the required amount of {@link TimetableStop} via an {@link TimetablesV1Api}.
+ * Helper for loading the required amount of {@link TimetableStop} via a {@link TimetablesV1Api}.
  * This consists of a series of calls.
  *
  * @author Sönke Küper - initial contribution
@@ -73,7 +73,7 @@ public final class TimetableLoader {
     private Date lastRequestedChanges;
 
     /**
-     * Creates an new {@link TimetableLoader}.
+     * Creates a new {@link TimetableLoader}.
      *
      * @param api {@link TimetablesV1Api} to use.
      * @param stopPredicate Filter for selection of loaded {@link TimetableStop}.

bundles/org.openhab.binding.deutschebahn/src/main/java/org/openhab/binding/deutschebahn/internal/timetable/TimetableStopComparator.java

@@ -32,7 +32,7 @@ public class TimetableStopComparator implements Comparator<TimetableStop> {
     private final EventType eventSelection;
 
     /**
-     * Creates an new {@link TimetableStopComparator} that sorts {@link TimetableStop} according the Event selected
+     * Creates a new {@link TimetableStopComparator} that sorts {@link TimetableStop} according the Event selected
      * selected by the given {@link EventType}.
      */
     public TimetableStopComparator(EventType eventSelection) {

bundles/org.openhab.binding.deutschebahn/src/main/java/org/openhab/binding/deutschebahn/internal/timetable/TimetablesV1ApiFactory.java

@@ -26,7 +26,7 @@ import org.openhab.binding.deutschebahn.internal.timetable.TimetablesV1Impl.Http
 public interface TimetablesV1ApiFactory {
 
     /**
-     * Creates an new instance of the {@link TimetablesV1Api}.
+     * Creates a new instance of the {@link TimetablesV1Api}.
      */
     public abstract TimetablesV1Api create(final String clientId, final String clientSecret,
             final HttpCallable httpCallable) throws JAXBException;

bundles/org.openhab.binding.deutschebahn/src/test/java/org/openhab/binding/deutschebahn/internal/timetable/TimetablesV1ApiStub.java

@@ -36,14 +36,14 @@ public final class TimetablesV1ApiStub implements TimetablesV1Api {
     }
 
     /**
-     * Creates an new {@link TimetablesV1ApiStub}, that returns the given result.
+     * Creates a new {@link TimetablesV1ApiStub}, that returns the given result.
      */
     public static TimetablesV1ApiStub createWithResult(Timetable timetable) {
         return new TimetablesV1ApiStub(timetable);
     }
 
     /**
-     * Creates an new {@link TimetablesV1ApiStub} that throws an Exception.
+     * Creates a new {@link TimetablesV1ApiStub} that throws an Exception.
      */
     public static TimetablesV1ApiStub createWithException() {
         return new TimetablesV1ApiStub(null);

bundles/org.openhab.binding.deutschebahn/src/test/java/org/openhab/binding/deutschebahn/internal/timetable/TimetablesV1ImplTestHelper.java

@@ -20,7 +20,7 @@ import java.net.URL;
 import org.eclipse.jdt.annotation.NonNullByDefault;
 
 /**
- * Helper interface for jUnit Tests to provide an {@link TimetablesApiTestModule}.
+ * Helper interface for jUnit Tests to provide a {@link TimetablesApiTestModule}.
  * 
  * @author Sönke Küper - initial contribution.
  */
@@ -33,7 +33,7 @@ public interface TimetablesV1ImplTestHelper {
     public static final String CLIENT_SECRET = "354c8161cd7fb0936c840240280c131e";
 
     /**
-     * Creates an {@link TimetablesApiTestModule} that uses http response data from file system.
+     * Creates a {@link TimetablesApiTestModule} that uses http response data from file system.
      * Uses default-testdata from directory /timetablesData
      */
     public default TimetablesApiTestModule createApiWithTestdata() throws Exception {
@@ -41,7 +41,7 @@ public interface TimetablesV1ImplTestHelper {
     }
 
     /**
-     * Creates an {@link TimetablesApiTestModule} that uses http response data from file system.
+     * Creates a {@link TimetablesApiTestModule} that uses http response data from file system.
      * 
      * @param dataDirectory Directory within test-resources containing the stub-data.
      */

bundles/org.openhab.binding.digitalstrom/src/main/java/org/openhab/binding/digitalstrom/internal/lib/event/EventHandler.java

@@ -34,7 +34,7 @@ import org.openhab.binding.digitalstrom.internal.lib.event.types.EventItem;
 public interface EventHandler {
 
     /**
-     * Handles a {@link EventItem} e.g. which was detected by the {@link EventListener}.
+     * Handles an {@link EventItem} e.g. which was detected by the {@link EventListener}.
      *
      * @param eventItem to handle
      */
@@ -63,14 +63,14 @@ public interface EventHandler {
     String getUID();
 
     /**
-     * Sets a {@link EventListener} to this {@link EventHandler}.
+     * Sets an {@link EventListener} to this {@link EventHandler}.
      *
      * @param eventListener to set
      */
     void setEventListener(EventListener eventListener);
 
     /**
-     * Unsets a {@link EventListener} to this {@link EventHandler}.
+     * Unsets an {@link EventListener} to this {@link EventHandler}.
      *
      * @param eventListener to unset
      */

bundles/org.openhab.binding.digitalstrom/src/main/java/org/openhab/binding/digitalstrom/internal/lib/event/EventListener.java

@@ -39,7 +39,7 @@ import com.google.gson.JsonObject;
  * added {@link EventHandler} about the detected events, if it supports the event-type.<br>
  * You can add {@link EventHandler}'s through the constructors or the methods {@link #addEventHandler(EventHandler)} and
  * {@link #addEventHandlers(List)}.<br>
- * You can also delete a {@link EventHandler} though the method {@link #removeEventHandler(EventHandler)}.<br>
+ * You can also delete an {@link EventHandler} though the method {@link #removeEventHandler(EventHandler)}.<br>
  * If the {@link EventListener} is started, both methods subscribe respectively unsubscribe the event-types of the
  * {@link EventHandler}/s automatically.<br>
  * If you want to dynamically subscribe event-types, e.g. because a configuration has changed and a
@@ -106,7 +106,7 @@ public class EventListener {
     }
 
     /**
-     * Creates a new {@link EventListener} without a {@link EventHandler}<br>
+     * Creates a new {@link EventListener} without an {@link EventHandler}<br>
      * <br>
      * To get notified by events you have to call {@link #start()} and {@link #addEventHandler(EventHandler)} or
      * {@link #addEventHandlers(List)}.
@@ -188,7 +188,7 @@ public class EventListener {
     }
 
     /**
-     * Adds a {@link EventHandler}'s and subscribe the supported event-types, if the
+     * Adds an {@link EventHandler}'s and subscribe the supported event-types, if the
      * {@link EventListener} is started and the event-types are not already subscribed.<br>
      * <br>
      * <b>Note:</b><br>
@@ -217,7 +217,7 @@ public class EventListener {
     }
 
     /**
-     * Remove a {@link EventHandler} and unsubscribes the supported event-types, if the
+     * Remove an {@link EventHandler} and unsubscribes the supported event-types, if the
      * {@link EventListener} is started and no other {@link EventHandler} needed the event-types.
      *
      * @param eventHandler to remove

bundles/org.openhab.binding.digitalstrom/src/main/java/org/openhab/binding/digitalstrom/internal/lib/event/types/EventItem.java

@@ -34,7 +34,7 @@ public interface EventItem {
 
     /**
      * Returns {@link HashMap} with the properties fiels of this {@link EventItem}.
-     * The key is a {@link EventResponseEnum} and represents the property name
+     * The key is an {@link EventResponseEnum} and represents the property name
      * and the value is the property value.
      *
      * @return the properties of this {@link EventItem}
@@ -43,7 +43,7 @@ public interface EventItem {
 
     /**
      * Returns {@link HashMap} with the source fields of this {@link EventItem}.
-     * The key is a {@link EventResponseEnum} and represents the property name
+     * The key is an {@link EventResponseEnum} and represents the property name
      * and the value is the property value.
      *
      * @return the properties of this {@link EventItem}

bundles/org.openhab.binding.digitalstrom/src/main/java/org/openhab/binding/digitalstrom/internal/lib/listener/SceneStatusListener.java

@@ -15,7 +15,7 @@ package org.openhab.binding.digitalstrom.internal.lib.listener;
 import org.openhab.binding.digitalstrom.internal.lib.structure.scene.InternalScene;
 
 /**
- * The {@link SceneStatusListener} is notified, if a {@link InternalScene} status has changed or a
+ * The {@link SceneStatusListener} is notified, if an {@link InternalScene} status has changed or a
  * {@link InternalScene} has been removed or added.
  *
  * <p>
@@ -43,14 +43,14 @@ public interface SceneStatusListener {
     void onSceneStateChanged(boolean newState);
 
     /**
-     * This method is called whenever a {@link InternalScene} is removed.
+     * This method is called whenever an {@link InternalScene} is removed.
      *
      * @param scene that was removed
      */
     void onSceneRemoved(InternalScene scene);
 
     /**
-     * This method is called whenever a {@link InternalScene} is added.
+     * This method is called whenever an {@link InternalScene} is added.
      *
      * @param scene that was added
      */

bundles/org.openhab.binding.digitalstrom/src/main/java/org/openhab/binding/digitalstrom/internal/lib/manager/SceneManager.java

@@ -36,7 +36,7 @@ import org.openhab.binding.digitalstrom.internal.lib.structure.scene.InternalSce
  * , {@link #callDeviceScene(String, Short)} etc. can be used.
  *
  * <p>
- * If you call the {@link #start()} method a {@link EventListener} will be started to handle scene calls and undos from
+ * If you call the {@link #start()} method an {@link EventListener} will be started to handle scene calls and undos from
  * the outside.
  *
  * @author Michael Ochel - Initial contribution
@@ -54,7 +54,7 @@ public interface SceneManager extends EventHandler {
     void callInternalScene(InternalScene scene);
 
     /**
-     * Activates a {@link InternalScene} with the given id, if it exists. Otherwise a new
+     * Activates an {@link InternalScene} with the given id, if it exists. Otherwise a new
      * {@link InternalScene} will be created and activated, if it is a callable scene.
      *
      * @param sceneID of the scene to call
@@ -86,7 +86,7 @@ public interface SceneManager extends EventHandler {
     void undoInternalScene(InternalScene scene);
 
     /**
-     * Deactivates a {@link InternalScene} with the given sceneID, if it exists. Otherwise a new
+     * Deactivates an {@link InternalScene} with the given sceneID, if it exists. Otherwise a new
      * {@link InternalScene} will be created and deactivated, if it is a callable scene.
      *
      * @param sceneID of the scene to undo

bundles/org.openhab.binding.digitalstrom/src/main/java/org/openhab/binding/digitalstrom/internal/lib/manager/impl/SceneManagerImpl.java

@@ -97,7 +97,7 @@ public class SceneManagerImpl implements SceneManager {
 
     /**
      * Same constructor like {@link #SceneManagerImpl(ConnectionManager, StructureManager, ManagerStatusListener)}, but
-     * a {@link EventListener} can be set, too.
+     * an {@link EventListener} can be set, too.
      *
      * @param connectionManager (must not be null)
      * @param structureManager (must not be null)

bundles/org.openhab.binding.digitalstrom/src/main/java/org/openhab/binding/digitalstrom/internal/lib/manager/impl/StructureManagerImpl.java

@@ -199,8 +199,8 @@ public class StructureManagerImpl implements StructureManager {
     }
 
     /**
-     * This method build the digitalSTROM structure as an {@link HashMap} with the zone id as key
+     * This method build the digitalSTROM structure as a {@link HashMap} with the zone id as key
-     * and an {@link HashMap} as value. This {@link HashMap} has the group id as key and a {@link List}
+     * and a {@link HashMap} as value. This {@link HashMap} has the group id as key and a {@link List}
      * with all digitalSTROM {@link Device}s.<br>
      * <br>
      * <b>Note:</b> the zone id 0 is the broadcast address and the group id 0, too.

bundles/org.openhab.binding.digitalstrom/src/main/java/org/openhab/binding/digitalstrom/internal/lib/manager/impl/TemperatureControlManager.java

@@ -37,7 +37,8 @@ import org.slf4j.LoggerFactory;
 
 /**
  * The {@link TemperatureControlManager} is responsible for handling the zone temperature control of the digitalSTROM
- * zones. For that it implements a {@link EventHandler} to get informed by control changes, like the target temperature.
+ * zones. For that it implements an {@link EventHandler} to get informed by control changes, like the target
+ * temperature.
  * It also implement the {@link TemperatureControlSensorTransmitter}, so the zone temperature can be set through this
  * class. <br>
  * <br>

bundles/org.openhab.binding.digitalstrom/src/main/java/org/openhab/binding/digitalstrom/internal/lib/serverconnection/DsAPI.java

@@ -743,7 +743,7 @@ public interface DsAPI {
      * operation mode, see
      * {@link OperationModes}.<br>
      * To set the values a {@link List} with an object array has to be set as controlVlaues parameter. The 1th field has
-     * to be a {@link String} for the {@link OperationModes} name and the 2nd field has to be a {@link Integer} for the
+     * to be a {@link String} for the {@link OperationModes} name and the 2nd field has to be an {@link Integer} for the
      * new value. If the control mode is {@link ControlModes#PID_CONTROL} it is the nominal temperature, otherwise it is
      * the control valve value.
      *

bundles/org.openhab.binding.digitalstrom/src/main/java/org/openhab/binding/digitalstrom/internal/lib/serverconnection/impl/JSONResponseHandler.java

@@ -21,7 +21,7 @@ import com.google.gson.JsonParseException;
 import com.google.gson.JsonParser;
 
 /**
- * The {@link JSONResponseHandler} checks an digitalSTROM-JSON response and can parse it to an {@link JsonObject}.
+ * The {@link JSONResponseHandler} checks an digitalSTROM-JSON response and can parse it to a {@link JsonObject}.
  *
  * @author Alexander Betker - Initial contribution
  * @author Alex Maier - Initial contribution

bundles/org.openhab.binding.digitalstrom/src/main/java/org/openhab/binding/digitalstrom/internal/lib/structure/devices/Device.java

@@ -773,7 +773,7 @@ public interface Device extends GeneralDeviceInformation {
     boolean isSensorEchoBoxEnabled();
 
     /**
-     * Sets the {@link DeviceSensorValue} through a {@link EventItem} of the type
+     * Sets the {@link DeviceSensorValue} through an {@link EventItem} of the type
      * {@link EventNames#DEVICE_SENSOR_VALUE}.
      *
      * @param event of the sensor update

bundles/org.openhab.binding.digitalstrom/src/main/java/org/openhab/binding/digitalstrom/internal/lib/structure/devices/impl/DeviceImpl.java

@@ -1679,7 +1679,7 @@ public class DeviceImpl extends AbstractGeneralDeviceInformations implements Dev
     }
 
     /**
-     * if an {@link DeviceStatusListener} is registered inform him about the new
+     * if a {@link DeviceStatusListener} is registered inform him about the new
      * state otherwise do nothing.
      *
      * @param deviceStateUpdate

bundles/org.openhab.binding.dsmr/src/main/java/org/openhab/binding/dsmr/internal/device/cosem/CosemDecimal.java

@@ -44,7 +44,7 @@ class CosemDecimal extends CosemValueDescriptor<DecimalType> {
     }
 
     /**
-     * Parses a String value (that represents an decimal) to an {@link DecimalType} object.
+     * Parses a String value (that represents an decimal) to a {@link DecimalType} object.
      *
      * @param cosemValue the value to parse
      * @return {@link DecimalType} representing the value of the cosem value

bundles/org.openhab.binding.dsmr/src/main/java/org/openhab/binding/dsmr/internal/device/cosem/CosemObject.java

@@ -105,7 +105,7 @@ public class CosemObject {
     /**
      * Parses the List of COSEM String value to COSEM objects values.
      * <p>
-     * When the parser has problems it throws an {@link ParseException}. The
+     * When the parser has problems it throws a {@link ParseException}. The
      * already parsed values will still be available. It is up to the caller how
      * to handle a partially parsed message.
      *

bundles/org.openhab.binding.elerotransmitterstick/src/main/java/org/openhab/binding/elerotransmitterstick/internal/config/EleroChannelConfig.java

@@ -15,7 +15,7 @@ package org.openhab.binding.elerotransmitterstick.internal.config;
 import org.openhab.binding.elerotransmitterstick.internal.handler.EleroChannelHandler;
 
 /**
- * The {@link EleroChannelConfig} holds configuration data of a {@link EleroChannelHandler}
+ * The {@link EleroChannelConfig} holds configuration data of an {@link EleroChannelHandler}
  *
  * @author Volker Bier - Initial contribution
  */

bundles/org.openhab.binding.exec/README.md

@@ -91,7 +91,7 @@ DateTime APCLastExecution {channel="exec:command:apc:lastexecution"}
 
 ## Full Example
 
-Following is an example how to set up an exec command thing, pass it a parameter, debug it with a rule and set the returned string to an Number Item. 
+Following is an example how to set up an exec command thing, pass it a parameter, debug it with a rule and set the returned string to a Number Item.
 
 **demo.things**
 

bundles/org.openhab.binding.homeconnect/src/main/java/org/openhab/binding/homeconnect/internal/discovery/HomeConnectDiscoveryService.java

@@ -51,7 +51,7 @@ public class HomeConnectDiscoveryService extends AbstractDiscoveryService
     private @Nullable HomeConnectBridgeHandler bridgeHandler;
 
     /**
-     * Construct an {@link HomeConnectDiscoveryService}.
+     * Construct a {@link HomeConnectDiscoveryService}.
      *
      */
     public HomeConnectDiscoveryService() {

bundles/org.openhab.binding.innogysmarthome/src/main/java/org/openhab/binding/innogysmarthome/internal/client/entity/action/IntegerActionParam.java

@@ -13,7 +13,7 @@
 package org.openhab.binding.innogysmarthome.internal.client.entity.action;
 
 /**
- * Defines the structure of a {@link IntegerActionParam}.
+ * Defines the structure of an {@link IntegerActionParam}.
  *
  * @author Oliver Kuhl - Initial contribution
  */

bundles/org.openhab.binding.km200/src/main/java/org/openhab/binding/km200/internal/handler/KM200ThingHandler.java

@@ -362,7 +362,7 @@ public class KM200ThingHandler extends BaseThingHandler {
             logger.trace("Create things: {} id: {} channel: {}", thing.getUID(), subKey, thing.getUID().getId());
             switch (subKeyType) {
                 case DATA_TYPE_STRING_VALUE:
-                    /* Creating an new channel type with capabilities from service */
+                    /* Creating a new channel type with capabilities from service */
                     List<StateOption> options = null;
                     if (serObj.serviceTreeMap.get(subKey).getValueParameter() != null) {
                         options = new ArrayList<>();
@@ -409,7 +409,7 @@ public class KM200ThingHandler extends BaseThingHandler {
                     }
                     /* Check the capabilities of this service */
                     if (serObj.serviceTreeMap.get(subKey).getValueParameter() != null) {
-                        /* Creating an new channel type with capabilities from service */
+                        /* Creating a new channel type with capabilities from service */
                         // The type is definitely correct here
                         @SuppressWarnings("unchecked")
                         List<Object> subValParas = (List<Object>) serObj.serviceTreeMap.get(subKey).getValueParameter();

bundles/org.openhab.binding.lcn/src/main/java/org/openhab/binding/lcn/internal/connection/Connection.java

@@ -45,7 +45,7 @@ import org.slf4j.LoggerFactory;
 
 /**
  * This class represents a configured connection to one LCN-PCHK.
- * It uses a {@link AsynchronousSocketChannel} to connect to LCN-PCHK.
+ * It uses an {@link AsynchronousSocketChannel} to connect to LCN-PCHK.
  * Included logic:
  * <ul>
  * <li>Reconnection on connection loss

bundles/org.openhab.binding.lifx/src/main/java/org/openhab/binding/lifx/internal/dto/PacketFactory.java

@@ -118,7 +118,7 @@ public class PacketFactory {
     /**
      * Registers a new generic packet handler for the given packet class. The
      * packet class must meet the criteria for {@link GenericHandler};
-     * specifically, it must have an no-argument constructor and require no
+     * specifically, it must have a no-argument constructor and require no
      * parsing logic outside of an invocation of
      * {@link Packet#parse(java.nio.ByteBuffer)}.
      *

bundles/org.openhab.binding.livisismarthome/src/main/java/org/openhab/binding/livisismarthome/internal/client/api/entity/action/IntegerActionParamDTO.java

@@ -13,7 +13,7 @@
 package org.openhab.binding.livisismarthome.internal.client.api.entity.action;
 
 /**
- * Defines the structure of a {@link IntegerActionParamDTO}.
+ * Defines the structure of an {@link IntegerActionParamDTO}.
  *
  * @author Oliver Kuhl - Initial contribution
  */

bundles/org.openhab.binding.livisismarthome/src/main/java/org/openhab/binding/livisismarthome/internal/discovery/LivisiDeviceDiscoveryService.java

@@ -53,7 +53,7 @@ public class LivisiDeviceDiscoveryService extends AbstractDiscoveryService
     private @Nullable LivisiBridgeHandler bridgeHandler;
 
     /**
-     * Construct an {@link LivisiDeviceDiscoveryService}.
+     * Construct a {@link LivisiDeviceDiscoveryService}.
      */
     public LivisiDeviceDiscoveryService() {
         super(SEARCH_TIME_SECONDS);

bundles/org.openhab.binding.logreader/src/3rdparty/java/org/apache/commons/io/input/Tailer.java

@@ -61,7 +61,7 @@ import org.apache.commons.io.FileUtils;
  * </ul>
  * </li>
  * <li>Using an {@link java.util.concurrent.Executor}</li>
- * <li>Using an {@link Thread}</li>
+ * <li>Using a {@link Thread}</li>
  * </ul>
  *
  * <p>

bundles/org.openhab.binding.lutron/src/main/java/org/openhab/binding/lutron/internal/config/OGroupConfig.java

@@ -15,7 +15,7 @@ package org.openhab.binding.lutron.internal.config;
 import org.eclipse.jdt.annotation.NonNullByDefault;
 
 /**
- * Configuration settings for a {@link org.openhab.binding.lutron.internal.handler.OGroupHandler}.
+ * Configuration settings for an {@link org.openhab.binding.lutron.internal.handler.OGroupHandler}.
  *
  * @author Bob Adair - Initial contribution
  */

bundles/org.openhab.binding.mihome/src/main/java/org/openhab/binding/mihome/internal/socket/XiaomiSocket.java

@@ -55,7 +55,7 @@ public abstract class XiaomiSocket {
     private final Thread socketReceiveThread = new Thread(this::receiveData);
 
     /**
-     * Sets up an {@link XiaomiSocket} with the MiHome multicast address and a random port
+     * Sets up a {@link XiaomiSocket} with the MiHome multicast address and a random port
      *
      * @param owner identifies the socket owner
      */
@@ -64,7 +64,7 @@ public abstract class XiaomiSocket {
     }
 
     /**
-     * Sets up an {@link XiaomiSocket} with the MiHome multicast address and a specific port
+     * Sets up a {@link XiaomiSocket} with the MiHome multicast address and a specific port
      *
      * @param port the socket will be bound to this port
      * @param owner identifies the socket owner

bundles/org.openhab.binding.mqtt.generic/src/main/java/org/openhab/binding/mqtt/generic/ChannelState.java

@@ -36,7 +36,7 @@ import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
 /**
- * This object consists of an {@link Value}, which is updated on the respective MQTT topic change.
+ * This object consists of a {@link Value}, which is updated on the respective MQTT topic change.
  * Updates to the value are propagated via the {@link ChannelStateUpdateListener}.
  *
  * @author David Graeff - Initial contribution

bundles/org.openhab.binding.mqtt.homeassistant/src/main/java/org/openhab/binding/mqtt/homeassistant/internal/config/dto/AbstractChannelConfiguration.java

@@ -67,7 +67,7 @@ public abstract class AbstractChannelConfiguration {
     protected @Nullable Device device;
 
     /**
-     * Parse the base properties of the configJSON into a {@link AbstractChannelConfiguration}
+     * Parse the base properties of the configJSON into an {@link AbstractChannelConfiguration}
      *
      * @param configJSON channels configuration in JSON
      * @param gson parser

bundles/org.openhab.binding.nanoleaf/src/main/java/org/openhab/binding/nanoleaf/internal/model/Layout.java

@@ -62,7 +62,7 @@ public class Layout {
     }
 
     /**
-     * Returns an text representation for a canvas layout.
+     * Returns a text representation for a canvas layout.
      *
      * Note only canvas supported currently due to its easy geometry
      *

bundles/org.openhab.binding.neeo/src/main/java/org/openhab/binding/neeo/internal/NeeoUtil.java

@@ -56,7 +56,7 @@ public class NeeoUtil {
     }
 
     /**
-     * Utility function to close a {@link AutoCloseable} and log any exception thrown.
+     * Utility function to close an {@link AutoCloseable} and log any exception thrown.
      *
      * @param closeable a possibly null {@link AutoCloseable}. If null, no action is done.
      */

bundles/org.openhab.binding.neeo/src/main/java/org/openhab/binding/neeo/internal/models/NeeoBrain.java

@@ -16,7 +16,7 @@ import org.eclipse.jdt.annotation.NonNullByDefault;
 import org.eclipse.jdt.annotation.Nullable;
 
 /**
- * The model representing an Neeo Brain(serialize/deserialize json use only)
+ * The model representing a Neeo Brain(serialize/deserialize json use only)
  *
  * @author Tim Roberts - Initial contribution
  */

bundles/org.openhab.binding.neeo/src/main/java/org/openhab/binding/neeo/internal/models/NeeoDevice.java

@@ -16,7 +16,7 @@ import org.eclipse.jdt.annotation.NonNullByDefault;
 import org.eclipse.jdt.annotation.Nullable;
 
 /**
- * The model representing an NEEO Device (serialize/deserialize json use only)
+ * The model representing a NEEO Device (serialize/deserialize json use only)
  *
  * @author Tim Roberts - Initial contribution
  */

bundles/org.openhab.binding.neeo/src/main/java/org/openhab/binding/neeo/internal/models/NeeoDeviceDetails.java

@@ -18,7 +18,7 @@ import org.eclipse.jdt.annotation.NonNullByDefault;
 import org.eclipse.jdt.annotation.Nullable;
 
 /**
- * The model representing an Neeo Device Details (serialize/deserialize json use only)
+ * The model representing a Neeo Device Details (serialize/deserialize json use only)
  *
  * @author Tim Roberts - Initial contribution
  */

bundles/org.openhab.binding.neeo/src/main/java/org/openhab/binding/neeo/internal/models/NeeoDeviceDetailsTiming.java

@@ -16,7 +16,7 @@ import org.eclipse.jdt.annotation.NonNullByDefault;
 import org.eclipse.jdt.annotation.Nullable;
 
 /**
- * The model representing an Neeo Device Details Timings (serialize/deserialize json use only)
+ * The model representing a Neeo Device Details Timings (serialize/deserialize json use only)
  *
  * @author Tim Roberts - Initial contribution
  */

bundles/org.openhab.binding.neeo/src/main/java/org/openhab/binding/neeo/internal/models/NeeoMacro.java

@@ -16,7 +16,7 @@ import org.eclipse.jdt.annotation.NonNullByDefault;
 import org.eclipse.jdt.annotation.Nullable;
 
 /**
- * The model representing an Neeo Macro (serialize/deserialize json use only)
+ * The model representing a Neeo Macro (serialize/deserialize json use only)
  *
  * @author Tim Roberts - Initial contribution
  */

bundles/org.openhab.binding.neeo/src/main/java/org/openhab/binding/neeo/internal/models/NeeoRecipe.java

@@ -16,7 +16,7 @@ import org.eclipse.jdt.annotation.NonNullByDefault;
 import org.eclipse.jdt.annotation.Nullable;
 
 /**
- * The model representing an Neeo Recipe (serialize/deserialize json use only).
+ * The model representing a Neeo Recipe (serialize/deserialize json use only).
  *
  * @author Tim Roberts - Initial contribution
  */

bundles/org.openhab.binding.neeo/src/main/java/org/openhab/binding/neeo/internal/models/NeeoRoom.java

@@ -16,7 +16,7 @@ import org.eclipse.jdt.annotation.NonNullByDefault;
 import org.eclipse.jdt.annotation.Nullable;
 
 /**
- * The model representing an Neeo Room (serialize/deserialize json use only).
+ * The model representing a Neeo Room (serialize/deserialize json use only).
  *
  * @author Tim Roberts - Initial contribution
  */

bundles/org.openhab.binding.neeo/src/main/java/org/openhab/binding/neeo/internal/models/NeeoScenario.java

@@ -18,7 +18,7 @@ import org.eclipse.jdt.annotation.NonNullByDefault;
 import org.eclipse.jdt.annotation.Nullable;
 
 /**
- * The model representing an Neeo Scenario (serialize/deserialize json use only).
+ * The model representing a Neeo Scenario (serialize/deserialize json use only).
  *
  * @author Tim Roberts - Initial contribution
  */

bundles/org.openhab.binding.onkyo/src/main/java/org/openhab/binding/onkyo/internal/automation/modules/OnkyoThingActions.java

@@ -24,7 +24,7 @@ import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
 /**
- * Some automation actions to be used with a {@link OnkyoThingActions}
+ * Some automation actions to be used with an {@link OnkyoThingActions}
  *
  * @author David Masshardt - initial contribution
  */

bundles/org.openhab.binding.plugwise/src/main/java/org/openhab/binding/plugwise/internal/PlugwiseThingDiscoveryService.java

@@ -53,7 +53,7 @@ import org.slf4j.LoggerFactory;
 
 /**
  * Discovers Plugwise devices by periodically reading the Circle+ node/MAC table with {@link RoleCallRequestMessage}s.
- * Sleeping end devices are discovered when they announce being awake with a {@link AnnounceAwakeRequestMessage}. To
+ * Sleeping end devices are discovered when they announce being awake with an {@link AnnounceAwakeRequestMessage}. To
  * reduce network traffic {@link InformationRequestMessage}s are only sent to undiscovered devices.
  *
  * @author Wouter Born, Karel Goderis - Initial contribution

bundles/org.openhab.binding.plugwise/src/main/java/org/openhab/binding/plugwise/internal/protocol/PowerChangeRequestMessage.java

@@ -18,7 +18,7 @@ import org.openhab.binding.plugwise.internal.protocol.field.MACAddress;
 
 /**
  * Requests the power state of a relay device (Circle, Circle+, Stealth) to be switched on/off. The current power state
- * of a device is retrieved by sending a {@link InformationRequestMessage} and reading the
+ * of a device is retrieved by sending an {@link InformationRequestMessage} and reading the
  * {@link InformationResponseMessage#getPowerState()} value.
  *
  * @author Wouter Born, Karel Goderis - Initial contribution

bundles/org.openhab.binding.pulseaudio/src/main/java/org/openhab/binding/pulseaudio/internal/PulseaudioClient.java

@@ -261,7 +261,7 @@ public class PulseaudioClient {
     }
 
     /**
-     * retrieves a {@link AbstractAudioDeviceConfig} by its identifier
+     * retrieves an {@link AbstractAudioDeviceConfig} by its identifier
      * If several devices correspond to the deviceIdentifier, returns the first one (aphabetical order)
      *
      * @param The device identifier to match against
@@ -312,7 +312,7 @@ public class PulseaudioClient {
     }
 
     /**
-     * change the volume of a {@link AbstractAudioDeviceConfig}
+     * change the volume of an {@link AbstractAudioDeviceConfig}
      *
      * @param item the {@link AbstractAudioDeviceConfig} to handle
      * @param vol the new volume value the {@link AbstractAudioDeviceConfig} should be changed to (possible values from
@@ -459,7 +459,7 @@ public class PulseaudioClient {
     }
 
     /**
-     * change the volume of a {@link AbstractAudioDeviceConfig}
+     * change the volume of an {@link AbstractAudioDeviceConfig}
      *
      * @param item the {@link AbstractAudioDeviceConfig} to handle
      * @param vol the new volume percent value the {@link AbstractAudioDeviceConfig} should be changed to (possible

bundles/org.openhab.binding.russound/src/main/java/org/openhab/binding/russound/internal/rio/AbstractBridgeHandler.java

@@ -68,7 +68,7 @@ public abstract class AbstractBridgeHandler<E extends AbstractRioProtocol> exten
     /**
      * Get's the {@link AbstractRioProtocol} handler. May be null if none currently exists
      *
-     * @return a {@link AbstractRioProtocol} handler or null if none exists
+     * @return an {@link AbstractRioProtocol} handler or null if none exists
      */
     protected E getProtocolHandler() {
         return protocolHandler;

bundles/org.openhab.binding.russound/src/main/java/org/openhab/binding/russound/internal/rio/AbstractThingHandler.java

@@ -61,7 +61,7 @@ public abstract class AbstractThingHandler<E extends AbstractRioProtocol> extend
     /**
      * Get's the {@link AbstractRioProtocol} handler. May be null if none currently exists
      *
-     * @return a {@link AbstractRioProtocol} handler or null if none exists
+     * @return an {@link AbstractRioProtocol} handler or null if none exists
      */
     protected E getProtocolHandler() {
         return protocolHandler;

bundles/org.openhab.binding.shelly/src/main/java/org/openhab/binding/shelly/internal/manager/ShellyManagerOverviewPage.java

@@ -168,7 +168,7 @@ public class ShellyManagerOverviewPage extends ShellyManagerPage {
                     logger.debug("{}: No firmware files found for device type {}", LOG_PREFIX, deviceType);
                 } else {
                     // Create selection list
-                    json = "{" + json.replace("[{", "\"versions\":[{") + "}"; // make it an named array
+                    json = "{" + json.replace("[{", "\"versions\":[{") + "}"; // make it a named array
                     FwArchList list = getFirmwareArchiveList(deviceType);
                     ArrayList<FwArchEntry> versions = list.versions;
                     if (versions != null) {

bundles/org.openhab.binding.shelly/src/main/java/org/openhab/binding/shelly/internal/manager/ShellyManagerPage.java

@@ -460,7 +460,7 @@ public class ShellyManagerPage {
             list.versions = new ArrayList<FwArchEntry>();
         } else {
             // Create selection list
-            json = "{" + json.replace("[{", "\"versions\":[{") + "}"; // make it an named array
+            json = "{" + json.replace("[{", "\"versions\":[{") + "}"; // make it a named array
             list = fromJson(gson, json, FwArchList.class);
         }
 

bundles/org.openhab.binding.smartmeter/src/main/java/org/openhab/binding/smartmeter/internal/ObisCode.java

@@ -47,7 +47,7 @@ public class ObisCode {
     }
 
     /**
-     * Gets a {@link ObisCode} from a String. It must follow the pattern {@value #OBIS_PATTERN}
+     * Gets an {@link ObisCode} from a String. It must follow the pattern {@value #OBIS_PATTERN}
      *
      * @param obis The obis as String.
      * @return The new Obis code. Can not be null.

bundles/org.openhab.binding.smartmeter/src/main/java/org/openhab/binding/smartmeter/internal/sml/SmlUnitConversion.java

@@ -22,7 +22,7 @@ import org.openhab.core.library.unit.Units;
 import org.openmuc.jsml.EUnit;
 
 /**
- * Converts a {@link EUnit} to an {@link Unit}.
+ * Converts an {@link EUnit} to a {@link Unit}.
  *
  * @author Matthias Steigenberger - Initial contribution
  *

bundles/org.openhab.binding.systeminfo/src/main/java/org/openhab/binding/systeminfo/internal/model/DeviceNotFoundException.java

@@ -28,7 +28,7 @@ public class DeviceNotFoundException extends IOException {
     private static final long serialVersionUID = -707507777792259512L;
 
     /**
-     * Constructs an {@code DeviceNotFoundException} with {@code null}
+     * Constructs a {@code DeviceNotFoundException} with {@code null}
      * as its error detail message.
      */
     public DeviceNotFoundException() {
@@ -36,7 +36,7 @@ public class DeviceNotFoundException extends IOException {
     }
 
     /**
-     * Constructs an {@code DeviceNotFoundException} with the specified detail message.
+     * Constructs a {@code DeviceNotFoundException} with the specified detail message.
      *
      *
      * @param message
@@ -48,7 +48,7 @@ public class DeviceNotFoundException extends IOException {
     }
 
     /**
-     * Constructs an {@code DeviceNotFoundException} with the specified detail message
+     * Constructs a {@code DeviceNotFoundException} with the specified detail message
      * and cause.
      *
      * <p>

bundles/org.openhab.binding.tesla/src/main/java/org/openhab/binding/tesla/internal/handler/VehicleListener.java

@@ -17,7 +17,7 @@ import org.openhab.binding.tesla.internal.protocol.VehicleConfig;
 
 /**
  * The {@link VehicleListener} interface can be implemented by classes that want to be informed about
- * existing vehicles of a given account. They need to register on an {@link TeslaAccountHandler}.
+ * existing vehicles of a given account. They need to register on a {@link TeslaAccountHandler}.
  *
  * @author Kai Kreuzer - Initial contribution
  */

bundles/org.openhab.binding.wundergroundupdatereceiver/README.md

@@ -177,7 +177,7 @@ The binding tries to post received values as the item types described in the cha
 ### Rule examples
 
 You can use the trigger channel to create a rule to calculate additional values.
-Create an new manual Item with a meaningful id, fx. WundergroundUpdateReceiverBinging_HeatIndex with a Number type.
+Create a new manual Item with a meaningful id, fx. WundergroundUpdateReceiverBinging_HeatIndex with a Number type.
 Create a rule that triggers when the trigger channel is updated and the following DSL:
 
 ```

bundles/org.openhab.binding.xmltv/src/main/java/org/openhab/binding/xmltv/internal/jaxb/MediaChannel.java

@@ -27,7 +27,7 @@ import javax.xml.bind.annotation.adapters.XmlJavaTypeAdapter;
 import org.eclipse.jdt.annotation.NonNullByDefault;
 
 /**
- * Java class for an channel XML element
+ * Java class for a channel XML element
  * Renamed to MediaChannel in order to avoid confusion with Framework Channels
  *
  * @author Gaël L'hopital - Initial contribution

bundles/org.openhab.binding.yamahareceiver/src/main/java/org/openhab/binding/yamahareceiver/internal/protocol/ProtocolFactory.java

@@ -28,7 +28,7 @@ import org.openhab.binding.yamahareceiver.internal.state.SystemControlStateListe
 import org.openhab.binding.yamahareceiver.internal.state.ZoneControlStateListener;
 
 /**
- * Factory to create a {@link AbstractConnection} connection object based on a feature test.
+ * Factory to create an {@link AbstractConnection} connection object based on a feature test.
  * Also returns implementation objects for all the protocol interfaces.
  * <p>
  * At the moment only the XML protocol is supported.
@@ -39,7 +39,7 @@ import org.openhab.binding.yamahareceiver.internal.state.ZoneControlStateListene
 public interface ProtocolFactory {
     /**
      * Asynchronous method to create and return a connection object. Depending
-     * on the feature test it might be either a {@link XMLConnection} or a JsonConnection.
+     * on the feature test it might be either an {@link XMLConnection} or a JsonConnection.
      *
      * @param host The host name
      * @param connectionStateListener

bundles/org.openhab.io.neeo/src/main/java/org/openhab/io/neeo/internal/NeeoUtil.java

@@ -200,7 +200,7 @@ public class NeeoUtil {
     }
 
     /**
-     * Utility function to close a {@link AutoCloseable} and log any exception thrown.
+     * Utility function to close an {@link AutoCloseable} and log any exception thrown.
      *
      * @param closeable a possibly null {@link AutoCloseable}. If null, no action is done.
      */

bundles/org.openhab.io.neeo/src/main/java/org/openhab/io/neeo/internal/models/NeeoNotification.java

@@ -17,7 +17,7 @@ import org.eclipse.jdt.annotation.Nullable;
 import org.openhab.io.neeo.internal.NeeoUtil;
 
 /**
- * The model representing an NEEO notification (serialize/deserialize json use only).
+ * The model representing a NEEO notification (serialize/deserialize json use only).
  *
  * @author Tim Roberts - Initial Contribution
  */

bundles/org.openhab.io.neeo/src/main/java/org/openhab/io/neeo/internal/models/NeeoRecipe.java

@@ -18,7 +18,7 @@ import org.eclipse.jdt.annotation.Nullable;
 import com.google.gson.annotations.SerializedName;
 
 /**
- * The model representing an NEEO recipe (serialize/deserialize json use only).
+ * The model representing a NEEO recipe (serialize/deserialize json use only).
  *
  * @author Tim Roberts - Initial Contribution
  */

bundles/org.openhab.io.neeo/src/main/java/org/openhab/io/neeo/internal/models/NeeoRecipeUrls.java

@@ -16,7 +16,7 @@ import org.eclipse.jdt.annotation.NonNullByDefault;
 import org.openhab.io.neeo.internal.NeeoUtil;
 
 /**
- * The model representing an NEEO recipe urls (serialize/deserialize json use only).
+ * The model representing a NEEO recipe urls (serialize/deserialize json use only).
  *
  * @author Tim Roberts - Initial Contribution
  */

bundles/org.openhab.io.neeo/src/main/java/org/openhab/io/neeo/internal/models/NeeoSensorNotification.java

@@ -18,7 +18,7 @@ import org.openhab.io.neeo.internal.NeeoConstants;
 import org.openhab.io.neeo.internal.NeeoUtil;
 
 /**
- * The model representing an NEEO sensor notification (serialize/deserialize json use only).
+ * The model representing a NEEO sensor notification (serialize/deserialize json use only).
  *
  * @author Tim Roberts - Initial Contribution
  */