mate rename¶
Rename a managed file
Synopsis¶
Rename a managed file in both source and target.
This renames the source file, the target file, and updates tracking.
Attributes belong to the source file only; the target is always named without them. If <new-name> has no attributes, the source keeps the ones it already has. If it has any, they replace the source's attributes, so give the full set. #encrypted cannot be added or dropped this way, since that would not change the content: use 'mate encrypt' or 'mate decrypt'.
Hooks matching the old or the new target path run afterwards, with a confirmation prompt (see 'mate hooks').
mate rename <source> <new-name> [flags]
Examples¶
mate rename nvim/init.lua init.vim
mate rename zsh/.zshrc .zshrc.bak
mate rename git/.gitconfig#template .gitconfig.local
(source becomes .gitconfig.local#template, target .gitconfig.local)
mate rename ssh/.ssh/config config#perm:600
(changes only the attributes; the target keeps its name)
Options¶
-h, --help help for rename
Options inherited from parent commands¶
-c, --config string config file (default: mate.yaml in $STATEMATE_DIR if set, else in the local config's source_dir, else in the current directory)
-p, --profile string override auto-detected profile
SEE ALSO¶
- mate - Statemate - system configuration management