App::Vimpl

Vimpl is meant to be a simple script to manage Vim plugins with Git and
Pathogen.vim.  Plugins are scraped from the excellent http://vim-scripts.org
list of mirrors and installed as git submodules in $HOME/.vim/bundle/

USAGE

	vimpl <command> [<args>]

Commands:
	
	init - Initializes a git repo in your $HOME/.vim folder and installs 
		Pathogen.vim as a git submodule.

	restore <gitrepo> - Clones the provided git repository into $HOME/.vim
		Initializes all git submodules and updates all submodules.

	search <vim plugins>... - Provides a list of matching plugins found
		on vim-scripts.org for each name provided.

	install [<vim plugin name>|<vim script number>|<git repo>]...- Installs
		provided Vim plugin names/numbers as git submodules from their
		respective vim-scripts.org mirrors.  Also will install a provided
		git repo as a submodule in .vim/bundle.

	list - Lists the installed Vim plugins (omits Pathogen.vim from
		the list)

	remove <vim plugins>... - Removes provided Vim plugins.
		Must match the names in 'list'.

	pull [config|plugin|all] - Does a 'git pull origin master' for either
		the remote for the $HOME/.vim repo , git submodules or both.
		If not specified, plugins only.

	update - Updates the local list of plugin mirrors from vim-scripts.org.

	backup - If the $HOME/.vim repo already has a remote origin,
		'backup' will push to it.

		backup github <name> [public|private] - Vimpl will attempt to
			create a repo for you on GitHub <name> using credentials in your
			$HOME/.gitconfig .  Vimpl will then push your .vim config to
			the fresh repo.

		backup <gitrepo> - Vimpl will attempt to set the provided repo as
			the remote origin in $HOME/.vim and push to it.

INSTALLATION

To install this module from source or tarball, run the following commands:

	perl Makefile.PL
	make
	make test
	make install


To install this module from CPAN:

	perl -MCPAN -e 'install App::Vimpl'

	or

	cpanm App::Vimpl

SUPPORT AND DOCUMENTATION

After installing, you can find documentation for this module with the
perldoc command.

    perldoc App::Vimpl

You can also look for information at:

    Vimpl's GitHub page
        https://github.com/moshen/Vimpl

    AnnoCPAN, Annotated CPAN documentation
        http://annocpan.org/dist/App-Vimpl

    CPAN Ratings
        http://cpanratings.perl.org/d/App-Vimpl

    Search CPAN
        http://search.cpan.org/dist/App-Vimpl/


LICENSE AND COPYRIGHT

Copyright (C) 2011 Colin Kennedy

This program is free software; you can redistribute it and/or modify it
under the terms of either: the GNU General Public License as published
by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.

