api: Add warnings about the returned value to \*del_var functions

This commit is contained in:
ZyX
2016-03-17 23:31:31 +03:00
parent 4f8b686435
commit 25bb08dad9
5 changed files with 16 additions and 5 deletions

View File

@@ -223,7 +223,10 @@ Object window_set_var(Window window, String name, Object value, Error *err)
/// @param window The window handle
/// @param name The variable name
/// @param[out] err Details of an error that may have occurred
/// @return The old value
/// @return The old value or nil if there was no previous value.
///
/// @warning It may return nil if there was no previous value
/// or if previous value was `v:null`.
Object window_del_var(Window window, String name, Error *err)
{
win_T *win = find_window_by_handle(window, err);