From fdbc5c6a84ae349ac0eb447235ded3541b3e2e83 Mon Sep 17 00:00:00 2001
From: BurdetteLamar <BurdetteLamar@Yahoo.com>
Date: Wed, 6 Jul 2022 14:52:15 -0500
Subject: [PATCH 1/5] Enhanced RDoc

---
 ext/date/date_core.c | 72 ++++++++++++++++++++++++++++++--------------
 1 file changed, 49 insertions(+), 23 deletions(-)

diff --git a/ext/date/date_core.c b/ext/date/date_core.c
index dc0f001..a50a0e4 100644
--- a/ext/date/date_core.c
+++ b/ext/date/date_core.c
@@ -2473,6 +2473,8 @@ date_s__valid_jd_p(int argc, VALUE *argv, VALUE klass)
  *
  *   Date.valid_jd?(2451944) # => true
  *
+ * See {Argument start}[rdoc-ref:Date@Argument+start].
+ *
  * Related: Date.jd.
  */
 static VALUE
@@ -3358,7 +3360,7 @@ date_s_jd(int argc, VALUE *argv, VALUE klass)
 
 /*
  * call-seq:
- *    Date.ordinal(year = -4712, yday = 1, start = Date::ITALY) -> date
+ *   Date.ordinal(year = -4712, yday = 1, start = Date::ITALY) -> date
  *
  * Returns a new \Date object formed fom the arguments.
  *
@@ -3529,7 +3531,7 @@ date_initialize(int argc, VALUE *argv, VALUE self)
 
 /*
  * call-seq:
- *   Date.commercial(cwyear=-4712, cweek=1, cwday=1, start=Date::ITALY) -> date
+ *   Date.commercial(cwyear = -4712, cweek = 1, cwday = 1, start = Date::ITALY) -> date
  *
  * Returns a new \Date object constructed from the arguments.
  *
@@ -3744,11 +3746,14 @@ static void set_sg(union DateData *, double);
 
 /*
  * call-seq:
- *    Date.today([start=Date::ITALY])  ->  date
+ *   Date.today(start = Date::ITALY) -> date
  *
- * Creates a date object denoting the present day.
+ * Returns a new \Date object constructed from the present date:
+ *
+ *   Date.today.to_s # => "2022-07-06"
+ *
+ * See {Argument start}[rdoc-ref:Date@Argument+start].
  *
- *    Date.today   #=> #<Date: 2011-06-11 ...>
  */
 static VALUE
 date_s_today(int argc, VALUE *argv, VALUE klass)
@@ -4339,7 +4344,7 @@ date_s__strptime_internal(int argc, VALUE *argv, VALUE klass,
 
 /*
  * call-seq:
- *    Date._strptime(string[, format='%F'])  ->  hash
+ *   Date._strptime(string, format = '%F') -> hash
  *
  * Parses the given representation of date and time with the given
  * template, and returns a hash of parsed elements.  _strptime does
@@ -4358,7 +4363,7 @@ date_s__strptime(int argc, VALUE *argv, VALUE klass)
 
 /*
  * call-seq:
- *    Date.strptime([string='-4712-01-01'[, format='%F'[, start=Date::ITALY]]])  ->  date
+ *   Date.strptime(string = '-4712-01-01', format = '%F', start = Date::ITALY) -> date
  *
  * Parses the given representation of date and time with the given
  * template, and creates a date object.  strptime does not support
@@ -4372,6 +4377,8 @@ date_s__strptime(int argc, VALUE *argv, VALUE klass)
  *    Date.strptime('2001 05 6', '%Y %W %u')	#=> #<Date: 2001-02-03 ...>
  *    Date.strptime('sat3feb01', '%a%d%b%y')	#=> #<Date: 2001-02-03 ...>
  *
+ * See {Argument start}[rdoc-ref:Date@Argument+start].
+ *
  * See also strptime(3) and #strftime.
  */
 static VALUE
@@ -4459,7 +4466,7 @@ date_s__parse_internal(int argc, VALUE *argv, VALUE klass)
 
 /*
  * call-seq:
- *    Date._parse(string[, comp=true], limit: 128)  ->  hash
+ *   Date._parse(string, comp = true, limit: 128) -> hash
  *
  * Parses the given representation of date and time, and returns a
  * hash of parsed elements.
@@ -4487,7 +4494,7 @@ date_s__parse(int argc, VALUE *argv, VALUE klass)
 
 /*
  * call-seq:
- *    Date.parse(string='-4712-01-01'[, comp=true[, start=Date::ITALY]], limit: 128)  ->  date
+ *   Date.parse(string = '-4712-01-01', comp = true, start = Date::ITALY, limit: 128) -> date
  *
  * Parses the given representation of date and time, and creates a
  * date object.
@@ -4508,6 +4515,8 @@ date_s__parse(int argc, VALUE *argv, VALUE klass)
  * Raise an ArgumentError when the string length is longer than _limit_.
  * You can stop this check by passing `limit: nil`, but note that
  * it may take a long time to parse.
+ ^
+ * See {Argument start}[rdoc-ref:Date@Argument+start].
  */
 static VALUE
 date_s_parse(int argc, VALUE *argv, VALUE klass)
@@ -4546,7 +4555,7 @@ VALUE date__jisx0301(VALUE);
 
 /*
  * call-seq:
- *    Date._iso8601(string, limit: 128)  ->  hash
+ *   Date._iso8601(string, limit: 128) -> hash
  *
  * Returns a hash of parsed elements.
  *
@@ -4567,7 +4576,7 @@ date_s__iso8601(int argc, VALUE *argv, VALUE klass)
 
 /*
  * call-seq:
- *    Date.iso8601(string='-4712-01-01'[, start=Date::ITALY], limit: 128)  ->  date
+ *   Date.iso8601(string = '-4712-01-01', start = Date::ITALY, limit: 128) -> date
  *
  * Creates a new Date object by parsing from a string according to
  * some typical ISO 8601 formats.
@@ -4579,6 +4588,8 @@ date_s__iso8601(int argc, VALUE *argv, VALUE klass)
  * Raise an ArgumentError when the string length is longer than _limit_.
  * You can stop this check by passing `limit: nil`, but note that
  * it may take a long time to parse.
+ *
+ * See {Argument start}[rdoc-ref:Date@Argument+start].
  */
 static VALUE
 date_s_iso8601(int argc, VALUE *argv, VALUE klass)
@@ -4607,7 +4618,7 @@ date_s_iso8601(int argc, VALUE *argv, VALUE klass)
 
 /*
  * call-seq:
- *    Date._rfc3339(string, limit: 128)  ->  hash
+ *   Date._rfc3339(string, limit: 128) -> hash
  *
  * Returns a hash of parsed elements.
  *
@@ -4628,7 +4639,7 @@ date_s__rfc3339(int argc, VALUE *argv, VALUE klass)
 
 /*
  * call-seq:
- *    Date.rfc3339(string='-4712-01-01T00:00:00+00:00'[, start=Date::ITALY], limit: 128)  ->  date
+ *   Date.rfc3339(string = '-4712-01-01T00:00:00+00:00', start = Date::ITALY, limit: 128) -> date
  *
  * Creates a new Date object by parsing from a string according to
  * some typical RFC 3339 formats.
@@ -4638,6 +4649,8 @@ date_s__rfc3339(int argc, VALUE *argv, VALUE klass)
  * Raise an ArgumentError when the string length is longer than _limit_.
  * You can stop this check by passing `limit: nil`, but note that
  * it may take a long time to parse.
+ *
+ * See {Argument start}[rdoc-ref:Date@Argument+start].
  */
 static VALUE
 date_s_rfc3339(int argc, VALUE *argv, VALUE klass)
@@ -4666,7 +4679,7 @@ date_s_rfc3339(int argc, VALUE *argv, VALUE klass)
 
 /*
  * call-seq:
- *    Date._xmlschema(string, limit: 128)  ->  hash
+ *   Date._xmlschema(string, limit: 128) -> hash
  *
  * Returns a hash of parsed elements.
  *
@@ -4687,7 +4700,7 @@ date_s__xmlschema(int argc, VALUE *argv, VALUE klass)
 
 /*
  * call-seq:
- *    Date.xmlschema(string='-4712-01-01'[, start=Date::ITALY], limit: 128)  ->  date
+ *   Date.xmlschema(string = '-4712-01-01', start = Date::ITALY, limit: 128)  ->  date
  *
  * Creates a new Date object by parsing from a string according to
  * some typical XML Schema formats.
@@ -4697,6 +4710,9 @@ date_s__xmlschema(int argc, VALUE *argv, VALUE klass)
  * Raise an ArgumentError when the string length is longer than _limit_.
  * You can stop this check by passing `limit: nil`, but note that
  * it may take a long time to parse.
+ *
+ * See {Argument start}[rdoc-ref:Date@Argument+start].
+ *
  */
 static VALUE
 date_s_xmlschema(int argc, VALUE *argv, VALUE klass)
@@ -4725,14 +4741,15 @@ date_s_xmlschema(int argc, VALUE *argv, VALUE klass)
 
 /*
  * call-seq:
- *    Date._rfc2822(string, limit: 128)  ->  hash
- *    Date._rfc822(string, limit: 128)   ->  hash
+ *   Date._rfc2822(string, limit: 128) -> hash
  *
  * Returns a hash of parsed elements.
  *
  * Raise an ArgumentError when the string length is longer than _limit_.
  * You can stop this check by passing `limit: nil`, but note that
  * it may take a long time to parse.
+ *
+ * Date._rfc822 is an alias for Date._rfc2822.
  */
 static VALUE
 date_s__rfc2822(int argc, VALUE *argv, VALUE klass)
@@ -4747,8 +4764,7 @@ date_s__rfc2822(int argc, VALUE *argv, VALUE klass)
 
 /*
  * call-seq:
- *    Date.rfc2822(string='Mon, 1 Jan -4712 00:00:00 +0000'[, start=Date::ITALY], limit: 128)  ->  date
- *    Date.rfc822(string='Mon, 1 Jan -4712 00:00:00 +0000'[, start=Date::ITALY], limit: 128)   ->  date
+ *   Date.rfc2822(string = 'Mon, 1 Jan -4712 00:00:00 +0000', start = Date::ITALY, limit: 128) -> date
  *
  * Creates a new Date object by parsing from a string according to
  * some typical RFC 2822 formats.
@@ -4759,6 +4775,10 @@ date_s__rfc2822(int argc, VALUE *argv, VALUE klass)
  * Raise an ArgumentError when the string length is longer than _limit_.
  * You can stop this check by passing `limit: nil`, but note that
  * it may take a long time to parse.
+ *
+ * See {Argument start}[rdoc-ref:Date@Argument+start].
+ *
+ * Date.rfc822 is an alias for Date.rfc2822.
  */
 static VALUE
 date_s_rfc2822(int argc, VALUE *argv, VALUE klass)
@@ -4786,7 +4806,7 @@ date_s_rfc2822(int argc, VALUE *argv, VALUE klass)
 
 /*
  * call-seq:
- *    Date._httpdate(string, limit: 128)  ->  hash
+ *   Date._httpdate(string, limit: 128) -> hash
  *
  * Returns a hash of parsed elements.
  *
@@ -4807,7 +4827,7 @@ date_s__httpdate(int argc, VALUE *argv, VALUE klass)
 
 /*
  * call-seq:
- *    Date.httpdate(string='Mon, 01 Jan -4712 00:00:00 GMT'[, start=Date::ITALY], limit: 128)  ->  date
+ *   Date.httpdate( string = 'Mon, 01 Jan -4712 00:00:00 GMT', start = Date::ITALY, limit: 128) -> date
  *
  * Creates a new Date object by parsing from a string according to
  * some RFC 2616 format.
@@ -4818,6 +4838,9 @@ date_s__httpdate(int argc, VALUE *argv, VALUE klass)
  * Raise an ArgumentError when the string length is longer than _limit_.
  * You can stop this check by passing `limit: nil`, but note that
  * it may take a long time to parse.
+ *
+ * See {Argument start}[rdoc-ref:Date@Argument+start].
+ *
  */
 static VALUE
 date_s_httpdate(int argc, VALUE *argv, VALUE klass)
@@ -4845,7 +4868,7 @@ date_s_httpdate(int argc, VALUE *argv, VALUE klass)
 
 /*
  * call-seq:
- *    Date._jisx0301(string, limit: 128)  ->  hash
+ *   Date._jisx0301(string, limit: 128) -> hash
  *
  * Returns a hash of parsed elements.
  *
@@ -4866,7 +4889,7 @@ date_s__jisx0301(int argc, VALUE *argv, VALUE klass)
 
 /*
  * call-seq:
- *    Date.jisx0301(string='-4712-01-01'[, start=Date::ITALY], limit: 128)  ->  date
+ *   Date.jisx0301(string = '-4712-01-01', start = Date::ITALY, limit: 128) -> date
  *
  * Creates a new Date object by parsing from a string according to
  * some typical JIS X 0301 formats.
@@ -4880,6 +4903,9 @@ date_s__jisx0301(int argc, VALUE *argv, VALUE klass)
  * Raise an ArgumentError when the string length is longer than _limit_.
  * You can stop this check by passing `limit: nil`, but note that
  * it may take a long time to parse.
+ *
+ * See {Argument start}[rdoc-ref:Date@Argument+start].
+ *
  */
 static VALUE
 date_s_jisx0301(int argc, VALUE *argv, VALUE klass)

From a485d80f22d6a5f1601f344bce5e67c53cd0db5f Mon Sep 17 00:00:00 2001
From: Burdette Lamar <BurdetteLamar@Yahoo.com>
Date: Thu, 7 Jul 2022 09:20:53 -0500
Subject: [PATCH 2/5] Update ext/date/date_core.c

Co-authored-by: Peter Zhu <peter@peterzhu.ca>
---
 ext/date/date_core.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/ext/date/date_core.c b/ext/date/date_core.c
index a50a0e4..4e37457 100644
--- a/ext/date/date_core.c
+++ b/ext/date/date_core.c
@@ -4515,7 +4515,7 @@ date_s__parse(int argc, VALUE *argv, VALUE klass)
  * Raise an ArgumentError when the string length is longer than _limit_.
  * You can stop this check by passing `limit: nil`, but note that
  * it may take a long time to parse.
- ^
+ *
  * See {Argument start}[rdoc-ref:Date@Argument+start].
  */
 static VALUE

From 37bfc5fc4e6ba95c5a96151af3beb0094301d7b8 Mon Sep 17 00:00:00 2001
From: Burdette Lamar <BurdetteLamar@Yahoo.com>
Date: Thu, 7 Jul 2022 09:21:03 -0500
Subject: [PATCH 3/5] Update ext/date/date_core.c

Co-authored-by: Peter Zhu <peter@peterzhu.ca>
---
 ext/date/date_core.c | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/ext/date/date_core.c b/ext/date/date_core.c
index 4e37457..10cdda5 100644
--- a/ext/date/date_core.c
+++ b/ext/date/date_core.c
@@ -4827,7 +4827,7 @@ date_s__httpdate(int argc, VALUE *argv, VALUE klass)
 
 /*
  * call-seq:
- *   Date.httpdate( string = 'Mon, 01 Jan -4712 00:00:00 GMT', start = Date::ITALY, limit: 128) -> date
+ *   Date.httpdate(string = 'Mon, 01 Jan -4712 00:00:00 GMT', start = Date::ITALY, limit: 128) -> date
  *
  * Creates a new Date object by parsing from a string according to
  * some RFC 2616 format.

From 752f63462a3ba2b2356422df561d97b00250c6a1 Mon Sep 17 00:00:00 2001
From: BurdetteLamar <BurdetteLamar@Yahoo.com>
Date: Thu, 7 Jul 2022 10:01:56 -0500
Subject: [PATCH 4/5] Enhanced RDoc

---
 ext/date/date_core.c | 34 +++++++++++++++++-----------------
 1 file changed, 17 insertions(+), 17 deletions(-)

diff --git a/ext/date/date_core.c b/ext/date/date_core.c
index a50a0e4..33b6681 100644
--- a/ext/date/date_core.c
+++ b/ext/date/date_core.c
@@ -2473,7 +2473,7 @@ date_s__valid_jd_p(int argc, VALUE *argv, VALUE klass)
  *
  *   Date.valid_jd?(2451944) # => true
  *
- * See {Argument start}[rdoc-ref:Date@Argument+start].
+ * See {Argument +start+}[rdoc-ref:Date@Argument+start].
  *
  * Related: Date.jd.
  */
@@ -2566,7 +2566,7 @@ date_s__valid_civil_p(int argc, VALUE *argv, VALUE klass)
  *   Date.valid_date?(2001, 2, 29) # => false
  *   Date.valid_date?(2001, 2, -1) # => true
  *
- * See {Argument start}[rdoc-ref:Date@Argument+start].
+ * See {Argument +start+}[rdoc-ref:Date@Argument+start].
  *
  * Date.valid_date? is an alias for Date.valid_civil?.
  *
@@ -2655,7 +2655,7 @@ date_s__valid_ordinal_p(int argc, VALUE *argv, VALUE klass)
  *   Date.valid_ordinal?(2001, 34)  # => true
  *   Date.valid_ordinal?(2001, 366) # => false
  *
- * See {Argument start}[rdoc-ref:Date@Argument+start].
+ * See {Argument +start+}[rdoc-ref:Date@Argument+start].
  *
  * Related: Date.jd, Date.ordinal.
  */
@@ -2744,7 +2744,7 @@ date_s__valid_commercial_p(int argc, VALUE *argv, VALUE klass)
  *
  * See Date.commercial.
  *
- * See {Argument start}[rdoc-ref:Date@Argument+start].
+ * See {Argument +start+}[rdoc-ref:Date@Argument+start].
  *
  * Related: Date.jd, Date.commercial.
  */
@@ -3319,7 +3319,7 @@ static VALUE d_lite_plus(VALUE, VALUE);
  *
  *     Date.jd(Date::ITALY - 1).julian?    # => true
  *
- * See {Argument start}[rdoc-ref:Date@Argument+start].
+ * See {Argument +start+}[rdoc-ref:Date@Argument+start].
  *
  * Related: Date.new.
  */
@@ -3384,7 +3384,7 @@ date_s_jd(int argc, VALUE *argv, VALUE klass)
  *
  * Raises an exception if +yday+ is zero or out of range.
  *
- * See {Argument start}[rdoc-ref:Date@Argument+start].
+ * See {Argument +start+}[rdoc-ref:Date@Argument+start].
  *
  * Related: Date.jd, Date.new.
  */
@@ -3461,7 +3461,7 @@ date_s_civil(int argc, VALUE *argv, VALUE klass)
  * where +n+ is the number of days in the month;
  * when the argument is negative, counts backward from the end of the month.
  *
- * See {Argument start}[rdoc-ref:Date@Argument+start].
+ * See {Argument +start+}[rdoc-ref:Date@Argument+start].
  *
  * Date.civil is an alias for Date.new.
  *
@@ -3569,7 +3569,7 @@ date_initialize(int argc, VALUE *argv, VALUE self)
  *     Date.commercial(2020, 1, 1).to_s # => "2019-12-30"
        Date.commercial(2020, 1, 7).to_s # => "2020-01-05"
  *
- * See {Argument start}[rdoc-ref:Date@Argument+start].
+ * See {Argument +start+}[rdoc-ref:Date@Argument+start].
  *
  * Related: Date.jd, Date.new, Date.ordinal.
  */
@@ -3752,7 +3752,7 @@ static void set_sg(union DateData *, double);
  *
  *   Date.today.to_s # => "2022-07-06"
  *
- * See {Argument start}[rdoc-ref:Date@Argument+start].
+ * See {Argument +start+}[rdoc-ref:Date@Argument+start].
  *
  */
 static VALUE
@@ -4377,7 +4377,7 @@ date_s__strptime(int argc, VALUE *argv, VALUE klass)
  *    Date.strptime('2001 05 6', '%Y %W %u')	#=> #<Date: 2001-02-03 ...>
  *    Date.strptime('sat3feb01', '%a%d%b%y')	#=> #<Date: 2001-02-03 ...>
  *
- * See {Argument start}[rdoc-ref:Date@Argument+start].
+ * See {Argument +start+}[rdoc-ref:Date@Argument+start].
  *
  * See also strptime(3) and #strftime.
  */
@@ -4516,7 +4516,7 @@ date_s__parse(int argc, VALUE *argv, VALUE klass)
  * You can stop this check by passing `limit: nil`, but note that
  * it may take a long time to parse.
  ^
- * See {Argument start}[rdoc-ref:Date@Argument+start].
+ * See {Argument +start+}[rdoc-ref:Date@Argument+start].
  */
 static VALUE
 date_s_parse(int argc, VALUE *argv, VALUE klass)
@@ -4589,7 +4589,7 @@ date_s__iso8601(int argc, VALUE *argv, VALUE klass)
  * You can stop this check by passing `limit: nil`, but note that
  * it may take a long time to parse.
  *
- * See {Argument start}[rdoc-ref:Date@Argument+start].
+ * See {Argument +start+}[rdoc-ref:Date@Argument+start].
  */
 static VALUE
 date_s_iso8601(int argc, VALUE *argv, VALUE klass)
@@ -4650,7 +4650,7 @@ date_s__rfc3339(int argc, VALUE *argv, VALUE klass)
  * You can stop this check by passing `limit: nil`, but note that
  * it may take a long time to parse.
  *
- * See {Argument start}[rdoc-ref:Date@Argument+start].
+ * See {Argument +start+}[rdoc-ref:Date@Argument+start].
  */
 static VALUE
 date_s_rfc3339(int argc, VALUE *argv, VALUE klass)
@@ -4711,7 +4711,7 @@ date_s__xmlschema(int argc, VALUE *argv, VALUE klass)
  * You can stop this check by passing `limit: nil`, but note that
  * it may take a long time to parse.
  *
- * See {Argument start}[rdoc-ref:Date@Argument+start].
+ * See {Argument +start+}[rdoc-ref:Date@Argument+start].
  *
  */
 static VALUE
@@ -4776,7 +4776,7 @@ date_s__rfc2822(int argc, VALUE *argv, VALUE klass)
  * You can stop this check by passing `limit: nil`, but note that
  * it may take a long time to parse.
  *
- * See {Argument start}[rdoc-ref:Date@Argument+start].
+ * See {Argument +start+}[rdoc-ref:Date@Argument+start].
  *
  * Date.rfc822 is an alias for Date.rfc2822.
  */
@@ -4839,7 +4839,7 @@ date_s__httpdate(int argc, VALUE *argv, VALUE klass)
  * You can stop this check by passing `limit: nil`, but note that
  * it may take a long time to parse.
  *
- * See {Argument start}[rdoc-ref:Date@Argument+start].
+ * See {Argument +start+}[rdoc-ref:Date@Argument+start].
  *
  */
 static VALUE
@@ -4904,7 +4904,7 @@ date_s__jisx0301(int argc, VALUE *argv, VALUE klass)
  * You can stop this check by passing `limit: nil`, but note that
  * it may take a long time to parse.
  *
- * See {Argument start}[rdoc-ref:Date@Argument+start].
+ * See {Argument +start+}[rdoc-ref:Date@Argument+start].
  *
  */
 static VALUE

From a5542253fa83938fd33644431f0dbe9a3bc8c7af Mon Sep 17 00:00:00 2001
From: BurdetteLamar <BurdetteLamar@Yahoo.com>
Date: Thu, 7 Jul 2022 13:13:01 -0500
Subject: [PATCH 5/5] Enhanced RDoc

---
 ext/date/date_core.c | 36 ++++++++++++++++++------------------
 1 file changed, 18 insertions(+), 18 deletions(-)

diff --git a/ext/date/date_core.c b/ext/date/date_core.c
index 2b041e8..e71eec2 100644
--- a/ext/date/date_core.c
+++ b/ext/date/date_core.c
@@ -2473,7 +2473,7 @@ date_s__valid_jd_p(int argc, VALUE *argv, VALUE klass)
  *
  *   Date.valid_jd?(2451944) # => true
  *
- * See {Argument +start+}[rdoc-ref:Date@Argument+start].
+ * See argument {start}[rdoc-ref:Date@Argument+start].
  *
  * Related: Date.jd.
  */
@@ -2566,7 +2566,7 @@ date_s__valid_civil_p(int argc, VALUE *argv, VALUE klass)
  *   Date.valid_date?(2001, 2, 29) # => false
  *   Date.valid_date?(2001, 2, -1) # => true
  *
- * See {Argument +start+}[rdoc-ref:Date@Argument+start].
+ * See argument {start}[rdoc-ref:Date@Argument+start].
  *
  * Date.valid_date? is an alias for Date.valid_civil?.
  *
@@ -2655,7 +2655,7 @@ date_s__valid_ordinal_p(int argc, VALUE *argv, VALUE klass)
  *   Date.valid_ordinal?(2001, 34)  # => true
  *   Date.valid_ordinal?(2001, 366) # => false
  *
- * See {Argument +start+}[rdoc-ref:Date@Argument+start].
+ * See argument {start}[rdoc-ref:Date@Argument+start].
  *
  * Related: Date.jd, Date.ordinal.
  */
@@ -2744,7 +2744,7 @@ date_s__valid_commercial_p(int argc, VALUE *argv, VALUE klass)
  *
  * See Date.commercial.
  *
- * See {Argument +start+}[rdoc-ref:Date@Argument+start].
+ * See argument {start}[rdoc-ref:Date@Argument+start].
  *
  * Related: Date.jd, Date.commercial.
  */
@@ -3319,7 +3319,7 @@ static VALUE d_lite_plus(VALUE, VALUE);
  *
  *     Date.jd(Date::ITALY - 1).julian?    # => true
  *
- * See {Argument +start+}[rdoc-ref:Date@Argument+start].
+ * See argument {start}[rdoc-ref:Date@Argument+start].
  *
  * Related: Date.new.
  */
@@ -3384,7 +3384,7 @@ date_s_jd(int argc, VALUE *argv, VALUE klass)
  *
  * Raises an exception if +yday+ is zero or out of range.
  *
- * See {Argument +start+}[rdoc-ref:Date@Argument+start].
+ * See argument {start}[rdoc-ref:Date@Argument+start].
  *
  * Related: Date.jd, Date.new.
  */
@@ -3461,7 +3461,7 @@ date_s_civil(int argc, VALUE *argv, VALUE klass)
  * where +n+ is the number of days in the month;
  * when the argument is negative, counts backward from the end of the month.
  *
- * See {Argument +start+}[rdoc-ref:Date@Argument+start].
+ * See argument {start}[rdoc-ref:Date@Argument+start].
  *
  * Date.civil is an alias for Date.new.
  *
@@ -3569,7 +3569,7 @@ date_initialize(int argc, VALUE *argv, VALUE self)
  *     Date.commercial(2020, 1, 1).to_s # => "2019-12-30"
        Date.commercial(2020, 1, 7).to_s # => "2020-01-05"
  *
- * See {Argument +start+}[rdoc-ref:Date@Argument+start].
+ * See argument {start}[rdoc-ref:Date@Argument+start].
  *
  * Related: Date.jd, Date.new, Date.ordinal.
  */
@@ -3752,7 +3752,7 @@ static void set_sg(union DateData *, double);
  *
  *   Date.today.to_s # => "2022-07-06"
  *
- * See {Argument +start+}[rdoc-ref:Date@Argument+start].
+ * See argument {start}[rdoc-ref:Date@Argument+start].
  *
  */
 static VALUE
@@ -4377,7 +4377,7 @@ date_s__strptime(int argc, VALUE *argv, VALUE klass)
  *    Date.strptime('2001 05 6', '%Y %W %u')	#=> #<Date: 2001-02-03 ...>
  *    Date.strptime('sat3feb01', '%a%d%b%y')	#=> #<Date: 2001-02-03 ...>
  *
- * See {Argument +start+}[rdoc-ref:Date@Argument+start].
+ * See argument {start}[rdoc-ref:Date@Argument+start].
  *
  * See also strptime(3) and #strftime.
  */
@@ -4515,8 +4515,8 @@ date_s__parse(int argc, VALUE *argv, VALUE klass)
  * Raise an ArgumentError when the string length is longer than _limit_.
  * You can stop this check by passing `limit: nil`, but note that
  * it may take a long time to parse.
- *
- * See {Argument +start+}[rdoc-ref:Date@Argument+start].
+ ^
+ * See argument {start}[rdoc-ref:Date@Argument+start].
  */
 static VALUE
 date_s_parse(int argc, VALUE *argv, VALUE klass)
@@ -4589,7 +4589,7 @@ date_s__iso8601(int argc, VALUE *argv, VALUE klass)
  * You can stop this check by passing `limit: nil`, but note that
  * it may take a long time to parse.
  *
- * See {Argument +start+}[rdoc-ref:Date@Argument+start].
+ * See argument {start}[rdoc-ref:Date@Argument+start].
  */
 static VALUE
 date_s_iso8601(int argc, VALUE *argv, VALUE klass)
@@ -4650,7 +4650,7 @@ date_s__rfc3339(int argc, VALUE *argv, VALUE klass)
  * You can stop this check by passing `limit: nil`, but note that
  * it may take a long time to parse.
  *
- * See {Argument +start+}[rdoc-ref:Date@Argument+start].
+ * See argument {start}[rdoc-ref:Date@Argument+start].
  */
 static VALUE
 date_s_rfc3339(int argc, VALUE *argv, VALUE klass)
@@ -4711,7 +4711,7 @@ date_s__xmlschema(int argc, VALUE *argv, VALUE klass)
  * You can stop this check by passing `limit: nil`, but note that
  * it may take a long time to parse.
  *
- * See {Argument +start+}[rdoc-ref:Date@Argument+start].
+ * See argument {start}[rdoc-ref:Date@Argument+start].
  *
  */
 static VALUE
@@ -4776,7 +4776,7 @@ date_s__rfc2822(int argc, VALUE *argv, VALUE klass)
  * You can stop this check by passing `limit: nil`, but note that
  * it may take a long time to parse.
  *
- * See {Argument +start+}[rdoc-ref:Date@Argument+start].
+ * See argument {start}[rdoc-ref:Date@Argument+start].
  *
  * Date.rfc822 is an alias for Date.rfc2822.
  */
@@ -4839,7 +4839,7 @@ date_s__httpdate(int argc, VALUE *argv, VALUE klass)
  * You can stop this check by passing `limit: nil`, but note that
  * it may take a long time to parse.
  *
- * See {Argument +start+}[rdoc-ref:Date@Argument+start].
+ * See argument {start}[rdoc-ref:Date@Argument+start].
  *
  */
 static VALUE
@@ -4904,7 +4904,7 @@ date_s__jisx0301(int argc, VALUE *argv, VALUE klass)
  * You can stop this check by passing `limit: nil`, but note that
  * it may take a long time to parse.
  *
- * See {Argument +start+}[rdoc-ref:Date@Argument+start].
+ * See argument {start}[rdoc-ref:Date@Argument+start].
  *
  */
 static VALUE