git 5.0.0.beta.2 → 5.0.0.beta.4

data/lib/git/commands/ls_files.rb

@@ -73,119 +73,123 @@ module Git
         execution_option :chdir
       end
 
-      # @!method call(*, **)
       #
-      #   @overload call(*file, **options)
+      # @overload call(*file, **options)
       #
-      #     Execute the `git ls-files` command.
+      #   Execute the `git ls-files` command.
       #
-      #     @param file [Array<String>] paths to limit file listing
+      #   @param file [Array<String>] paths to limit file listing
       #
-      #     @param options [Hash] command options
+      #   @param options [Hash] command options
       #
-      #     @option options [Boolean, nil] :z (nil) use NUL line termination and do not quote filenames
+      #   @option options [Boolean, nil] :z (nil) use NUL line termination and do not quote filenames
       #
-      #     @option options [Boolean, nil] :t (nil) show status tags together with filenames
+      #   @option options [Boolean, nil] :t (nil) show status tags together with filenames
       #
-      #     @option options [Boolean, nil] :v (nil) similar to `-t` but use lowercase letters for files
-      #       that are marked as assume unchanged
+      #   @option options [Boolean, nil] :v (nil) similar to `-t` but use lowercase letters for files
+      #     that are marked as assume unchanged
       #
-      #     @option options [Boolean, nil] :f (nil) similar to `-t` but use lowercase letters for files
-      #       that are marked as fsmonitor valid
+      #   @option options [Boolean, nil] :f (nil) similar to `-t` but use lowercase letters for files
+      #     that are marked as fsmonitor valid
       #
-      #     @option options [Boolean, nil] :cached (nil) show all files cached in the index
+      #   @option options [Boolean, nil] :cached (nil) show all files cached in the index
       #
-      #       Alias: :c
+      #     Alias: :c
       #
-      #     @option options [Boolean, nil] :deleted (nil) show files with an unstaged deletion
+      #   @option options [Boolean, nil] :deleted (nil) show files with an unstaged deletion
       #
-      #       Alias: :d
+      #     Alias: :d
       #
-      #     @option options [Boolean, nil] :others (nil) show other (i.e. untracked) files in the output
+      #   @option options [Boolean, nil] :others (nil) show other (i.e. untracked) files in the output
       #
-      #       Alias: :o
+      #     Alias: :o
       #
-      #     @option options [Boolean, nil] :ignored (nil) show only ignored files in the output
+      #   @option options [Boolean, nil] :ignored (nil) show only ignored files in the output
       #
-      #       Must be used with either `:cached` or `:others`. When used with `:cached`, shows only
-      #       cached files matching an exclude pattern. When used with `:others`, shows only
-      #       untracked files matched by an exclude pattern.
+      #     Must be used with either `:cached` or `:others`. When used with `:cached`, shows only
+      #     cached files matching an exclude pattern. When used with `:others`, shows only
+      #     untracked files matched by an exclude pattern.
       #
-      #       Alias: :i
+      #     Alias: :i
       #
-      #     @option options [Boolean, nil] :stage (nil) show object name, mode bits, and stage number
+      #   @option options [Boolean, nil] :stage (nil) show object name, mode bits, and stage number
       #
-      #       Alias: :s
+      #     Alias: :s
       #
-      #     @option options [Boolean, nil] :unmerged (nil) show information about unmerged files
+      #   @option options [Boolean, nil] :unmerged (nil) show information about unmerged files
       #
-      #       Alias: :u
+      #     Alias: :u
       #
-      #     @option options [Boolean, nil] :killed (nil) show untracked files that need to be removed
-      #       due to file/directory conflicts for tracked files
+      #   @option options [Boolean, nil] :killed (nil) show untracked files that need to be removed
+      #     due to file/directory conflicts for tracked files
       #
-      #       Alias: :k
+      #     Alias: :k
       #
-      #     @option options [Boolean, nil] :modified (nil) show files with an unstaged modification
+      #   @option options [Boolean, nil] :modified (nil) show files with an unstaged modification
       #
-      #       Alias: :m
+      #     Alias: :m
       #
-      #     @option options [Boolean, nil] :resolve_undo (nil) show files having resolve-undo information
+      #   @option options [Boolean, nil] :resolve_undo (nil) show files having resolve-undo information
       #
-      #     @option options [Boolean, nil] :directory (nil) show just the directory name (with trailing
-      #       slash) when a whole directory is classified as "other"
+      #   @option options [Boolean, nil] :directory (nil) show just the directory name (with trailing
+      #     slash) when a whole directory is classified as "other"
       #
-      #     @option options [Boolean, nil] :no_empty_directory (nil) do not list empty directories
+      #   @option options [Boolean, nil] :no_empty_directory (nil) do not list empty directories
       #
-      #     @option options [Boolean, nil] :eol (nil) show EOL and encoding attributes of files
+      #   @option options [Boolean, nil] :eol (nil) show EOL and encoding attributes of files
       #
-      #     @option options [Boolean, nil] :deduplicate (nil) suppress duplicate filenames when showing
-      #       only filenames
+      #   @option options [Boolean, nil] :deduplicate (nil) suppress duplicate filenames when showing
+      #     only filenames
       #
-      #     @option options [String] :exclude (nil) skip untracked files matching the given pattern
+      #   @option options [String] :exclude (nil) skip untracked files matching the given pattern
       #
-      #       Alias: :x
+      #     Alias: :x
       #
-      #     @option options [String] :exclude_from (nil) read exclude patterns from the given file
+      #   @option options [String] :exclude_from (nil) read exclude patterns from the given file
       #
-      #       Alias: :X
+      #     Alias: :X
       #
-      #     @option options [String] :exclude_per_directory (nil) read additional exclude patterns
-      #       from the named file in each directory
+      #   @option options [String] :exclude_per_directory (nil) read additional exclude patterns
+      #     from the named file in each directory
       #
-      #     @option options [Boolean, nil] :exclude_standard (nil) add the standard git exclusions
+      #   @option options [Boolean, nil] :exclude_standard (nil) add the standard git exclusions
       #
-      #     @option options [Boolean, nil] :error_unmatch (nil) treat unmatched files as an error
+      #   @option options [Boolean, nil] :error_unmatch (nil) treat unmatched files as an error
       #
-      #     @option options [String] :with_tree (nil) pretend paths removed since the named
-      #       tree-ish are still present when using `--error-unmatch`
+      #   @option options [String] :with_tree (nil) pretend paths removed since the named
+      #     tree-ish are still present when using `--error-unmatch`
       #
-      #     @option options [Boolean, nil] :full_name (nil) force paths to be output relative to the
-      #       project top-level directory
+      #   @option options [Boolean, nil] :full_name (nil) force paths to be output relative to the
+      #     project top-level directory
       #
-      #     @option options [Boolean, nil] :recurse_submodules (nil) recursively calls ls-files on each
-      #       active submodule in the repository
+      #   @option options [Boolean, nil] :recurse_submodules (nil) recursively calls ls-files on each
+      #     active submodule in the repository
       #
-      #     @option options [Boolean, Integer, String, nil] :abbrev (nil) show only a partial prefix of the
-      #       object name; pass `true` for the default number of hex digits, or an Integer or String
-      #       for a specific prefix length (e.g., `abbrev: 10` or `abbrev: "10"`)
+      #   @option options [Boolean, Integer, String, nil] :abbrev (nil) show only a partial prefix of the
+      #     object name; pass `true` for the default number of hex digits, or an Integer or String
+      #     for a specific prefix length (e.g., `abbrev: 10` or `abbrev: "10"`)
       #
-      #     @option options [Boolean, nil] :debug (nil) after each filename, output raw index information
-      #       (ctime data, mtime data, dev, ino, uid, gid, size, flags, flagsx)
+      #   @option options [Boolean, nil] :debug (nil) after each filename, output raw index information
+      #     (ctime data, mtime data, dev, ino, uid, gid, size, flags, flagsx)
       #
-      #     @option options [Boolean, nil] :sparse (nil) if the index is sparse, show the sparse directory
-      #       entries rather than expanding to the contained files
+      #   @option options [Boolean, nil] :sparse (nil) if the index is sparse, show the sparse directory
+      #     entries rather than expanding to the contained files
       #
-      #     @option options [String] :format (nil) a string that interpolates %(fieldname) from
-      #       the index entry for each file
+      #   @option options [String] :format (nil) a string that interpolates %(fieldname) from
+      #     the index entry for each file
       #
-      #     @option options [String] :chdir (nil) run the command from the specified directory
+      #   @option options [String] :chdir (nil) run the command from the specified directory
       #
-      #     @return [Git::CommandLineResult] the result of calling `git ls-files`
+      #   @return [Git::CommandLine::Result] the result of calling `git ls-files`
       #
-      #     @raise [ArgumentError] if unsupported options are provided
+      #   @raise [ArgumentError] if unsupported options are provided
       #
-      #     @raise [Git::FailedError] if git exits with a non-zero exit status
+      #   @raise [Git::FailedError] if git exits with a non-zero exit status
+      #
+      #   @api public
+      def call(*, **)
+        super
+      end
     end
   end
 end

data/lib/git/commands/ls_remote.rb

@@ -10,14 +10,6 @@ module Git
     # associated commit IDs. Can be used to detect changes in a remote
     # repository without cloning or fetching.
     #
-    # @note `arguments` block audited against https://git-scm.com/docs/git-ls-remote/2.53.0
-    #
-    # @see https://git-scm.com/docs/git-ls-remote git-ls-remote documentation
-    #
-    # @see Git::Commands
-    #
-    # @api private
-    #
     # @example List all refs in a remote
     #   ls_remote = Git::Commands::LsRemote.new(execution_context)
     #   ls_remote.call('origin')
@@ -38,6 +30,14 @@ module Git
     #   ls_remote = Git::Commands::LsRemote.new(execution_context)
     #   ls_remote.call('origin', 'HEAD', symref: true)
     #
+    # @note `arguments` block audited against https://git-scm.com/docs/git-ls-remote/2.53.0
+    #
+    # @see https://git-scm.com/docs/git-ls-remote git-ls-remote documentation
+    #
+    # @see Git::Commands
+    #
+    # @api private
+    #
     class LsRemote < Git::Commands::Base
       arguments do
         literal 'ls-remote'
@@ -71,85 +71,91 @@ module Git
       # Exit status 2 means no matching refs were found (used with --exit-code)
       allow_exit_status 0..2
 
-      # @!method call(*, **)
       #
-      #   @overload call(repository = nil, *patterns, **options)
+      # @overload call(repository = nil, *patterns, **options)
+      #
+      #   Execute the `git ls-remote` command
       #
-      #     Execute the `git ls-remote` command
+      #   @param repository [String, nil] the remote name or URL to query
       #
-      #     @param repository [String, nil] The remote name or URL to query
+      #     When nil, git uses the remote inferred from the current branch's
+      #     tracking configuration, or "origin" if no tracking remote is set.
       #
-      #       When nil, git uses the remote inferred from the current branch's
-      #       tracking configuration, or "origin" if no tracking remote is set.
+      #   @param patterns [Array<String>] one or more ref patterns to filter results
       #
-      #     @param patterns [Array<String>] One or more ref patterns to filter results
+      #     When omitted, all references (after filtering via `--branches`, `--tags`,
+      #     `--refs`) are shown. When specified, only refs matching one or more
+      #     patterns are displayed.
       #
-      #       When omitted, all references (after filtering via `--branches`, `--tags`,
-      #       `--refs`) are shown. When specified, only refs matching one or more
-      #       patterns are displayed.
+      #   @param options [Hash] command options
       #
-      #     @param options [Hash] command options
+      #   @option options [Boolean, nil] :branches (nil) limit output to refs under `refs/heads/`
       #
-      #     @option options [Boolean, nil] :branches (nil) limit output to refs under `refs/heads/`
+      #     Alias: :b
       #
-      #       Alias: :b
+      #   @option options [Boolean, nil] :heads (nil) limit output to refs under `refs/heads/`
       #
-      #     @option options [Boolean, nil] :heads (nil) limit output to refs under `refs/heads/`
+      #     Deprecated: use `:branches` instead. Kept for backward compatibility with
+      #     older git versions where `--heads` is the only supported flag.
       #
-      #       Deprecated: use `:branches` instead. Kept for backward compatibility with
-      #       older git versions where `--heads` is the only supported flag.
+      #     Alias: :h
       #
-      #       Alias: :h
+      #   @option options [Boolean, nil] :tags (nil) limit output to refs under `refs/tags/`
       #
-      #     @option options [Boolean, nil] :tags (nil) limit output to refs under `refs/tags/`
+      #     Alias: :t
       #
-      #       Alias: :t
+      #   @option options [Boolean, nil] :refs (nil) exclude peeled tags and pseudorefs
+      #     like `HEAD` from the output
       #
-      #     @option options [Boolean, nil] :refs (nil) exclude peeled tags and pseudorefs
-      #       like `HEAD` from the output
+      #   @option options [String] :upload_pack (nil) full path to `git-upload-pack`
+      #     on the remote host
       #
-      #     @option options [String] :upload_pack (nil) full path to `git-upload-pack`
-      #       on the remote host
+      #     Useful when accessing repositories via SSH where the daemon does not
+      #     use the PATH configured by the user.
       #
-      #       Useful when accessing repositories via SSH where the daemon does not
-      #       use the PATH configured by the user.
+      #   @option options [Boolean, nil] :quiet (nil) do not print the remote URL to stderr
       #
-      #     @option options [Boolean, nil] :quiet (nil) do not print the remote URL to stderr
+      #     Alias: :q
       #
-      #       Alias: :q
+      #   @option options [Boolean, nil] :exit_code (nil) exit with status `2` when no
+      #     matching refs are found in the remote repository
       #
-      #     @option options [Boolean, nil] :exit_code (nil) exit with status `2` when no
-      #       matching refs are found in the remote repository
+      #     Without this option, the command exits `0` whenever it successfully
+      #     communicates with the remote, even if no refs match.
       #
-      #       Without this option, the command exits `0` whenever it successfully
-      #       communicates with the remote, even if no refs match.
+      #   @option options [Boolean, nil] :get_url (nil) expand and print the remote URL
+      #     (respecting `url.<base>.insteadOf` config) and exit without contacting
+      #     the remote
       #
-      #     @option options [Boolean, nil] :get_url (nil) expand and print the remote URL
-      #       (respecting `url.<base>.insteadOf` config) and exit without contacting
-      #       the remote
+      #   @option options [String] :sort (nil) sort output by the given key
       #
-      #     @option options [String] :sort (nil) sort output by the given key
+      #     Prefix `-` for descending order. Supports `"version:refname"` or
+      #     `"v:refname"`. See `git for-each-ref` for sort key documentation.
       #
-      #       Prefix `-` for descending order. Supports `"version:refname"` or
-      #       `"v:refname"`. See `git for-each-ref` for sort key documentation.
+      #   @option options [Boolean, nil] :symref (nil) show the underlying ref pointed to by
+      #     symbolic refs
       #
-      #     @option options [Boolean, nil] :symref (nil) show the underlying ref pointed to by
-      #       symbolic refs
+      #     The `upload-pack` protocol currently surfaces only the `HEAD` symref,
+      #     so that is typically the only symref shown.
       #
-      #       The `upload-pack` protocol currently surfaces only the `HEAD` symref,
-      #       so that is typically the only symref shown.
+      #   @option options [String, Array<String>] :server_option (nil) transmit a
+      #     string to the server when communicating using protocol version 2
       #
-      #     @option options [String, Array<String>] :server_option (nil) transmit a
-      #       string to the server when communicating using protocol version 2
+      #     The string must not contain NUL or LF characters. Repeatable by
+      #     passing an Array. Alias: :o
       #
-      #       The string must not contain NUL or LF characters. Repeatable by
-      #       passing an Array. Alias: :o
+      #   @option options [Numeric] :timeout (nil) execution timeout in seconds
       #
-      #     @option options [Numeric] :timeout (nil) execution timeout in seconds
+      #   @return [Git::CommandLine::Result] the result of calling `git ls-remote`
       #
-      #     @return [Git::CommandLineResult] the result of calling `git ls-remote`
+      #   @raise [ArgumentError] if unsupported options are provided
       #
-      #     @raise [Git::FailedError] if git exits outside the allowed range (exit code > 2)
+      #   @raise [Git::FailedError] if git exits outside the allowed range (exit code > 2)
+      #
+      #   @api public
+      def call(*, **)
+        super
+      end
     end
   end
 end

data/lib/git/commands/ls_tree.rb

@@ -10,12 +10,6 @@ module Git
     # name, and file name of each item. Supports recursive listing, output
     # format control, and path filtering.
     #
-    # @note `arguments` block audited against https://git-scm.com/docs/git-ls-tree/2.53.0
-    #
-    # @see https://git-scm.com/docs/git-ls-tree git-ls-tree
-    #
-    # @api private
-    #
     # @example List the top-level tree of HEAD
     #   ls_tree = Git::Commands::LsTree.new(execution_context)
     #   ls_tree.call('HEAD')
@@ -32,6 +26,12 @@ module Git
     #   ls_tree = Git::Commands::LsTree.new(execution_context)
     #   ls_tree.call('HEAD', 'lib/')
     #
+    # @note `arguments` block audited against https://git-scm.com/docs/git-ls-tree/2.53.0
+    #
+    # @see https://git-scm.com/docs/git-ls-tree git-ls-tree
+    #
+    # @api private
+    #
     class LsTree < Git::Commands::Base
       arguments do
         literal 'ls-tree'
@@ -57,75 +57,79 @@ module Git
         operand :path, repeatable: true
       end
 
-      # @!method call(*, **)
       #
-      #   @overload call(tree_ish, *path, **options)
+      # @overload call(tree_ish, *path, **options)
+      #
+      #   Execute the git ls-tree command
       #
-      #     Execute the git ls-tree command
+      #   @param tree_ish [String] the tree object to list (SHA, branch name, tag, etc.)
       #
-      #     @param tree_ish [String] the tree object to list (SHA, branch name, tag, etc.)
+      #   @param path [Array<String>] optional path(s) to restrict the listing
       #
-      #     @param path [Array<String>] optional path(s) to restrict the listing
+      #     When given, only entries matching these paths are shown.
       #
-      #       When given, only entries matching these paths are shown.
+      #   @param options [Hash] command options
       #
-      #     @param options [Hash] command options
+      #   @option options [Boolean, nil] :d (nil) show only the named tree entry itself,
+      #     not its children
       #
-      #     @option options [Boolean, nil] :d (nil) show only the named tree entry itself,
-      #       not its children
+      #   @option options [Boolean, nil] :r (nil) recurse into sub-trees
       #
-      #     @option options [Boolean, nil] :r (nil) recurse into sub-trees
+      #   @option options [Boolean, nil] :t (nil) show tree entries even when going to
+      #     recurse them
       #
-      #     @option options [Boolean, nil] :t (nil) show tree entries even when going to
-      #       recurse them
+      #     Implies recursive listing (`:r`) in git.
       #
-      #       Implies recursive listing (`:r`) in git.
+      #   @option options [Boolean, nil] :long (nil) show object size of blob (file)
+      #     objects
       #
-      #     @option options [Boolean, nil] :long (nil) show object size of blob (file)
-      #       objects
+      #     Cannot be combined with `:name_only` or `:object_only`.
       #
-      #       Cannot be combined with `:name_only` or `:object_only`.
+      #     Alias: :l
       #
-      #       Alias: :l
+      #   @option options [Boolean, nil] :z (nil) use NUL (`\0`) as line terminator
+      #     instead of newline, and do not quote filenames
       #
-      #     @option options [Boolean, nil] :z (nil) use NUL (`\0`) as line terminator
-      #       instead of newline, and do not quote filenames
+      #   @option options [Boolean, nil] :name_only (nil) list only filenames, one per
+      #     line
       #
-      #     @option options [Boolean, nil] :name_only (nil) list only filenames, one per
-      #       line
+      #     Cannot be combined with `:object_only` or `:long`.
       #
-      #       Cannot be combined with `:object_only` or `:long`.
+      #     Alias: :name_status
       #
-      #       Alias: :name_status
+      #   @option options [Boolean, nil] :object_only (nil) list only the object names
+      #     (SHAs), one per line
       #
-      #     @option options [Boolean, nil] :object_only (nil) list only the object names
-      #       (SHAs), one per line
+      #     Cannot be combined with `:name_only` or `:long`.
       #
-      #       Cannot be combined with `:name_only` or `:long`.
+      #   @option options [Boolean, nil] :full_name (nil) show full path names instead
+      #     of paths relative to the current working directory
       #
-      #     @option options [Boolean, nil] :full_name (nil) show full path names instead
-      #       of paths relative to the current working directory
+      #   @option options [Boolean, nil] :full_tree (nil) do not limit the listing to
+      #     the current working directory; implies `:full_name`
       #
-      #     @option options [Boolean, nil] :full_tree (nil) do not limit the listing to
-      #       the current working directory; implies `:full_name`
+      #   @option options [Boolean, String, nil] :abbrev (nil) use abbreviated object names
       #
-      #     @option options [Boolean, String, nil] :abbrev (nil) use abbreviated object names
+      #     When `true`, uses git's default abbreviated name length. When a string
+      #     (e.g. `'8'`), uses exactly that many hex digits.
       #
-      #       When `true`, uses git's default abbreviated name length. When a string
-      #       (e.g. `'8'`), uses exactly that many hex digits.
+      #   @option options [String] :format (nil) a format string that interpolates
+      #     `%(fieldname)` placeholders from tree entries
       #
-      #     @option options [String] :format (nil) a format string that interpolates
-      #       `%(fieldname)` placeholders from tree entries
+      #     Cannot be combined with `:long`, `:name_only`, or `:object_only`.
       #
-      #       Cannot be combined with `:long`, `:name_only`, or `:object_only`.
+      #   @return [Git::CommandLine::Result] the result of calling `git ls-tree`
       #
-      #     @return [Git::CommandLineResult] the result of calling `git ls-tree`
+      #   @raise [ArgumentError] if unsupported options are provided
       #
-      #     @raise [ArgumentError] if unsupported options are provided
+      #   @raise [ArgumentError] if the tree-ish operand is missing
       #
-      #     @raise [ArgumentError] if the tree-ish operand is missing
+      #   @raise [Git::FailedError] if git exits with a non-zero exit status
       #
-      #     @raise [Git::FailedError] if git exits with a non-zero exit status
+      #   @api public
+      def call(*, **)
+        super
+      end
     end
   end
 end

data/lib/git/commands/maintenance/register.rb

@@ -32,43 +32,45 @@ module Git
           execution_option :env
         end
 
-        # @!method call(*, **)
         #
-        #   @overload call(**options)
+        # @overload call(**options)
         #
-        #     Initialize config values so scheduled maintenance will start running
+        #   Initialize config values so scheduled maintenance will start running
         #
-        #     This adds the repository to the `maintenance.repo` config variable
-        #     in the current user's global config (or the specified config file)
-        #     and enables recommended configuration values for
-        #     `maintenance.<task>.schedule`.
+        #   This adds the repository to the `maintenance.repo` config variable
+        #   in the current user's global config (or the specified config file)
+        #   and enables recommended configuration values for
+        #   `maintenance.<task>.schedule`.
         #
-        #     Also sets `maintenance.strategy` to 'incremental' if not previously set,
-        #     and disables foreground maintenance by setting `maintenance.auto = false`
-        #     in the current repository.
+        #   Also sets `maintenance.strategy` to 'incremental' if not previously set,
+        #   and disables foreground maintenance by setting `maintenance.auto = false`
+        #   in the current repository.
         #
-        #     @param options [Hash] command options
+        #   @param options [Hash] command options
         #
-        #     @option options [Boolean, String, nil] :config_file (nil) use a specified
-        #       config file instead of the global config (`--config-file`)
+        #   @option options [Boolean, String, nil] :config_file (nil) use a specified
+        #     config file instead of the global config (`--config-file`)
         #
-        #       When a String, the path is passed as `--config-file <file>`.
+        #     When a String, the path is passed as `--config-file <file>`.
         #
-        #     @option options [Boolean, nil] :no_config_file (nil) disable the config file
-        #       (`--no-config-file`)
+        #   @option options [Boolean, nil] :no_config_file (nil) disable the config file
+        #     (`--no-config-file`)
         #
-        #     @option options [Hash] :env (nil) environment variables to set for the git
-        #       process; merged with the default environment; not passed to the git CLI
+        #   @option options [Hash] :env (nil) environment variables to set for the git
+        #     process; merged with the default environment; not passed to the git CLI
         #
-        #     @return [Git::CommandLineResult] the result of calling `git maintenance register`
+        #   @return [Git::CommandLine::Result] the result of calling `git maintenance register`
         #
-        #     @raise [ArgumentError] if unsupported options are provided
+        #   @raise [ArgumentError] if unsupported options are provided
         #
-        #     @raise [Git::FailedError] if git exits with a non-zero exit status
+        #   @raise [Git::FailedError] if git exits with a non-zero exit status
         #
-        #     @raise [Git::VersionError] if git version is below 2.30.0
+        #   @raise [Git::VersionError] if git version is below 2.30.0
         #
-        #     @api public
+        #   @api public
+        def call(*, **)
+          super
+        end
       end
     end
   end

data/lib/git/commands/maintenance/run.rb

@@ -43,7 +43,12 @@ module Git
           execution_option :env
         end
 
-        # @!method call(*, **)
+        # @!method call(*, **options)
+        #
+        #   @param options [Hash] command options
+        #
+        #   @option options [Boolean, nil] :auto (nil) command option key; see overload docs
+        #     for the full option list
         #
         #   @overload call(**options)
         #
@@ -89,7 +94,7 @@ module Git
         #     @option options [Hash] :env (nil) environment variables to set for the git
         #       process; merged with the default environment; not passed to the git CLI
         #
-        #     @return [Git::CommandLineResult] the result of calling `git maintenance run`
+        #     @return [Git::CommandLine::Result] the result of calling `git maintenance run`
         #
         #     @raise [ArgumentError] if unsupported options are provided
         #

data/lib/git/commands/maintenance/start.rb

@@ -32,7 +32,12 @@ module Git
           execution_option :env
         end
 
-        # @!method call(*, **)
+        # @!method call(*, **options)
+        #
+        #   @param options [Hash] command options
+        #
+        #   @option options [String] :scheduler (nil) command option key; see overload docs
+        #     for the full option list
         #
         #   @overload call(**options)
         #
@@ -53,7 +58,7 @@ module Git
         #     @option options [Hash] :env (nil) environment variables to set for the git
         #       process; merged with the default environment; not passed to the git CLI
         #
-        #     @return [Git::CommandLineResult] the result of calling `git maintenance start`
+        #     @return [Git::CommandLine::Result] the result of calling `git maintenance start`
         #
         #     @raise [ArgumentError] if unsupported options are provided
         #