mirrors/dotdrop
1
0
Fork 0
mirror of https://github.com/deadc0de6/dotdrop.git synced 2026-02-04 17:24:46 +00:00
Code Activity

update chmod doc

Browse Source
This commit is contained in:
deadc0de6
2020-11-14 15:04:25 +01:00
parent 2f17d36ffb
commit ae15569041
1 changed files with 11 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
docs/config.md
View File

@@ -61,27 +61,29 @@ Here are some rules on the use of variables in configs:
## Permissions
Dotfile allows to control the permission applied to a dotfile using the
config dotfile entry `chmod`.
A `chmod` entry on a directory is applied to the directory only, not recursively.
Dotdrop allows to control the permission applied to a dotfile using the
config dotfile entry [chmod](config-format.md#dotfiles-entry).
A [chmod](config-format.md#dotfiles-entry) entry on a directory is applied to the
directory only, not recursively.
On `import` the following rules are applied:
* if the `-m --preserve-mode` switch is provided the imported file permissions are
stored in a `chmod` entry
* if imported file permissions differ from umask then its permissions are automatically
stored in the `chmod` entry
* if imported file permissions differ from umask its permissions are automatically
stored in the `chmod` entry
* otherwise no `chmod` entry is added
On `install` the following rules are applied:
* if `chmod` is specified in the dotfile, it will be applied to the installed dotfile
* if file exists and its permissions differ from `umask` and no `chmod` is specified user needs
to confirm installation (unless `-f --force` is used or the permission match the dotfile in the `dotpath`)
* if no `chmod` is specified and the file exists on the filesystem with different permissions than the file in the `dotpath`
then the user needs to confirm the dotfile installation (unless `-f --force` is used)
On `update`:
* no `chmod` entry is added/updated in the config however the rights are mirrored from the filesystem to the
file in `dotpath`
* no `chmod` entry is added/updated in the config however the rights are mirrored
from the filesystem to the dotfile in the `dotpath`
## Symlink dotfiles