fish_delta - compare functions and completions to the default — fish-shell 3.7.1 documentation

# fish_delta - compare functions and completions to the default

## Synopsis

    fish_delta name ...
    fish_delta [-f | --no-functions] [-c | --no-completions] [-C | --no-config] [-d | --no-diff] [-n | --new] [-V | --vendor=]
    fish_delta [-h | --help]

## Description

The `fish_delta` function tells you, at a glance, which of your functions and completions differ from the set that fish ships.

It does this by going through the relevant variables (`fish_function_path` for functions and `fish_complete_path` for completions) and comparing the files against fish’s default directories.

If any names are given, it will only compare files by those names (plus a “.fish” extension).

By default, it will also use `diff` to display the difference between the files. If `diff` is unavailable, it will skip it, but in that case it also cannot figure out if the files really differ.

The exit status is 1 if there was a difference and 2 for other errors, otherwise 0.

## Options

The following options are available:

-f or --no-functions

  Stops checking functions

-c or --no-completions

  Stops checking completions

-C or --no-config

  Stops checking configuration files like config.fish or snippets in the conf.d directories.

-d or --no-diff

  Removes the diff display (this happens automatically if `diff` can’t be found)

-n or --new

  Also prints new files (i.e. those that can’t be found in fish’s default directories).

-Vvalue or --vendor=value

  Determines how the vendor directories are counted. Valid values are:

  - “default” - counts vendor files as belonging to the defaults. Any changes in other directories will be counted as changes over them. This is the default.

  - “user” - counts vendor files as belonging to the user files. Any changes in them will be counted as new or changed files.

  - “ignore” - ignores vendor directories. Files of the same name will be counted as “new” if no file of the same name in fish’s default directories exists.

-h or --help

  Prints `fish_delta`’s help (this).

## Example

Running just:

    fish_delta

will give you a list of all your changed functions and completions, including diffs (if you have the `diff` command).

It might look like this:

    > fish_delta
    New: /home/alfa/.config/fish/functions/battery.fish
    Changed: /home/alfa/.config/fish/test/completions/cargo.fish
    --- /home/alfa/.config/fish/test/completions/cargo.fish 2022-09-02 12:57:55.579229959 +0200
    +++ /usr/share/fish/completions/cargo.fish      2022-09-25 17:51:53.000000000 +0200
    # the output of `diff` follows

The options are there to select which parts of the output you want. With `--no-completions` you can compare just functions, and with `--no-diff` you can turn off the `diff` display.

To only compare your `fish_git_prompt`, you might use:

    fish_delta --no-completions fish_git_prompt

which will only compare files called “fish_git_prompt.fish”.