add methods overloads; fix doc

Author: Cadabra

src/DateRecurrenceR/Core/DayOfMonth.cs

@@ -60,7 +60,10 @@ public override int GetHashCode()
         return _value;
     }
 
-    /// <inheritdoc />
+    /// <summary>
+    /// Converts the numeric value of this instance to its equivalent string representation.
+    /// </summary>
+    /// <returns>The string representation of the value of this instance, consisting of a sequence of digits ranging from 0 to 9 with no leading zeroes.</returns>
     public override string ToString()
     {
         return _value.ToString();

src/DateRecurrenceR/Core/DayOfYear.cs

@@ -60,7 +60,10 @@ public override int GetHashCode()
         return _value;
     }
 
-    /// <inheritdoc />
+    /// <summary>
+    /// Converts the numeric value of this instance to its equivalent string representation.
+    /// </summary>
+    /// <returns>The string representation of the value of this instance, consisting of a sequence of digits ranging from 0 to 9 with no leading zeroes.</returns>
     public override string ToString()
     {
         return _value.ToString();

src/DateRecurrenceR/Core/Interval.cs

@@ -60,7 +60,10 @@ public override int GetHashCode()
         return _value;
     }
 
-    /// <inheritdoc />
+    /// <summary>
+    /// Converts the numeric value of this instance to its equivalent string representation.
+    /// </summary>
+    /// <returns>The string representation of the value of this instance, consisting of a sequence of digits ranging from 0 to 9 with no leading zeroes.</returns>
     public override string ToString()
     {
         return _value.ToString();

src/DateRecurrenceR/Core/MonthOfYear.cs

@@ -60,7 +60,10 @@ public override int GetHashCode()
         return _value;
     }
 
-    /// <inheritdoc />
+    /// <summary>
+    /// Converts the numeric value of this instance to its equivalent string representation.
+    /// </summary>
+    /// <returns>The string representation of the value of this instance, consisting of a sequence of digits ranging from 0 to 9 with no leading zeroes.</returns>
     public override string ToString()
     {
         return _value.ToString();

src/DateRecurrenceR/Recurrence.Daily.cs

@@ -7,7 +7,21 @@ namespace DateRecurrenceR;
 public partial struct Recurrence
 {
     /// <summary>
-    ///     Gets an enumerator for daily period for first <c>n</c> contiguous dates.
+    ///     Returns an enumerator for daily period for first <c>n</c> contiguous dates.
+    /// </summary>
+    /// <param name="beginDate">The date when the recurrence begins.</param>
+    /// <param name="count">The maximum number of contiguous dates.</param>
+    /// <param name="interval">The interval between occurrences.</param>
+    /// <returns>
+    ///     <see cref="IEnumerator{T}" /> type of <see cref="DateOnly" />
+    /// </returns>
+    public static IEnumerator<DateOnly> Daily(DateOnly beginDate, int count, Interval interval)
+    {
+        return Daily(beginDate, beginDate, count, interval);
+    }
+
+    /// <summary>
+    ///     Returns an enumerator for daily period for first <c>n</c> contiguous dates.
     /// </summary>
     /// <param name="beginDate">The date when the recurrence begins.</param>
     /// <param name="fromDate">The date when a specific range starts.</param>
@@ -16,7 +30,6 @@ public partial struct Recurrence
     /// <returns>
     ///     <see cref="IEnumerator{T}" /> type of <see cref="DateOnly" />
     /// </returns>
-    /// <exception cref="ArgumentException">If <paramref name="interval" /> less than 1.</exception>
     public static IEnumerator<DateOnly> Daily(DateOnly beginDate,
         DateOnly fromDate,
         int count,
@@ -36,7 +49,22 @@ public static IEnumerator<DateOnly> Daily(DateOnly beginDate,
     }
 
     /// <summary>
-    ///     Gets an enumerator for daily period in intersection ranges <c>[beginDate, endDate]</c> and
+    ///     Returns an enumerator for daily period in intersection ranges <c>[beginDate, endDate]</c> and
+    ///     <c>[fromDate, toDate]</c>.
+    /// </summary>
+    /// <param name="beginDate">The date when the recurrence begins.</param>
+    /// <param name="endDate">The date when the recurrence ends.</param>
+    /// <param name="interval">The interval between occurrences.</param>
+    /// <returns>
+    ///     <see cref="IEnumerator{T}" /> type of <see cref="DateOnly" />
+    /// </returns>
+    public static IEnumerator<DateOnly> Daily(DateOnly beginDate, DateOnly endDate, Interval interval)
+    {
+        return Daily(beginDate, endDate, beginDate, endDate, interval);
+    }
+
+    /// <summary>
+    ///     Returns an enumerator for daily period in intersection ranges <c>[beginDate, endDate]</c> and
     ///     <c>[fromDate, toDate]</c>.
     /// </summary>
     /// <param name="beginDate">The date when the recurrence begins.</param>
@@ -47,7 +75,6 @@ public static IEnumerator<DateOnly> Daily(DateOnly beginDate,
     /// <returns>
     ///     <see cref="IEnumerator{T}" /> type of <see cref="DateOnly" />
     /// </returns>
-    /// <exception cref="ArgumentException">If <paramref name="interval" /> less than 1.</exception>
     public static IEnumerator<DateOnly> Daily(DateOnly beginDate,
         DateOnly endDate,
         DateOnly fromDate,

src/DateRecurrenceR/Recurrence.Monthly.cs

@@ -7,7 +7,26 @@ namespace DateRecurrenceR;
 public partial struct Recurrence
 {
     /// <summary>
-    ///     Gets an enumerator for monthly period for first <c>n</c> contiguous dates.<br/>
+    ///     Returns an enumerator for monthly period for first <c>n</c> contiguous dates.<br/>
+    ///     <b>By day of month.</b>
+    /// </summary>
+    /// <param name="beginDate">The date when the recurrence begins.</param>
+    /// <param name="count">The maximum number of contiguous dates.</param>
+    /// <param name="dayOfMonth">
+    ///     The day of the month. Takes the last day of the month if <paramref name="dayOfMonth" /> is more than the days
+    ///     in the month.
+    /// </param>
+    /// <param name="interval">The interval between occurrences.</param>
+    /// <returns>
+    ///     <see cref="IEnumerator{T}" /> type of <see cref="DateOnly" />
+    /// </returns>
+    public static IEnumerator<DateOnly> Monthly(DateOnly beginDate, int count, DayOfMonth dayOfMonth, Interval interval)
+    {
+        return Monthly(beginDate, beginDate, count, dayOfMonth, interval);
+    }
+
+    /// <summary>
+    ///     Returns an enumerator for monthly period for first <c>n</c> contiguous dates.<br/>
     ///     <b>By day of month.</b>
     /// </summary>
     /// <param name="beginDate">The date when the recurrence begins.</param>
@@ -21,7 +40,6 @@ public partial struct Recurrence
     /// <returns>
     ///     <see cref="IEnumerator{T}" /> type of <see cref="DateOnly" />
     /// </returns>
-    /// <exception cref="ArgumentException">If <paramref name="interval" /> less than 1.</exception>
     public static IEnumerator<DateOnly> Monthly(DateOnly beginDate,
         DateOnly fromDate,
         int count,
@@ -48,7 +66,25 @@ DateOnly GetNextDate(int year, int month)
     }
 
     /// <summary>
-    ///     Gets an enumerator for monthly period for first <c>n</c> contiguous dates.<br/>
+    ///     Returns an enumerator for monthly period for first <c>n</c> contiguous dates.<br/>
+    ///     <b>By day of week and number of week.</b>
+    /// </summary>
+    /// <param name="beginDate">The date when the recurrence begins.</param>
+    /// <param name="count">The maximum number of contiguous dates.</param>
+    /// <param name="dayOfWeek">The day of the week.</param>
+    /// <param name="numberOfWeek">The number of the week. The first week of a month starts from the first day of the month.</param>
+    /// <param name="interval">The interval between occurrences.</param>
+    /// <returns>
+    ///     <see cref="IEnumerator{T}" /> type of <see cref="DateOnly" />
+    /// </returns>
+    public static IEnumerator<DateOnly> Monthly(DateOnly beginDate, int count, DayOfWeek dayOfWeek,
+        NumberOfWeek numberOfWeek, Interval interval)
+    {
+        return Monthly(beginDate, beginDate, count, dayOfWeek, numberOfWeek, interval);
+    }
+
+    /// <summary>
+    ///     Returns an enumerator for monthly period for first <c>n</c> contiguous dates.<br/>
     ///     <b>By day of week and number of week.</b>
     /// </summary>
     /// <param name="beginDate">The date when the recurrence begins.</param>
@@ -60,7 +96,6 @@ DateOnly GetNextDate(int year, int month)
     /// <returns>
     ///     <see cref="IEnumerator{T}" /> type of <see cref="DateOnly" />
     /// </returns>
-    /// <exception cref="ArgumentException">If <paramref name="interval" /> less than 1.</exception>
     public static IEnumerator<DateOnly> Monthly(DateOnly beginDate,
         DateOnly fromDate,
         int count,
@@ -87,7 +122,30 @@ DateOnly GetNextDate(int year, int month)
     }
 
     /// <summary>
-    ///     Gets an enumerator for monthly period in intersection ranges <c>[beginDate, endDate]</c> and
+    ///     Returns an enumerator for monthly period in intersection ranges <c>[beginDate, endDate]</c> and
+    ///     <c>[fromDate, toDate]</c>.<br/>
+    ///     <b>By day of month.</b>
+    /// </summary>
+    /// <param name="beginDate">The date when the recurrence begins.</param>
+    /// <param name="endDate">The date when the recurrence ends.</param>
+    /// <param name="dayOfMonth">
+    ///     The day of the month. Takes the last day of the month if <paramref name="dayOfMonth" /> is more than the days
+    ///     in the month.
+    /// </param>
+    /// <param name="interval">The interval between occurrences.</param>
+    /// <returns>
+    ///     <see cref="IEnumerator{T}" /> type of <see cref="DateOnly" />
+    /// </returns>
+    public static IEnumerator<DateOnly> Monthly(DateOnly beginDate,
+        DateOnly endDate,
+        DayOfMonth dayOfMonth,
+        Interval interval)
+    {
+        return Monthly(beginDate, endDate, beginDate, endDate, dayOfMonth, interval);
+    }
+
+    /// <summary>
+    ///     Returns an enumerator for monthly period in intersection ranges <c>[beginDate, endDate]</c> and
     ///     <c>[fromDate, toDate]</c>.<br/>
     ///     <b>By day of month.</b>
     /// </summary>
@@ -103,7 +161,6 @@ DateOnly GetNextDate(int year, int month)
     /// <returns>
     ///     <see cref="IEnumerator{T}" /> type of <see cref="DateOnly" />
     /// </returns>
-    /// <exception cref="ArgumentException">If <paramref name="interval" /> less than 1.</exception>
     public static IEnumerator<DateOnly> Monthly(DateOnly beginDate,
         DateOnly endDate,
         DateOnly fromDate,
@@ -131,7 +188,29 @@ DateOnly GetNextDate(int year, int month)
     }
 
     /// <summary>
-    ///     Gets an enumerator for monthly period in intersection ranges <c>[beginDate, endDate]</c> and
+    ///     Returns an enumerator for monthly period in intersection ranges <c>[beginDate, endDate]</c> and
+    ///     <c>[fromDate, toDate]</c>.<br/>
+    ///     <b>By day of week and number of week.</b>
+    /// </summary>
+    /// <param name="beginDate">The date when the recurrence begins.</param>
+    /// <param name="endDate">The date when the recurrence ends.</param>
+    /// <param name="dayOfWeek">The day of the week.</param>
+    /// <param name="numberOfWeek">The number of the week. The first week of a month starts from the first day of the month.</param>
+    /// <param name="interval">The interval between occurrences.</param>
+    /// <returns>
+    ///     <see cref="IEnumerator{T}" /> type of <see cref="DateOnly" />
+    /// </returns>
+    public static IEnumerator<DateOnly> Monthly(DateOnly beginDate,
+        DateOnly endDate,
+        DayOfWeek dayOfWeek,
+        NumberOfWeek numberOfWeek,
+        Interval interval)
+    {
+        return Monthly(beginDate, endDate, beginDate, endDate, dayOfWeek, numberOfWeek, interval);
+    }
+
+    /// <summary>
+    ///     Returns an enumerator for monthly period in intersection ranges <c>[beginDate, endDate]</c> and
     ///     <c>[fromDate, toDate]</c>.<br/>
     ///     <b>By day of week and number of week.</b>
     /// </summary>
@@ -145,7 +224,6 @@ DateOnly GetNextDate(int year, int month)
     /// <returns>
     ///     <see cref="IEnumerator{T}" /> type of <see cref="DateOnly" />
     /// </returns>
-    /// <exception cref="ArgumentException">If <paramref name="interval" /> less than 1.</exception>
     public static IEnumerator<DateOnly> Monthly(DateOnly beginDate,
         DateOnly endDate,
         DateOnly fromDate,

src/DateRecurrenceR/Recurrence.Weekly.cs

@@ -7,7 +7,27 @@ namespace DateRecurrenceR;
 public partial struct Recurrence
 {
     /// <summary>
-    ///     Gets an enumerator for weekly period for first <c>n</c> contiguous dates.
+    ///     Returns an enumerator for weekly period for first <c>n</c> contiguous dates.
+    /// </summary>
+    /// <param name="beginDate">The date when the recurrence begins.</param>
+    /// <param name="count">The maximum number of contiguous dates.</param>
+    /// <param name="weekDays">Days of the week.</param>
+    /// <param name="firstDayOfWeek">The first day of the week.</param>
+    /// <param name="interval">The interval between occurrences.</param>
+    /// <returns>
+    ///     <see cref="IEnumerator{T}" /> type of <see cref="DateOnly" />
+    /// </returns>
+    public static IEnumerator<DateOnly> Weekly(DateOnly beginDate,
+        int count,
+        WeekDays weekDays,
+        DayOfWeek firstDayOfWeek,
+        Interval interval)
+    {
+        return Weekly(beginDate, beginDate, count, weekDays, firstDayOfWeek, interval);
+    }
+
+    /// <summary>
+    ///     Returns an enumerator for weekly period for first <c>n</c> contiguous dates.
     /// </summary>
     /// <param name="beginDate">The date when the recurrence begins.</param>
     /// <param name="fromDate">The date when a specific range starts.</param>
@@ -18,7 +38,6 @@ public partial struct Recurrence
     /// <returns>
     ///     <see cref="IEnumerator{T}" /> type of <see cref="DateOnly" />
     /// </returns>
-    /// <exception cref="ArgumentException">If <paramref name="interval" /> less than 1.</exception>
     public static IEnumerator<DateOnly> Weekly(DateOnly beginDate,
         DateOnly fromDate,
         int count,
@@ -43,7 +62,28 @@ public static IEnumerator<DateOnly> Weekly(DateOnly beginDate,
     }
 
     /// <summary>
-    ///     Gets an enumerator for weekly period in intersection ranges <c>[beginDate, endDate]</c> and
+    ///     Returns an enumerator for weekly period in intersection ranges <c>[beginDate, endDate]</c> and
+    ///     <c>[fromDate, toDate]</c>.
+    /// </summary>
+    /// <param name="beginDate">The date when the recurrence begins.</param>
+    /// <param name="endDate">The date when the recurrence ends.</param>
+    /// <param name="weekDays">Days of the week.</param>
+    /// <param name="firstDayOfWeek">The first day of the week.</param>
+    /// <param name="interval">The interval between occurrences.</param>
+    /// <returns>
+    ///     <see cref="IEnumerator{T}" /> type of <see cref="DateOnly" />
+    /// </returns>
+    public static IEnumerator<DateOnly> Weekly(DateOnly beginDate,
+        DateOnly endDate,
+        WeekDays weekDays,
+        DayOfWeek firstDayOfWeek,
+        Interval interval)
+    {
+        return Weekly(beginDate, endDate, beginDate, endDate, weekDays, firstDayOfWeek, interval);
+    }
+
+    /// <summary>
+    ///     Returns an enumerator for weekly period in intersection ranges <c>[beginDate, endDate]</c> and
     ///     <c>[fromDate, toDate]</c>.
     /// </summary>
     /// <param name="beginDate">The date when the recurrence begins.</param>
@@ -56,7 +96,6 @@ public static IEnumerator<DateOnly> Weekly(DateOnly beginDate,
     /// <returns>
     ///     <see cref="IEnumerator{T}" /> type of <see cref="DateOnly" />
     /// </returns>
-    /// <exception cref="ArgumentException">If <paramref name="interval" /> less than 1.</exception>
     public static IEnumerator<DateOnly> Weekly(DateOnly beginDate,
         DateOnly endDate,
         DateOnly fromDate,