sourCEntral - mobile manpages

pdf

vim-addons

NAME
vim−addons − command line manager of Vim add−ons

SYNOPSIS
vim−addons [OPTION ...] [COMMAND [ADDON ...]]

DESCRIPTION
Manage Vim addons installed system−wide, enabling on a per−user basis their installation, removal, ...

vim−addons is capable of managing all Vim addons registered in the system−wide registry of Vim addons (see vim−registry(5)). Each system−wide addon can be, with respect to a user Vim configuration, in one of the following states:
installed

all of the files composing the addon are installed (i.e. symlinked) somewhere under ~/.vim. The addon is fully functional for the current user

removed

the files composing the addon are not installed under ~/.vim. The addon might still be working for the current user if it is installed system−wide by the local administrator

disabled

the files composing the addon are not installed under ~/.vim, but the addon is installed system−wide. However, the addon has been disabled for the current user explicitely requiring so via some configuration line in ~/.vim/plugin/vim−addons.vim. The addon is not working for the current user

broken

only some of the files composing the addon are installed under ~/.vim. The addon is probably not working for the current user

COMMANDS
A number of commands can be given to vim−addons to inspect or alter the status of the addons: list, status, install, remove, disable, amend, files, show.

A description of the semantics of each command is reported below.

list

list, one per line, the names of the addons available in the system (i.e. of all the addons mentioned in the registry, not necessarily of all enabled addons)

status

show, one per line, the status of the addons available in the system. If one or more addon arguments are specified only show the status of those addons. This is the default command if nothing is specified.

install

install one or more addons under ~/.vim. Requires at least one addon argument

remove

remove one or more addons from ~/.vim. Requires at least one addon argument

disable

disable one or more addons to be used by the current user. Usually used for addons which are system−wide enabled by the local administrator but that the current user does not want to be used. Using this command will automatically change the content of ~/.vim/plugin/vim−addons.vim, probably adding let definitions which will inhibit the given addon to be used. Requires at least one addon argument

amend

undo the effects of a previous disable command. Requires at least one addon argument

files

list, one per line, the files composing the specified addons. Files are listed relative to components of the Vim runtimepath (see ’runtimepath’ in the Vim help). Requires at least one addon argument

show

displays detailed information about the specified addons

OPTIONS
All commands accept the following options:
−h, −−help

show this usage message and exit

−q, −−query

be quiet and make the output more parseable (for "status")

−r, −−registry−dir

set the registry directory (default: /usr/share/vim/registry)

−s, −−source−dir

set the addons source directory (default: /usr/share/vim/addons)

−t, −−target−dir

set the addons target directory (default: $HOME/.vim)

−v, −−verbose

increase verbosity level

−y, −−system−dir

set the system−wide target directory (default: /var/lib/vim/addons)

−w, −−system−wide

set the addons target directory to the system−wide target directory, possibly overriding the −t option

AUTHOR
Stefano Zacchiroli <zack AT debian DOT org>

SEE ALSO
vim(1), vim−registry(5)

COPYRIGHT
Copyright (C) 2007 Stefano Zacchiroli

This program is free software, you can redistribute it and/or modify it under the terms of the GNU General Public License version 3 as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.

pdf