Skip to content

Commit

Permalink
Add FAQ section
Browse files Browse the repository at this point in the history
Document workaround for `stow` error on macOS. Closes #7.
  • Loading branch information
unixorn committed Sep 7, 2018
1 parent 5906269 commit 0a31d3e
Showing 1 changed file with 16 additions and 0 deletions.
16 changes: 16 additions & 0 deletions Readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,8 @@
- [ZSH options.](#zsh-options)
- [Self-update Settings](#self-update-settings)
- [Changing the zgen plugin list](#changing-the-zgen-plugin-list)
- [FAQ](#faq)
- [Stow complains with a Warning! that stowing zsh would cause conflicts](#stow-complains-with-a-warning-that-stowing-zsh-would-cause-conflicts)
- [Other Resources](#other-resources)
- [ZSH](#zsh)
- [Dotfiles in general](#dotfiles-in-general)
Expand Down Expand Up @@ -178,6 +180,20 @@ It's a pain to create `.zgen-local-plugins` from scratch, so to make customizing

Copy that to your `$HOME/.zgen-local-plugins`, change the list and the next time you start a terminal session you'll get your list instead of mine.

# FAQ

## Stow complains with a Warning! that stowing zsh would cause conflicts

You ran `stow --target=/Users/YourUsername zsh` in the top level of the repo, and stow printed the following error:

```
WARNING! stowing zsh would cause conflicts:
* existing target is neither a link nor a directory: .zshrc
All operations aborted.
```

Per @jefheaton, this is caused when trying to replace an existing `.zshrc` file. He fixed it by closing `~` in Finder so Finder wouldn't create a `.DS_Store` file, deleting the existing `.DS_Store`, and then removing the old `.zshrc`. You may have to rename it first if ZSH is keeping the file open, then deleting it after closing all your Terminal/iTerm 2 windows.

# Other Resources

## ZSH
Expand Down

0 comments on commit 0a31d3e

Please sign in to comment.