# Ken Powers' Dotfiles

These are my configuration files. Take a look at how I configure my shell and
feel free to use ideas or suggest improvements.

## Installation

1. Clone this repository to `$HOME/.dotfiles`.
1. Follow the instructions in the `etc` directory to set up system settings.
1. Run `./install.sh`.
1. Optionally follow the instructions in [`./vendor/packages`] to install
   packages I use on a regular basis.

## Structure

Everything in `home` is linked to `$HOME/.$file`. Old links are overridden /
updated and dead links are deleted. `lib` contains any files which should not
necessarily be linked to in `$HOME`. `etc` contains configuration miscellaneous
tools. `vendor` contains subtrees for external repositories.

## Other Tips

### Xcode

If you need to accept the xcode license at any point for some reason:

```sh
sudo xcodebuild -license
```

### Not Ken?

If your name is not Ken Powers you will probably want to edit
[`./home/gitconfig`][gitc] to have your information. You can do this on your
own branch to make pulling upstream changes easier.

[Homebrew]: http://brew.sh/ "Homebrew"
[`./vendor/packages`]: vendor/packages "./vendor/packages"
[gitc]: ./home/gitconfig "gitconfig"

# Ken Powers' Dotfiles

These are my configuration files. Take a look at how I configure my shell and
feel free to use ideas or suggest improvements.

## Installation

1. Clone this repository to `$HOME/.dotfiles`.
1. Follow the instructions in the `etc` directory to set up system settings.
1. Run `./install.sh`.
1. Optionally follow the instructions in [`./vendor/packages`] to install
   packages I use on a regular basis.

## Structure

Everything in `home` is linked to `$HOME/.$file`. Old links are overridden /
updated and dead links are deleted. `lib` contains any files which should not
necessarily be linked to in `$HOME`. `etc` contains configuration miscellaneous
tools. `vendor` contains subtrees for external repositories.

## Other Tips

### Xcode

If you need to accept the xcode license at any point for some reason:

```sh
sudo xcodebuild -license
```

### Not Ken?

If your name is not Ken Powers you will probably want to edit
[`./home/gitconfig`][gitc] to have your information. You can do this on your
own branch to make pulling upstream changes easier.

### Private Environment Variables

You can create a file at `home/env.local.zsh` which will be `source`d by
`home/zshenv`. `*.local.zsh` is in this repository's `.gitignore` file so you
don't have to worry about sensitive data being committed to the repository.

[Homebrew]: http://brew.sh/ "Homebrew"
[`./vendor/packages`]: vendor/packages "./vendor/packages"
[gitc]: ./home/gitconfig "gitconfig"

Add note about private environment variables.
Add note about private environment variables.
