f701b4de0fb55b71e2cfb17522a08fba741ff170

 1diff --git a/plugins/globalias/README.md b/plugins/globalias/README.md
 2index db2e5bee0a1f7c9d7b02fef176fb224f2a3ddb19..ba9888ccb9a6098dd2d0c698c09e2a3525efb801 100644
 3--- a/plugins/globalias/README.md
 4+++ b/plugins/globalias/README.md
 5@@ -1,37 +1,62 @@
 6-#Globalias
 7+# Globalias plugin
 8 
 9+Expands all glob expressions, subcommands and aliases (including global).
10 
11-Expands all globes, backtick expressions and aliases(including global).
12+Idea from: http://blog.patshead.com/2012/11/automatically-expaning-zsh-global-aliases---simplified.html.
13+
14+## Usage
15+
16+Add `globalias` to the plugins array in your zshrc file:
17+
18+```zsh
19+plugins=(... globalias)
20+```
21+
22+Then just press `SPACE` to trigger the expansion of a command you've written.
23+
24+If you only want to insert a space without expanding the command line, press
25+`CTRL`+`SPACE`.
26+
27+## Examples
28+
29+#### Glob expressions
30 
31 ```
32 $ touch {1..10}<space>
33-#expands to
34+# expands to
35 $ touch 1 2 3 4 5 6 7 8 9 10
36 
37+$ ls **/*.json<space>
38+# expands to
39+$ ls folder/file.json anotherfolder/another.json
40+```
41+
42+#### Subcommands
43+
44+```
45 $ mkdir "`date -R`"
46-#expands to
47+# expands to
48 $ mkdir Tue,\ 04\ Oct\ 2016\ 13:54:03\ +0300
49 
50-#.zshrc:
51+```
52+
53+#### Aliases
54+
55+```
56+# .zshrc:
57 alias -g G="| grep --color=auto -P"
58 alias l='ls --color=auto -lah'
59 
60 $ l<space>G<space>
61-#expands to
62+# expands to
63 $ ls --color=auto -lah | grep --color=auto -P
64-
65-ls **/*.json<space>
66-#expands to
67-ls folder/file.json anotherfolder/another.json
68 ```
69 
70-####Returns autocompletion to your custom aliases:
71 ```
72-#.zsrc
73+# .zsrc:
74 alias S="sudo systemctl"
75 
76 $ S<space>
77-#expands to:
78-sudo systemctl s<tab>
79-#trigger autocompletion
80+# expands to:
81+$ sudo systemctl
82 ```