rbs 3.6.1 → 3.9.5

data/stdlib/csv/0/csv.rbs

@@ -9,7 +9,6 @@
 # *   A *column* *separator* delimits fields in a row. A common column separator
 #     is the comma character `","`.
 #
-#
 # This CSV String, with row separator `"\n"` and column separator `","`, has
 # three rows and two columns:
 #     "foo,0\nbar,1\nbaz,2\n"
@@ -28,7 +27,6 @@
 #     IO object.
 # *   Generating CSV data to a String object.
 #
-#
 # To make CSV available:
 #     require 'csv'
 #
@@ -51,11 +49,9 @@
 #     *   The outer Array is the entire "table".
 #     *   Each inner Array is a row.
 #     *   Each String is a field.
-#
 # *   A CSV::Table object.  For details, see [\CSV with
 #     Headers](#class-CSV-label-CSV+with+Headers).
 #
-#
 # #### Parsing a String
 #
 # The input to be parsed can be a string:
@@ -168,7 +164,6 @@
 # *   Method CSV.instance returns a new or cached CSV object.
 # *   Method CSV() also returns a new or cached CSV object.
 #
-#
 # ### Instance Methods
 #
 # CSV has three groups of instance methods:
@@ -176,7 +171,6 @@
 # *   Methods included by module Enumerable.
 # *   Methods delegated to class IO. See below.
 #
-#
 # #### Delegated Methods
 #
 # For convenience, a CSV object will delegate to many methods in class IO. (A
@@ -215,7 +209,6 @@
 # *   IO#truncate
 # *   IO#tty?
 #
-#
 # ### Options
 #
 # The default values for options are:
@@ -274,7 +267,6 @@
 # *   `empty_value`: Specifies the object that is to be substituted for each
 #     empty field.
 #
-#
 # ###### Option `row_sep`
 #
 # Specifies the row separator, a String or the Symbol `:auto` (see below), to be
@@ -365,7 +357,6 @@
 # *   Data is `ARGF`, `STDIN`, `STDOUT`, or `STDERR`.
 # *   The stream is only available for output.
 #
-#
 # Obviously, discovery takes a little time. Set manually if speed is important.
 # Also note that IO objects should be opened in binary mode on Windows if this
 # feature will be used as the line-ending translation can cause problems with
@@ -684,7 +675,6 @@
 # *   The converters apply only to the header row.
 # *   The built-in header converters are `:downcase` and `:symbol`.
 #
-#
 # This section assumes prior execution of:
 #     str = <<-EOT
 #     Name,Value
@@ -756,7 +746,6 @@
 # *   If a String, converts it to a Regexp, ignores lines that match it.
 # *   If `nil`, no lines are considered to be comments.
 #
-#
 # Default value:
 #     CSV::DEFAULT_OPTIONS.fetch(:skip_lines) # => nil
 #
@@ -885,7 +874,6 @@
 # *   `write_empty_value`: Specifies the object that is to be substituted for
 #     each empty field.
 #
-#
 # ###### Option `row_sep`
 #
 # Specifies the row separator, a String or the Symbol `:auto` (see below), to be
@@ -976,7 +964,6 @@
 # *   Data is `ARGF`, `STDIN`, `STDOUT`, or `STDERR`.
 # *   The stream is only available for output.
 #
-#
 # Obviously, discovery takes a little time. Set manually if speed is important.
 # Also note that IO objects should be opened in binary mode on Windows if this
 # feature will be used as the line-ending translation can cause problems with
@@ -1231,12 +1218,10 @@
 # *   See [Field Converters](#class-CSV-label-Field+Converters).
 # *   See [Header Converters](#class-CSV-label-Header+Converters).
 #
-#
 # Also by default, each value to be written during generation is written
 # 'as-is'. You can use a *write* *converter* to modify values before writing.
 # *   See [Write Converters](#class-CSV-label-Write+Converters).
 #
-#
 # #### Specifying Converters
 #
 # You can specify converters for parsing or generating in the `options` argument
@@ -1245,14 +1230,12 @@
 # *   Option `header_converters` for converting parsed header values.
 # *   Option `write_converters` for converting values to be written (generated).
 #
-#
 # There are three forms for specifying converters:
 # *   A converter proc: executable code to be used for conversion.
 # *   A converter name: the name of a stored converter.
 # *   A converter list: an array of converter procs, converter names, and
 #     converter lists.
 #
-#
 # ##### Converter Procs
 #
 # This converter proc, `strip_converter`, accepts a value `field` and returns
@@ -1263,7 +1246,6 @@
 # string_converter` specifies that:
 # *   Proc `string_converter` is to be called for each parsed field.
 # *   The converter's return value is to replace the `field` value.
-#
 # Example:
 #     string = " foo , 0 \n bar , 1 \n baz , 2 \n"
 #     array = CSV.parse(string, converters: strip_converter)
@@ -1293,7 +1275,6 @@
 # *   The 1-based line index.
 # *   The field header, if any.
 #
-#
 # ##### Stored Converters
 #
 # A converter may be given a name and stored in a structure where the parsing
@@ -1305,7 +1286,6 @@
 # *   `:float`: converts each String-embedded float into a true Float.
 # *   `:date`: converts each String-embedded date into a true Date.
 # *   `:date_time`: converts each String-embedded date-time into a true DateTime
-#
 # . This example creates a converter proc, then stores it:
 #     strip_converter = proc {|field| field.strip }
 #     CSV::Converters[:strip] = strip_converter
@@ -1320,7 +1300,6 @@
 # *   `:downcase`: Downcases each header.
 # *   `:symbol`: Converts each header to a Symbol.
 #
-#
 # There is no such storage structure for write headers.
 #
 # In order for the parsing methods to access stored converters in
@@ -1338,7 +1317,6 @@
 # *   Names of stored converters.
 # *   Nested converter lists.
 #
-#
 # Examples:
 #     numeric_converters = [:integer, :float]
 #     date_converters = [:date, :date_time]
@@ -1387,7 +1365,6 @@
 #         csv.converters # => [:integer]
 #         csv.read # => [["foo", 0], ["bar", 1], ["baz", 2]]
 #
-#
 # Installing a field converter does not affect already-read rows:
 #     csv = CSV.new(string)
 #     csv.shift # => ["foo", "0"]
@@ -1407,8 +1384,6 @@
 #     *   A Proc field converter.
 #     *   An Array of field converter names.
 #
-#
-#
 # Display:
 #     CSV::Converters.each_pair do |name, value|
 #       if value.kind_of?(Proc)
@@ -1522,7 +1497,6 @@
 #         tbl = CSV.parse(string, headers: true)
 #         tbl.headers # => ["Name", "Count"]
 #
-#
 # ##### Built-In Header Converters
 #
 # The built-in header converters are in Hash CSV::HeaderConverters. The keys
@@ -1547,7 +1521,6 @@
 # *   Removes non-word characters.
 # *   Makes the string into a Symbol.
 #
-#
 # ##### Custom Header Converters
 #
 # You can define a custom header converter:
@@ -1744,15 +1717,12 @@ class CSV < Object
   #     *   Positioned at the beginning. To position at the end, for appending,
   #         use method CSV.generate. For any other positioning, pass a preset
   #         StringIO object instead.
-  #
   # *   Argument `options`: See:
   #     *   [Options for Parsing](#class-CSV-label-Options+for+Parsing)
   #     *   [Options for Generating](#class-CSV-label-Options+for+Generating)
-  #
   #     For performance reasons, the options cannot be overridden in a CSV object,
   #     so those specified here will endure.
   #
-  #
   # In addition to the CSV instance methods, several IO methods are delegated. See
   # [Delegated Methods](#class-CSV-label-Delegated+Methods).
   #
@@ -1793,11 +1763,9 @@ class CSV < Object
   #     *   Positioned at the beginning. To position at the end, for appending,
   #         use method CSV.generate. For any other positioning, pass a preset
   #         StringIO object instead.
-  #
   # *   Argument `options`: see [Options for
   #     Parsing](#class-CSV-label-Options+for+Parsing)
   #
-  #
   # ###### Without Option `headers`
   #
   # Without {option `headers`[}](#class-CSV-label-Option+headers) case.
@@ -1916,11 +1884,9 @@ class CSV < Object
   #     *   Positioned at the beginning. To position at the end, for appending,
   #         use method CSV.generate. For any other positioning, pass a preset
   #         StringIO object instead.
-  #
   # *   Argument `options`: see [Options for
   #     Parsing](#class-CSV-label-Options+for+Parsing)
   #
-  #
   # ###### Without Option `headers`
   #
   # Without option `headers`, returns the first row as a new Array.
@@ -1975,7 +1941,6 @@ class CSV < Object
   # *   A CSV::Table object, if headers are in use.
   # *   An Array of Arrays, otherwise.
   #
-  #
   # The data source must be opened for reading.
   #
   # Without headers:
@@ -2043,7 +2008,6 @@ class CSV < Object
   # *   Argument `row` must be an Array object or a CSV::Row object.
   # *   The output stream must be open for writing.
   #
-  #
   # ---
   #
   # Append Arrays:
@@ -2099,7 +2063,6 @@ class CSV < Object
   # *   Arguments `options`, if given, should be generating options. See [Options
   #     for Generating](#class-CSV-label-Options+for+Generating).
   #
-  #
   # ---
   #
   # Creates a new CSV object via `CSV.new(csv_string, **options)`; calls the block
@@ -2227,7 +2190,6 @@ CSV::VERSION: String
 # *   Fields: each is an object, not necessarily a String.
 # *   Headers: each serves a key, and also need not be a String.
 #
-#
 # ### Instance Methods
 #
 # CSV::Row has three groups of instance methods:
@@ -2238,8 +2200,6 @@ CSV::VERSION: String
 #     *   Array#length
 #     *   Array#size
 #
-#
-#
 # ## Creating a CSV::Row Instance
 #
 # Commonly, a new CSV::Row instance is created by parsing CSV source that has
@@ -2658,7 +2618,6 @@ class CSV::Row < Object
   # *   Header.
   # *   Range of headers.
   #
-  #
   # For `specifier` in one of the first four cases above, returns the result of
   # `self.field(specifier)`;  see #field.
   #
@@ -2765,7 +2724,6 @@ class CSV::Row < Object
   # Returns an ASCII-compatible String showing:
   # *   Class CSV::Row.
   # *   Header-value pairs.
-  #
   # Example:
   #     source = "Name,Value\nfoo,0\nbar,1\nbaz,2\n"
   #     table = CSV.parse(source, headers: true)
@@ -2875,7 +2833,6 @@ end
 # *   Rows: each is a Table::Row object.
 # *   Headers: names for the columns.
 #
-#
 # ### Instance Methods
 #
 # CSV::Table has three groups of instance methods:
@@ -2886,8 +2843,6 @@ end
 #     *   Array#length
 #     *   Array#size
 #
-#
-#
 # ## Creating a CSV::Table Instance
 #
 # Commonly, a new CSV::Table instance is created by parsing CSV source using
@@ -2921,7 +2876,6 @@ end
 # *   Column mode.
 # *   Mixed mode (the default for a new table).
 #
-#
 # The access mode for aCSV::Table instance affects the behavior of some of its
 # instance methods:
 # *   #[]
@@ -2931,7 +2885,6 @@ end
 # *   #each
 # *   #values_at
 #
-#
 # ### Row Mode
 #
 # Set a table to row mode with method #by_row!:
@@ -2984,7 +2937,6 @@ end
 # *   A Range index refers to multiple rows.
 # *   A String index refers to a column.
 #
-#
 # Set a table to mixed mode with method #by_col_or_row!:
 #     source = "Name,Value\nfoo,0\nbar,1\nbaz,2\n"
 #     table = CSV.parse(source, headers: true)
@@ -3025,7 +2977,6 @@ class CSV::Table[out Elem] < Object
   # *   Argument `array_of_rows` must be an Array of CSV::Row objects.
   # *   Argument `headers`, if given, may be an Array of Strings.
   #
-  #
   # ---
   #
   # Create an empty CSV::Table object:
@@ -3135,7 +3086,6 @@ class CSV::Table[out Elem] < Object
   # *   Access mode: `:row` or `:col_or_row`.
   # *   Return value: *nth* row of the table, if that row exists; otherwise `nil`.
   #
-  #
   # Returns the *nth* row of the table if that row exists:
   #     source = "Name,Value\nfoo,0\nbar,1\nbaz,2\n"
   #     table = CSV.parse(source, headers: true)
@@ -3166,7 +3116,6 @@ class CSV::Table[out Elem] < Object
   # *   Return value: *nth* column of the table, if that column exists; otherwise
   #     an Array of `nil` fields of length `self.size`.
   #
-  #
   # Returns the *nth* column of the table if that column exists:
   #     source = "Name,Value\nfoo,0\nbar,1\nbaz,2\n"
   #     table = CSV.parse(source, headers: true)
@@ -3190,7 +3139,6 @@ class CSV::Table[out Elem] < Object
   # *   Return value: rows from the table, beginning at row `range.start`, if
   #     those rows exists.
   #
-  #
   # Returns rows from the table, beginning at row `range.first`, if those rows
   # exist:
   #     source = "Name,Value\nfoo,0\nbar,1\nbaz,2\n"
@@ -3230,7 +3178,6 @@ class CSV::Table[out Elem] < Object
   # *   Return value: column data from the table, beginning at column
   #     `range.start`, if those columns exist.
   #
-  #
   # Returns column values from the table, if the column exists; the values are
   # arranged by row:
   #     source = "Name,Value\nfoo,0\nbar,1\nbaz,2\n"
@@ -3261,7 +3208,6 @@ class CSV::Table[out Elem] < Object
   # *   Access mode: `:col` or `:col_or_row`
   # *   Return value: column data from the table, if that `header` exists.
   #
-  #
   # Returns column values from the table, if the column exists:
   #     source = "Name,Value\nfoo,0\nbar,1\nbaz,2\n"
   #     table = CSV.parse(source, headers: true)
@@ -3299,7 +3245,6 @@ class CSV::Table[out Elem] < Object
   # *   Access mode: `:row` or `:col_or_row`.
   # *   Return value: `row`.
   #
-  #
   # If the row exists, it is replaced:
   #     source = "Name,Value\nfoo,0\nbar,1\nbaz,2\n"
   #     table = CSV.parse(source, headers: true)
@@ -3341,7 +3286,6 @@ class CSV::Table[out Elem] < Object
   # *   Access mode: `:col`.
   # *   Return value: `array_of_fields`.
   #
-  #
   # If the column exists, it is replaced:
   #     source = "Name,Value\nfoo,0\nbar,1\nbaz,2\n"
   #     table = CSV.parse(source, headers: true)
@@ -3380,7 +3324,6 @@ class CSV::Table[out Elem] < Object
   # *   Access mode: `:col` or `:col_or_row`.
   # *   Return value: `field_or_array_of_fields`.
   #
-  #
   # If the column exists, it is replaced:
   #     source = "Name,Value\nfoo,0\nbar,1\nbaz,2\n"
   #     table = CSV.parse(source, headers: true)
@@ -3684,7 +3627,6 @@ class CSV::Table[out Elem] < Object
   # *   Access mode: `:row`, `:col`, or `:col_or_row`.
   # *   Size:  Row count, including the header row.
   #
-  #
   # Example:
   #     source = "Name,Value\nfoo,0\nbar,1\nbaz,2\n"
   #     table = CSV.parse(source, headers: true)
@@ -3814,3 +3756,21 @@ class CSV::Table[out Elem] < Object
   #
   def values_at: (*untyped indices_or_headers) -> untyped
 end
+
+%a{annotate:rdoc:skip}
+class Array[unchecked out Elem] < Object
+  # Equivalent to CSV::generate_line(self, options)
+  #
+  #   ["CSV", "data"].to_csv
+  #     #=> "CSV,data\n"
+  def to_csv: (**untyped options) -> String
+end
+
+%a{annotate:rdoc:skip}
+class String
+  # Equivalent to CSV::parse_line(self, options)
+  #
+  #   "CSV,data".parse_csv
+  #     #=> ["CSV", "data"]
+  def parse_csv: (**untyped options) -> ::Array[String?]?
+end

data/stdlib/csv/0/manifest.yaml

@@ -1,2 +1,3 @@
 dependencies:
   - name: forwardable
+  - name: stringio

data/stdlib/date/0/date.rbs

@@ -5,8 +5,7 @@
 #
 # *   You need both dates and times; Date handles only dates.
 # *   You need only Gregorian dates (and not Julian dates); see [Julian and
-#     Gregorian Calendars](rdoc-ref:calendars.rdoc).
-#
+#     Gregorian Calendars](rdoc-ref:date/calendars.rdoc).
 #
 # A Date object, once created, is immutable, and cannot be modified.
 #
@@ -52,7 +51,6 @@
 #         Date.strptime('1999 52 5', '%Y %W %u')   # => #<Date: 1999-12-31>
 #         Date.strptime('fri31dec99', '%a%d%b%y')  # => #<Date: 1999-12-31>
 #
-#
 # See also the specialized methods in ["Specialized Format Strings" in Formats
 # for Dates and
 # Times](rdoc-ref:strftime_formatting.rdoc@Specialized+Format+Strings)
@@ -90,7 +88,7 @@ class Date
   # number of days in the month; when the argument is negative, counts backward
   # from the end of the month.
   #
-  # See argument [start](rdoc-ref:calendars.rdoc@Argument+start).
+  # See argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
   #
   # Related: Date.jd.
   #
@@ -311,8 +309,7 @@ class Date
   #         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:calendars.rdoc@Argument+start).
+  # See argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
   #
   # Related: Date.jd, Date.new, Date.ordinal.
   #
@@ -346,10 +343,9 @@ class Date
   #
   # See:
   #
-  # *   Argument [start](rdoc-ref:calendars.rdoc@Argument+start).
+  # *   Argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
   # *   Argument [limit](rdoc-ref:Date@Argument+limit).
   #
-  #
   # Related: Date._httpdate (returns a hash).
   #
   def self.httpdate: (String str, ?Integer start) -> Date
@@ -368,10 +364,9 @@ class Date
   #
   # See:
   #
-  # *   Argument [start](rdoc-ref:calendars.rdoc@Argument+start).
+  # *   Argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
   # *   Argument [limit](rdoc-ref:Date@Argument+limit).
   #
-  #
   # Related: Date._iso8601 (returns a hash).
   #
   def self.iso8601: (String str, ?Integer start) -> Date
@@ -398,8 +393,7 @@ class Date
   #
   #         Date.jd(Date::ITALY - 1).julian?    # => true
   #
-  #
-  # See argument [start](rdoc-ref:calendars.rdoc@Argument+start).
+  # See argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
   #
   # Related: Date.new.
   #
@@ -423,10 +417,9 @@ class Date
   #
   # See:
   #
-  # *   Argument [start](rdoc-ref:calendars.rdoc@Argument+start).
+  # *   Argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
   # *   Argument [limit](rdoc-ref:Date@Argument+limit).
   #
-  #
   # Related: Date._jisx0301 (returns a hash).
   #
   def self.jisx0301: (String str, ?Integer start) -> Date
@@ -487,7 +480,7 @@ class Date
   #
   # Raises an exception if `yday` is zero or out of range.
   #
-  # See argument [start](rdoc-ref:calendars.rdoc@Argument+start).
+  # See argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
   #
   # Related: Date.jd, Date.new.
   #
@@ -517,10 +510,9 @@ class Date
   #
   # See:
   #
-  # *   Argument [start](rdoc-ref:calendars.rdoc@Argument+start).
+  # *   Argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
   # *   Argument [limit](rdoc-ref:Date@Argument+limit).
   #
-  #
   # Related: Date._parse (returns a hash).
   #
   def self.parse: (?String str, ?boolish complete, ?Integer start) -> Date
@@ -539,10 +531,9 @@ class Date
   #
   # See:
   #
-  # *   Argument [start](rdoc-ref:calendars.rdoc@Argument+start).
+  # *   Argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
   # *   Argument [limit](rdoc-ref:Date@Argument+limit).
   #
-  #
   # Related: Date._rfc2822 (returns a hash).
   #
   def self.rfc2822: (String str, ?Integer start) -> Date
@@ -560,10 +551,9 @@ class Date
   #
   # See:
   #
-  # *   Argument [start](rdoc-ref:calendars.rdoc@Argument+start).
+  # *   Argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
   # *   Argument [limit](rdoc-ref:Date@Argument+limit).
   #
-  #
   # Related: Date._rfc3339 (returns a hash).
   #
   def self.rfc3339: (String str, ?Integer start) -> Date
@@ -582,10 +572,9 @@ class Date
   #
   # See:
   #
-  # *   Argument [start](rdoc-ref:calendars.rdoc@Argument+start).
+  # *   Argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
   # *   Argument [limit](rdoc-ref:Date@Argument+limit).
   #
-  #
   # Related: Date._rfc2822 (returns a hash).
   #
   def self.rfc822: (String str, ?Integer start) -> Date
@@ -609,7 +598,7 @@ class Date
   # Times](rdoc-ref:strftime_formatting.rdoc). (Unlike Date.strftime, does not
   # support flags and width.)
   #
-  # See argument [start](rdoc-ref:calendars.rdoc@Argument+start).
+  # See argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
   #
   # See also [strptime(3)](https://man7.org/linux/man-pages/man3/strptime.3.html).
   #
@@ -625,7 +614,7 @@ class Date
   #
   #     Date.today.to_s # => "2022-07-06"
   #
-  # See argument [start](rdoc-ref:calendars.rdoc@Argument+start).
+  # See argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
   #
   def self.today: (?Integer start) -> Date
 
@@ -640,7 +629,7 @@ class Date
   #     Date.valid_date?(2001, 2, 29) # => false
   #     Date.valid_date?(2001, 2, -1) # => true
   #
-  # See argument [start](rdoc-ref:calendars.rdoc@Argument+start).
+  # See argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
   #
   # Related: Date.jd, Date.new.
   #
@@ -658,7 +647,7 @@ class Date
   #
   # See Date.commercial.
   #
-  # See argument [start](rdoc-ref:calendars.rdoc@Argument+start).
+  # See argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
   #
   # Related: Date.jd, Date.commercial.
   #
@@ -675,7 +664,7 @@ class Date
   #     Date.valid_date?(2001, 2, 29) # => false
   #     Date.valid_date?(2001, 2, -1) # => true
   #
-  # See argument [start](rdoc-ref:calendars.rdoc@Argument+start).
+  # See argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
   #
   # Related: Date.jd, Date.new.
   #
@@ -690,7 +679,7 @@ class Date
   #
   #     Date.valid_jd?(2451944) # => true
   #
-  # See argument [start](rdoc-ref:calendars.rdoc@Argument+start).
+  # See argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
   #
   # Related: Date.jd.
   #
@@ -706,7 +695,7 @@ class Date
   #     Date.valid_ordinal?(2001, 34)  # => true
   #     Date.valid_ordinal?(2001, 366) # => false
   #
-  # See argument [start](rdoc-ref:calendars.rdoc@Argument+start).
+  # See argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
   #
   # Related: Date.jd, Date.ordinal.
   #
@@ -725,10 +714,9 @@ class Date
   #
   # See:
   #
-  # *   Argument [start](rdoc-ref:calendars.rdoc@Argument+start).
+  # *   Argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
   # *   Argument [limit](rdoc-ref:Date@Argument+limit).
   #
-  #
   # Related: Date._xmlschema (returns a hash).
   #
   def self.xmlschema: (String str, ?Integer start) -> Date
@@ -755,10 +743,10 @@ class Date
   #   rdoc-file=ext/date/date_core.c
   #   - d - other  ->  date or rational
   # -->
-  # Returns the difference between the two dates if the other is a date object.
-  # If the other is a numeric value, returns a date object pointing `other` days
-  # before self.  If the other is a fractional number, assumes its precision is at
-  # most nanosecond.
+  # If the other is a date object, returns a Rational whose value is the
+  # difference between the two dates in days. If the other is a numeric value,
+  # returns a date object pointing `other` days before self. If the other is a
+  # fractional number, assumes its precision is at most nanosecond.
   #
   #     Date.new(2001,2,3) - 1   #=> #<Date: 2001-02-02 ...>
   #     DateTime.new(2001,2,3) - Rational(1,2)
@@ -810,7 +798,6 @@ class Date
   # *   `1` if `other` is smaller.
   # *   `nil` if the two are incomparable.
   #
-  #
   # Argument `other` may be:
   #
   # *   Another Date object:
@@ -1238,7 +1225,7 @@ class Date
   #     d1 = d0.new_start(Date::JULIAN)
   #     d1.julian? # => true
   #
-  # See argument [start](rdoc-ref:calendars.rdoc@Argument+start).
+  # See argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
   #
   def new_start: (?Integer start) -> Date
 
@@ -1335,10 +1322,9 @@ class Date
   #
   # See:
   #
-  # *   Argument [start](rdoc-ref:calendars.rdoc@Argument+start).
+  # *   Argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
   # *   Argument [limit](rdoc-ref:Date@Argument+limit).
   #
-  #
   # Related: Date._rfc2822 (returns a hash).
   #
   def rfc822: () -> String
@@ -1369,7 +1355,7 @@ class Date
   #     Date.new(2001, 2, 3, Date::GREGORIAN).start # => -Infinity
   #     Date.new(2001, 2, 3, Date::JULIAN).start    # => Infinity
   #
-  # See argument [start](rdoc-ref:calendars.rdoc@Argument+start).
+  # See argument [start](rdoc-ref:date/calendars.rdoc@Argument+start).
   #
   def start: () -> Float
 
@@ -1385,7 +1371,6 @@ class Date
   # *   The last date is the last one that is before or equal to `limit`, which
   #     should be a Date object.
   #
-  #
   # Example:
   #
   #     limit = Date.new(2001, 12, 31)