Configs

The following operations act upon the Configs directory:

• status: reads the state of all dotfiles and displays them in a digestible form

• add: tries to symlink all unsymlinked dotfiles, if the dotfile is marked as not_owned they're ignored unless explicitly told to not do so

• rm: remove all symlinked dotfiles

Status

When status is run with no arguments:

$ tuckr status

it checks the status of all programs and displays it, returning either 0 or 1 depending on whether there were any remaining unsymlinked dotfiles.
If one wishes to check the status of individual or multiple programs that is achieved by running:

tuckr status program...

When returning tuckr returns an error code pertaining to the specified programs.

Add

The add command symlinks unsymlinked groups, returning an error code in case of failure symlinking. By default add ignores all conflicting files, conflicts should be handled by checking the status command and deciding whether to adopt or override conflicts.

Say there's a group foo in conflict, to adopt the system's dotfile:

$ tuckr add -a foo

To override conflicts:

$ tuckr add -f foo

Rm

The remove command removes dotfiles marked as symlinked, it only returns an error if there was a failure to remove files. It accepts either a single program or multiple

$ tuckr rm foo
$ tuckr rm foo bar

Globbing and exluding programs

Globbing permits you to select every group at once. if there are conditional groups, only the groups that are valid on your platform will be selected, if you still wanted to use conditional groups that would not be valid you would have to type them out manually.

$ tuckr add \*

Exclusion permits you to exclude certain groups, it always works but it's its most useful when paired with globbing:

$ tuckr add \* -e foo,bar
$ tuckr rm \* -e foo,bar

Note: on some systems the glob symbol * is not part of the shell's operators and thus do not need to be escaped.