Sync classref with current source

classes/[email protected]

@@ -1172,7 +1172,7 @@ enum **KeyModifierMask**:
 
 - **KEY_MASK_CTRL** = **268435456** --- Ctrl key mask.
 
-- **KEY_MASK_CMD** = **268435456** --- Cmd key mask.
+- **KEY_MASK_CMD** = **268435456** --- Command key mask. On macOS, this is equivalent to :ref:`KEY_MASK_META<class_@GlobalScope_constant_KEY_MASK_META>`. On other platforms, this is equivalent to :ref:`KEY_MASK_CTRL<class_@GlobalScope_constant_KEY_MASK_CTRL>`. This mask should be preferred to :ref:`KEY_MASK_META<class_@GlobalScope_constant_KEY_MASK_META>` or :ref:`KEY_MASK_CTRL<class_@GlobalScope_constant_KEY_MASK_CTRL>` for system shortcuts as it handles all platforms correctly.
 
 - **KEY_MASK_KPAD** = **536870912** --- Keypad key mask.
 

classes/class_aabb.rst

@@ -97,7 +97,7 @@ Property Descriptions
 | *Default* | Vector3( 0, 0, 0 ) |
 +-----------+--------------------+
 
-Ending corner.
+Ending corner. This is calculated as ``position + size``. Changing this property changes :ref:`size<class_AABB_property_size>` accordingly.
 
 ----
 
@@ -154,7 +154,7 @@ Returns this ``AABB`` expanded to include a given point.
 
 - :ref:`float<class_float>` **get_area** **(** **)**
 
-Gets the area of the ``AABB``.
+Returns the volume of the ``AABB``.
 
 ----
 
@@ -290,7 +290,7 @@ Returns ``true`` if the ``AABB`` intersects the line segment between ``from`` an
 
 - :ref:`bool<class_bool>` **is_equal_approx** **(** :ref:`AABB<class_AABB>` aabb **)**
 
-Returns ``true`` if this ``AABB`` and ``aabb`` are approximately equal, by calling ``is_equal_approx`` on each component.
+Returns ``true`` if this ``AABB`` and ``aabb`` are approximately equal, by calling :ref:`@GDScript.is_equal_approx<class_@GDScript_method_is_equal_approx>` on each component.
 
 ----
 

classes/class_confirmationdialog.rst

@@ -41,6 +41,12 @@ Description
 
 Dialog for confirmation of actions. This dialog inherits from :ref:`AcceptDialog<class_AcceptDialog>`, but has by default an OK and Cancel button (in host OS order).
 
+To get cancel action, you can use:
+
+::
+
+    get_cancel().connect("pressed", self, "cancelled").
+
 Method Descriptions
 -------------------
 

classes/class_optionbutton.rst

@@ -144,6 +144,8 @@ Property Descriptions
 | *Getter*  | get_selected() |
 +-----------+----------------+
 
+The index of the currently selected item, or ``-1`` if no item is selected.
+
 Method Descriptions
 -------------------
 
@@ -151,7 +153,7 @@ Method Descriptions
 
 - void **add_icon_item** **(** :ref:`Texture<class_Texture>` texture, :ref:`String<class_String>` label, :ref:`int<class_int>` id=-1 **)**
 
-Adds an item, with a ``texture`` icon, text ``label`` and (optionally) ``id``. If no ``id`` is passed, ``id`` becomes the item index. New items are appended at the end.
+Adds an item, with a ``texture`` icon, text ``label`` and (optionally) ``id``. If no ``id`` is passed, the item index will be used as the item's ID. New items are appended at the end.
 
 ----
 
@@ -159,7 +161,7 @@ Adds an item, with a ``texture`` icon, text ``label`` and (optionally) ``id``. I
 
 - void **add_item** **(** :ref:`String<class_String>` label, :ref:`int<class_int>` id=-1 **)**
 
-Adds an item, with text ``label`` and (optionally) ``id``. If no ``id`` is passed, ``id`` becomes the item index. New items are appended at the end.
+Adds an item, with text ``label`` and (optionally) ``id``. If no ``id`` is passed, the item index will be used as the item's ID. New items are appended at the end.
 
 ----
 
@@ -175,7 +177,7 @@ Adds a separator to the list of items. Separators help to group items. Separator
 
 - void **clear** **(** **)**
 
-Clear all the items in the ``OptionButton``.
+Clears all the items in the ``OptionButton``.
 
 ----
 
@@ -183,7 +185,7 @@ Clear all the items in the ``OptionButton``.
 
 - :ref:`int<class_int>` **get_item_count** **(** **)** const
 
-Returns the amount of items in the OptionButton.
+Returns the amount of items in the OptionButton, including separators.
 
 ----
 
@@ -215,6 +217,8 @@ Returns the index of the item with the given ``id``.
 
 - :ref:`Variant<class_Variant>` **get_item_metadata** **(** :ref:`int<class_int>` idx **)** const
 
+Retrieves the metadata of an item. Metadata may be any type and can be used to store extra information about an item, such as an external string ID.
+
 ----
 
 .. _class_OptionButton_method_get_item_text:
@@ -237,31 +241,39 @@ Returns the :ref:`PopupMenu<class_PopupMenu>` contained in this button.
 
 - :ref:`int<class_int>` **get_selected_id** **(** **)** const
 
+Returns the ID of the selected item, or ``0`` if no item is selected.
+
 ----
 
 .. _class_OptionButton_method_get_selected_metadata:
 
 - :ref:`Variant<class_Variant>` **get_selected_metadata** **(** **)** const
 
+Gets the metadata of the selected item. Metadata for items can be set using :ref:`set_item_metadata<class_OptionButton_method_set_item_metadata>`.
+
 ----
 
 .. _class_OptionButton_method_is_item_disabled:
 
 - :ref:`bool<class_bool>` **is_item_disabled** **(** :ref:`int<class_int>` idx **)** const
 
+Returns ``true`` if the item at index ``idx`` is disabled.
+
 ----
 
 .. _class_OptionButton_method_remove_item:
 
 - void **remove_item** **(** :ref:`int<class_int>` idx **)**
 
+Removes the item at index ``idx``.
+
 ----
 
 .. _class_OptionButton_method_select:
 
 - void **select** **(** :ref:`int<class_int>` idx **)**
 
-Select an item by index and make it the current item.
+Selects an item by index and makes it the current item. This will work even if the item is disabled.
 
 ----
 
@@ -269,13 +281,17 @@ Select an item by index and make it the current item.
 
 - void **set_item_disabled** **(** :ref:`int<class_int>` idx, :ref:`bool<class_bool>` disabled **)**
 
+Sets whether the item at index ``idx`` is disabled.
+
+Disabled items are drawn differently in the dropdown and are not selectable by the user. If the current selected item is set as disabled, it will remain selected.
+
 ----
 
 .. _class_OptionButton_method_set_item_icon:
 
 - void **set_item_icon** **(** :ref:`int<class_int>` idx, :ref:`Texture<class_Texture>` texture **)**
 
-Sets the icon of an item at index ``idx``.
+Sets the icon of the item at index ``idx``.
 
 ----
 
@@ -283,7 +299,7 @@ Sets the icon of an item at index ``idx``.
 
 - void **set_item_id** **(** :ref:`int<class_int>` idx, :ref:`int<class_int>` id **)**
 
-Sets the ID of an item at index ``idx``.
+Sets the ID of the item at index ``idx``.
 
 ----
 
@@ -291,11 +307,13 @@ Sets the ID of an item at index ``idx``.
 
 - void **set_item_metadata** **(** :ref:`int<class_int>` idx, :ref:`Variant<class_Variant>` metadata **)**
 
+Sets the metadata of an item. Metadata may be of any type and can be used to store extra information about an item, such as an external string ID.
+
 ----
 
 .. _class_OptionButton_method_set_item_text:
 
 - void **set_item_text** **(** :ref:`int<class_int>` idx, :ref:`String<class_String>` text **)**
 
-Sets the text of an item at index ``idx``.
+Sets the text of the item at index ``idx``.
 

classes/class_plane.rst

@@ -100,6 +100,8 @@ Property Descriptions
 | *Default* | 0.0 |
 +-----------+-----+
 
+Distance from the origin to the plane, in the direction of :ref:`normal<class_Plane_property_normal>`.
+
 ----
 
 .. _class_Plane_property_normal:
@@ -110,6 +112,8 @@ Property Descriptions
 | *Default* | Vector3( 0, 0, 0 ) |
 +-----------+--------------------+
 
+The normal of the plane. "Over" or "Above" the plane is considered the side of the plane towards where the normal is pointing.
+
 ----
 
 .. _class_Plane_property_x:
@@ -120,6 +124,8 @@ Property Descriptions
 | *Default* | 0.0 |
 +-----------+-----+
 
+The :ref:`normal<class_Plane_property_normal>`'s X component.
+
 ----
 
 .. _class_Plane_property_y:
@@ -130,6 +136,8 @@ Property Descriptions
 | *Default* | 0.0 |
 +-----------+-----+
 
+The :ref:`normal<class_Plane_property_normal>`'s Y component.
+
 ----
 
 .. _class_Plane_property_z:
@@ -140,6 +148,8 @@ Property Descriptions
 | *Default* | 0.0 |
 +-----------+-----+
 
+The :ref:`normal<class_Plane_property_normal>`'s Z component.
+
 Method Descriptions
 -------------------
 
@@ -147,13 +157,13 @@ Method Descriptions
 
 - :ref:`Plane<class_Plane>` **Plane** **(** :ref:`float<class_float>` a, :ref:`float<class_float>` b, :ref:`float<class_float>` c, :ref:`float<class_float>` d **)**
 
-Creates a plane from the four parameters ``a``, ``b``, ``c`` and ``d``.
+Creates a plane from the four parameters. The three components of the resulting plane's :ref:`normal<class_Plane_property_normal>` are ``a``, ``b`` and ``c``, and the plane has a distance of ``d`` from the origin.
 
 ----
 
 - :ref:`Plane<class_Plane>` **Plane** **(** :ref:`Vector3<class_Vector3>` v1, :ref:`Vector3<class_Vector3>` v2, :ref:`Vector3<class_Vector3>` v3 **)**
 
-Creates a plane from three points.
+Creates a plane from the three points, given in clockwise order.
 
 ----
 

classes/class_visualserver.rst

@@ -756,12 +756,16 @@ Signals
 
 - **frame_post_draw** **(** **)**
 
+Emitted at the end of the frame, after the VisualServer has finished updating all the Viewports.
+
 ----
 
 .. _class_VisualServer_signal_frame_pre_draw:
 
 - **frame_pre_draw** **(** **)**
 
+Emitted at the beginning of the frame, before the VisualServer updates all the Viewports.
+
 Enumerations
 ------------
 
@@ -1904,48 +1908,64 @@ Sets margin size, where black bars (or images, if :ref:`black_bars_set_images<cl
 
 - :ref:`RID<class_RID>` **camera_create** **(** **)**
 
+Creates a camera and adds it to the VisualServer. It can be accessed with the RID that is returned. This RID will be used in all ``camera_*`` VisualServer functions.
+
 ----
 
 .. _class_VisualServer_method_camera_set_cull_mask:
 
 - void **camera_set_cull_mask** **(** :ref:`RID<class_RID>` camera, :ref:`int<class_int>` layers **)**
 
+Sets the cull mask associated with this camera. The cull mask describes which 3d layers are rendered by this camera. Equivalent to :ref:`Camera.cull_mask<class_Camera_property_cull_mask>`.
+
 ----
 
 .. _class_VisualServer_method_camera_set_environment:
 
 - void **camera_set_environment** **(** :ref:`RID<class_RID>` camera, :ref:`RID<class_RID>` env **)**
 
+Sets the environment used by this camera. Equivalent to :ref:`Camera.environment<class_Camera_property_environment>`.
+
 ----
 
 .. _class_VisualServer_method_camera_set_frustum:
 
 - void **camera_set_frustum** **(** :ref:`RID<class_RID>` camera, :ref:`float<class_float>` size, :ref:`Vector2<class_Vector2>` offset, :ref:`float<class_float>` z_near, :ref:`float<class_float>` z_far **)**
 
+Sets camera to use frustum projection. This mode allows adjusting the ``offset`` argument to create "tilted frustum" effects.
+
 ----
 
 .. _class_VisualServer_method_camera_set_orthogonal:
 
 - void **camera_set_orthogonal** **(** :ref:`RID<class_RID>` camera, :ref:`float<class_float>` size, :ref:`float<class_float>` z_near, :ref:`float<class_float>` z_far **)**
 
+Sets camera to use orthogonal projection, also known as orthographic projection. Objects remain the same size on the screen no matter how far away they are.
+
 ----
 
 .. _class_VisualServer_method_camera_set_perspective:
 
 - void **camera_set_perspective** **(** :ref:`RID<class_RID>` camera, :ref:`float<class_float>` fovy_degrees, :ref:`float<class_float>` z_near, :ref:`float<class_float>` z_far **)**
 
+Sets camera to use perspective projection. Objects on the screen becomes smaller when they are far away.
+
 ----
 
 .. _class_VisualServer_method_camera_set_transform:
 
 - void **camera_set_transform** **(** :ref:`RID<class_RID>` camera, :ref:`Transform<class_Transform>` transform **)**
 
+Sets :ref:`Transform<class_Transform>` of camera.
+
 ----
 
 .. _class_VisualServer_method_camera_set_use_vertical_aspect:
 
 - void **camera_set_use_vertical_aspect** **(** :ref:`RID<class_RID>` camera, :ref:`bool<class_bool>` enable **)**
 
+If ``true``, preserves the horizontal aspect ratio which is equivalent to :ref:`Camera.KEEP_WIDTH<class_Camera_constant_KEEP_WIDTH>`. If ``false``, preserves the vertical aspect ratio which is equivalent to :ref:`Camera.KEEP_HEIGHT<class_Camera_constant_KEEP_HEIGHT>`.
+
 ----
 
 .. _class_VisualServer_method_canvas_create:
@@ -1984,6 +2004,8 @@ Adds a line command to the :ref:`CanvasItem<class_CanvasItem>`'s draw commands.
 
 - void **canvas_item_add_mesh** **(** :ref:`RID<class_RID>` item, :ref:`RID<class_RID>` mesh, :ref:`Transform2D<class_Transform2D>` transform=Transform2D( 1, 0, 0, 1, 0, 0 ), :ref:`Color<class_Color>` modulate=Color( 1, 1, 1, 1 ), :ref:`RID<class_RID>` texture, :ref:`RID<class_RID>` normal_map **)**
 
+Adds a mesh command to the :ref:`CanvasItem<class_CanvasItem>`'s draw commands.
+
 ----
 
 .. _class_VisualServer_method_canvas_item_add_multimesh:
@@ -2074,6 +2096,8 @@ Adds a texture rect with region setting to the :ref:`CanvasItem<class_CanvasItem
 
 - void **canvas_item_add_triangle_array** **(** :ref:`RID<class_RID>` item, :ref:`PoolIntArray<class_PoolIntArray>` indices, :ref:`PoolVector2Array<class_PoolVector2Array>` points, :ref:`PoolColorArray<class_PoolColorArray>` colors, :ref:`PoolVector2Array<class_PoolVector2Array>` uvs=PoolVector2Array(  ), :ref:`PoolIntArray<class_PoolIntArray>` bones=PoolIntArray(  ), :ref:`PoolRealArray<class_PoolRealArray>` weights=PoolRealArray(  ), :ref:`RID<class_RID>` texture, :ref:`int<class_int>` count=-1, :ref:`RID<class_RID>` normal_map, :ref:`bool<class_bool>` antialiased=false **)**
 
+Adds a triangle array to the :ref:`CanvasItem<class_CanvasItem>`'s draw commands.
+
 ----
 
 .. _class_VisualServer_method_canvas_item_clear:
@@ -2120,6 +2144,8 @@ Defines a custom drawing rectangle for the :ref:`CanvasItem<class_CanvasItem>`.
 
 - void **canvas_item_set_distance_field_mode** **(** :ref:`RID<class_RID>` item, :ref:`bool<class_bool>` enabled **)**
 
+Enables the use of distance fields for GUI elements that are rendering distance field based fonts.
+
 ----
 
 .. _class_VisualServer_method_canvas_item_set_draw_behind_parent:
@@ -2358,6 +2384,8 @@ The mode of the light, see :ref:`CanvasLightMode<enum_VisualServer_CanvasLightMo
 
 - void **canvas_light_set_scale** **(** :ref:`RID<class_RID>` light, :ref:`float<class_float>` scale **)**
 
+Sets the texture's scale factor of the light. Equivalent to :ref:`Light2D.texture_scale<class_Light2D_property_texture_scale>`.
+
 ----
 
 .. _class_VisualServer_method_canvas_light_set_shadow_buffer_size:
@@ -2412,12 +2440,16 @@ Smoothens the shadow. The lower, the smoother.
 
 - void **canvas_light_set_texture** **(** :ref:`RID<class_RID>` light, :ref:`RID<class_RID>` texture **)**
 
+Sets texture to be used by light. Equivalent to :ref:`Light2D.texture<class_Light2D_property_texture>`.
+
 ----
 
 .. _class_VisualServer_method_canvas_light_set_texture_offset:
 
 - void **canvas_light_set_texture_offset** **(** :ref:`RID<class_RID>` light, :ref:`Vector2<class_Vector2>` offset **)**
 
+Sets the offset of the light's texture. Equivalent to :ref:`Light2D.offset<class_Light2D_property_offset>`.
+
 ----
 
 .. _class_VisualServer_method_canvas_light_set_transform:
@@ -2432,6 +2464,8 @@ Sets the canvas light's :ref:`Transform2D<class_Transform2D>`.
 
 - void **canvas_light_set_z_range** **(** :ref:`RID<class_RID>` light, :ref:`int<class_int>` min_z, :ref:`int<class_int>` max_z **)**
 
+Sets the Z range of objects that will be affected by this light. Equivalent to :ref:`Light2D.range_z_min<class_Light2D_property_range_z_min>` and :ref:`Light2D.range_z_max<class_Light2D_property_range_z_max>`.
+
 ----
 
 .. _class_VisualServer_method_canvas_occluder_polygon_create:
@@ -2486,126 +2520,168 @@ Modulates all colors in the given canvas.
 
 - :ref:`RID<class_RID>` **directional_light_create** **(** **)**
 
+Creates a directional light and adds it to the VisualServer. It can be accessed with the RID that is returned. This RID can be used in most ``light_*`` VisualServer functions.
+
 ----
 
 .. _class_VisualServer_method_draw:
 
 - void **draw** **(** :ref:`bool<class_bool>` swap_buffers=true, :ref:`float<class_float>` frame_step=0.0 **)**
 
+Draws a frame. *This method is deprecated*, please use :ref:`force_draw<class_VisualServer_method_force_draw>` instead.
+
 ----
 
 .. _class_VisualServer_method_environment_create:
 
 - :ref:`RID<class_RID>` **environment_create** **(** **)**
 
+Creates an environment and adds it to the VisualServer. It can be accessed with the RID that is returned. This RID will be used in all ``environment_*`` VisualServer functions.
+
 ----
 
 .. _class_VisualServer_method_environment_set_adjustment:
 
 - void **environment_set_adjustment** **(** :ref:`RID<class_RID>` env, :ref:`bool<class_bool>` enable, :ref:`float<class_float>` brightness, :ref:`float<class_float>` contrast, :ref:`float<class_float>` saturation, :ref:`RID<class_RID>` ramp **)**
 
+Sets the values to be used with the "Adjustment" post-process effect. See :ref:`Environment<class_Environment>` for more details.
+
 ----
 
 .. _class_VisualServer_method_environment_set_ambient_light:
 
 - void **environment_set_ambient_light** **(** :ref:`RID<class_RID>` env, :ref:`Color<class_Color>` color, :ref:`float<class_float>` energy=1.0, :ref:`float<class_float>` sky_contibution=0.0 **)**
 
+Sets the ambient light parameters. See :ref:`Environment<class_Environment>` for more details.
+
 ----
 
 .. _class_VisualServer_method_environment_set_background:
 
 - void **environment_set_background** **(** :ref:`RID<class_RID>` env, :ref:`EnvironmentBG<enum_VisualServer_EnvironmentBG>` bg **)**
 
+Sets the *BGMode* of the environment. Equivalent to :ref:`Environment.background_mode<class_Environment_property_background_mode>`.
+
 ----
 
 .. _class_VisualServer_method_environment_set_bg_color:
 
 - void **environment_set_bg_color** **(** :ref:`RID<class_RID>` env, :ref:`Color<class_Color>` color **)**
 
+Color displayed for clear areas of the scene (if using Custom color or Color+Sky background modes).
+
 ----
 
 .. _class_VisualServer_method_environment_set_bg_energy:
 
 - void **environment_set_bg_energy** **(** :ref:`RID<class_RID>` env, :ref:`float<class_float>` energy **)**
 
+Sets the intensity of the background color.
+
 ----
 
 .. _class_VisualServer_method_environment_set_canvas_max_layer:
 
 - void **environment_set_canvas_max_layer** **(** :ref:`RID<class_RID>` env, :ref:`int<class_int>` max_layer **)**
 
+Sets the maximum layer to use if using Canvas background mode.
+
 ----
 
 .. _class_VisualServer_method_environment_set_dof_blur_far:
 
 - void **environment_set_dof_blur_far** **(** :ref:`RID<class_RID>` env, :ref:`bool<class_bool>` enable, :ref:`float<class_float>` distance, :ref:`float<class_float>` transition, :ref:`float<class_float>` far_amount, :ref:`EnvironmentDOFBlurQuality<enum_VisualServer_EnvironmentDOFBlurQuality>` quality **)**
 
+Sets the values to be used with the "DoF Far Blur" post-process effect. See :ref:`Environment<class_Environment>` for more details.
+
 ----
 
 .. _class_VisualServer_method_environment_set_dof_blur_near:
 
 - void **environment_set_dof_blur_near** **(** :ref:`RID<class_RID>` env, :ref:`bool<class_bool>` enable, :ref:`float<class_float>` distance, :ref:`float<class_float>` transition, :ref:`float<class_float>` far_amount, :ref:`EnvironmentDOFBlurQuality<enum_VisualServer_EnvironmentDOFBlurQuality>` quality **)**
 
+Sets the values to be used with the "DoF Near Blur" post-process effect. See :ref:`Environment<class_Environment>` for more details.
+
 ----
 
 .. _class_VisualServer_method_environment_set_fog:
 
 - void **environment_set_fog** **(** :ref:`RID<class_RID>` env, :ref:`bool<class_bool>` enable, :ref:`Color<class_Color>` color, :ref:`Color<class_Color>` sun_color, :ref:`float<class_float>` sun_amount **)**
 
+Sets the variables to be used with the scene fog. See :ref:`Environment<class_Environment>` for more details.
+
 ----
 
 .. _class_VisualServer_method_environment_set_fog_depth:
 
 - void **environment_set_fog_depth** **(** :ref:`RID<class_RID>` env, :ref:`bool<class_bool>` enable, :ref:`float<class_float>` depth_begin, :ref:`float<class_float>` depth_end, :ref:`float<class_float>` depth_curve, :ref:`bool<class_bool>` transmit, :ref:`float<class_float>` transmit_curve **)**
 
+Sets the variables to be used with the fog depth effect. See :ref:`Environment<class_Environment>` for more details.
+
 ----
 
 .. _class_VisualServer_method_environment_set_fog_height:
 
 - void **environment_set_fog_height** **(** :ref:`RID<class_RID>` env, :ref:`bool<class_bool>` enable, :ref:`float<class_float>` min_height, :ref:`float<class_float>` max_height, :ref:`float<class_float>` height_curve **)**
 
+Sets the variables to be used with the fog height effect. See :ref:`Environment<class_Environment>` for more details.
+
 ----
 
 .. _class_VisualServer_method_environment_set_glow:
 
 - void **environment_set_glow** **(** :ref:`RID<class_RID>` env, :ref:`bool<class_bool>` enable, :ref:`int<class_int>` level_flags, :ref:`float<class_float>` intensity, :ref:`float<class_float>` strength, :ref:`float<class_float>` bloom_threshold, :ref:`EnvironmentGlowBlendMode<enum_VisualServer_EnvironmentGlowBlendMode>` blend_mode, :ref:`float<class_float>` hdr_bleed_threshold, :ref:`float<class_float>` hdr_bleed_scale, :ref:`float<class_float>` hdr_luminance_cap, :ref:`bool<class_bool>` bicubic_upscale **)**
 
+Sets the variables to be used with the "glow" post-process effect. See :ref:`Environment<class_Environment>` for more details.
+
 ----
 
 .. _class_VisualServer_method_environment_set_sky:
 
 - void **environment_set_sky** **(** :ref:`RID<class_RID>` env, :ref:`RID<class_RID>` sky **)**
 
+Sets the :ref:`Sky<class_Sky>` to be used as the environment's background when using *BGMode* sky. Equivalent to :ref:`Environment.background_sky<class_Environment_property_background_sky>`.
+
 ----
 
 .. _class_VisualServer_method_environment_set_sky_custom_fov:
 
 - void **environment_set_sky_custom_fov** **(** :ref:`RID<class_RID>` env, :ref:`float<class_float>` scale **)**
 
+Sets a custom field of view for the background :ref:`Sky<class_Sky>`. Equivalent to :ref:`Environment.background_sky_custom_fov<class_Environment_property_background_sky_custom_fov>`.
+
 ----
 
 .. _class_VisualServer_method_environment_set_sky_orientation:
 
 - void **environment_set_sky_orientation** **(** :ref:`RID<class_RID>` env, :ref:`Basis<class_Basis>` orientation **)**
 
+Sets the rotation of the background :ref:`Sky<class_Sky>` expressed as a :ref:`Basis<class_Basis>`. Equivalent to :ref:`Environment.background_sky_orientation<class_Environment_property_background_sky_orientation>`.
+
 ----
 
 .. _class_VisualServer_method_environment_set_ssao:
 
 - void **environment_set_ssao** **(** :ref:`RID<class_RID>` env, :ref:`bool<class_bool>` enable, :ref:`float<class_float>` radius, :ref:`float<class_float>` intensity, :ref:`float<class_float>` radius2, :ref:`float<class_float>` intensity2, :ref:`float<class_float>` bias, :ref:`float<class_float>` light_affect, :ref:`float<class_float>` ao_channel_affect, :ref:`Color<class_Color>` color, :ref:`EnvironmentSSAOQuality<enum_VisualServer_EnvironmentSSAOQuality>` quality, :ref:`EnvironmentSSAOBlur<enum_VisualServer_EnvironmentSSAOBlur>` blur, :ref:`float<class_float>` bilateral_sharpness **)**
 
+Sets the variables to be used with the "Screen Space Ambient Occlusion (SSAO)" post-process effect. See :ref:`Environment<class_Environment>` for more details.
+
 ----
 
 .. _class_VisualServer_method_environment_set_ssr:
 
 - void **environment_set_ssr** **(** :ref:`RID<class_RID>` env, :ref:`bool<class_bool>` enable, :ref:`int<class_int>` max_steps, :ref:`float<class_float>` fade_in, :ref:`float<class_float>` fade_out, :ref:`float<class_float>` depth_tolerance, :ref:`bool<class_bool>` roughness **)**
 
+Sets the variables to be used with the "screen space reflections" post-process effect. See :ref:`Environment<class_Environment>` for more details.
+
 ----
 
 .. _class_VisualServer_method_environment_set_tonemap:
 
 - void **environment_set_tonemap** **(** :ref:`RID<class_RID>` env, :ref:`EnvironmentToneMapper<enum_VisualServer_EnvironmentToneMapper>` tone_mapper, :ref:`float<class_float>` exposure, :ref:`float<class_float>` white, :ref:`bool<class_bool>` auto_exposure, :ref:`float<class_float>` min_luminance, :ref:`float<class_float>` max_luminance, :ref:`float<class_float>` auto_exp_speed, :ref:`float<class_float>` auto_exp_grey **)**
 
+Sets the variables to be used with the "tonemap" post-process effect. See :ref:`Environment<class_Environment>` for more details.
+
 ----
 
 .. _class_VisualServer_method_finish:
@@ -2620,6 +2696,8 @@ Removes buffers and clears testcubes.
 
 - void **force_draw** **(** :ref:`bool<class_bool>` swap_buffers=true, :ref:`float<class_float>` frame_step=0.0 **)**
 
+Forces a frame to be drawn when the function is called. Drawing a frame updates all :ref:`Viewport<class_Viewport>`\ s that are set to update. Use with extreme caution.
+
 ----
 
 .. _class_VisualServer_method_force_sync:
@@ -2834,72 +2912,96 @@ Returns ``true`` if the OS supports a certain feature. Features might be s3tc, e
 
 - void **immediate_begin** **(** :ref:`RID<class_RID>` immediate, :ref:`PrimitiveType<enum_VisualServer_PrimitiveType>` primitive, :ref:`RID<class_RID>` texture **)**
 
+Sets up :ref:`ImmediateGeometry<class_ImmediateGeometry>` internals to prepare for drawing. Equivalent to :ref:`ImmediateGeometry.begin<class_ImmediateGeometry_method_begin>`.
+
 ----
 
 .. _class_VisualServer_method_immediate_clear:
 
 - void **immediate_clear** **(** :ref:`RID<class_RID>` immediate **)**
 
+Clears everything that was set up between :ref:`immediate_begin<class_VisualServer_method_immediate_begin>` and :ref:`immediate_end<class_VisualServer_method_immediate_end>`. Equivalent to :ref:`ImmediateGeometry.clear<class_ImmediateGeometry_method_clear>`.
+
 ----
 
 .. _class_VisualServer_method_immediate_color:
 
 - void **immediate_color** **(** :ref:`RID<class_RID>` immediate, :ref:`Color<class_Color>` color **)**
 
+Sets the color to be used with next vertex. Equivalent to :ref:`ImmediateGeometry.set_color<class_ImmediateGeometry_method_set_color>`.
+
 ----
 
 .. _class_VisualServer_method_immediate_create:
 
 - :ref:`RID<class_RID>` **immediate_create** **(** **)**
 
+Creates an :ref:`ImmediateGeometry<class_ImmediateGeometry>` and adds it to the VisualServer. It can be accessed with the RID that is returned. This RID will be used in all ``immediate_*`` VisualServer functions.
+
 ----
 
 .. _class_VisualServer_method_immediate_end:
 
 - void **immediate_end** **(** :ref:`RID<class_RID>` immediate **)**
 
+Ends drawing the :ref:`ImmediateGeometry<class_ImmediateGeometry>` and displays it. Equivalent to :ref:`ImmediateGeometry.end<class_ImmediateGeometry_method_end>`.
+
 ----
 
 .. _class_VisualServer_method_immediate_get_material:
 
 - :ref:`RID<class_RID>` **immediate_get_material** **(** :ref:`RID<class_RID>` immediate **)** const
 
+Returns the material assigned to the :ref:`ImmediateGeometry<class_ImmediateGeometry>`.
+
 ----
 
 .. _class_VisualServer_method_immediate_normal:
 
 - void **immediate_normal** **(** :ref:`RID<class_RID>` immediate, :ref:`Vector3<class_Vector3>` normal **)**
 
+Sets the normal to be used with next vertex. Equivalent to :ref:`ImmediateGeometry.set_normal<class_ImmediateGeometry_method_set_normal>`.
+
 ----
 
 .. _class_VisualServer_method_immediate_set_material:
 
 - void **immediate_set_material** **(** :ref:`RID<class_RID>` immediate, :ref:`RID<class_RID>` material **)**
 
+Sets the material to be used to draw the :ref:`ImmediateGeometry<class_ImmediateGeometry>`.
+
 ----
 
 .. _class_VisualServer_method_immediate_tangent:
 
 - void **immediate_tangent** **(** :ref:`RID<class_RID>` immediate, :ref:`Plane<class_Plane>` tangent **)**
 
+Sets the tangent to be used with next vertex. Equivalent to :ref:`ImmediateGeometry.set_tangent<class_ImmediateGeometry_method_set_tangent>`.
+
 ----
 
 .. _class_VisualServer_method_immediate_uv:
 
 - void **immediate_uv** **(** :ref:`RID<class_RID>` immediate, :ref:`Vector2<class_Vector2>` tex_uv **)**
 
+Sets the UV to be used with next vertex. Equivalent to :ref:`ImmediateGeometry.set_uv<class_ImmediateGeometry_method_set_uv>`.
+
 ----
 
 .. _class_VisualServer_method_immediate_uv2:
 
 - void **immediate_uv2** **(** :ref:`RID<class_RID>` immediate, :ref:`Vector2<class_Vector2>` tex_uv **)**
 
+Sets the UV2 to be used with next vertex. Equivalent to :ref:`ImmediateGeometry.set_uv2<class_ImmediateGeometry_method_set_uv2>`.
+
 ----
 
 .. _class_VisualServer_method_immediate_vertex:
 
 - void **immediate_vertex** **(** :ref:`RID<class_RID>` immediate, :ref:`Vector3<class_Vector3>` vertex **)**
 
+Adds the next vertex using the information provided in advance. Equivalent to :ref:`ImmediateGeometry.add_vertex<class_ImmediateGeometry_method_add_vertex>`.
+
 ----
 
 .. _class_VisualServer_method_immediate_vertex_2d: