@@ -2,10 +2,63 @@

 A 14-line [Vim][] "plugin manager" using [Git][] and [`:packadd`][].

+Annoyed by having to [bootstrap plugin manager plugins][vim-plug-installation]?

+By having to run a [separate install step][vim-plug-pluginstall] even though

+you explicitly said you wanted a plugin in your `vimrc`? Tired of your plugin

+manager doing [weird, hard to debug][vim-plug-issues] things behind your back?

+Concerned that GitHub is becoming the [implicit custodian][vim-plug-url-format]

+of all of the worlds software? <small>*(I bully [`vim-plug`][] here, probably

+undeservedly, because it is the most popular. I used it for a long time and

+it's great!)*</small>

+

+Give this a try in your [`vimrc`][]!

+

+```vim

+" https://git.rcrnstn.net/rcrnstn/vim-gitadd

+" Make sure to not enable |:syntax| or |:filetype| until all plugins that

+" interact with them have been added! See |:packadd|.

+command! -bar -bang -nargs=+ GitAdd call s:GitAdd(<q-bang>, <f-args>)

+function! s:GitAdd(bang, url, ...) abort

+  let name = split(a:url, '/')[-1]

+  let dir = split(&packpath, ',')[0] . '/pack/gitadd/opt/' . name

+  if !isdirectory(dir)

+    silent execute '!git clone --recurse-submodules' join(a:000) a:url dir

+    if isdirectory(dir . '/doc')

+      execute 'helptags' dir . '/doc'

+    endif

+  endif

+  if empty(a:bang)

+    execute 'packadd!' name

+  endif

+endfunction

+```

+

+Any arguments that [`git clone`][] accepts, e.g. [`--branch`][] or

+[`--depth`][], can be given after the URL.

+

+Requiring the full URL might be slightly annoying, but it is self-documenting,

+works with [`netrw-gx`][], and does not discriminate against non-GitHub

+repositories by making them stick out like a sore thumb.

+

+No "update plugins" command? Nope. You know what tool is great at handling

+different versions of software? Git! A Git alias/shell function helps,

+something to the effect of `for dir in *; do echo "=== $dir ==="; git -C "$dir"

+"$@"; done`.

+

 [`vim-gitadd`]: https://git.rcrnstn.net/rcrnstn/vim-gitadd

 [Vim]: https://en.wikipedia.org/wiki/Vim_(text_editor)

 [Git]: https://en.wikipedia.org/wiki/Git

 [`:packadd`]: https://vimhelp.org/repeat.txt.html#%3Apackadd

+[vim-plug-installation]: https://github.com/junegunn/vim-plug/blob/0.11.0/README.md#installation

+[vim-plug-pluginstall]: https://github.com/junegunn/vim-plug/blob/0.11.0/README.md#pluginstall-and-plugupdate

+[vim-plug-issues]: https://github.com/junegunn/vim-plug/issues?q=

+[vim-plug-url-format]: https://github.com/junegunn/vim-plug/blob/0.11.0/doc/plug.txt#L231

+[`vim-plug`]: https://github.com/junegunn/vim-plug

+[`vimrc`]: https://vimhelp.org/starting.txt.html#vimrc

+[`git clone`]: https://git-scm.com/docs/git-clone

+[`--branch`]: https://git-scm.com/docs/git-clone#Documentation/git-clone.txt---branchltnamegt

+[`--depth`]: https://git-scm.com/docs/git-clone#Documentation/git-clone.txt---depthltdepthgt

+[`netrw-gx`]: https://vimhelp.org/pi_netrw.txt.html#netrw-gx

 ## License

@@ -6,3 +6,11 @@ A 14-line [Vim][] "plugin manager" using [Git][] and [`:packadd`][].

 [Vim]: https://en.wikipedia.org/wiki/Vim_(text_editor)

 [Git]: https://en.wikipedia.org/wiki/Git

 [`:packadd`]: https://vimhelp.org/repeat.txt.html#%3Apackadd

+

+## License

+

+Licensed under the [ISC License][] unless otherwise noted, see the

+[`LICENSE`][] file.

+

+[ISC License]: https://choosealicense.com/licenses/isc

+[`LICENSE`]: LICENSE

new file mode 100644

@@ -0,0 +1,8 @@

+# [`vim-gitadd`][]

+

+A 14-line [Vim][] "plugin manager" using [Git][] and [`:packadd`][].

+

+[`vim-gitadd`]: https://git.rcrnstn.net/rcrnstn/vim-gitadd

+[Vim]: https://en.wikipedia.org/wiki/Vim_(text_editor)

+[Git]: https://en.wikipedia.org/wiki/Git

+[`:packadd`]: https://vimhelp.org/repeat.txt.html#%3Apackadd