trovl add

Adds a symlink that points to the target file

Synopsis

When possible, add a true symlink (as in, not a junction or hard link) to a target file.

  • If a symlink already exists at the specified location, the user will be prompted on if they want to overwrite it with the new link.
  • If a directory already exists at the specified location for the symlink, an error will occur.
  • If a single, ordinary file already exists at the specified location for the symlink, the user will be prompted on if they want to backup the file.

When backing up a file that would be overwritten by this new symlink, trovl always uses $XDG_CACHE_HOME first, before falling back to OS defaults. The backup directory is $XDG_CACHE_HOME/trovl/backups. See trovl’s use of environment variables to learn more.

1

trovl add <target> <symlink> [target2, symlink2, ...] [flags]

Examples 

1

trovl add ~/dotfiles/.vimrc ~/.vimrc

Options 

1
2
3
4
5
6
7

      --backup              backup existing single files if a symlink would overwrite it
      --backup-dir string   specify where to backup files (default: $XDG_CACHE_HOME/trovl/backups)
  -h, --help                help for add
      --no-backup           do not backup existing files and abandon symlink creation
      --no-overwrite        do not overwrite any existing symlinks
      --overwrite           overwrite any existing symlinks
      --relative            retain relative paths to target

Options inherited from parent commands 

1
2
3

      --debug     show debug info
      --dry-run   walk through an operation without making changes
  -v, --verbose   have verbose outputs for actions taken

SEE ALSO

  • trovl - A cross-platform symlink manager.