Skip to content

Commit b51132c

Browse files
authored
JavaDoc cleanup in ComprehensiveZmanimCalendar
1 parent 926bfb5 commit b51132c

1 file changed

Lines changed: 8 additions & 18 deletions

File tree

src/main/java/com/kosherjava/zmanim/ComprehensiveZmanimCalendar.java

Lines changed: 8 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -181,15 +181,7 @@ public class ComprehensiveZmanimCalendar extends ZmanimCalendar {
181181
protected static final double ZENITH_19_POINT_8 = GEOMETRIC_ZENITH + 19.8;
182182

183183
/**
184-
* The zenith of 26° below {@link #GEOMETRIC_ZENITH geometric zenith} (90°). This calculation is used for
185-
* calculating <em>alos</em> (dawn) and <em>tzais</em> (nightfall) according to some opinions. This calculation is
186-
* based on the position of the sun {@link #getAlos120Minutes() 120 minutes} after sunset in Jerusalem <a href=
187-
* "https://kosherjava.com/2022/01/12/equinox-vs-equilux-zmanim-calculations/">around the equinox / equilux</a> which
188-
* calculates to 26&deg; below {@link #GEOMETRIC_ZENITH geometric zenith}. Since the level of darkness when the sun is
189-
* 26&deg; and at a point when the level of darkness is long past the 18&deg; point where the darkest point is reached,
190-
* it should only be used <em>lechumra</em> such as delaying the start of nighttime <em>mitzvos</em> or avoiding eating
191-
* this early on a fast day.
192-
*
184+
* The zenith of 26&deg; below {@link #GEOMETRIC_ZENITH geometric zenith} (90&deg;).
193185
* @see #getAlos26Degrees()
194186
* @see #getTzais26Degrees()
195187
* @see #getAlos120Minutes()
@@ -222,13 +214,7 @@ public class ComprehensiveZmanimCalendar extends ZmanimCalendar {
222214
protected static final double ZENITH_5_POINT_88 = GEOMETRIC_ZENITH + 5.88;
223215

224216
/**
225-
* The zenith of 16.9&deg; below geometric zenith (90&deg;). This calculation is used for determining <em>alos</em>
226-
* (dawn) based on the opinion of the Baal Hatanya. It is based on the calculation that the time between dawn
227-
* and <em>netz amiti</em> (sunrise) is 72 minutes, the time that is takes to walk 4 mil at 18 minutes
228-
* a mil (<a href="https://en.wikipedia.org/wiki/Maimonides">Rambam</a> and others). The sun's position at 72
229-
* minutes before {@link #getSunriseBaalHatanya <em>netz amiti</em> (sunrise)} in Jerusalem <a href=
230-
* "https://kosherjava.com/2022/01/12/equinox-vs-equilux-zmanim-calculations/">around the equinox / equilux</a> is
231-
* 16.9&deg; below {@link #GEOMETRIC_ZENITH geometric zenith}.
217+
* The zenith of 16.9&deg; below geometric zenith (90&deg;).
232218
*
233219
* @see #getAlosBaalHatanya()
234220
*/
@@ -3559,9 +3545,13 @@ public long getShaahZmanisBaalHatanya() {
35593545
/**
35603546
* Returns the <a href="https://en.wikipedia.org/wiki/Shneur_Zalman_of_Liadi">Baal Hatanya</a>'s <em>alos</em>
35613547
* (dawn) calculated as the time when the sun is 16.9&deg; below the eastern {@link #GEOMETRIC_ZENITH geometric horizon}
3562-
* before {@link #getSunriseWithElevation() sunrise}. For more information the source of 16.9&deg; see {@link #ZENITH_16_POINT_9}.
3548+
* before {@link #getSunriseWithElevation() sunrise}. It is based on the calculation that the time between dawn and
3549+
* <em>netz amiti</em> (sunrise) is 72 minutes, the time that is takes to walk 4 mil at 18 minutes
3550+
* a mil (<a href="https://en.wikipedia.org/wiki/Maimonides">Rambam</a> and others). The sun's position at 72
3551+
* minutes before {@link #getSunriseBaalHatanya <em>netz amiti</em> (sunrise)} in Jerusalem <a href=
3552+
* "https://kosherjava.com/2022/01/12/equinox-vs-equilux-zmanim-calculations/">around the equinox / equilux</a> is
3553+
* 16.9&deg; below {@link #GEOMETRIC_ZENITH geometric zenith}.
35633554
*
3564-
* @see #ZENITH_16_POINT_9
35653555
* @return The <code>Instant</code> of dawn. If the calculation can't be computed such as northern and southern
35663556
* locations even south of the Arctic Circle and north of the Antarctic Circle where the sun may not reach
35673557
* low enough below the horizon for this calculation, a <code>null</code> will be returned. See detailed

0 commit comments

Comments
 (0)