From 09ced94dd45f8b4f15ee77917fedd033948da8de Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9mi=20Verschelde?= <rverschelde@gmail.com>
Date: Sun, 26 Jan 2020 15:18:06 +0100
Subject: doc: Do not expose Variant::NIL as a type in the class reference

Fix signals Variant arguments incorrectly listed as Nil.

Fixes #12520.
---
 doc/classes/@GlobalScope.xml   |   2 +-
 doc/classes/EditorProperty.xml |   4 +-
 doc/classes/Input.xml          |   2 +
 doc/classes/Nil.xml            | 169 -----------------------------------------
 doc/classes/RichTextLabel.xml  |   6 +-
 doc/classes/SceneTree.xml      |   4 +-
 6 files changed, 10 insertions(+), 177 deletions(-)
 delete mode 100644 doc/classes/Nil.xml

(limited to 'doc/classes')

diff --git a/doc/classes/@GlobalScope.xml b/doc/classes/@GlobalScope.xml
index 73f0f1bd41..25f054ef72 100644
--- a/doc/classes/@GlobalScope.xml
+++ b/doc/classes/@GlobalScope.xml
@@ -1454,7 +1454,7 @@
 			Default method flags.
 		</constant>
 		<constant name="TYPE_NIL" value="0" enum="Variant.Type">
-			Variable is of type [Nil] (only applied for [code]null[/code]).
+			Variable is [code]null[/code].
 		</constant>
 		<constant name="TYPE_BOOL" value="1" enum="Variant.Type">
 			Variable is of type [bool].
diff --git a/doc/classes/EditorProperty.xml b/doc/classes/EditorProperty.xml
index 5c24f0bebc..c28d18ec72 100644
--- a/doc/classes/EditorProperty.xml
+++ b/doc/classes/EditorProperty.xml
@@ -113,7 +113,7 @@
 		<signal name="property_changed">
 			<argument index="0" name="property" type="String">
 			</argument>
-			<argument index="1" name="value" type="Nil">
+			<argument index="1" name="value" type="Variant">
 			</argument>
 			<description>
 				Do not emit this manually, use the [method emit_changed] method instead.
@@ -138,7 +138,7 @@
 		<signal name="property_keyed_with_value">
 			<argument index="0" name="property" type="String">
 			</argument>
-			<argument index="1" name="value" type="Nil">
+			<argument index="1" name="value" type="Variant">
 			</argument>
 			<description>
 				Emit it if you want to key a property with a single value.
diff --git a/doc/classes/Input.xml b/doc/classes/Input.xml
index b827c5a49b..8baca2f06b 100644
--- a/doc/classes/Input.xml
+++ b/doc/classes/Input.xml
@@ -277,6 +277,8 @@
 			<argument index="3" name="guid" type="String">
 			</argument>
 			<description>
+				Notifies the [Input] singleton that a connection has changed, to update the state for the [code]device[/code] index.
+				This is used internally and should not have to be called from user scripts. See [signal joy_connection_changed] for the signal emitted when this is triggered internally.
 			</description>
 		</method>
 		<method name="parse_input_event">
diff --git a/doc/classes/Nil.xml b/doc/classes/Nil.xml
deleted file mode 100644
index a5c1ade6ed..0000000000
--- a/doc/classes/Nil.xml
+++ /dev/null
@@ -1,169 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" ?>
-<class name="Nil" category="Built-In Types" version="3.2">
-	<brief_description>
-	</brief_description>
-	<description>
-	</description>
-	<tutorials>
-	</tutorials>
-	<methods>
-		<method name="Nil">
-			<argument index="0" name="from" type="PoolColorArray">
-			</argument>
-			<description>
-			</description>
-		</method>
-		<method name="Nil">
-			<argument index="0" name="from" type="PoolVector3Array">
-			</argument>
-			<description>
-			</description>
-		</method>
-		<method name="Nil">
-			<argument index="0" name="from" type="PoolVector2Array">
-			</argument>
-			<description>
-			</description>
-		</method>
-		<method name="Nil">
-			<argument index="0" name="from" type="PoolStringArray">
-			</argument>
-			<description>
-			</description>
-		</method>
-		<method name="Nil">
-			<argument index="0" name="from" type="PoolRealArray">
-			</argument>
-			<description>
-			</description>
-		</method>
-		<method name="Nil">
-			<argument index="0" name="from" type="PoolIntArray">
-			</argument>
-			<description>
-			</description>
-		</method>
-		<method name="Nil">
-			<argument index="0" name="from" type="PoolByteArray">
-			</argument>
-			<description>
-			</description>
-		</method>
-		<method name="Nil">
-			<argument index="0" name="from" type="Array">
-			</argument>
-			<description>
-			</description>
-		</method>
-		<method name="Nil">
-			<argument index="0" name="from" type="Dictionary">
-			</argument>
-			<description>
-			</description>
-		</method>
-		<method name="Nil">
-			<argument index="0" name="from" type="Object">
-			</argument>
-			<description>
-			</description>
-		</method>
-		<method name="Nil">
-			<argument index="0" name="from" type="RID">
-			</argument>
-			<description>
-			</description>
-		</method>
-		<method name="Nil">
-			<argument index="0" name="from" type="NodePath">
-			</argument>
-			<description>
-			</description>
-		</method>
-		<method name="Nil">
-			<argument index="0" name="from" type="Color">
-			</argument>
-			<description>
-			</description>
-		</method>
-		<method name="Nil">
-			<argument index="0" name="from" type="Transform">
-			</argument>
-			<description>
-			</description>
-		</method>
-		<method name="Nil">
-			<argument index="0" name="from" type="Basis">
-			</argument>
-			<description>
-			</description>
-		</method>
-		<method name="Nil">
-			<argument index="0" name="from" type="AABB">
-			</argument>
-			<description>
-			</description>
-		</method>
-		<method name="Nil">
-			<argument index="0" name="from" type="Quat">
-			</argument>
-			<description>
-			</description>
-		</method>
-		<method name="Nil">
-			<argument index="0" name="from" type="Plane">
-			</argument>
-			<description>
-			</description>
-		</method>
-		<method name="Nil">
-			<argument index="0" name="from" type="Transform2D">
-			</argument>
-			<description>
-			</description>
-		</method>
-		<method name="Nil">
-			<argument index="0" name="from" type="Vector3">
-			</argument>
-			<description>
-			</description>
-		</method>
-		<method name="Nil">
-			<argument index="0" name="from" type="Rect2">
-			</argument>
-			<description>
-			</description>
-		</method>
-		<method name="Nil">
-			<argument index="0" name="from" type="Vector2">
-			</argument>
-			<description>
-			</description>
-		</method>
-		<method name="Nil">
-			<argument index="0" name="from" type="String">
-			</argument>
-			<description>
-			</description>
-		</method>
-		<method name="Nil">
-			<argument index="0" name="from" type="float">
-			</argument>
-			<description>
-			</description>
-		</method>
-		<method name="Nil">
-			<argument index="0" name="from" type="int">
-			</argument>
-			<description>
-			</description>
-		</method>
-		<method name="Nil">
-			<argument index="0" name="from" type="bool">
-			</argument>
-			<description>
-			</description>
-		</method>
-	</methods>
-	<constants>
-	</constants>
-</class>
diff --git a/doc/classes/RichTextLabel.xml b/doc/classes/RichTextLabel.xml
index c3fb226b6a..e95e6909c5 100644
--- a/doc/classes/RichTextLabel.xml
+++ b/doc/classes/RichTextLabel.xml
@@ -325,21 +325,21 @@
 	</members>
 	<signals>
 		<signal name="meta_clicked">
-			<argument index="0" name="meta" type="Nil">
+			<argument index="0" name="meta" type="Variant">
 			</argument>
 			<description>
 				Triggered when the user clicks on content between meta tags. If the meta is defined in text, e.g. [code][url={"data"="hi"}]hi[/url][/code], then the parameter for this signal will be a [String] type. If a particular type or an object is desired, the [method push_meta] method must be used to manually insert the data into the tag stack.
 			</description>
 		</signal>
 		<signal name="meta_hover_ended">
-			<argument index="0" name="meta" type="Nil">
+			<argument index="0" name="meta" type="Variant">
 			</argument>
 			<description>
 				Triggers when the mouse exits a meta tag.
 			</description>
 		</signal>
 		<signal name="meta_hover_started">
-			<argument index="0" name="meta" type="Nil">
+			<argument index="0" name="meta" type="Variant">
 			</argument>
 			<description>
 				Triggers when the mouse enters a meta tag.
diff --git a/doc/classes/SceneTree.xml b/doc/classes/SceneTree.xml
index 6a4105ca2f..38b017ab7e 100644
--- a/doc/classes/SceneTree.xml
+++ b/doc/classes/SceneTree.xml
@@ -329,9 +329,9 @@
 			</description>
 		</signal>
 		<signal name="global_menu_action">
-			<argument index="0" name="id" type="Nil">
+			<argument index="0" name="id" type="Variant">
 			</argument>
-			<argument index="1" name="meta" type="Nil">
+			<argument index="1" name="meta" type="Variant">
 			</argument>
 			<description>
 				Emitted whenever global menu item is clicked.
-- 
cgit v1.2.3