git 5.0.0.beta.3 → 5.0.0.beta.4

data/lib/git/commands/log.rb

@@ -162,471 +162,473 @@ module Git
         execution_option :timeout
       end
 
-      # @!method call(*, **)
       #
-      #   @overload call(*revision_range, **options)
+      # @overload call(*revision_range, **options)
       #
-      #     Execute the `git log` command.
+      #   Execute the `git log` command.
       #
-      #     @param revision_range [Array<String>] zero or more revision specifiers
+      #   @param revision_range [Array<String>] zero or more revision specifiers
       #
-      #       Examples include `'v1.0..v2.0'`, `'abc123'`, `'^v0.9'`, or any
-      #       expression accepted by git-log(1). When multiple values are given they
-      #       are passed as separate positional arguments to git. Defaults to no
-      #       revision constraint (i.e. all reachable commits).
+      #     Examples include `'v1.0..v2.0'`, `'abc123'`, `'^v0.9'`, or any
+      #     expression accepted by git-log(1). When multiple values are given they
+      #     are passed as separate positional arguments to git. Defaults to no
+      #     revision constraint (i.e. all reachable commits).
       #
-      #     @param options [Hash] command options
+      #   @param options [Hash] command options
       #
-      #     ### Commit Limiting
+      #   ### Commit Limiting
       #
-      #     @option options [Integer, String] :max_count (nil) maximum number of commits to output
+      #   @option options [Integer, String] :max_count (nil) maximum number of commits to output
       #
-      #       Alias: `:n`
+      #     Alias: `:n`
       #
-      #     @option options [Integer, String] :skip (nil) skip this many commits before starting output
+      #   @option options [Integer, String] :skip (nil) skip this many commits before starting output
       #
-      #     @option options [String] :since (nil) show commits more recent than the given date
+      #   @option options [String] :since (nil) show commits more recent than the given date
       #
-      #       Examples: `'2 weeks ago'`, `'2024-01-01'`
+      #     Examples: `'2 weeks ago'`, `'2024-01-01'`
       #
-      #     @option options [String] :after (nil) show commits more recent than the given date
-      #       (synonym for `:since`)
+      #   @option options [String] :after (nil) show commits more recent than the given date
+      #     (synonym for `:since`)
       #
-      #     @option options [String] :since_as_filter (nil) like `:since` but visits all commits
-      #       in the range rather than stopping at the first older commit
+      #   @option options [String] :since_as_filter (nil) like `:since` but visits all commits
+      #     in the range rather than stopping at the first older commit
       #
-      #     @option options [String] :until (nil) show commits older than the given date
+      #   @option options [String] :until (nil) show commits older than the given date
       #
-      #       Examples: `'1 month ago'`, `'2024-01-01'`
+      #     Examples: `'1 month ago'`, `'2024-01-01'`
       #
-      #     @option options [String] :before (nil) show commits older than the given date
-      #       (synonym for `:until`)
+      #   @option options [String] :before (nil) show commits older than the given date
+      #     (synonym for `:until`)
       #
-      #     @option options [String] :author (nil) limit commits to those whose author line
-      #       matches the given pattern (regular expression)
+      #   @option options [String] :author (nil) limit commits to those whose author line
+      #     matches the given pattern (regular expression)
       #
-      #     @option options [String] :committer (nil) limit commits to those whose committer
-      #       line matches the given pattern (regular expression)
+      #   @option options [String] :committer (nil) limit commits to those whose committer
+      #     line matches the given pattern (regular expression)
       #
-      #     @option options [String] :grep_reflog (nil) limit commits to those with reflog entries
-      #       matching the given pattern; requires `:walk_reflogs`
+      #   @option options [String] :grep_reflog (nil) limit commits to those with reflog entries
+      #     matching the given pattern; requires `:walk_reflogs`
       #
-      #     @option options [String] :grep (nil) limit commits to those whose log message matches
-      #       the given pattern (regular expression)
+      #   @option options [String] :grep (nil) limit commits to those whose log message matches
+      #     the given pattern (regular expression)
       #
-      #     @option options [Boolean, nil] :all_match (nil) limit output to commits matching all
-      #       `--grep` patterns (default: any)
+      #   @option options [Boolean, nil] :all_match (nil) limit output to commits matching all
+      #     `--grep` patterns (default: any)
       #
-      #     @option options [Boolean, nil] :invert_grep (nil) limit output to commits whose log
-      #       message does **not** match the `:grep` pattern
+      #   @option options [Boolean, nil] :invert_grep (nil) limit output to commits whose log
+      #     message does **not** match the `:grep` pattern
       #
-      #     @option options [Boolean, nil] :regexp_ignore_case (nil) match `--grep`, `--author`,
-      #       and `--committer` patterns case-insensitively
+      #   @option options [Boolean, nil] :regexp_ignore_case (nil) match `--grep`, `--author`,
+      #     and `--committer` patterns case-insensitively
       #
-      #       Alias: `:i`
+      #     Alias: `:i`
       #
-      #     @option options [Boolean, nil] :basic_regexp (nil) treat limiting patterns as basic POSIX
-      #       regular expressions (this is the default behavior)
+      #   @option options [Boolean, nil] :basic_regexp (nil) treat limiting patterns as basic POSIX
+      #     regular expressions (this is the default behavior)
       #
-      #     @option options [Boolean, nil] :extended_regexp (nil) treat limiting patterns as extended
-      #       POSIX regular expressions
+      #   @option options [Boolean, nil] :extended_regexp (nil) treat limiting patterns as extended
+      #     POSIX regular expressions
       #
-      #       Mutually exclusive with `:fixed_strings` and `:perl_regexp`. Alias: `:E`
+      #     Mutually exclusive with `:fixed_strings` and `:perl_regexp`. Alias: `:E`
       #
-      #     @option options [Boolean, nil] :fixed_strings (nil) treat limiting patterns as fixed
-      #       strings instead of regular expressions
+      #   @option options [Boolean, nil] :fixed_strings (nil) treat limiting patterns as fixed
+      #     strings instead of regular expressions
       #
-      #       Mutually exclusive with `:extended_regexp` and `:perl_regexp`. Alias: `:F`
+      #     Mutually exclusive with `:extended_regexp` and `:perl_regexp`. Alias: `:F`
       #
-      #     @option options [Boolean, nil] :perl_regexp (nil) treat limiting patterns as
-      #       Perl-compatible regular expressions
+      #   @option options [Boolean, nil] :perl_regexp (nil) treat limiting patterns as
+      #     Perl-compatible regular expressions
       #
-      #       Mutually exclusive with `:extended_regexp` and `:fixed_strings`. Alias: `:P`
+      #     Mutually exclusive with `:extended_regexp` and `:fixed_strings`. Alias: `:P`
       #
-      #     @option options [Boolean, nil] :remove_empty (nil) stop when a given path disappears
-      #       from the tree
+      #   @option options [Boolean, nil] :remove_empty (nil) stop when a given path disappears
+      #     from the tree
       #
-      #     @option options [Boolean, nil] :merges (nil) include only merge commits (`--merges`)
+      #   @option options [Boolean, nil] :merges (nil) include only merge commits (`--merges`)
       #
-      #       Equivalent to `--min-parents=2`.
+      #     Equivalent to `--min-parents=2`.
       #
-      #     @option options [Boolean, nil] :no_merges (nil) exclude merge commits (`--no-merges`)
+      #   @option options [Boolean, nil] :no_merges (nil) exclude merge commits (`--no-merges`)
       #
-      #       Equivalent to `--max-parents=1`.
+      #     Equivalent to `--max-parents=1`.
       #
-      #     @option options [Integer, String] :min_parents (nil) show only commits with at least this
-      #       many parents
+      #   @option options [Integer, String] :min_parents (nil) show only commits with at least this
+      #     many parents
       #
-      #     @option options [Integer, String] :max_parents (nil) show only commits with at most this
-      #       many parents
+      #   @option options [Integer, String] :max_parents (nil) show only commits with at most this
+      #     many parents
       #
-      #     @option options [Boolean, nil] :first_parent (nil) follow only the first parent commit
-      #       upon seeing a merge commit
+      #   @option options [Boolean, nil] :first_parent (nil) follow only the first parent commit
+      #     upon seeing a merge commit
       #
-      #     @option options [Boolean, nil] :exclude_first_parent_only (nil) when excluding commits
-      #       with `^`, follow only the first parent of merge commits
+      #   @option options [Boolean, nil] :exclude_first_parent_only (nil) when excluding commits
+      #     with `^`, follow only the first parent of merge commits
       #
-      #     @option options [Boolean, nil] :all (nil) pretend as if all refs in `refs/`, along
-      #       with `HEAD`, are listed on the command line
+      #   @option options [Boolean, nil] :all (nil) pretend as if all refs in `refs/`, along
+      #     with `HEAD`, are listed on the command line
       #
-      #     @option options [Boolean, String, nil] :branches (nil) pretend as if all refs in
-      #       `refs/heads` are listed on the command line
+      #   @option options [Boolean, String, nil] :branches (nil) pretend as if all refs in
+      #     `refs/heads` are listed on the command line
       #
-      #       Pass a shell glob pattern (e.g. `'feature*'`) to restrict to matching branch names
+      #     Pass a shell glob pattern (e.g. `'feature*'`) to restrict to matching branch names
       #
-      #     @option options [Boolean, String, nil] :tags (nil) pretend as if all refs in
-      #       `refs/tags` are listed on the command line
+      #   @option options [Boolean, String, nil] :tags (nil) pretend as if all refs in
+      #     `refs/tags` are listed on the command line
       #
-      #       Pass a shell glob pattern to restrict to matching tag names
+      #     Pass a shell glob pattern to restrict to matching tag names
       #
-      #     @option options [Boolean, String, nil] :remotes (nil) pretend as if all refs in
-      #       `refs/remotes` are listed on the command line
+      #   @option options [Boolean, String, nil] :remotes (nil) pretend as if all refs in
+      #     `refs/remotes` are listed on the command line
       #
-      #       Pass a shell glob pattern to restrict to matching remote-tracking branches
+      #     Pass a shell glob pattern to restrict to matching remote-tracking branches
       #
-      #     @option options [String] :glob (nil) pretend as if all refs matching the given shell
-      #       glob pattern are listed on the command line
+      #   @option options [String] :glob (nil) pretend as if all refs matching the given shell
+      #     glob pattern are listed on the command line
       #
-      #     @option options [String] :exclude (nil) do not include refs matching the given glob
-      #       that `--all`, `--branches`, `--tags`, `--remotes`, or `--glob` would otherwise use
+      #   @option options [String] :exclude (nil) do not include refs matching the given glob
+      #     that `--all`, `--branches`, `--tags`, `--remotes`, or `--glob` would otherwise use
       #
-      #     @option options [String] :exclude_hidden (nil) do not include refs hidden by the given
-      #       configuration; value is one of `fetch`, `receive`, or `uploadpack`
+      #   @option options [String] :exclude_hidden (nil) do not include refs hidden by the given
+      #     configuration; value is one of `fetch`, `receive`, or `uploadpack`
       #
-      #     @option options [Boolean, nil] :reflog (nil) pretend as if all objects mentioned by
-      #       reflogs are listed on the command line
+      #   @option options [Boolean, nil] :reflog (nil) pretend as if all objects mentioned by
+      #     reflogs are listed on the command line
       #
-      #     @option options [Boolean, nil] :alternate_refs (nil) pretend as if all objects mentioned
-      #       as ref tips of alternate repositories are listed on the command line
+      #   @option options [Boolean, nil] :alternate_refs (nil) pretend as if all objects mentioned
+      #     as ref tips of alternate repositories are listed on the command line
       #
-      #     @option options [Boolean, nil] :single_worktree (nil) examine only the current working
-      #       tree when `--all`, `--reflog`, or similar options are in use
+      #   @option options [Boolean, nil] :single_worktree (nil) examine only the current working
+      #     tree when `--all`, `--reflog`, or similar options are in use
       #
-      #     @option options [Boolean, nil] :ignore_missing (nil) ignore invalid object names in input
+      #   @option options [Boolean, nil] :ignore_missing (nil) ignore invalid object names in input
       #
-      #     @option options [Boolean, nil] :bisect (nil) pretend as if the bad bisect ref was listed
-      #       and the good bisect refs were excluded
+      #   @option options [Boolean, nil] :bisect (nil) pretend as if the bad bisect ref was listed
+      #     and the good bisect refs were excluded
       #
-      #     @option options [Boolean, nil] :cherry_mark (nil) like `:cherry_pick` but marks
-      #       equivalent commits with `=` instead of omitting them; inequivalent ones with +++
+      #   @option options [Boolean, nil] :cherry_mark (nil) like `:cherry_pick` but marks
+      #     equivalent commits with `=` instead of omitting them; inequivalent ones with +++
       #
-      #     @option options [Boolean, nil] :cherry_pick (nil) omit commits that introduce the same
-      #       change as a commit on the other side of a symmetric difference
+      #   @option options [Boolean, nil] :cherry_pick (nil) omit commits that introduce the same
+      #     change as a commit on the other side of a symmetric difference
       #
-      #     @option options [Boolean, nil] :left_only (nil) list only commits reachable from the
-      #       left side of a symmetric difference
+      #   @option options [Boolean, nil] :left_only (nil) list only commits reachable from the
+      #     left side of a symmetric difference
       #
-      #     @option options [Boolean, nil] :right_only (nil) list only commits reachable from the
-      #       right side of a symmetric difference
+      #   @option options [Boolean, nil] :right_only (nil) list only commits reachable from the
+      #     right side of a symmetric difference
       #
-      #     @option options [Boolean, nil] :cherry (nil) synonym for
-      #       `--right-only --cherry-mark --no-merges`
+      #   @option options [Boolean, nil] :cherry (nil) synonym for
+      #     `--right-only --cherry-mark --no-merges`
       #
-      #     @option options [Boolean, nil] :walk_reflogs (nil) walk reflog entries from most recent
-      #       to oldest instead of the commit ancestry chain
+      #   @option options [Boolean, nil] :walk_reflogs (nil) walk reflog entries from most recent
+      #     to oldest instead of the commit ancestry chain
       #
-      #       Alias: `:g`
+      #     Alias: `:g`
       #
-      #     @option options [Boolean, nil] :merge (nil) show commits touching conflicted paths in
-      #       the range `HEAD...MERGE_HEAD`; only useful with unmerged index entries
+      #   @option options [Boolean, nil] :merge (nil) show commits touching conflicted paths in
+      #     the range `HEAD...MERGE_HEAD`; only useful with unmerged index entries
       #
-      #     @option options [Boolean, nil] :boundary (nil) output excluded boundary commits,
-      #       prefixed with `-`
+      #   @option options [Boolean, nil] :boundary (nil) output excluded boundary commits,
+      #     prefixed with `-`
       #
-      #     ### History Simplification
+      #   ### History Simplification
       #
-      #     @option options [Boolean, nil] :simplify_by_decoration (nil) show only commits referenced
-      #       by some branch or tag
+      #   @option options [Boolean, nil] :simplify_by_decoration (nil) show only commits referenced
+      #     by some branch or tag
       #
-      #     @option options [Boolean, nil] :show_pulls (nil) include merge commits that are not
-      #       TREESAME to their first parent but are TREESAME to a later parent
+      #   @option options [Boolean, nil] :show_pulls (nil) include merge commits that are not
+      #     TREESAME to their first parent but are TREESAME to a later parent
       #
-      #     @option options [Boolean, nil] :full_history (nil) do not prune history; show all commits
-      #       that touched the given path(s)
+      #   @option options [Boolean, nil] :full_history (nil) do not prune history; show all commits
+      #     that touched the given path(s)
       #
-      #     @option options [Boolean, nil] :dense (nil) show only commits not TREESAME to any parent
+      #   @option options [Boolean, nil] :dense (nil) show only commits not TREESAME to any parent
       #
-      #     @option options [Boolean, nil] :sparse (nil) show all commits in the simplified history
+      #   @option options [Boolean, nil] :sparse (nil) show all commits in the simplified history
       #
-      #     @option options [Boolean, nil] :simplify_merges (nil) remove needless merges from the
-      #       result of `:full_history` with parent rewriting
+      #   @option options [Boolean, nil] :simplify_merges (nil) remove needless merges from the
+      #     result of `:full_history` with parent rewriting
       #
-      #     @option options [Boolean, String, nil] :ancestry_path (nil) limit to commits on the
-      #       ancestry chain between the range endpoints
+      #   @option options [Boolean, String, nil] :ancestry_path (nil) limit to commits on the
+      #     ancestry chain between the range endpoints
       #
-      #       Pass `true` for `--ancestry-path`; pass a commit SHA for `--ancestry-path=<commit>`
+      #     Pass `true` for `--ancestry-path`; pass a commit SHA for `--ancestry-path=<commit>`
       #
-      #     ### Commit Ordering
+      #   ### Commit Ordering
       #
-      #     @option options [Boolean, nil] :date_order (nil) show commits in commit timestamp order,
-      #       no parents before all children
+      #   @option options [Boolean, nil] :date_order (nil) show commits in commit timestamp order,
+      #     no parents before all children
       #
-      #     @option options [Boolean, nil] :author_date_order (nil) like `:date_order` but ordered
-      #       by author timestamp
+      #   @option options [Boolean, nil] :author_date_order (nil) like `:date_order` but ordered
+      #     by author timestamp
       #
-      #     @option options [Boolean, nil] :topo_order (nil) avoid showing commits on multiple lines
-      #       of history intermixed
+      #   @option options [Boolean, nil] :topo_order (nil) avoid showing commits on multiple lines
+      #     of history intermixed
       #
-      #     @option options [Boolean, nil] :reverse (nil) output selected commits in reverse order;
-      #       cannot be combined with `:walk_reflogs`
+      #   @option options [Boolean, nil] :reverse (nil) output selected commits in reverse order;
+      #     cannot be combined with `:walk_reflogs`
       #
-      #     ### Object Traversal
+      #   ### Object Traversal
       #
-      #     @option options [Boolean, String, nil] :no_walk (nil) show only the given commits without
-      #       traversing ancestors
+      #   @option options [Boolean, String, nil] :no_walk (nil) show only the given commits without
+      #     traversing ancestors
       #
-      #       Pass `true` for `--no-walk` (sorted); pass `"unsorted"` for `--no-walk=unsorted`
+      #     Pass `true` for `--no-walk` (sorted); pass `"unsorted"` for `--no-walk=unsorted`
       #
-      #     @option options [Boolean, nil] :do_walk (nil) override a previous `--no-walk`
+      #   @option options [Boolean, nil] :do_walk (nil) override a previous `--no-walk`
       #
-      #     ### Commit Formatting
+      #   ### Commit Formatting
       #
-      #     @option options [Boolean, String, nil] :pretty (nil) pretty-print commit log in a format
+      #   @option options [Boolean, String, nil] :pretty (nil) pretty-print commit log in a format
       #
-      #       Pass `true` for `--pretty` (`medium` format); pass a format name such as `"oneline"`,
-      #       `"short"`, `"full"`, `"fuller"`, `"email"`, `"raw"`, or a `format:<string>`
-      #       expression for `--pretty=<format>`.
+      #     Pass `true` for `--pretty` (`medium` format); pass a format name such as `"oneline"`,
+      #     `"short"`, `"full"`, `"fuller"`, `"email"`, `"raw"`, or a `format:<string>`
+      #     expression for `--pretty=<format>`.
       #
-      #       Alias: `:format`
+      #     Alias: `:format`
       #
-      #     @option options [Boolean, nil] :abbrev_commit (nil) abbreviate commit hash (`--abbrev-commit`)
+      #   @option options [Boolean, nil] :abbrev_commit (nil) abbreviate commit hash (`--abbrev-commit`)
       #
-      #     @option options [Boolean, nil] :no_abbrev_commit (nil) do not abbreviate commit hash (`--no-abbrev-commit`)
+      #   @option options [Boolean, nil] :no_abbrev_commit (nil) do not abbreviate commit hash (`--no-abbrev-commit`)
       #
-      #     @option options [Boolean, nil] :oneline (nil) shorthand for
-      #       `--pretty=oneline --abbrev-commit`
+      #   @option options [Boolean, nil] :oneline (nil) shorthand for
+      #     `--pretty=oneline --abbrev-commit`
       #
-      #     @option options [String] :encoding (nil) re-encode the commit log message in the
-      #       given character encoding before output
+      #   @option options [String] :encoding (nil) re-encode the commit log message in the
+      #     given character encoding before output
       #
-      #     @option options [Boolean, String, nil] :expand_tabs (nil) expand tabs in log messages (`--expand-tabs`)
+      #   @option options [Boolean, String, nil] :expand_tabs (nil) expand tabs in log messages (`--expand-tabs`)
       #
-      #       Pass `true` for `--expand-tabs` (width 8); pass an integer string like `"4"` for
-      #       `--expand-tabs=<n>`
+      #     Pass `true` for `--expand-tabs` (width 8); pass an integer string like `"4"` for
+      #     `--expand-tabs=<n>`
       #
-      #     @option options [Boolean, nil] :no_expand_tabs (nil) do not expand tabs in log messages (`--no-expand-tabs`)
+      #   @option options [Boolean, nil] :no_expand_tabs (nil) do not expand tabs in log messages (`--no-expand-tabs`)
       #
-      #     @option options [Boolean, String, nil] :notes (nil) show notes annotating the commit (`--notes`)
+      #   @option options [Boolean, String, nil] :notes (nil) show notes annotating the commit (`--notes`)
       #
-      #       Pass `true` for `--notes`; pass a ref string for `--notes=<ref>`
+      #     Pass `true` for `--notes`; pass a ref string for `--notes=<ref>`
       #
-      #     @option options [Boolean, nil] :no_notes (nil) suppress notes output (`--no-notes`)
+      #   @option options [Boolean, nil] :no_notes (nil) suppress notes output (`--no-notes`)
       #
-      #     @option options [Boolean, nil] :show_notes_by_default (nil) show the default notes unless
-      #       options for displaying specific notes are given
+      #   @option options [Boolean, nil] :show_notes_by_default (nil) show the default notes unless
+      #     options for displaying specific notes are given
       #
-      #     @option options [Boolean, nil] :show_signature (nil) verify a signed commit with
-      #       `gpg --verify`
+      #   @option options [Boolean, nil] :show_signature (nil) verify a signed commit with
+      #     `gpg --verify`
       #
-      #     @option options [Boolean, nil] :relative_date (nil) show dates relative to the current
-      #       time (synonym for `--date=relative`)
+      #   @option options [Boolean, nil] :relative_date (nil) show dates relative to the current
+      #     time (synonym for `--date=relative`)
       #
-      #     @option options [String] :date (nil) format for dates in human-readable output
+      #   @option options [String] :date (nil) format for dates in human-readable output
       #
-      #       Examples: `'relative'`, `'iso'`, `'short'`, `'format:%Y-%m-%d'`
+      #     Examples: `'relative'`, `'iso'`, `'short'`, `'format:%Y-%m-%d'`
       #
-      #     @option options [Boolean, nil] :parents (nil) print the parents of each commit and
-      #       enable parent rewriting
+      #   @option options [Boolean, nil] :parents (nil) print the parents of each commit and
+      #     enable parent rewriting
       #
-      #     @option options [Boolean, nil] :children (nil) print the children of each commit and
-      #       enable parent rewriting
+      #   @option options [Boolean, nil] :children (nil) print the children of each commit and
+      #     enable parent rewriting
       #
-      #     @option options [Boolean, nil] :left_right (nil) mark which side of a symmetric
-      #       difference a commit is reachable from (`<` for left, `>` for right)
+      #   @option options [Boolean, nil] :left_right (nil) mark which side of a symmetric
+      #     difference a commit is reachable from (`<` for left, `>` for right)
       #
-      #     @option options [Boolean, nil] :graph (nil) draw a text-based graphical representation
-      #       of the commit history on the left side of output; implies `--topo-order`
+      #   @option options [Boolean, nil] :graph (nil) draw a text-based graphical representation
+      #     of the commit history on the left side of output; implies `--topo-order`
       #
-      #     @option options [Boolean, String, nil] :show_linear_break (nil) put a barrier between
-      #       non-linear consecutive commits when `--graph` is not used
+      #   @option options [Boolean, String, nil] :show_linear_break (nil) put a barrier between
+      #     non-linear consecutive commits when `--graph` is not used
       #
-      #       Pass `true` for `--show-linear-break`; pass a string for a custom barrier text
+      #     Pass `true` for `--show-linear-break`; pass a string for a custom barrier text
       #
-      #     @option options [Boolean, nil] :follow (nil) continue listing the history of a file
-      #       beyond renames; requires `:path` to be set to exactly one path element
+      #   @option options [Boolean, nil] :follow (nil) continue listing the history of a file
+      #     beyond renames; requires `:path` to be set to exactly one path element
       #
-      #     @option options [Boolean, String, nil] :decorate (nil) print ref names of commits shown (`--decorate`)
+      #   @option options [Boolean, String, nil] :decorate (nil) print ref names of commits shown (`--decorate`)
       #
-      #       Pass `true` for `--decorate` (short format); pass a string such as `"full"` for
-      #       `--decorate=<format>`
+      #     Pass `true` for `--decorate` (short format); pass a string such as `"full"` for
+      #     `--decorate=<format>`
       #
-      #     @option options [Boolean, nil] :no_decorate (nil) do not print ref names (`--no-decorate`)
+      #   @option options [Boolean, nil] :no_decorate (nil) do not print ref names (`--no-decorate`)
       #
-      #     @option options [String] :decorate_refs (nil) use only refs matching this pattern
-      #       for decorations
+      #   @option options [String] :decorate_refs (nil) use only refs matching this pattern
+      #     for decorations
       #
-      #     @option options [String] :decorate_refs_exclude (nil) do not use refs matching this
-      #       pattern for decorations
+      #   @option options [String] :decorate_refs_exclude (nil) do not use refs matching this
+      #     pattern for decorations
       #
-      #     @option options [Boolean, nil] :clear_decorations (nil) clear all previous
-      #       `--decorate-refs` / `--decorate-refs-exclude` options
+      #   @option options [Boolean, nil] :clear_decorations (nil) clear all previous
+      #     `--decorate-refs` / `--decorate-refs-exclude` options
       #
-      #     @option options [Boolean, nil] :source (nil) print the ref name by which each commit
-      #       was reached
+      #   @option options [Boolean, nil] :source (nil) print the ref name by which each commit
+      #     was reached
       #
-      #     @option options [Boolean, nil] :use_mailmap (nil) use the mailmap file to map author/
-      #       committer names and addresses to canonical real names (`--use-mailmap`)
+      #   @option options [Boolean, nil] :use_mailmap (nil) use the mailmap file to map author/
+      #     committer names and addresses to canonical real names (`--use-mailmap`)
       #
-      #     @option options [Boolean, nil] :no_use_mailmap (nil) disable mailmap substitution (`--no-use-mailmap`)
+      #   @option options [Boolean, nil] :no_use_mailmap (nil) disable mailmap substitution (`--no-use-mailmap`)
       #
-      #     @option options [Boolean, nil] :full_diff (nil) show full diff for commits touching the
-      #       specified paths, not just the diff for those paths
+      #   @option options [Boolean, nil] :full_diff (nil) show full diff for commits touching the
+      #     specified paths, not just the diff for those paths
       #
-      #     @option options [Boolean, nil] :log_size (nil) include a `log size <n>` line for each
-      #       commit indicating the length of the commit message in bytes
+      #   @option options [Boolean, nil] :log_size (nil) include a `log size <n>` line for each
+      #     commit indicating the length of the commit message in bytes
       #
-      #     ### Diff Formatting
+      #   ### Diff Formatting
       #
-      #     @option options [Boolean, nil] :patch (nil) generate patch output
+      #   @option options [Boolean, nil] :patch (nil) generate patch output
       #
-      #       Alias: `:p`
+      #     Alias: `:p`
       #
-      #     @option options [Boolean, nil] :no_patch (nil) suppress all diff output
+      #   @option options [Boolean, nil] :no_patch (nil) suppress all diff output
       #
-      #       Alias: `:s`
+      #     Alias: `:s`
       #
-      #     @option options [String] :diff_merges (nil) diff format for merge commits
+      #   @option options [String] :diff_merges (nil) diff format for merge commits
       #
-      #       Values: `"off"`, `"on"`, `"first-parent"`, `"separate"`, `"combined"`,
-      #       `"dense-combined"`, `"remerge"`
+      #     Values: `"off"`, `"on"`, `"first-parent"`, `"separate"`, `"combined"`,
+      #     `"dense-combined"`, `"remerge"`
       #
-      #     @option options [Boolean, nil] :no_diff_merges (nil) disable diff output for merge
-      #       commits (synonym for `--diff-merges=off`)
+      #   @option options [Boolean, nil] :no_diff_merges (nil) disable diff output for merge
+      #     commits (synonym for `--diff-merges=off`)
       #
-      #     @option options [Boolean, nil] :combined_all_paths (nil) in combined diffs, list the
-      #       file name from all parents; only meaningful with `-c` or `--cc`
+      #   @option options [Boolean, nil] :combined_all_paths (nil) in combined diffs, list the
+      #     file name from all parents; only meaningful with `-c` or `--cc`
       #
-      #     @option options [Boolean, nil] :raw (nil) show a summary of changes using the raw diff
-      #       format for each commit
+      #   @option options [Boolean, nil] :raw (nil) show a summary of changes using the raw diff
+      #     format for each commit
       #
-      #     @option options [Boolean, String, nil] :stat (nil) generate a diffstat
+      #   @option options [Boolean, String, nil] :stat (nil) generate a diffstat
       #
-      #       Pass `true` for `--stat`; pass a string such as `"80,40"` for
-      #       `--stat=<width>[,<name-width>[,<count>]]`
+      #     Pass `true` for `--stat`; pass a string such as `"80,40"` for
+      #     `--stat=<width>[,<name-width>[,<count>]]`
       #
-      #     @option options [Boolean, nil] :compact_summary (nil) output a condensed summary of
-      #       extended header information in diffstat; implies `--stat`
+      #   @option options [Boolean, nil] :compact_summary (nil) output a condensed summary of
+      #     extended header information in diffstat; implies `--stat`
       #
-      #     @option options [Boolean, nil] :numstat (nil) like `--stat` but shows numbers of added
-      #       and deleted lines in decimal notation without abbreviation
+      #   @option options [Boolean, nil] :numstat (nil) like `--stat` but shows numbers of added
+      #     and deleted lines in decimal notation without abbreviation
       #
-      #     @option options [Boolean, nil] :shortstat (nil) output only the last line of the
-      #       `--stat` format
+      #   @option options [Boolean, nil] :shortstat (nil) output only the last line of the
+      #     `--stat` format
       #
-      #     @option options [Boolean, String, nil] :dirstat (nil) output distribution of relative
-      #       amount of changes per sub-directory
+      #   @option options [Boolean, String, nil] :dirstat (nil) output distribution of relative
+      #     amount of changes per sub-directory
       #
-      #       Pass `true` for `--dirstat`; pass a parameter string such as `"files,10"` for
-      #       `--dirstat=<params>`
+      #     Pass `true` for `--dirstat`; pass a parameter string such as `"files,10"` for
+      #     `--dirstat=<params>`
       #
-      #     @option options [Boolean, nil] :summary (nil) output a condensed summary of extended
-      #       header information such as creations, renames, and mode changes
+      #   @option options [Boolean, nil] :summary (nil) output a condensed summary of extended
+      #     header information such as creations, renames, and mode changes
       #
-      #     @option options [Boolean, nil] :name_only (nil) show only the names of changed files
+      #   @option options [Boolean, nil] :name_only (nil) show only the names of changed files
       #
-      #     @option options [Boolean, nil] :name_status (nil) show only the names and status of
-      #       changed files
+      #   @option options [Boolean, nil] :name_status (nil) show only the names and status of
+      #     changed files
       #
-      #     @option options [Boolean, String, nil] :submodule (nil) specify how differences in
-      #       submodules are shown
+      #   @option options [Boolean, String, nil] :submodule (nil) specify how differences in
+      #     submodules are shown
       #
-      #       Pass `true` for `--submodule` (log format); pass `"short"`, `"log"`, or `"diff"`
-      #       for `--submodule=<format>`
+      #     Pass `true` for `--submodule` (log format); pass `"short"`, `"log"`, or `"diff"`
+      #     for `--submodule=<format>`
       #
-      #     @option options [Boolean, String, nil] :color (nil) show colored diff output (`--color`)
+      #   @option options [Boolean, String, nil] :color (nil) show colored diff output (`--color`)
       #
-      #       Pass `true` for `--color`; pass a string such as `"always"` for `--color=<when>`
+      #     Pass `true` for `--color`; pass a string such as `"always"` for `--color=<when>`
       #
-      #     @option options [Boolean, nil] :no_color (nil) suppress colored diff output (`--no-color`)
+      #   @option options [Boolean, nil] :no_color (nil) suppress colored diff output (`--no-color`)
       #
-      #     @option options [Boolean, nil] :full_index (nil) show the full pre- and post-image blob
-      #       object names on the index line of patch output
+      #   @option options [Boolean, nil] :full_index (nil) show the full pre- and post-image blob
+      #     object names on the index line of patch output
       #
-      #     @option options [Boolean, nil] :binary (nil) output a binary diff that can be applied
-      #       with `git apply`; implies `--patch`
+      #   @option options [Boolean, nil] :binary (nil) output a binary diff that can be applied
+      #     with `git apply`; implies `--patch`
       #
-      #     @option options [Boolean, String, nil] :abbrev (nil) show the shortest unique object
-      #       name prefix in diff-raw output
+      #   @option options [Boolean, String, nil] :abbrev (nil) show the shortest unique object
+      #     name prefix in diff-raw output
       #
-      #       Pass `true` for `--abbrev`; pass an integer string for `--abbrev=<n>`
+      #     Pass `true` for `--abbrev`; pass an integer string for `--abbrev=<n>`
       #
-      #     @option options [String] :diff_filter (nil) select files by status letter
-      #       (e.g. `"AD"` for Added and Deleted)
+      #   @option options [String] :diff_filter (nil) select files by status letter
+      #     (e.g. `"AD"` for Added and Deleted)
       #
-      #     @option options [Boolean, String, nil] :find_renames (nil) detect renames
+      #   @option options [Boolean, String, nil] :find_renames (nil) detect renames
       #
-      #       Pass `true` for `--find-renames`; pass a percentage threshold string such as
-      #       `"90"` for `--find-renames=<n>`
+      #     Pass `true` for `--find-renames`; pass a percentage threshold string such as
+      #     `"90"` for `--find-renames=<n>`
       #
-      #     @option options [Boolean, String, nil] :find_copies (nil) detect copies as well as
-      #       renames
+      #   @option options [Boolean, String, nil] :find_copies (nil) detect copies as well as
+      #     renames
       #
-      #       Pass `true` for `--find-copies`; pass a threshold string for `--find-copies=<n>`
+      #     Pass `true` for `--find-copies`; pass a threshold string for `--find-copies=<n>`
       #
-      #     @option options [Boolean, nil] :find_copies_harder (nil) inspect unmodified files as
-      #       candidates for copy source; expensive for large projects
+      #   @option options [Boolean, nil] :find_copies_harder (nil) inspect unmodified files as
+      #     candidates for copy source; expensive for large projects
       #
-      #     @option options [Boolean, String, nil] :relative (nil) show pathnames relative to the
-      #       given subdirectory, or the current directory when run from a subdirectory (`--relative`)
+      #   @option options [Boolean, String, nil] :relative (nil) show pathnames relative to the
+      #     given subdirectory, or the current directory when run from a subdirectory (`--relative`)
       #
-      #       Pass `true` for `--relative`; pass a path string for `--relative=<path>`
+      #     Pass `true` for `--relative`; pass a path string for `--relative=<path>`
       #
-      #     @option options [Boolean, nil] :no_relative (nil) show absolute pathnames (`--no-relative`)
+      #   @option options [Boolean, nil] :no_relative (nil) show absolute pathnames (`--no-relative`)
       #
-      #     @option options [Boolean, nil] :text (nil) treat all files as text; alias `-a`
+      #   @option options [Boolean, nil] :text (nil) treat all files as text; alias `-a`
       #
-      #     @option options [Boolean, nil] :ignore_space_at_eol (nil) ignore changes in whitespace
-      #       at end of line
+      #   @option options [Boolean, nil] :ignore_space_at_eol (nil) ignore changes in whitespace
+      #     at end of line
       #
-      #     @option options [Boolean, nil] :ignore_space_change (nil) ignore changes in amount of
-      #       whitespace; alias `-b`
+      #   @option options [Boolean, nil] :ignore_space_change (nil) ignore changes in amount of
+      #     whitespace; alias `-b`
       #
-      #     @option options [Boolean, nil] :ignore_all_space (nil) ignore whitespace when comparing
-      #       lines; alias `-w`
+      #   @option options [Boolean, nil] :ignore_all_space (nil) ignore whitespace when comparing
+      #     lines; alias `-w`
       #
-      #     @option options [Boolean, nil] :ignore_blank_lines (nil) ignore changes whose lines are
-      #       all blank
+      #   @option options [Boolean, nil] :ignore_blank_lines (nil) ignore changes whose lines are
+      #     all blank
       #
-      #     @option options [String] :ignore_matching_lines (nil) ignore changes whose all lines
-      #       match the given regular expression
+      #   @option options [String] :ignore_matching_lines (nil) ignore changes whose all lines
+      #     match the given regular expression
       #
-      #     @option options [Boolean, nil] :ext_diff (nil) allow external diff helpers (`--ext-diff`)
+      #   @option options [Boolean, nil] :ext_diff (nil) allow external diff helpers (`--ext-diff`)
       #
-      #     @option options [Boolean, nil] :no_ext_diff (nil) disallow external diff helpers (`--no-ext-diff`)
+      #   @option options [Boolean, nil] :no_ext_diff (nil) disallow external diff helpers (`--no-ext-diff`)
       #
-      #     @option options [Boolean, nil] :textconv (nil) allow external text conversion filters
-      #       when comparing binary files (`--textconv`)
+      #   @option options [Boolean, nil] :textconv (nil) allow external text conversion filters
+      #     when comparing binary files (`--textconv`)
       #
-      #     @option options [Boolean, nil] :no_textconv (nil) disallow external text conversion filters
-      #       (`--no-textconv`)
+      #   @option options [Boolean, nil] :no_textconv (nil) disallow external text conversion filters
+      #     (`--no-textconv`)
       #
-      #     @option options [Boolean, nil] :no_prefix (nil) do not show any source or destination
-      #       prefix
+      #   @option options [Boolean, nil] :no_prefix (nil) do not show any source or destination
+      #     prefix
       #
-      #     @option options [String] :src_prefix (nil) show the given source prefix instead of
-      #       `a/`
+      #   @option options [String] :src_prefix (nil) show the given source prefix instead of
+      #     `a/`
       #
-      #     @option options [String] :dst_prefix (nil) show the given destination prefix instead
-      #       of `b/`
+      #   @option options [String] :dst_prefix (nil) show the given destination prefix instead
+      #     of `b/`
       #
-      #     ### Paths
+      #   ### Paths
       #
-      #     @option options [Array<String>] :path (nil) limit commits to those that affected the
-      #       given paths
+      #   @option options [Array<String>] :path (nil) limit commits to those that affected the
+      #     given paths
       #
-      #     ### Execution
+      #   ### Execution
       #
-      #     @option options [Integer, Float] :timeout (nil) number of seconds to wait before the
-      #       command is aborted with a timeout error
+      #   @option options [Integer, Float] :timeout (nil) number of seconds to wait before the
+      #     command is aborted with a timeout error
       #
-      #     @return [Git::CommandLineResult] the result of calling `git log`
+      #   @return [Git::CommandLine::Result] the result of calling `git log`
       #
-      #     @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