Update outdated documentation

This commit is contained in:
xylous 2021-06-19 09:49:03 +03:00
parent a48e4eaf4f
commit a520bad83d

View File

@ -1,14 +1,14 @@
# gitstatus.zsh # gitstatus.zsh
`gitstatus` is a zsh plugin that you can add to your prompt to help you see what `gitstatus.zsh` is a plugin made for prompts - it tells you how many things have
you're doing in a git repository more easily. changed since the last git commit in a repository.
## Why such a thing? ## Why such a thing?
Frankly, it's because I needed something small and fast that would integrate Frankly, it's because I needed something small and fast that would integrate
well with my (multi-line) prompt. well with my (multi-line) prompt.
Is it useful? For myself at least, yes. Is it useful? For me and probably a handful other people, yes.
## Getting Started ## Getting Started
@ -36,26 +36,20 @@ Add the following lines to your zshrc:
```zsh ```zsh
function precmd() function precmd()
{ {
source path/to/installation/gitstatus.plugin.zsh local gitstatus="$(path/to/installation/gitstatus.plugin.zsh)"
PS1="%F{blue}%~%F{default} $gitstatus $ "
} }
``` ```
`precmd()` is a zsh builtin that executes a series of commands right before the `precmd()` is a zsh builtin function that executes a series of commands right
prompt is drawn. before the prompt is drawn. In this example, it updates the output of the
`gitstatus` script and then uses it in a prompt.
NOTE: you will have to redefine your prompt to include the variable And of course, remember to replace `path/to/installation` with the actual path
`$GIT_STATUS`, which is exported to the environment by this plugin. Something to the program.
like this:
```zsh
PS1="%F{blue}%~%F{default} $GIT_STATUS $ "
```
## Roadmap ## Roadmap
- [ ] Find a way to not source the script every time a new prompt is
drawn
- [ ] Add bash support
- [ ] Add screenshots - [ ] Add screenshots
## Contributing ## Contributing