Replace vim_free() implementation

This replaces the vim_free() implementation with a free() call and adds
a deprecated flag for the doxygen documentation.
replaced `vim_free()` calls with `free()` calls
removed `vim_free()` function