mj / zsh-config

Download as
Browse Code ยป

Commit 4a1cecfff38ddc501342a7e12bb59617b08a72d1

Authored by Shrikant Sharat
1 parent e9bdca5444

Add notes about antigen and -help commands in README.

Showing 1 changed file with 43 additions and 0 deletions Inline Diff

1 # Antigen 1 # Antigen
2 2
3 Antigen is a small set of functions that help you easily manage your shell (zsh) 3 Antigen is a small set of functions that help you easily manage your shell (zsh)
4 plugins, called bundles. The concept is pretty much the same as bundles in a 4 plugins, called bundles. The concept is pretty much the same as bundles in a
5 typical vim+pathogen setup. Antigen is to zsh, what [Vundle][] is to vim. 5 typical vim+pathogen setup. Antigen is to zsh, what [Vundle][] is to vim.
6 6
7 Please note that this is a very new project and can be considered beta at best. 7 Please note that this is a very new project and can be considered beta at best.
8 That said, I am using antigen full time now on my work machine. Also, please 8 That said, I am using antigen full time now on my work machine. Also, please
9 read the commit comments of the changesets when you pull a new version of 9 read the commit comments of the changesets when you pull a new version of
10 antigen. 10 antigen.
11 11
12 ## Show off 12 ## Show off
13 13
14 > Enough talk. Let's fight! 14 > Enough talk. Let's fight!
15 > -- Po, Kung-fu Panda. 15 > -- Po, Kung-fu Panda.
16 16
17 You're going to experience antigen right in your open shell. No `.zshrc` 17 You're going to experience antigen right in your open shell. No `.zshrc`
18 tweaking and reading the rest of this documentation. Kinda like an ice-cream 18 tweaking and reading the rest of this documentation. Kinda like an ice-cream
19 sample, if you will. 19 sample, if you will.
20 20
21 Get and load antigen. 21 Get and load antigen.
22 22
23 curl https://raw.github.com/zsh-users/antigen/master/antigen.zsh > antigen.zsh 23 curl https://raw.github.com/zsh-users/antigen/master/antigen.zsh > antigen.zsh
24 source antigen.zsh 24 source antigen.zsh
25 25
26 There. You now have all the antigen goodies. Let's try install some plugins. How 26 There. You now have all the antigen goodies. Let's try install some plugins. How
27 about some color to start with. Get the [syntax highlighting plugin][] by 27 about some color to start with. Get the [syntax highlighting plugin][] by
28 running 28 running
29 29
30 antigen-bundle zsh-users/zsh-syntax-highlighting 30 antigen-bundle zsh-users/zsh-syntax-highlighting
31 31
32 Now let it do its thing and once its done and you're back at your prompt, try 32 Now let it do its thing and once its done and you're back at your prompt, try
33 and type a command. See that? Colors! 33 and type a command. See that? Colors!
34 34
35 So, you do git? ruby? git and ruby? There are lots of awesome plugins over at 35 So, you do git? ruby? git and ruby? There are lots of awesome plugins over at
36 oh-my-zsh. Treat yourself to some. 36 oh-my-zsh. Treat yourself to some.
37 37
38 antigen-bundle robbyrussell/oh-my-zsh plugins/ruby 38 antigen-bundle robbyrussell/oh-my-zsh plugins/ruby
39 antigen-bundle robbyrussell/oh-my-zsh plugins/git 39 antigen-bundle robbyrussell/oh-my-zsh plugins/git
40 40
41 There are lots of plugins out there in the wild and people are writing zsh 41 There are lots of plugins out there in the wild and people are writing zsh
42 utilities as small scripts all the time. Antigen is compatible with all of them. 42 utilities as small scripts all the time. Antigen is compatible with all of them.
43 The plugins and scripts don't need any special handling to be compatible with 43 The plugins and scripts don't need any special handling to be compatible with
44 antigen. 44 antigen.
45 45
46 Another example, [kennethreitz's autoenv](autoenv). Just a bundle command away. 46 Another example, [kennethreitz's autoenv](autoenv). Just a bundle command away.
47 47
48 antigen-bundle kennethreitz/autoenv 48 antigen-bundle kennethreitz/autoenv
49 49
50 And boom! you have all the autoenv goodness. Just remember how you used to do 50 And boom! you have all the autoenv goodness. Just remember how you used to do
51 these before antigen, clone it, modify your bashrc to source it, load a new 51 these before antigen, clone it, modify your bashrc to source it, load a new
52 terminal, all just to test it out. Duh! 52 terminal, all just to test it out. Duh!
53 53
54 The side effect of this is that you can tell antigen to grab just about anything 54 The side effect of this is that you can tell antigen to grab just about anything
55 from anyone's `dotfiles` repo, as long as it is in a directory under any repo on 55 from anyone's `dotfiles` repo, as long as it is in a directory under any repo on
56 github. 56 github.
57 57
58 And themes? How would you like a fancy new prompt for yourself? 58 And themes? How would you like a fancy new prompt for yourself?
59 59
60 antigen-theme funky 60 antigen-theme funky
61 61
62 No? Not your taste? There are many themes available to you, check out the 62 No? Not your taste? There are many themes available to you, check out the
63 oh-my-zsh's [page on themes][]. (You can currently only install themes from 63 oh-my-zsh's [page on themes][]. (You can currently only install themes from
64 robbyrussell's, i.e., the canonical oh-my-zsh repo). 64 robbyrussell's, i.e., the canonical oh-my-zsh repo).
65 65
66 Note: Many of those plugins and especially themes, assume you have the core 66 Note: Many of those plugins and especially themes, assume you have the core
67 library of oh-my-zsh loaded. So, if you want to experiment further, issue a 67 library of oh-my-zsh loaded. So, if you want to experiment further, issue a
68 68
69 antigen-lib 69 antigen-lib
70 70
71 and continue until you're tired. At which point you can come back to this page 71 and continue until you're tired. At which point you can come back to this page
72 ;) 72 ;)
73 73
74 ## Usage 74 ## Usage
75 75
76 So, now that you're here, I'll assume you are convinced and want antigen running 76 So, now that you're here, I'll assume you are convinced and want antigen running
77 your shell all the time. Sweet. Let's do it. 77 your shell all the time. Sweet. Let's do it.
78 78
79 First, clone this repo, probably as a submodule if you have your dotfiles in a 79 First, clone this repo, probably as a submodule if you have your dotfiles in a
80 git repo, 80 git repo,
81 81
82 git clone https://github.com/sharat87/antigen.git 82 git clone https://github.com/sharat87/antigen.git
83 83
84 The usage should be very familiar to you if you use Vundle. A typical `.zshrc` 84 The usage should be very familiar to you if you use Vundle. A typical `.zshrc`
85 might look like this 85 might look like this
86 86
87 source /path-to-antigen-clone/antigen.zsh 87 source /path-to-antigen-clone/antigen.zsh
88 88
89 # Load the oh-my-zsh's library. 89 # Load the oh-my-zsh's library.
90 antigen-lib 90 antigen-lib
91 91
92 # Bundles from the default repo (robbyrussell's oh-my-zsh). 92 # Bundles from the default repo (robbyrussell's oh-my-zsh).
93 antigen-bundle git 93 antigen-bundle git
94 antigen-bundle heroku 94 antigen-bundle heroku
95 antigen-bundle pip 95 antigen-bundle pip
96 antigen-bundle lein 96 antigen-bundle lein
97 antigen-bundle command-not-found 97 antigen-bundle command-not-found
98 98
99 # Syntax highlighting bundle. 99 # Syntax highlighting bundle.
100 antigen-bundle zsh-users/zsh-syntax-highlighting 100 antigen-bundle zsh-users/zsh-syntax-highlighting
101 101
102 # Load the theme. 102 # Load the theme.
103 antigen-theme robbyrussell 103 antigen-theme robbyrussell
104 104
105 # Tell antigen that you're done. 105 # Tell antigen that you're done.
106 antigen-apply 106 antigen-apply
107 107
108 Open your zsh with this zshrc and you should see all the bundles you defined 108 Open your zsh with this zshrc and you should see all the bundles you defined
109 here, getting installed. Once its done, you are ready to roll. The complete 109 here, getting installed. Once its done, you are ready to roll. The complete
110 syntax for the `antigen-bundle` command is discussed further down on this page. 110 syntax for the `antigen-bundle` command is discussed further down on this page.
111 111
112 ## Motivation 112 ## Motivation
113 113
114 If you use zsh and [oh-my-zsh][], you know that having many different plugins 114 If you use zsh and [oh-my-zsh][], you know that having many different plugins
115 that are developed by many different authors in a single (sub)repo is not a very 115 that are developed by many different authors in a single (sub)repo is not a very
116 easy to maintain. There are some really fantastic plugins and utilities in 116 easy to maintain. There are some really fantastic plugins and utilities in
117 oh-my-zsh, but having them all in a single repo doesn't really scale well. And I 117 oh-my-zsh, but having them all in a single repo doesn't really scale well. And I
118 admire robbyrussell's efforts for reviewing and merging the gigantic number of 118 admire robbyrussell's efforts for reviewing and merging the gigantic number of
119 pull requests the project gets. It needs a better way of plugin management. 119 pull requests the project gets. It needs a better way of plugin management.
120 120
121 This was discussed on [a][1] [few][2] [issues][3], but it doesn't look like 121 This was discussed on [a][1] [few][2] [issues][3], but it doesn't look like
122 there was any progress made. So, I'm trying to start this off with antigen, 122 there was any progress made. So, I'm trying to start this off with antigen,
123 hoping to better this situation. Please note that I'm by no means a zsh or any 123 hoping to better this situation. Please note that I'm by no means a zsh or any
124 shell script expert (far from it). 124 shell script expert (far from it).
125 125
126 [1]: https://github.com/robbyrussell/oh-my-zsh/issues/465 126 [1]: https://github.com/robbyrussell/oh-my-zsh/issues/465
127 [2]: https://github.com/robbyrussell/oh-my-zsh/issues/377 127 [2]: https://github.com/robbyrussell/oh-my-zsh/issues/377
128 [3]: https://github.com/robbyrussell/oh-my-zsh/issues/1014 128 [3]: https://github.com/robbyrussell/oh-my-zsh/issues/1014
129 129
130 Inspired by vundle, antigen can pull oh-my-zsh style plugins from various github 130 Inspired by vundle, antigen can pull oh-my-zsh style plugins from various github
131 repositories. You are not limited to use plugins from the oh-my-zsh repository 131 repositories. You are not limited to use plugins from the oh-my-zsh repository
132 only and you don't need to maintain your own fork and pull from upstream every 132 only and you don't need to maintain your own fork and pull from upstream every
133 now and then. 133 now and then.
134 134
135 Antigen also lets you switch the prompt theme with one command, just like that 135 Antigen also lets you switch the prompt theme with one command, just like that
136 136
137 bundle-theme candy 137 bundle-theme candy
138 138
139 and your prompt is changed, just for this session of course. 139 and your prompt is changed, just for this session of course.
140 140
141 ## Commands 141 ## Commands
142 142
143 The following are the commands provided by antigen. Note that the `-` in the
144 following commands is kind of optional. You can write `antigen-bundle ...` as
145 `antigen bundle` and get away with it. For more details see the help on
146 `antigen` command further down in this section.
147
143 ### antigen-bundle 148 ### antigen-bundle
144 149
145 This command tells antigen to install (if not already installed) and load the 150 This command tells antigen to install (if not already installed) and load the
146 given plugin. The simplest usage follows the following syntax. 151 given plugin. The simplest usage follows the following syntax.
147 152
148 antigen-bundle <plugin-name> 153 antigen-bundle <plugin-name>
149 154
150 This will install the `plugins/<name>` directory from [robbyrussell's 155 This will install the `plugins/<name>` directory from [robbyrussell's
151 oh-my-zsh][oh-my-zsh] (can be changed by setting `ANTIGEN_DEFAULT_REPO_URL`). 156 oh-my-zsh][oh-my-zsh] (can be changed by setting `ANTIGEN_DEFAULT_REPO_URL`).
152 157
153 However, the above is just syntax sugar for the extended syntax of the 158 However, the above is just syntax sugar for the extended syntax of the
154 `antigen-bundle` command. 159 `antigen-bundle` command.
155 160
156 antigen-bundle [<url> [<loc>]] 161 antigen-bundle [<url> [<loc>]]
157 162
158 where `<url>` is the repository url and it defaults to [robbyrussell's 163 where `<url>` is the repository url and it defaults to [robbyrussell's
159 oh-my-zsh][oh-my-zsh] repo (can be changed by setting `ANTIGEN_DEFAULT_REPO_URL` 164 oh-my-zsh][oh-my-zsh] repo (can be changed by setting `ANTIGEN_DEFAULT_REPO_URL`
160 discussed further down). `<loc>` is the path under this repository which has the 165 discussed further down). `<loc>` is the path under this repository which has the
161 zsh plugin. This is typically the directory that contains a `*.plugin.zsh` file, 166 zsh plugin. This is typically the directory that contains a `*.plugin.zsh` file,
162 but it could contain a completion file or just many `*.zsh` files to be sourced. 167 but it could contain a completion file or just many `*.zsh` files to be sourced.
163 `<loc>` defaults to `/`, which indicates the repository itself is a plugin. 168 `<loc>` defaults to `/`, which indicates the repository itself is a plugin.
164 169
165 An example invocation would be 170 An example invocation would be
166 171
167 # The following is the same as `antigen-bundle ant`. But for demonstration 172 # The following is the same as `antigen-bundle ant`. But for demonstration
168 # purposes, we use the extended syntax here. 173 # purposes, we use the extended syntax here.
169 antigen-bundle https://github.com/robbyrussell/oh-my-zsh.git plugins/ant 174 antigen-bundle https://github.com/robbyrussell/oh-my-zsh.git plugins/ant
170 175
171 This would install the ant plugin from robbyrussell's oh-my-zsh repo. Of course, 176 This would install the ant plugin from robbyrussell's oh-my-zsh repo. Of course,
172 github url's can be shortened. 177 github url's can be shortened.
173 178
174 antigen-bundle robbyrussell/oh-my-zsh plugins/ant 179 antigen-bundle robbyrussell/oh-my-zsh plugins/ant
175 180
176 And since this repo is the default, even that isn't necessary. But we can't 181 And since this repo is the default, even that isn't necessary. But we can't
177 specify the `loc` without giving the first argument. 182 specify the `loc` without giving the first argument.
178 183
179 For this and a few other reasons, `antigen-bundle` also supports a simple 184 For this and a few other reasons, `antigen-bundle` also supports a simple
180 keyword argument syntax, using which we can rewrite the above as 185 keyword argument syntax, using which we can rewrite the above as
181 186
182 antigen-bundle --loc=plugins/ant 187 antigen-bundle --loc=plugins/ant
183 188
184 Which picks up the default for the `url` argument, and uses the `loc` given to 189 Which picks up the default for the `url` argument, and uses the `loc` given to
185 it. 190 it.
186 191
187 *Note* that you can mix and match positional and keyword arguments. But you 192 *Note* that you can mix and match positional and keyword arguments. But you
188 can't have positional arguments after keyword arguments. 193 can't have positional arguments after keyword arguments.
189 194
190 antigen-bundle robbyrussell/oh-my-zsh --loc=plugins/ant 195 antigen-bundle robbyrussell/oh-my-zsh --loc=plugins/ant
191 196
192 And keyword arguments don't care about the order in which the arguments are 197 And keyword arguments don't care about the order in which the arguments are
193 specified. The following is perfectly valid. 198 specified. The following is perfectly valid.
194 199
195 antigen-bundle --loc=plugins/ant --url=robbyrussell/oh-my-zsh 200 antigen-bundle --loc=plugins/ant --url=robbyrussell/oh-my-zsh
196 201
197 In addition to the above discussed arguments, `antigen-bundle` also takes a 202 In addition to the above discussed arguments, `antigen-bundle` also takes a
198 `btype` keyword-only argument, that is used internally. You shouldn't be 203 `btype` keyword-only argument, that is used internally. You shouldn't be
199 concerned with this argument, its only used internally and will probably go away 204 concerned with this argument, its only used internally and will probably go away
200 in the future. It indicates whether the bundle is a theme or a simple plugin. 205 in the future. It indicates whether the bundle is a theme or a simple plugin.
201 206
202 You can use this `antigen-bundle` command not just from your `.zshrc`, but also 207 You can use this `antigen-bundle` command not just from your `.zshrc`, but also
203 from your shell environment. This allows you to install plugins on the fly and 208 from your shell environment. This allows you to install plugins on the fly and
204 try them out. Of course if you want a bundle to be available every time you open 209 try them out. Of course if you want a bundle to be available every time you open
205 a shell, put it in your `.zshrc`. 210 a shell, put it in your `.zshrc`.
206 211
207 Other keyword-only arguments accepted: 212 Other keyword-only arguments accepted:
208 213
209 `branch` &mdash; Specify the branch of the git repo to be used for this bundle. 214 `branch` &mdash; Specify the branch of the git repo to be used for this bundle.
210 Please note that if you specify two plugins to be loaded from the same git repo, 215 Please note that if you specify two plugins to be loaded from the same git repo,
211 but different branches, then two separate clones of this repo will be 216 but different branches, then two separate clones of this repo will be
212 maintained. This is a small implementation detail and shouldn't influence you in 217 maintained. This is a small implementation detail and shouldn't influence you in
213 any way. 218 any way.
214 219
215 ### antigen-bundles 220 ### antigen-bundles
216 221
217 If you have a fair number of bundles, using the `antigen-bundle` command can 222 If you have a fair number of bundles, using the `antigen-bundle` command can
218 look cumbersome. You can use the `antigen-bundles` command to *bulk* define 223 look cumbersome. You can use the `antigen-bundles` command to *bulk* define
219 bundles instead of individual calls to `antigen-bundle`. 224 bundles instead of individual calls to `antigen-bundle`.
220 225
221 Usage is pretty straightforward. Just pipe the bundle specifications, just as 226 Usage is pretty straightforward. Just pipe the bundle specifications, just as
222 you would give to the `antigen-bundle` command, one per line, into the 227 you would give to the `antigen-bundle` command, one per line, into the
223 `antigen-bundles` command. The easiest way to do this, is using the heredoc 228 `antigen-bundles` command. The easiest way to do this, is using the heredoc
224 syntax. 229 syntax.
225 230
226 antigen-bundles <<EOF 231 antigen-bundles <<EOF
227 # Guess what to install when running an unknown command. 232 # Guess what to install when running an unknown command.
228 command-not-found 233 command-not-found
229 234
230 # The heroku tool helper plugin. 235 # The heroku tool helper plugin.
231 heroku 236 heroku
232 237
233 EOF 238 EOF
234 239
235 This is equivalent to 240 This is equivalent to
236 241
237 antigen-bundle command-not-found 242 antigen-bundle command-not-found
238 antigen-bundle heroku 243 antigen-bundle heroku
239 244
240 Of course, as you can see, from the lines piped to `antigen-bundles`, empty 245 Of course, as you can see, from the lines piped to `antigen-bundles`, empty
241 lines and those starting with a `#` are ignored. The rest are passed to 246 lines and those starting with a `#` are ignored. The rest are passed to
242 `antigen-bundle` without any quoting rules applied. They are actually `eval`-ed 247 `antigen-bundle` without any quoting rules applied. They are actually `eval`-ed
243 with the `antigen-bundle` command. See the source if you want to really 248 with the `antigen-bundle` command. See the source if you want to really
244 understand how it works. Its a very small function. 249 understand how it works. Its a very small function.
245 250
246 ### antigen-update 251 ### antigen-update
247 252
248 This is something you might not want to put in your `.zshrc`. Instead, run it 253 This is something you might not want to put in your `.zshrc`. Instead, run it
249 occasionally to update all your plugins. It doesn't take any arguments. 254 occasionally to update all your plugins. It doesn't take any arguments.
250 255
251 antigen-update 256 antigen-update
252 257
253 Please note that the updates that are downloaded are not immediately available. 258 Please note that the updates that are downloaded are not immediately available.
254 You have to open a new shell to be able to see the changes. This is a limitation 259 You have to open a new shell to be able to see the changes. This is a limitation
255 by design since reloading all the plugins *might* have some nasty side effects 260 by design since reloading all the plugins *might* have some nasty side effects
256 that may not be immediately apparent. Let's just say it can make your shell act 261 that may not be immediately apparent. Let's just say it can make your shell act
257 real quirky. 262 real quirky.
258 263
259 **Please note**: This command is not for updating *antigen* itself. Its for 264 **Please note**: This command is not for updating *antigen* itself. Its for
260 updating the bundles you are using with antigen. 265 updating the bundles you are using with antigen.
261 266
262 ### antigen-list 267 ### antigen-list
263 268
264 Use this command to list out the currently *loaded* plugins. Keep in mind that 269 Use this command to list out the currently *loaded* plugins. Keep in mind that
265 this includes any bundles installed on-the-fly. 270 this includes any bundles installed on-the-fly.
266 271
267 Takes no arguments. Gives out the repo url and the plugin's location under the 272 Takes no arguments. Gives out the repo url and the plugin's location under the
268 repo. 273 repo.
269 274
270 ### antigen-cleanup 275 ### antigen-cleanup
271 276
272 Used to clean up the clones of repos which are not used by any plugins. It takes 277 Used to clean up the clones of repos which are not used by any plugins. It takes
273 no arguments. When this is run, it lists out the repo-clones that are available 278 no arguments. When this is run, it lists out the repo-clones that are available
274 but are not used by any plugin *currently loaded*. 279 but are not used by any plugin *currently loaded*.
275 280
276 This command currently cannot run in a non-interactive mode. So it won't be very 281 This command currently cannot run in a non-interactive mode. So it won't be very
277 pleasant to use it in your `.zshrc`. 282 pleasant to use it in your `.zshrc`.
278 283
279 ### antigen-lib 284 ### antigen-lib
280 285
281 This is a shortcut to 286 This is a shortcut to
282 287
283 antigen-bundle --loc=lib 288 antigen-bundle --loc=lib
284 289
285 So, it basically installs the oh-my-zsh's library as a bundle. Please note that 290 So, it basically installs the oh-my-zsh's library as a bundle. Please note that
286 this assumes that the `ANTIGEN_DEFAULT_REPO_URL` is set to the oh-my-zsh repo or 291 this assumes that the `ANTIGEN_DEFAULT_REPO_URL` is set to the oh-my-zsh repo or
287 a fork of that repo. If you want to specify the `url` too, then you can't use 292 a fork of that repo. If you want to specify the `url` too, then you can't use
288 the `antigen-lib` short cut. You have to do that directly with the 293 the `antigen-lib` short cut. You have to do that directly with the
289 `antigen-bundle` command. 294 `antigen-bundle` command.
290 295
291 This is present only for legacy reasons and *might* (or might not) be removed in 296 This is present only for legacy reasons and *might* (or might not) be removed in
292 the future. 297 the future.
293 298
294 Use 299 Use
295 300
296 antigen-lib 301 antigen-lib
297 302
298 in your `.zshrc`, before any `antigen-bundle` declarations. It takes no 303 in your `.zshrc`, before any `antigen-bundle` declarations. It takes no
299 arguments. 304 arguments.
300 305
301 ### antigen-theme 306 ### antigen-theme
302 307
303 Used for switching the prompt theme. Invoke it with the name of the theme you 308 Used for switching the prompt theme. Invoke it with the name of the theme you
304 want to use. 309 want to use.
305 310
306 antigen-theme fox 311 antigen-theme fox
307 312
308 Currently, themes are pulled from robbyrussell's oh-my-zsh repo, but it will 313 Currently, themes are pulled from robbyrussell's oh-my-zsh repo, but it will
309 support getting themes from other repos as well in the future. 314 support getting themes from other repos as well in the future.
310 315
311 You can use this command to change your theme on the fly in your shell. Go on, 316 You can use this command to change your theme on the fly in your shell. Go on,
312 try out a few themes in your shell before you set it in your `.zshrc`. 317 try out a few themes in your shell before you set it in your `.zshrc`.
313 318
314 ### antigen-apply 319 ### antigen-apply
315 320
316 You have to add this command after defining all bundles you need, in your zshrc. 321 You have to add this command after defining all bundles you need, in your zshrc.
317 The completions defined by your bundles will be loaded at this step. 322 The completions defined by your bundles will be loaded at this step.
318 323
319 It is possible to load completions as and when a bundle is specified with the 324 It is possible to load completions as and when a bundle is specified with the
320 bundle command, in which case this command would not be necessary. But loading 325 bundle command, in which case this command would not be necessary. But loading
321 the completions is a time-consuming process and your shell will start noticeably 326 the completions is a time-consuming process and your shell will start noticeably
322 slow if you have a good number of bundle specifications. 327 slow if you have a good number of bundle specifications.
323 328
324 However, if you're a zsh expert and can suggest a way so that this would not be 329 However, if you're a zsh expert and can suggest a way so that this would not be
325 necessary, I am very interested in discussing it. Please open up an issue with 330 necessary, I am very interested in discussing it. Please open up an issue with
326 your details. Thanks. 331 your details. Thanks.
327 332
333 ### antigen-help
334
335 This exists so that there can be some help right in the command line. Currently
336 it doesn't provide much help other than redirecting you to the project page for
337 documentation. It is intended to provide more meaning and sub-command specific
338 help in the future.
339
340 I could use some help here as I'm not that good at writing documentation that
341 looks good as output on the command line.
342
343 ### antigen
344
345 This is a parent command that mainly exists for convenience. The idea is the
346 following two are the same.
347
348 antigen-list
349 antigen list
350
351 and
352
353 antigen-help
354 antigen help
355
356 Because of this, we can create aliases like
357
358 alias a=antigen
359 alias an=antigen
360
361 and run the antigen commands without making them look annoyingly long.
362
363 a bundle ruby
364 a theme candy
365 a list
366
367 And even...
368
369 an update
370
328 ## Configuration 371 ## Configuration
329 372
330 The following environment variables can be set to customize the behavior of 373 The following environment variables can be set to customize the behavior of
331 antigen. Make sure you set them *before* source-ing `antigen.zsh`. 374 antigen. Make sure you set them *before* source-ing `antigen.zsh`.
332 375
333 `ANTIGEN_DEFAULT_REPO_URL` &mdash; This is the default repository url that is 376 `ANTIGEN_DEFAULT_REPO_URL` &mdash; This is the default repository url that is
334 used for `bundle` commands. The default value is robbyrussell's oh-my-zsh repo, 377 used for `bundle` commands. The default value is robbyrussell's oh-my-zsh repo,
335 but you can set this to the fork url of your own fork. 378 but you can set this to the fork url of your own fork.
336 379
337 `ADOTDIR` &mdash; This directory is used to store all the repo clones, your 380 `ADOTDIR` &mdash; This directory is used to store all the repo clones, your
338 bundles, themes, caches and everything else antigen requires to run smoothly. 381 bundles, themes, caches and everything else antigen requires to run smoothly.
339 Defaults to `$HOME/.antigen`. 382 Defaults to `$HOME/.antigen`.
340 383
341 **Note**: `ANTIGEN_REPO_CACHE` & `ANTIGEN_BUNDLE_DIR` &mdash; These variables 384 **Note**: `ANTIGEN_REPO_CACHE` & `ANTIGEN_BUNDLE_DIR` &mdash; These variables
342 were used previously but are now removed. Please use `ADOTDIR` instead, as 385 were used previously but are now removed. Please use `ADOTDIR` instead, as
343 mentioned above. 386 mentioned above.
344 387
345 ## Notes on writing plugins 388 ## Notes on writing plugins
346 389
347 > *TBD* 390 > *TBD*
348 391
349 ## Meta 392 ## Meta
350 393
351 Project is licensed with the [MIT License][license]. To contribute, just fork, 394 Project is licensed with the [MIT License][license]. To contribute, just fork,
352 make changes and send a pull request. If its a rather long/complicated change, 395 make changes and send a pull request. If its a rather long/complicated change,
353 please consider opening an [issue][] first so we can discuss it out. 396 please consider opening an [issue][] first so we can discuss it out.
354 397
355 Any comments/suggestions/feedback welcome. Please join the discussion on the 398 Any comments/suggestions/feedback welcome. Please join the discussion on the
356 [reddit page][] of this project. Also, follow me on twitter, 399 [reddit page][] of this project. Also, follow me on twitter,
357 [@sharat87](twitter). 400 [@sharat87](twitter).
358 401
359 [Vundle]: https://github.com/gmarik/vundle 402 [Vundle]: https://github.com/gmarik/vundle
360 [page on themes]: https://github.com/robbyrussell/oh-my-zsh/wiki/Themes 403 [page on themes]: https://github.com/robbyrussell/oh-my-zsh/wiki/Themes
361 [syntax highlighting plugin]: https://github.com/zsh-users/zsh-syntax-highlighting 404 [syntax highlighting plugin]: https://github.com/zsh-users/zsh-syntax-highlighting
362 [autoenv]: https://github.com/kennethreitz/autoenv 405 [autoenv]: https://github.com/kennethreitz/autoenv
363 [oh-my-zsh]: https://github.com/robbyrussell/oh-my-zsh 406 [oh-my-zsh]: https://github.com/robbyrussell/oh-my-zsh
364 [issue]: https://github.com/sharat87/antigen/issues 407 [issue]: https://github.com/sharat87/antigen/issues
365 [license]: http://mit.sharats.me 408 [license]: http://mit.sharats.me
366 [reddit page]: http://www.reddit.com/r/commandline/comments/u4f26/antigen_a_plugin_manager_for_zsh_shell/ 409 [reddit page]: http://www.reddit.com/r/commandline/comments/u4f26/antigen_a_plugin_manager_for_zsh_shell/
367 [twitter]: http://twitter.com/sharat87 410 [twitter]: http://twitter.com/sharat87
368 411