feat(docs): generate builtin.txt (#24493)

- eval.lua is now the source of truth.

- Formatting is much more consistent.

- Fixed Lua type generation for polymorphic functions (get(), etc).

- Removed "Overview" section from builtin.txt
  - Can generate this if we really want it.

- Moved functions from sign.txt and testing.txt into builtin.txt.

- Removed the *timer* *timers* tags since libuv timers via vim.uv should be preferred.

- Removed the temp-file-name tag from tempname()

- Moved lueval() from lua.txt to builtin.txt.

* Fix indent

* fixup!

* fixup! fixup!

* fixup! better tag formatting

* fixup: revert changes no longer needed

* fixup! CI

---------

Co-authored-by: zeertzjq <zeertzjq@outlook.com>

1 files changed, 14 insertions, 182 deletions

diff --git a/runtime/doc/testing.txt b/runtime/doc/testing.txt
index 2c1c77a51d..cce96132a1 100644
--- a/runtime/doc/testing.txt
+++ b/runtime/doc/testing.txt
@@ -40,187 +40,19 @@ test_garbagecollect_now()			 *test_garbagecollect_now()*
 ==============================================================================
 3. Assert functions				*assert-functions-details*
 
-
-assert_beeps({cmd})					*assert_beeps()*
-		Run {cmd} and add an error message to |v:errors| if it does
-		NOT produce a beep or visual bell.
-		Also see |assert_fails()|, |assert_nobeep()| and
-		|assert-return|.
-
-		Can also be used as a |method|: >
-			GetCmd()->assert_beeps()
-<
-							*assert_equal()*
-assert_equal({expected}, {actual} [, {msg}])
-		When {expected} and {actual} are not equal an error message is
-		added to |v:errors| and 1 is returned.  Otherwise zero is
-		returned. |assert-return|
-		The error is in the form "Expected {expected} but got
-		{actual}".  When {msg} is present it is prefixed to that.
-
-		There is no automatic conversion, the String "4" is different
-		from the Number 4.  And the number 4 is different from the
-		Float 4.0.  The value of 'ignorecase' is not used here, case
-		always matters.
-		Example: >
-	assert_equal('foo', 'bar')
-<		Will result in a string to be added to |v:errors|:
-	test.vim line 12: Expected 'foo' but got 'bar' ~
-
-		Can also be used as a |method|: >
-			mylist->assert_equal([1, 2, 3])
-
-<							*assert_equalfile()*
-assert_equalfile({fname-one}, {fname-two})
-		When the files {fname-one} and {fname-two} do not contain
-		exactly the same text an error message is added to |v:errors|.
-		Also see |assert-return|.
-		When {fname-one} or {fname-two} does not exist the error will
-		mention that.
-
-		Can also be used as a |method|: >
-			GetLog()->assert_equalfile('expected.log')
-
-assert_exception({error} [, {msg}])			*assert_exception()*
-		When v:exception does not contain the string {error} an error
-		message is added to |v:errors|.  Also see |assert-return|.
-		This can be used to assert that a command throws an exception.
-		Using the error number, followed by a colon, avoids problems
-		with translations: >
-			try
-			  commandthatfails
-			  call assert_false(1, 'command should have failed')
-			catch
-			  call assert_exception('E492:')
-			endtry
-<
-							*assert_fails()*
-assert_fails({cmd} [, {error} [, {msg} [, {lnum} [, {context}]]]])
-		Run {cmd} and add an error message to |v:errors| if it does
-		NOT produce an error or when {error} is not found in the
-		error message.  Also see |assert-return|.
-
-		When {error} is a string it must be found literally in the
-		first reported error. Most often this will be the error code,
-		including the colon, e.g. "E123:". >
-			assert_fails('bad cmd', 'E987:')
-<
-		When {error} is a |List| with one or two strings, these are
-		used as patterns.  The first pattern is matched against the
-		first reported error: >
-			assert_fails('cmd', ['E987:.*expected bool'])
-<		The second pattern, if present, is matched against the last
-		reported error.  To only match the last error use an empty
-		string for the first error: >
-			assert_fails('cmd', ['', 'E987:'])
-<
-		If {msg} is empty then it is not used.  Do this to get the
-		default message when passing the {lnum} argument.
-
-		When {lnum} is present and not negative, and the {error}
-		argument is present and matches, then this is compared with
-		the line number at which the error was reported. That can be
-		the line number in a function or in a script.
-
-		When {context} is present it is used as a pattern and matched
-		against the context (script name or function name) where
-		{lnum} is located in.
-
-		Note that beeping is not considered an error, and some failing
-		commands only beep.  Use |assert_beeps()| for those.
-
-		Can also be used as a |method|: >
-			GetCmd()->assert_fails('E99:')
-
-assert_false({actual} [, {msg}])			*assert_false()*
-		When {actual} is not false an error message is added to
-		|v:errors|, like with |assert_equal()|.
-		The error is in the form "Expected False but got {actual}".
-		When {msg} is present it is prepended to that.
-		Also see |assert-return|.
-
-		A value is false when it is zero. When {actual} is not a
-		number the assert fails.
-
-		Can also be used as a |method|: >
-			GetResult()->assert_false()
-
-assert_inrange({lower}, {upper}, {actual} [, {msg}])	 *assert_inrange()*
-		This asserts number and |Float| values.  When {actual}  is lower
-		than {lower} or higher than {upper} an error message is added
-		to |v:errors|.  Also see |assert-return|.
-		The error is in the form "Expected range {lower} - {upper},
-		but got {actual}".  When {msg} is present it is prefixed to
-		that.
-
-								*assert_match()*
-assert_match({pattern}, {actual} [, {msg}])
-		When {pattern} does not match {actual} an error message is
-		added to |v:errors|.  Also see |assert-return|.
-		The error is in the form "Pattern {pattern} does not match
-		{actual}".  When {msg} is present it is prefixed to that.
-
-		{pattern} is used as with |expr-=~|: The matching is always done
-		like 'magic' was set and 'cpoptions' is empty, no matter what
-		the actual value of 'magic' or 'cpoptions' is.
-
-		{actual} is used as a string, automatic conversion applies.
-		Use "^" and "$" to match with the start and end of the text.
-		Use both to match the whole text.
-
-		Example: >
-	assert_match('^f.*o$', 'foobar')
-<		Will result in a string to be added to |v:errors|:
-	test.vim line 12: Pattern '^f.*o$' does not match 'foobar' ~
-
-		Can also be used as a |method|: >
-			getFile()->assert_match('foo.*')
-<
-assert_nobeep({cmd})					*assert_nobeep()*
-		Run {cmd} and add an error message to |v:errors| if it
-		produces a beep or visual bell.
-		Also see |assert_beeps()|.
-
-		Can also be used as a |method|: >
-			GetCmd()->assert_nobeep()
-<
-							*assert_notequal()*
-assert_notequal({expected}, {actual} [, {msg}])
-		The opposite of `assert_equal()`: add an error message to
-		|v:errors| when {expected} and {actual} are equal.
-		Also see |assert-return|.
-
-		Can also be used as a |method|: >
-			mylist->assert_notequal([1, 2, 3])
-
-<							*assert_notmatch()*
-assert_notmatch({pattern}, {actual} [, {msg}])
-		The opposite of `assert_match()`: add an error message to
-		|v:errors| when {pattern} matches {actual}.
-		Also see |assert-return|.
-
-		Can also be used as a |method|: >
-			getFile()->assert_notmatch('bar.*')
-
-
-assert_report({msg})					*assert_report()*
-		Report a test failure directly, using String {msg}.
-		Always returns one.
-
-		Can also be used as a |method|: >
-			GetMessage()->assert_report()
-
-
-assert_true({actual} [, {msg}])				*assert_true()*
-		When {actual} is not true an error message is added to
-		|v:errors|, like with |assert_equal()|.
-		Also see |assert-return|.
-		A value is |TRUE| when it is a non-zero number or |v:true|.
-		When {actual} is not a number or |v:true| the assert fails.
-		When {msg} is given it precedes the default message.
-
-		Can also be used as a |method|: >
-			GetResult()->assert_true()
-<
+See:
+  - |assert_beeps()|
+  - |assert_equal()|
+  - |assert_equalfile()|
+  - |assert_exception()|
+  - |assert_fails()|
+  - |assert_false()|
+  - |assert_inrange()|
+  - |assert_match()|
+  - |assert_nobeep()|
+  - |assert_notequal()|
+  - |assert_notmatch()|
+  - |assert_report()|
+  - |assert_true()|
 
  vim:tw=78:ts=8:noet:ft=help:norl: