Document installer backup process

Marc Cornellà 2022-11-07 18:48:27 +01:00
parent 70d62acd75
commit 2ca298c5b2
No known key found for this signature in database
GPG Key ID: 0314585E776A9C1B

26
FAQ.md

@ -22,6 +22,8 @@ _If you don't find what you're looking for, and you think it should be covered b
- [How do I reset the completion cache?](#how-do-i-reset-the-completion-cache) - [How do I reset the completion cache?](#how-do-i-reset-the-completion-cache)
- [How do I manually update Oh My Zsh from a script?](#how-do-i-manually-update-oh-my-zsh-from-a-script) - [How do I manually update Oh My Zsh from a script?](#how-do-i-manually-update-oh-my-zsh-from-a-script)
- [Common problems](#common-problems) - [Common problems](#common-problems)
- [Installation](#installation)
- [My .zshrc file was deleted on install](#my-zshrc-file-was-deleted-on-install)
- [Font issues](#font-issues) - [Font issues](#font-issues)
- [I have a weird character in my prompt](#i-have-a-weird-character-in-my-prompt) - [I have a weird character in my prompt](#i-have-a-weird-character-in-my-prompt)
- [Completion issues](#completion-issues) - [Completion issues](#completion-issues)
@ -192,6 +194,30 @@ Another option is to use the `omz` CLI. The `omz update` command triggers an upd
## Common problems ## Common problems
### Installation
#### My .zshrc file was deleted on install
The installer script is designed to back up your existing `.zshrc` file, and any previous backups are also preserved.
This is the current behavior of the installer, so you can search for the backup file and restore it manually.
> NOTE: `~` is the path to the home directory.
a. If a `.zshrc` file is not found, write and modify the template zshrc file to `~/.zshrc`.
b. If otherwise the `.zshrc` exists, start the back up process:
1. If `~/.zshrc.pre-oh-my-zsh` exists, back it up to `~/.zshrc.pre-oh-my-zsh-<current-datetime>`, where `<current-datetime>` is in the format `YYYY-mm-dd_HH-MM-SS`. **If this destination file exists, the installer is aborted**.
2. After `~/.zshrc.pre-oh-my-zsh` is backed up, back up the existing `.zshrc` file to `~/.zshrc.pre-oh-my-zsh`.
3. **Only then write the template zshrc file to `~/.zshrc`.**
As you can see, the installer is designed to never delete any existing files, even if the installer is ran multiple times.
If you find that your `.zshrc` file was deleted, you can search for the backup file with the command below:
```sh
ls -l ~/.zshrc*
```
### Font issues ### Font issues
#### I have a weird character in my prompt #### I have a weird character in my prompt