From: Robin Cheney <cheneyr@eternal.ddnss.de>
Date: Sun, 16 Nov 2025 09:28:43 +0000 (+0100)
Subject: Javadoc corrections
X-Git-Url: https://git.eternal.ddnss.de/?a=commitdiff_plain;h=9677075307369733fb3c7ccdd62da15e0afc17c0;p=tankstelle.git

Javadoc corrections
---

diff --git a/src/main/java/de/diejungsvondertanke/tankstelle/FuelStation.java b/src/main/java/de/diejungsvondertanke/tankstelle/FuelStation.java
index 338203a..8b7658f 100644
--- a/src/main/java/de/diejungsvondertanke/tankstelle/FuelStation.java
+++ b/src/main/java/de/diejungsvondertanke/tankstelle/FuelStation.java
@@ -111,6 +111,7 @@ abstract class FuelStation {
      * Get the price for a specific type of fuel for this fuel station
      * 
      * @param fuel_type The {@link FuelType FuelType} to get
+     * @return The price for a specific type of fuel for this fuel station
      * @throws NoSuchFuelTypeError This Error is thrown on the attempt to choose a
      *                             fuel type from a fuel station
      *                             which the fuel station does not have
@@ -128,7 +129,7 @@ abstract class FuelStation {
      * Get the cumulative price for the amount of fuel stored
      * 
      * => What you would get if you would sell all fuel of this station at the
-     * current prices
+     * current price(s)
      * 
      * @return the income in €
      */
@@ -188,6 +189,7 @@ abstract class FuelStation {
      * Get the fuel amount for a specific type of fuel for this fuel station
      * 
      * @param fuel_type The {@link FuelType FuelType} to get
+     * @return The fuel amount for a specific type of fuel for this fuel station
      * @throws NoSuchFuelTypeError This Error is thrown on the attempt to choose a
      *                             fuel type from a fuel station
      *                             which the fuel station does not have
diff --git a/src/main/java/de/diejungsvondertanke/tankstelle/Main.java b/src/main/java/de/diejungsvondertanke/tankstelle/Main.java
index 8b3ba1f..13a5719 100644
--- a/src/main/java/de/diejungsvondertanke/tankstelle/Main.java
+++ b/src/main/java/de/diejungsvondertanke/tankstelle/Main.java
@@ -83,6 +83,9 @@ public class Main {
      * @param fuelType Select the type of fuel
      * 
      * @return a FuelStation (all of type {@link FuelStation})
+     * @throws NoSuchFuelTypeError This Error is thrown on the attempt to choose a
+     *                             fuel type from a fuel station which the fuel
+     *                             station does not have
      */
     public static FuelStation getHighestPrice(FuelType fuelType) throws NoSuchFuelTypeError {
         float highestPrice = fuelStations[0].get_price(fuelType);
@@ -100,9 +103,10 @@ public class Main {
      * Get the FuelStation with the highest price
      * 
      * 
-     * @param fuelType Select the type of fuel
-     * 
      * @return a FuelStation (all of type {@link FuelStation})
+     * @throws NoSuchFuelTypeError This Error is thrown on the attempt to choose a
+     *                             fuel type from a fuel station which the fuel
+     *                             station does not have
      */
     public static FuelStation getHighestAccumulatedValue() throws NoSuchFuelTypeError {
         float highestValue = fuelStations[0].get_cumulative_retail_price();
@@ -123,6 +127,9 @@ public class Main {
      * @param fuelType Select the type of fuel
      * 
      * @return a FuelStation (all of type {@link FuelStation})
+     * @throws NoSuchFuelTypeError This Error is thrown on the attempt to choose a
+     *                             fuel type from a fuel station which the fuel
+     *                             station does not have
      */
     public static FuelStation getHighestStoredAmount(FuelType fuelType) throws NoSuchFuelTypeError {
         float highestAmount = fuelStations[0].getStored_amount(fuelType);
@@ -143,6 +150,9 @@ public class Main {
      * @param fuelType Select the type of fuel
      * 
      * @return a FuelStation (all of type {@link FuelStation})
+     * @throws NoSuchFuelTypeError This Error is thrown on the attempt to choose a
+     *                             fuel type from a fuel station which the fuel
+     *                             station does not have
      */
     public static FuelStation getLowestStoredAmount(FuelType fuelType) throws NoSuchFuelTypeError {
         float lowestAmount = fuelStations[0].getStored_amount(fuelType);