NOTE: This page is mostly for myself, unless you're interested

dotfile-utils

If you plan on using these scripts, it is assumed by default that this repo is stored in $HOME/.dotfiles (so that README.md is located at $HOME/.dotfiles/README.md).

If you wish to store this repo elsewhere, change these environment variables accordingly:

• BAK_DEST: Destination to backup dotfiles to, either during restoration or backup.
• ORIGIN: If restoring, this is the location of the NEW dotfiles (probably the location of this repo). If backing up, this is where you're CURRENT dotfiles are located (probably $HOME).
• REPO_LOC: Location of this repo. Default: $HOME/.dotfiles

Scripts:

• restdots: backs up current conflicting dotfiles and restores the new dotfiles to those locations.
  • Default backup location when restoring is $HOME/.dotfiles/restback
• backdots: backs up current dotfiles by OVERWRITING THE FILES IN THIS REPOSITORY by default.
  • Define BAK_DEST and ORIGIN environment variables as needed.
• pulldots: Essentially just a git pull from origin.
  • Define the REPO_LOC environment variable if not using the default location.
• pushdots: A git add, commit (with your commit message), and push to origin/master of the entire repo.
• extsetup: Extra setup commands. (i.e. xrdb ~/.Xresources)

Examples:

# Restore using default paths
./restdots

# Restore using alternate repo location
REPO_LOC="/some/alt/location/dotfiles" ./restdots

# Backup dotfiles using default paths
./backdots

# Push dotfiles to origin/master with a commit message from the default repo location.
./pushdots "This is what I changed"

# Pull dotfiles from origin/master.
./pulldots

# Pull and restore the new dotfiles from the repository (origin/master).
./pulldots && ./restdots

# Backup and push your current dotfiles to the repository with a commit message (origin/master).
./backdots && ./pushdots "This is what I changed."

# Every other command that needs to run for installation.
./extsetup