diff --git a/Plugin:svn.md b/Plugin:svn.md
index fea203f..a824bbb 100644
--- a/Plugin:svn.md
+++ b/Plugin:svn.md
@@ -1,19 +1,25 @@
 # `svn` plugin
 
+This plugin adds some utility functions to display additional information regarding your current svn reositiory. 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 (bug: returns the first path element if branches not used) |
+|svn_get_rev_nr          | revision number                         |
 |svn_dirty               | changes in this subversion repo         |
 
-##Usage
-###Agnoster theme git-like prompt
+## Caveats
+
+The plugin expects the first directory to be the current branch / tag / trunk.
+
+## Usage
+
+### Agnoster theme git-like prompt
 
 Enable the svn plugin and add the followind lines to your ```~/.zshrc```