This is a mirror of http://www.vim.org/scripts/script.php?script_id=2818

Asneeded allows loading a script by the name of a command or function that
the script defines.  You can use :AN to load by a command; functions are
loaded automatically (via FuncUndefined).

Example (this is supposed to work with the default setup):

	:AN ANedit

This will source the script  AsNeeded/anplus.vim  (located below the
'runtimepath') which defines the :ANedit command.

Before :AN can be used, user scripts need to be scanned with :ANmakeTags to
create ANtags files.  These files (like normal tags files) map commands and
functions to script file names.  In order to find ANtags files,
g:asneeded_path needs to be set up properly.

This script has the same purpose as the AsNeeded plugin created by DrChip
(vimscript #915).

The ANtags file format is compatible, but paths included in file names are
not recognized.  In other words, each directory needs its own ANtags file.


Comparison (not to be taken too seriously...) of both scripts:

Advantages:
- no creation of temporary buffers
- configurable load path (load scripts from more than one location)
- command-line completion instead of a menu
- :ANmakeTags creates tags for certain files, not for a whole directory
- :AN only loads a script if the command argument is not defined yet
- single tags can be disabled in the ANtags file to solve ambiguities

Left Offs:
- mappings are not recognized (at least not per default)
- no "on-the-fly" mode: search for functions and commands requires an ANtags
  file
- :AN only takes a command name as argument (not a function name)
- no creation of skeleton commands (beyond purpose)

DrChip's AsNeeded version: 17c