diff options
| author | romkatv <roman.perepelitsa@gmail.com> | 2019-12-02 15:09:06 +0300 |
|---|---|---|
| committer | romkatv <roman.perepelitsa@gmail.com> | 2019-12-02 15:09:06 +0300 |
| commit | e0697c200f730afd372bd63522bb11a8c1b1e00b (patch) | |
| tree | 28da96267f246dd4962f0667dca33af9a978b60c /README.md | |
| parent | ac2f387dfd68007801ab75004b076e89ce88eab9 (diff) | |
add Git status description to FAQ
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 30 |
1 files changed, 30 insertions, 0 deletions
@@ -36,6 +36,8 @@ it will generate the same prompt. 1. [Why is my right prompt in the wrong place?](#why-is-my-right-prompt-in-the-wrong-place) 1. [I cannot install the recommended font. Help!](#i-cannot-install-the-recommended-font-help) 1. [Why do I have a question mark symbol in my prompt? Is my font broken?](#why-do-i-have-a-question-mark-symbol-in-my-prompt-is-my-font-broken) + 1. [What do different symbols in Git status mean?](#what-do-different-symbols-in-git-status-mean) + 1. [How do I change the format of Git status?](#how-do-i-change-the-format-of-git-status) 1. [Why does Powerlevel10k spawn extra processes?](#why-does-powerlevel10k-spawn-extra-processes) 1. [Are there configuration options that make Powerlevel10k slow?](#are-there-configuration-options-that-make-powerlevel10k-slow) 1. [Is Powerlevel10k fast to load?](#is-powerlevel10k-fast-to-load) @@ -398,6 +400,34 @@ some glyphs. To fix this problem, [install the recommended font](#recommended-meslo-nerd-font-patched-for-powerlevel10k) and run `p10k configure`. +### What do different symbols in Git status mean? + +When using *Lean*, *Classic* or *Rainbow* style, Git status may look like this: + +```text +feature:master ⇣42⇡42 *42 merge ~42 +42 !42 ?42 +``` + +| Symbol | Meaning | Source | +| --------- | -------------------------------------------------------------------- | ------------------------------------------------------ | +| `feature` | current branch; replaced with `#tag` or `@commit` if not on a branch | `git status` | +| `master` | remote tracking branch; only shown if different from local branch | `git rev-parse --abbrev-ref --symbolic-full-name @{u}` | +| `⇣42` | this many commits behind the remote | `git status` | +| `⇡42` | this many commits ahead of the remote | `git status` | +| `*42` | this many stashes | `git stash list` | +| `merge` | repository state | `git status` | +| `~42` | this many merge conflicts | `git status` | +| `+42` | this many staged changes | `git status` | +| `!42` | this many unstaged changes | `git status` | +| `?42` | this many untracked files | `git status` | + +See also: [How do I change the format of Git status?](#how-do-i-change-the-format-of-git-status) + +### How do I change the format of Git status? + +To change the format of Git status, open `~/.p10k.zsh`, search for `my_git_formatter` and edit its +source code. + ### Why does Powerlevel10k spawn extra processes? Powerlevel10k uses [gitstatus](https://github.com/romkatv/gitstatus) as the backend behind `vcs` |