javadoc corrections

library/src/main/java/org/mustangproject/Invoice.java

@@ -842,6 +842,7 @@ public class Invoice implements IExportableTransaction {
 	/**
 	 * Decide when the VAT should be collected.
 	 * @param vatDueDateTypeCode use EventTimeCodeTypeConstants
+	 * @return fluent setter
 	 */
 	public Invoice setVATDueDateTypeCode(String vatDueDateTypeCode) {
 		this.vatDueDateTypeCode = vatDueDateTypeCode;

library/src/main/java/org/mustangproject/ReferencedDocument.java

@@ -22,7 +22,7 @@ public class ReferencedDocument implements IReferencedDocument {
 
 	/***
 	 * sets an ID assigned by the sender
-	 * @param issuerAssignedID
+	 * @param issuerAssignedID the ID as a string :-)
 	 */
 	public void setIssuerAssignedID(String issuerAssignedID) {
 		this.issuerAssignedID = issuerAssignedID;
@@ -30,7 +30,7 @@ public class ReferencedDocument implements IReferencedDocument {
 
 	/**
 	 * which type is the document? e.g. "916" for additional invoice related
-	 * @param typeCode
+	 * @param typeCode as String, e.g. 916
 	 */
 	public void setTypeCode(String typeCode) {
 		this.typeCode = typeCode;
@@ -38,7 +38,7 @@ public class ReferencedDocument implements IReferencedDocument {
 
 	/**
 	 * type of the reference of this line, a UNTDID 1153 code
-	 * @param referenceTypeCode
+	 * @param referenceTypeCode three uppercase character reference type code as string
 	 */
 	public void setReferenceTypeCode(String referenceTypeCode) {
 		this.referenceTypeCode = referenceTypeCode;

library/src/main/java/org/mustangproject/SubjectCode.java

@@ -1,7 +1,7 @@
 package org.mustangproject;
 
 /**
- * EN16931-ID: BT-21 - the qualification of the free text on the invoice from BT-22<br/>
+ * EN16931-ID: BT-21 - the qualification of the free text on the invoice from BT-22
  * In the first step only the recommended codes are implemented. 
  */
 public enum SubjectCode {

library/src/main/java/org/mustangproject/TradeParty.java

@@ -659,7 +659,7 @@ public class TradeParty implements IZUGFeRDExportableTradeParty {
 	 * e.g. which floor (if LineTwo has already been used e.g. for which building)
 	 * This could sometimes be BT-165?
 	 *
-	 * @param additionalAddress2
+	 * @param additionalAddress2 e.g. which floor, as String
 	 * @return fluent setter
 	 */
 	public TradeParty setAdditionalAddressExtension(String additionalAddress2) {

library/src/main/java/org/mustangproject/ZUGFeRD/IExportableTransaction.java

@@ -1,21 +1,23 @@
-/** **********************************************************************
+/**
- *
+ * *********************************************************************
+ * <p>
  * Copyright 2018 Jochen Staerk
- *
+ * <p>
  * Use is subject to license terms.
- *
+ * <p>
  * Licensed under the Apache License, Version 2.0 (the "License"); you may not
  * use this file except in compliance with the License. You may obtain a copy
  * of the License at http://www.apache.org/licenses/LICENSE-2.0.
- *
+ * <p>
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
  * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- *
+ * <p>
  * See the License for the specific language governing permissions and
  * limitations under the License.
- *
+ * <p>
- *********************************************************************** */
+ * **********************************************************************
+ */
 package org.mustangproject.ZUGFeRD;
 
 /**
@@ -82,13 +84,12 @@ public interface IExportableTransaction {
 	/**
 	 * this should be the full sender institution name, details, manager and tax
 	 * registration. It is one of the few functions which may return null. e.g.
-	 * <p/>
+	 *
 	 * Lieferant GmbH Lieferantenstraße 20 80333 München Deutschland
 	 * Geschäftsführer: Hans Muster Handelsregisternummer: H A 123
-   * <p/>
 	 *
-   * It is written as an includedNode with subjectCode {@link org.mustangproject.SubjectCode#REG}. See also 
+	 * It is written as an includedNode with subjectCode {@link org.mustangproject.SubjectCode#REG}. See also
-   * {@link #getNotesWithSubjectCode()}
+	 * {@link #getNotesWithSubjectCode()}
 	 * @return null or full sender institution name, details, manager and tax
 	 *         registration
 	 */
@@ -494,13 +495,16 @@ public interface IExportableTransaction {
 		return null;
 	}
 
-  /**
+	/**
-   * A grouping of business terms to indicate accounting-relevant free texts including a qualification of these. <p/>
+	 * A grouping of business terms to indicate accounting-relevant free texts including a qualification of these.
-   * The information are written to the same xml nodes like {@link #getNotes()} but with explicit subjectCode.
+	 *
-   */
+	 * The information are written to the same xml nodes like {@link #getNotes()} but with explicit subjectCode.
-  default List<IncludedNote> getNotesWithSubjectCode(){
+	 * @return list of the notes
-    return null;
+	 */
-  }
+	default List<IncludedNote> getNotesWithSubjectCode() {
+		return null;
+	}
+
 	default String getSpecifiedProcuringProjectName() {
 		return null;
 	}

library/src/main/java/org/mustangproject/ZUGFeRD/IZUGFeRDExportableTradeParty.java

@@ -1,21 +1,23 @@
-/** **********************************************************************
+/**
- *
+ * *********************************************************************
+ * <p>
  * Copyright 2018 Jochen Staerk
- *
+ * <p>
  * Use is subject to license terms.
- *
+ * <p>
  * Licensed under the Apache License, Version 2.0 (the "License"); you may not
  * use this file except in compliance with the License. You may obtain a copy
  * of the License at http://www.apache.org/licenses/LICENSE-2.0.
- *
+ * <p>
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
  * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- *
+ * <p>
  * See the License for the specific language governing permissions and
  * limitations under the License.
- *
+ * <p>
- *********************************************************************** */
+ * **********************************************************************
+ */
 package org.mustangproject.ZUGFeRD;
 
 import org.mustangproject.TradeParty;
@@ -50,13 +52,14 @@ public interface IZUGFeRDExportableTradeParty {
 	}
 
 
-  /***
+	/***
 	 * gets the official representation
 	 * @return the interface with the attributes of the legal organisation
 	 */
-	default IZUGFeRDLegalOrganisation getLegalOrganisation()  {
+	default IZUGFeRDLegalOrganisation getLegalOrganisation() {
 		return null;
 	}
+
 	/**
 	 * customer global identification scheme
 	 *
@@ -69,15 +72,17 @@ public interface IZUGFeRDExportableTradeParty {
 
 	/**
 	 * URIUniversalCommunication scheme (see EAS code list of the ZUGFeRD documentation)
-	 *
+	 * I believe EM for Email
+	 * @return String with code
 	 */
 	default String getUriUniversalCommunicationIDScheme() {
 		return null;
 	}
+
 	/**
 	 * The URIID of URIUniversalCommunicationID
-   * It is used by some countries, i.e. Luxembourg
+	 * It is used by some countries, i.e. Luxembourg
-	 *
+	 * @return the URI as string
 	 */
 	default String getUriUniversalCommunicationID() {
 		return null;
@@ -94,6 +99,7 @@ public interface IZUGFeRDExportableTradeParty {
 	 * @return First and last name of the recipient
 	 */
 	String getName();
+
 	/**
 	 * Postal code of the recipient
 	 *

library/src/main/java/org/mustangproject/ZUGFeRD/ZUGFeRDExporterFromA3.java

@@ -645,6 +645,8 @@ public class ZUGFeRDExporterFromA3 extends XRExporter implements IZUGFeRDExporte
 	/**
 	 * Reads the XMPMetadata from the PDDocument, if it exists.
 	 * Otherwise creates XMPMetadata.
+	 * @return the finished XMPMetadata object
+	 * @throws IOException when e.g. XmpParsingException
 	 */
 	protected XMPMetadata getXmpMetadata()
 	    throws IOException
@@ -670,6 +672,7 @@ public class ZUGFeRDExporterFromA3 extends XRExporter implements IZUGFeRDExporte
 	/**
 	 * Sets the producer if the overwrite flag is set or the producer is not already set.
 	 * Sets the PDFVersion to 1.4 if the field is empty.
+	 * @param xmp the metadata as XML
 	 */
 	protected void writeAdobePDFSchema(XMPMetadata xmp) {
 		AdobePDFSchema pdf = getAdobePDFSchema(xmp);

library/src/main/java/org/mustangproject/ZUGFeRD/ZUGFeRDExporterFromPDFA.java

@@ -105,8 +105,8 @@ public class ZUGFeRDExporterFromPDFA implements IZUGFeRDExporter {
 	/***
 	 * Load from filename
 	 * @param pdfFilename binary of a PDF/A1 compliant document
-	 * @return
+	 * @return the A1 or A3 exporter
-	 * @throws IOException
+	 * @throws IOException e.g. on read error
 	 */
 	public IZUGFeRDExporter load(String pdfFilename) throws IOException {
 		determineAndSetExporter(getPDFAVersion(filenameToByteArray(pdfFilename)));