diff runtime/doc/eval.txt @ 14748:00da090af0ab v8.1.0386

patch 8.1.0386: cannot test with non-default option value commit https://github.com/vim/vim/commit/fe8ef98dd1d0b7d296d7db29b1e2fd1b56b788de Author: Bram Moolenaar <Bram@vim.org> Date: Thu Sep 13 20:31:54 2018 +0200 patch 8.1.0386: cannot test with non-default option value Problem: Cannot test with non-default option value. Solution: Add test_option_not_set().
author Christian Brabandt <cb@256bit.org>
date Thu, 13 Sep 2018 20:45:05 +0200
parents 0a3b9ecf7cb8
children a179e5cfcab7
line wrap: on
line diff
--- a/runtime/doc/eval.txt
+++ b/runtime/doc/eval.txt
@@ -2473,6 +2473,7 @@ test_null_job()			Job	null value for tes
 test_null_list()		List	null value for testing
 test_null_partial()		Funcref	null value for testing
 test_null_string()		String	null value for testing
+test_option_not_set({name})    none	reset flag indicating option was set
 test_override({expr}, {val})    none	test with Vim internal overrides
 test_settime({expr})		none	set current time for testing
 timer_info([{id}])		List	information about timers
@@ -8737,6 +8738,15 @@ test_null_partial()					*test_null_parti
 test_null_string()					*test_null_string()*
 		Return a String that is null. Only useful for testing.
 
+test_option_not_set({name})				*test_option_not_set()*
+		Reset the flag that indicates option {name} was set.  Thus it
+		looks like it still has the default value. Use like this: >
+			set ambiwidth=double
+			call test_option_not_set('ambiwidth')
+<		Now the 'ambiwidth' option behaves like it was never changed,
+		even though the value is "double".
+		Only to be used for testing!
+
 test_override({name}, {val})				*test_override()*
 		Overrides certain parts of Vims internal processing to be able
 		to run tests. Only to be used for testing Vim!