From abb4ccd38bc306baba60c4c205ab2725e8b5a3da Mon Sep 17 00:00:00 2001
From: jstaerk <jstaerk@usegroup.de>
Date: Wed, 22 May 2024 18:20:17 +0200
Subject: [PATCH] added some javadoc

---
 .../main/java/org/mustangproject/CashDiscount.java    | 11 ++++++++++-
 library/src/main/java/org/mustangproject/Invoice.java |  2 +-
 .../src/main/java/org/mustangproject/TradeParty.java  |  5 +++--
 3 files changed, 14 insertions(+), 4 deletions(-)

diff --git a/library/src/main/java/org/mustangproject/CashDiscount.java b/library/src/main/java/org/mustangproject/CashDiscount.java
index 05c00da3..c7fb7a03 100644
--- a/library/src/main/java/org/mustangproject/CashDiscount.java
+++ b/library/src/main/java/org/mustangproject/CashDiscount.java
@@ -4,9 +4,18 @@
 
 import java.math.BigDecimal;
 
+/***
+ * A class to represent discounts for early payments ("Skonto")
+ */
 public class CashDiscount implements IZUGFeRDCashDiscount {
 
+	/***
+	 * the reduction percent allowed in the period
+	 */
 	protected BigDecimal percent;
+	/***
+	 * the period (usually days) count how long the percent apply
+	 */
 	protected Integer days=null;
 
 	/***
@@ -15,7 +24,7 @@ public class CashDiscount implements IZUGFeRDCashDiscount {
 	 * is be space for a (optional) third parameter
 	 *
 	 * @param percent max 3 decimals "behind the dot", more precision is currently ignored
-	 * @param days
+	 * @param days the count of the periods (usually days) the percentage applies
 	 */
 	public CashDiscount(BigDecimal percent, int days) {
 		this.percent = percent;
diff --git a/library/src/main/java/org/mustangproject/Invoice.java b/library/src/main/java/org/mustangproject/Invoice.java
index aa26b64f..fb1d2943 100644
--- a/library/src/main/java/org/mustangproject/Invoice.java
+++ b/library/src/main/java/org/mustangproject/Invoice.java
@@ -578,7 +578,7 @@ public Invoice setDeliveryAddress(TradeParty deliveryAddress) {
 	}
 	/***
 	 * Adds a cash discount (skonto)
-	 * @param CashDiscount the percent/period combination
+	 * @param c the CashDiscount percent/period combination
 	 * @return fluent setter
 	 */
 	public Invoice addCashDiscount(CashDiscount c) {
diff --git a/library/src/main/java/org/mustangproject/TradeParty.java b/library/src/main/java/org/mustangproject/TradeParty.java
index edb16456..2a92cd23 100644
--- a/library/src/main/java/org/mustangproject/TradeParty.java
+++ b/library/src/main/java/org/mustangproject/TradeParty.java
@@ -423,8 +423,9 @@ public String getUriUniversalCommunicationIDScheme() {
 
 
 	/***
-	 * sets the email of the organization (not the one of the contact person)
-	 * (while setEmail has to be defined here getEmail comes from IZUGFeRDExportableTradeParty)
+	 * 	sets the email of the organization (not the one of the contact person)
+	 * 	(while setEmail has to be defined here getEmail comes from IZUGFeRDExportableTradeParty)
+	 * @param eMail address of institution (not contact)
 	 * @return fluent setter
 	 */
 	public TradeParty setEmail(String eMail) {