javadoc fixes

MenoData · Oct 23, 2017 · 2c7b514 · 2c7b514
1 parent fd09ef4
commit 2c7b514
Show file tree

Hide file tree

Showing 2 changed files with 12 additions and 14 deletions.
diff --git a/time4j-android/src/main/java/net/time4j/calendar/astro/SolarTime.java b/time4j-android/src/main/java/net/time4j/calendar/astro/SolarTime.java
@@ -55,9 +55,9 @@
  *
  * <pre>
  *     PlainDate date = PlainDate.of(2017, 12, 22);
- *     TZID tzid = () -> &quot;Africa/Dar_es_Salaam&quot;; // Tanzania: UTC+03:00
+ *     TZID tzid = Timezone.of(&quot;Africa/Dar_es_Salaam&quot;).getID(); // Tanzania: UTC+03:00
  *
- *     // high altitude => earlier sunrise and later sunset
+ *     // high altitude implies earlier sunrise and later sunset
  *     SolarTime kibo5895 =
  *       SolarTime.ofLocation().southernLatitude(3, 4, 0).easternLongitude(37, 21, 33).atAltitude(5895).build();
  *
@@ -91,9 +91,9 @@
  *
  * <pre>
  *     PlainDate date = PlainDate.of(2017, 12, 22);
- *     TZID tzid = () -> &quot;Africa/Dar_es_Salaam&quot;; // Tanzania: UTC+03:00
+ *     TZID tzid = Timezone.of(&quot;Africa/Dar_es_Salaam&quot;).getID(); // Tanzania: UTC+03:00
  *
- *     // gro&szlig;e H&ouml;he => fr&uuml;herer Sonnenaufgang und sp&auml;terer Sonnenuntergang
+ *     // gro&szlig;e H&ouml;he verursacht fr&uuml;heren Sonnenaufgang und sp&auml;teren Sonnenuntergang
  *     SolarTime kibo5895 =
  *       SolarTime.ofLocation().southernLatitude(3, 4, 0).easternLongitude(37, 21, 33).atAltitude(5895).build();
  *
@@ -1575,15 +1575,13 @@ private static void check(
      *
      * @see     java.util.ServiceLoader
      * @since   3.34/4.29
-     * @doctags.spec    All implementations must have a public no-arg constructor.
      */
     /*[deutsch]
      * <p>Ein SPI-Interface, das eine Fassade f&uuml;r die Berechnung von Sonnenaufgang oder Sonnenuntergang
      * darstellt. </p>
      *
      * @see     java.util.ServiceLoader
      * @since   3.34/4.29
-     * @doctags.spec    All implementations must have a public no-arg constructor.
      */
     public interface Calculator {
 

diff --git a/time4j-android/src/main/java/net/time4j/calendar/astro/StdSolarCalculator.java b/time4j-android/src/main/java/net/time4j/calendar/astro/StdSolarCalculator.java
@@ -309,7 +309,7 @@ private double adjustRange(double value) { // range [0.0, 360.0)
     /**
      * Follows closely the algorithms published by NOAA (National Oceanic and Atmospheric Administration).
      *
-     * <h4>Introduction</h4>
+     * <p><strong>Introduction</strong></p>
      *
      * <p>The <a href="https://www.esrl.noaa.gov/gmd/grad/solcalc/">website</a> of NOAA also links
      * to the calculation details. This is a calculator with reasonably good precision. But the altitude
@@ -320,7 +320,7 @@ private double adjustRange(double value) { // range [0.0, 360.0)
      * that local topology or the actual weather conditions are not taken into account. Therefore
      * truncating the results to minute precision should be considered. </p>
      *
-     * <h4>Example</h4>
+     * <p><strong>Example</strong></p>
      *
      * <pre>
      *     PlainDate date = PlainDate.of(2009, 9, 6);
@@ -338,7 +338,7 @@ private double adjustRange(double value) { // range [0.0, 360.0)
      * Folgt nahe den Algorithmen, die von der NOAA (National Oceanic and Atmospheric Administration)
      * ver&ouml;ffentlicht wurden.
      *
-     * <h4>Einleitung</h4>
+     * <p><strong>Einleitung</strong></p>
      *
      * <p>Die <a href="https://www.esrl.noaa.gov/gmd/grad/solcalc/">Webseite</a> der NOAA verlinkt
      * auch zu den Berechnungsdetails. Dieses Verfahren bietet eine recht gute Genauigkeit. Die H&ouml;he
@@ -350,7 +350,7 @@ private double adjustRange(double value) { // range [0.0, 360.0)
      * ber&uuml;cksichtigt werden. Deshalb ist das Abschneiden der Sekundenteile in den Ergebnissen
      * meistens angeraten. </p>
      *
-     * <h4>Beispiel</h4>
+     * <p><strong>Beispiel</strong></p>
      *
      * <pre>
      *     PlainDate date = PlainDate.of(2009, 9, 6);
@@ -678,7 +678,7 @@ private double solarLongitude(double jct) {
      * Based mainly on the astronomical calculations published by Jean Meeus in his book
      * &quot;Astronomical Algorithms&quot; (second edition).
      *
-     * <h4>Introduction</h4>
+     * <p><strong>Introduction</strong></p>
      *
      * <p>This calculation is the <strong>default</strong> method because it offers high precision
      * with the general limitation that the local topology or special weather conditions cannot be
@@ -687,7 +687,7 @@ private double solarLongitude(double jct) {
      * <p>The altitude of the observer is taken into account using a spheroid (WGS84)
      * and the assumption of a standard atmosphere (for the refraction). </p>
      *
-     * <h4>Supported features</h4>
+     * <p><strong>Supported features</strong></p>
      *
      * <ul>
      *     <li>declination</li>
@@ -698,7 +698,7 @@ private double solarLongitude(double jct) {
      * Basiert meist auf den astronomischen Berechnungen von Jean Meeus, die er im Buch
      * &quot;Astronomical Algorithms&quot; (zweite Auflage) ver&ouml;ffentlicht hat.
      *
-     * <h4>Einleitung</h4>
+     * <p><strong>Einleitung</strong></p>
      *
      * <p>Dieses Verfahren ist der <strong>Standard</strong>, weil es hohe Genauigkeit bietet, aber mit der
      * allgemeinen Einschr&auml;nkung, da&szlig; die lokale Topologie oder besondere Wetterbedingungen
@@ -708,7 +708,7 @@ private double solarLongitude(double jct) {
      * als geod&auml;tischen Modell und der Annahme einer Standardatmosph&auml;re (f&uuml;r
      * die Refraktion) ber&uuml;cksichtigt. </p>
      *
-     * <h4>Unterst&uuml;tzte Merkmale</h4>
+     * <p><strong>Unterst&uuml;tzte Merkmale</strong></p>
      *
      * <ul>
      *     <li>declination</li>