Clean up svn README

This commit is contained in:
Marc Cornellà 2016-09-29 13:56:16 +02:00
parent 364019a3c9
commit f573247a59

View File

@ -1,64 +1,67 @@
# `svn` plugin # `svn` plugin
This plugin adds some utility functions to display additional information regarding your current This plugin adds some utility functions to display additional information regarding your current
svn repsitiory. See http://subversion.apache.org/ for the full svn documentation. svn repository. See http://subversion.apache.org/ for the full svn documentation.
## Functions
| Command | Description |
|:-----------------------|:----------------------------------------|
|svn_prompt_info | prompt for some themes |
|in_svn | within svn directory |
|svn_get_repo_name | |
|svn_get_branch_name | branch name (see caveats) |
|svn_get_rev_nr | revision number |
|svn_dirty | changes in this subversion repo |
## Caveats
The plugin expects the first directory to be the current branch / tag / trunk. So, it returns
the first path element if you don't use branches.
## Usage
To use it, add `svn` to your plugins array: To use it, add `svn` to your plugins array:
```sh
```zsh
plugins=(... svn) plugins=(... svn)
``` ```
### Agnoster theme git-like prompt ## Functions
Enable the svn plugin and add the followind lines to your ```~/.zshrc``` | Command | Description |
|:----------------------|:--------------------------------------------|
| `svn_prompt_info` | Shows svn prompt in themes |
| `in_svn` | Checks if we're in an svn repository |
| `svn_get_repo_name` | Get repository name |
| `svn_get_branch_name` | Get branch name (see [caveats](#caveats)) |
| `svn_get_rev_nr` | Get revision number |
| `svn_dirty` | Checks if there are changes in the svn repo |
```shell ## Caveats
prompt_svn() {
local rev branch The plugin expects the first directory to be the current branch / tag / trunk. So it returns
if in_svn; then the first path element if you don't use branches.
rev=$(svn_get_rev_nr)
branch=$(svn_get_branch_name) ## Usage on themes
if [ `svn_dirty_choose_pwd 1 0` -eq 1 ]; then
prompt_segment yellow black To use this in the `agnoster` theme follow these instructions:
echo -n "$rev@$branch"
echo -n "±" 1. Enable the svn plugin
else
prompt_segment green black 2. Add the following lines to your `zshrc` file:
echo -n "$rev@$branch"
```shell
prompt_svn() {
local rev branch
if in_svn; then
rev=$(svn_get_rev_nr)
branch=$(svn_get_branch_name)
if [[ $(svn_dirty_choose_pwd 1 0) -eq 1 ]]; then
prompt_segment yellow black
echo -n "$rev@$branch"
echo -n "±"
else
prompt_segment green black
echo -n "$rev@$branch"
fi
fi fi
fi }
} ```
```
override the agnoster build_prompt() function: 3. Override the agnoster `build_prompt()` function:
```shell ```zsh
build_prompt() { build_prompt() {
RETVAL=$? RETVAL=$?
prompt_status prompt_status
prompt_context prompt_context
prompt_dir prompt_dir
prompt_git prompt_git
prompt_svn prompt_svn
prompt_end prompt_end
} }
``` ```