shell-user/oh-my-zsh
1
0
Fork 0
mirror of https://github.com/ohmyzsh/ohmyzsh.git synced 2024-05-11 05:55:17 +00:00
Code Issues Projects Releases Wiki Activity

Clean up plugin READMEs and a few plugins

Browse Source 
- fasd
- history
- mercurial
- pylint
- repo
- yii2
This commit is contained in:
Marc Cornellà
2020-03-11 19:57:46 +01:00
parent ff6d111d79
commit 610b2529d2
73 changed files with 528 additions and 535 deletions
Download Patch File Download Diff File Expand all files Collapse all files

97
plugins/mercurial/README.md
View File

@@ -1,61 +1,66 @@
# Mercurial plugin
### Usage
Update .zshrc:
1. Add name to the list of plugins, e.g. `plugins=(... mercurial ...)`
(that is pretty obvious).
2. Switch to a theme which uses `hg_prompt_info`.
This plugin adds some handy aliases for using Mercurial as well as a few
utility and prompt functions that can be used in a theme.
Or, customize the `$PROMPT` variable of your current theme to contain current folder mercurial repo info. This can be done by putting a custom version of the theme in `$ZSH_CUSTOM` or by changing `$PROMPT` in `.zshrc` after loading the theme.
To use it, add `mercurial` to the plugins array in your zshrc file:
The `robbyrussell` theme is used by default, so you need to modify `$PROMPT` var by adding `$(hg_prompt_info)` after `$(git_prompt_info)`, so it looks like this:
```zsh
plugins=(... mercurial)
```
```zsh
PROMPT='${ret_status}%{$fg_bold[green]%}%p %{$fg[cyan]%}%c %{$fg_bold[blue]%}$(git_prompt_info)$(hg_prompt_info)%{$fg_bold[blue]%} % %{$reset_color%}'
```
## Aliases
3. Initialize additional vars used in plugin. So in short put next in **.zshrc**:
| Alias | Command |
|--------|-------------------------------------------------------------------------------------------------------------|
| `hga` | `hg add` |
| `hgc` | `hg commit` |
| `hgca` | `hg commit --amend` |
| `hgb` | `hg branch` |
| `hgba` | `hg branches` |
| `hgbk` | `hg bookmarks` |
| `hgco` | `hg checkout` |
| `hgd` | `hg diff` |
| `hged` | `hg diffmerge` |
| `hgp` | `hg push` |
| `hgs` | `hg status` |
| `hgsl` | `hg log --limit 20 --template "{node|short} | {date|isodatesec} | {author|user}: {desc|strip|firstline}\n"` |
| `hgun` | `hg resolve --list` |
| `hgi` | `hg incoming` |
| `hgl` | `hg pull -u` |
| `hglr` | `hg pull --rebase` |
| `hgo` | `hg outgoing` |
```
ZSH_THEME_HG_PROMPT_PREFIX="%{$fg_bold[magenta]%}hg:(%{$fg[red]%}"
ZSH_THEME_HG_PROMPT_SUFFIX="%{$reset_color%}"
ZSH_THEME_HG_PROMPT_DIRTY="%{$fg[magenta]%}) %{$fg[yellow]%}✗%{$reset_color%}"
ZSH_THEME_HG_PROMPT_CLEAN="%{$fg[magenta]%})"
```
## Prompt usage
### What's inside?
#### Adds handy aliases:
###### general
* `hga` - 'hg add`
* `hgc` - `hg commit`
* `hgb` - `hg branch`
* `hgba` - `hg branches`
* `hgbk` - `hg bookmarks`
* `hgco` - `hg checkout`
* `hgd` - `hg diff`
* `hged` - `hg diffmerge`
- Switch to a theme which uses `hg_prompt_info`
###### pull and update
* `hgi` - `hg incoming`
* `hgl` - `hg pull -u`
* `hglr` - `hg pull --rebase`
* `hgo` - `hg outgoing`
* `hgp` - `hg push`
* `hgs` - `hg status`
* `hgsl` - `hg log --limit 20 --template "{node|short} | {date|isodatesec} | {author|user}: {desc|strip|firstline}\n"`
- Or customize the `$PROMPT` variable of your current theme to contain current folder mercurial repo info.
This can be done by putting a custom version of the theme in `$ZSH_CUSTOM` or by changing `$PROMPT` in
`.zshrc` after loading the theme.
###### this is the 'git commit --amend' equivalent
* `hgca` - `hg qimport -r tip ; hg qrefresh -e ; hg qfinish tip`
For example, for the `robbyrussell` theme you need to modify `$PROMPT` var by adding `$(hg_prompt_info)`
after `$(git_prompt_info)`, so it looks like this:
###### list unresolved files (since hg does not list unmerged files in the status command)
* `hgun` - `hg resolve --list`
```zsh
PROMPT='${ret_status}%{$fg_bold[green]%}%p %{$fg[cyan]%}%c %{$fg_bold[blue]%}$(git_prompt_info)$(hg_prompt_info)%{$fg_bold[blue]%} % %{$reset_color%}'
```
#### Displays repo branch and directory status in prompt
This is the same as git plugin does.
You can also redefine additional vars used in the plugin (after Oh My Zsh is sourced):
**Note**: Additional changes to **.zshrc**, or using a theme designed to use `hg_prompt_info`, are required in order for this to work.
```zsh
ZSH_THEME_HG_PROMPT_PREFIX="%{$fg_bold[magenta]%}hg:(%{$fg[red]%}"
ZSH_THEME_HG_PROMPT_SUFFIX="%{$reset_color%}"
ZSH_THEME_HG_PROMPT_DIRTY="%{$fg[magenta]%}) %{$fg[yellow]%}✗%{$reset_color%}"
ZSH_THEME_HG_PROMPT_CLEAN="%{$fg[magenta]%})"
```
### Mantainers
[ptrv](https://github.com/ptrv) - original creator
### Display repo branch and directory status in prompt
[oshybystyi](https://github.com/oshybystyi) - created this README and know how most of code works
This is the same as git plugin does. **Note**: additional changes to `.zshrc`, or using a theme designed
to use `hg_prompt_info`, are required in order for this to work.
## Mantainers
- [ptrv](https://github.com/ptrv): original creator
- [oshybystyi](https://github.com/oshybystyi)