timestamps v1
This commit is contained in:
@@ -3,6 +3,7 @@
|
||||
This repo is managed by **Sigil**, a minimal symlink-based dotfile tool.
|
||||
|
||||
## Repo layout
|
||||
|
||||
```
|
||||
~/.dotfiles/
|
||||
<package>/
|
||||
@@ -14,6 +15,7 @@ This repo is managed by **Sigil**, a minimal symlink-based dotfile tool.
|
||||
Each package has a `config.lua` that defines its target path per OS.
|
||||
|
||||
## Common commands
|
||||
|
||||
- `sigil apply` — apply symlinks (prompts for stale links)
|
||||
- `sigil apply --prune` — prune stale links without prompting
|
||||
- `sigil add <path>` — add a file/dir to the repo and symlink it
|
||||
@@ -22,13 +24,16 @@ Each package has a `config.lua` that defines its target path per OS.
|
||||
- `sigil remove <spec>` — same as unlink, plus remove package/subpath from repo
|
||||
|
||||
## Spec formats
|
||||
|
||||
`unlink/remove` accept these:
|
||||
|
||||
- `package` (entire package)
|
||||
- `package:relative/path`
|
||||
- repo path: `~/.dotfiles/<pkg>/files/...`
|
||||
- target path: e.g. `~/.config/<app>/...`
|
||||
|
||||
Examples:
|
||||
|
||||
```
|
||||
sigil unlink wezterm
|
||||
sigil unlink wezterm:lua
|
||||
@@ -37,5 +42,10 @@ sigil unlink ~/.config/wezterm/wezterm.lua
|
||||
```
|
||||
|
||||
## Notes
|
||||
|
||||
- If a repo file is missing, stale links should be pruned.
|
||||
- Prefer `sigil add` over manual moves into `files/`.
|
||||
|
||||
# Editing dotfiles
|
||||
|
||||
When editing dotfiles, it is preferred to add/edit the files in this project directly, instead of going to the source. this way we can then use sigil apply --prune, and everything will be synced, even when there are new files.
|
||||
|
||||
Reference in New Issue
Block a user