From a2b5909d2b689f4f609218d80087a332ce55f2be Mon Sep 17 00:00:00 2001
From: ulrich
Date: Fri, 24 Mar 2023 17:49:02 +0000
Subject: [PATCH] Kommentare fuer API-Doku hinzugefuegt

---
 src/de/uhilger/zeitrechnung/ChinesischesDatum.java |   49 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 files changed, 49 insertions(+), 0 deletions(-)

diff --git a/src/de/uhilger/zeitrechnung/ChinesischesDatum.java b/src/de/uhilger/zeitrechnung/ChinesischesDatum.java
index 3ece41c..e0c9f79 100644
--- a/src/de/uhilger/zeitrechnung/ChinesischesDatum.java
+++ b/src/de/uhilger/zeitrechnung/ChinesischesDatum.java
@@ -1,6 +1,27 @@
+/*
+  Zeitrechnung - a class library to determine calendar events
+  Copyright (c) 1984-2023 Ulrich Hilger, http://uhilger.de
+
+  This program is free software: you can redistribute it and/or modify
+  it under the terms of the GNU Affero General Public License as published by
+  the Free Software Foundation, either version 3 of the License, or
+  (at your option) any later version.
+
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU Affero General Public License for more details.
+
+  You should have received a copy of the GNU Affero General Public License
+  along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
 package de.uhilger.zeitrechnung;
 
 /**
+ * Einfache Klasse fuer ein ChinesischesDatum, die neben  
+ * Jahr, Monat und Tag auch den Zyklus im chinesischen 
+ * Kalender abbildet und festhaelt, ob der Monat ein 
+ * Schaltmonat ist.
  *
  * @author Ulrich Hilger
  */
@@ -9,28 +30,56 @@
   private long zyklus;
   private boolean schaltmonat;
   
+  /**
+   * Ein Objekt der Klasse ChinesischesDatum erzeugen
+   */
   public ChinesischesDatum() {
     super();
   }
   
+  /**
+   * Ein Objekt der Klasse ChinesischesDatum erzeugen
+   *
+   * @param zyklus  der Zyklus des chinesischen Kalenders
+   * @param jahr das Jahr im chinesischen Kalender
+   * @param monat  der Monat im chinesischen Kalender
+   * @param schaltmonat  true, wenn der Monat ein Schaltmonat ist, sonst false
+   * @param tag  Tag im Monat des chinesischen Kalenders
+   */
   public ChinesischesDatum(long zyklus, long jahr, int monat, boolean schaltmonat, int tag) {
     super(jahr, monat, tag);
     this.zyklus = zyklus;
     this.schaltmonat = schaltmonat;
   }
 
+  /**
+   * Den Zyklus dieses Datums im chinesischen Kalender ermitteln
+   * @return Zyklus
+   */
   public long getZyklus() {
     return zyklus;
   }
 
+  /**
+   * Den Zyklkus im chinesischen Kalender angeben
+   * @param zyklus der Zyklus dieses Datums
+   */
   public void setZyklus(long zyklus) {
     this.zyklus = zyklus;
   }
 
+  /**
+   * Ermitteln, ob der Monat dieses Datums ein Schaltmonat ist
+   * @return true, wenn der Monat ein Schaltmonat ist, sonst false 
+   */
   public boolean isSchaltmonat() {
     return schaltmonat;
   }
 
+  /**
+   * Angeben, ob der Monat dieses Datums ein Schaltmonat ist
+   * @param schaltmonat true, wenn der Monat ein Schaltmonat ist, sonst false
+   */
   public void setSchaltmonat(boolean schaltmonat) {
     this.schaltmonat = schaltmonat;
   }  

--
Gitblit v1.9.3