* dotfiles

*** selection

| class | instance |
|-|-|
| hw | [[https://frame.work/laptop13][framework 13]], [[https://docs.keeb.io/iris-rev3-build-guide/][iris]] |
| env | [[https://voidlinux.org/][void]] [[https://www.kernel.org/][linux]], [[https://yalter.github.io/niri/][niri]], [[https://www.gnu.org/software/bash/][bash]], [[https://www.tcl.tk/][tcl]] |
| look | [[https://github.com/blobject/cemant][cemant]], [[https://picaq.github.io/sarasa/][sarasa]], [[https://developer.apple.com/fonts/][sf pro]], [[https://github.com/blobject/agave][agave]] |

*** scripts

| name | description |
|-|-|
| *[[__shell/bin/00][00]]* | *run* file(s) based on mimetype (like =xdg-open=) |
| *[[__shell/bin/0c][0c]]* | pass *command* string to tcl |
| *[[__shell/bin/0l][0l]]* | read *log* |
| *[[__shell/bin/0m][0m]]* | wrap [[https://www.x.org/wiki/Projects/XRandR/][xrandr]] |
| *[[__shell/bin/0s][0s]]* | *system* utilities |
| *[[__shell/bin/0t][0t]]* | graphical *shell* utilities |
| *[[__shell/bin/0u][0u]]* | general utilities |
| *[[__shell/bin/0v][0v]]* | wrap [[https://www.qemu.org/][qemu]] |
| *[[__shell/bin/lib.tcl][lib.tcl]]* | *help* =0*= tcl scripts |


| *[[stow.tcl]]* | prep and link all user files |
| *[[load.tcl]]* | setup entire system + user configuration from scratch |

*** usage

**** keep a user configuration file

1. Let's say this repository is saved as =dotfiles= and you are in it.
2. Create a directory with a name of your choice, prepending =_=.
3. ~cd~ inside the new directory.
4. Pretending that you are at =$HOME=, recreate the location of the configuration file.
  - For example, say you want to back up [[https://wiki.archlinux.org/title/XDG_MIME_Applications#mimeapps.list][mimeapps.list]]. Create the path of folders =...dotfiles/_mime/.config=, and write the file =...dotfiles/_mime/.config/mimeapps.list=.

*Note*: Sometimes, a subpath may not exist, and that will affect both keeping and loading. Say you want to keep =$HOME/.config/foo/bar.txt=, but =$HOME/.config= doesn't exist yet. If you call ~./stow.tcl~ now to load everything, a link called =$HOME/.config= will be created referencing somewhere in =dotfiles=. When other files get put into =$HOME/.config=, all those files (even those you don't want to keep) will actually reside in this repository!

For this reason, edit the =fend= list inside =stow.tcl=. For the above example, add =.config= to the list (to link =foo/=) or add =.config/foo= (to link =bar.txt=).

**** load/restore all user configuration files

*Note*: If you don't want to load some =_configuration=, place it in =disabled= first.

1. Go to the =dotfiles= root directory.
2. ~./stow.tcl~

**** load entire system configuration

*IMPORTANT*: Customised to my system. Will most likely bork your system.

/WIP/

1. Go to the =dotfiles= root directory.
2. ~./load.tcl~
  - presumes: drives prepped; base system and tcl installed; internet available

**** remove a user configuration file.

/WIP/

1. Find the link and manually ~rm~ it.