classref: Sync with current upstream master branch

classes/[email protected]

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the @GDScript.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_@GDScript:
 
@@ -77,9 +78,9 @@ Member Functions
 +------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`float<class_float>`                      | :ref:`inverse_lerp<class_@GDScript_inverse_lerp>`  **(** :ref:`float<class_float>` from, :ref:`float<class_float>` to, :ref:`float<class_float>` value  **)**                                                                     |
 +------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`float<class_float>`                      | :ref:`is_inf<class_@GDScript_is_inf>`  **(** :ref:`float<class_float>` s  **)**                                                                                                                                                   |
+| :ref:`bool<class_bool>`                        | :ref:`is_inf<class_@GDScript_is_inf>`  **(** :ref:`float<class_float>` s  **)**                                                                                                                                                   |
 +------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`float<class_float>`                      | :ref:`is_nan<class_@GDScript_is_nan>`  **(** :ref:`float<class_float>` s  **)**                                                                                                                                                   |
+| :ref:`bool<class_bool>`                        | :ref:`is_nan<class_@GDScript_is_nan>`  **(** :ref:`float<class_float>` s  **)**                                                                                                                                                   |
 +------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`int<class_int>`                          | :ref:`len<class_@GDScript_len>`  **(** :ref:`Variant<class_variant>` var  **)**                                                                                                                                                   |
 +------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@@ -191,117 +192,228 @@ Member Function Description
 
 - :ref:`Color<class_color>`  **Color8**  **(** :ref:`int<class_int>` r8, :ref:`int<class_int>` g8, :ref:`int<class_int>` b8, :ref:`int<class_int>` a8  **)**
 
-Make a color from red, green, blue and alpha. Arguments can range from 0 to 255.
+Returns a 32 bit color with red, green, blue and alpha channels. Each channel has 8 bits of information ranging from 0 to 255.
+
+``r8`` red channel
+
+``g8`` green channel
+
+``b8`` blue channel
+
+``a8`` alpha channel
+
+::
+
+    red = Color8(255, 0, 0)
 
 .. _class_@GDScript_ColorN:
 
 - :ref:`Color<class_color>`  **ColorN**  **(** :ref:`String<class_string>` name, :ref:`float<class_float>` alpha  **)**
 
+Returns color ``name`` with ``alpha`` ranging from 0 to 1. Note: ``name`` is defined in color_names.inc.
+
+::
+
+    red = ColorN('red')
+
 .. _class_@GDScript_abs:
 
 - :ref:`float<class_float>`  **abs**  **(** :ref:`float<class_float>` s  **)**
 
-Returns the absolute value of parameter s  (i.e. unsigned value, works for integer and float).
+Returns the absolute value of parameter ``s``  (i.e. unsigned value, works for integer and float).
+
+::
+
+    # a is 1
+    a = abs(-1)
 
 .. _class_@GDScript_acos:
 
 - :ref:`float<class_float>`  **acos**  **(** :ref:`float<class_float>` s  **)**
 
-Returns the principal value of the arc cosine of s, expressed in radians. In trigonometrics, arc cosine is the inverse operation of cosine.
+Returns the arc cosine of ``s`` in radians. Use to get the angle of cosine ``s``.
+
+::
+
+    # c is 0.523599 or 30 degrees if converted with rad2deg(s)
+    c = acos(0.866025)
 
 .. _class_@GDScript_asin:
 
 - :ref:`float<class_float>`  **asin**  **(** :ref:`float<class_float>` s  **)**
 
-Returns the principal value of the arc sine of s, expressed in radians. In trigonometrics, arc sine is the inverse operation of sine.
+Returns the arc sine of ``s`` in radians. Use to get the angle of sine ``s``.
+
+::
+
+    # s is 0.523599 or 30 degrees if converted with rad2deg(s)
+    s = asin(0.5)
 
 .. _class_@GDScript_assert:
 
 - void  **assert**  **(** :ref:`bool<class_bool>` condition  **)**
 
-Assert that the condition is true. If the condition is false, generates an error.
+Assert that the ``condition`` is true. If the ``condition`` is false a fatal error is generated and the program is halted. Useful for debugging to make sure a value is always true.
+
+::
+
+    # Speed should always be between 0 and 20
+    speed = -10
+    assert(speed < 20) # Is true and program continues
+    assert(speed >= 0) # Is false and program stops
+    assert(speed >= 0 && speed < 20) # Or combined
 
 .. _class_@GDScript_atan:
 
 - :ref:`float<class_float>`  **atan**  **(** :ref:`float<class_float>` s  **)**
 
-Returns the principal value of the arc tangent of s, expressed in radians. In trigonometrics, arc tangent is the inverse operation of tangent. Notice that because of the sign ambiguity, the function cannot determine with certainty in which quadrant the angle falls only by its tangent value. See :ref:`atan2<class_@GDScript_atan2>` for an alternative that takes a fractional argument instead.
+Returns the arc tangent of ``s`` in radians. Use it to get the angle from an angle's tangent in trigonometry: ``atan(tan(angle)) == angle``.
+
+The method cannot know in which quadrant the angle should fall. See :ref:`atan2<class_@GDScript_atan2>` if you always want an exact angle.
+
+::
+
+    a = atan(0.5) # a is 0.463648
 
 .. _class_@GDScript_atan2:
 
 - :ref:`float<class_float>`  **atan2**  **(** :ref:`float<class_float>` x, :ref:`float<class_float>` y  **)**
 
-Returns the principal value of the arc tangent of y/x, expressed in radians. To compute the value, the function takes into account the sign of both arguments in order to determine the quadrant.
+Returns the arc tangent of ``y/x`` in radians. Use to get the angle of tangent ``y/x``. To compute the value, the method takes into account the sign of both arguments in order to determine the quadrant.
+
+::
+
+    a = atan(0,-1) # a is 3.141593
 
 .. _class_@GDScript_bytes2var:
 
 - :ref:`Variant<class_variant>`  **bytes2var**  **(** :ref:`PoolByteArray<class_poolbytearray>` bytes  **)**
 
-Decode a byte array back to a value.
+Decodes a byte array back to a value.
 
 .. _class_@GDScript_ceil:
 
 - :ref:`float<class_float>`  **ceil**  **(** :ref:`float<class_float>` s  **)**
 
-Rounds s upward, returning the smallest integral value that is not less than s.
+Rounds ``s`` upward, returning the smallest integral value that is not less than ``s``.
+
+::
+
+    i = ceil(1.45)  # i is 2
+    i = ceil(1.001) # i is 2
 
 .. _class_@GDScript_char:
 
 - :ref:`String<class_string>`  **char**  **(** :ref:`int<class_int>` ascii  **)**
 
+Returns a character as a String of the given ASCII code.
+
+::
+
+    # a is 'A'
+    a = char(65)
+    # a is 'a'
+    a = char(65+32)
+
 .. _class_@GDScript_clamp:
 
 - :ref:`float<class_float>`  **clamp**  **(** :ref:`float<class_float>` val, :ref:`float<class_float>` min, :ref:`float<class_float>` max  **)**
 
-Clamps a value between a minimum and maximum value.
+Clamps ``val`` and returns a value not less than ``min`` and not more than ``max``.
+
+::
+
+    speed = 1000
+    # a is 20
+    a = clamp(speed, 1, 20)
+    
+    speed = -10
+    # a is 1
+    a = clamp(speed, 1, 20)
 
 .. _class_@GDScript_convert:
 
 - :ref:`Object<class_object>`  **convert**  **(** :ref:`Variant<class_variant>` what, :ref:`int<class_int>` type  **)**
 
-Convert from a type to another in the best way possible. The "type" parameter uses the enum TYPE\_\* in :ref:`@Global Scope<class_@global scope>`.
+Converts from a type to another in the best way possible. The ``type`` parameter uses the enum TYPE\_\* in :ref:`@Global Scope<class_@global scope>`.
+
+::
+
+    a = Vector2(1, 0)
+    # prints 1
+    print(a.length())
+    a = convert(a, TYPE_STRING)
+    # prints 6
+    # (1, 0) is 6 characters
+    print(a.length())
 
 .. _class_@GDScript_cos:
 
 - :ref:`float<class_float>`  **cos**  **(** :ref:`float<class_float>` s  **)**
 
-Returns the cosine of an angle of s radians.
+Returns the cosine of angle ``s`` in radians.
+
+::
+
+    # prints 1 and -1
+    print(cos(PI\*2))
+    print(cos(PI))
 
 .. _class_@GDScript_cosh:
 
 - :ref:`float<class_float>`  **cosh**  **(** :ref:`float<class_float>` s  **)**
 
-Returns the hyperbolic cosine of s.
+Returns the hyperbolic cosine of ``s`` in radians.
+
+::
+
+    # prints 1.543081
+    print(cosh(1))
 
 .. _class_@GDScript_db2linear:
 
 - :ref:`float<class_float>`  **db2linear**  **(** :ref:`float<class_float>` db  **)**
 
-Convert from decibels to linear energy (audio).
+Converts from decibels to linear energy (audio).
 
 .. _class_@GDScript_decimals:
 
 - :ref:`float<class_float>`  **decimals**  **(** :ref:`float<class_float>` step  **)**
 
-Return the amount of decimals in the floating point value.
+Returns the position of the first non-zero digit, after the decimal point.
+
+::
+
+    # n is 2
+    n = decimals(0.035)
 
 .. _class_@GDScript_dectime:
 
 - :ref:`float<class_float>`  **dectime**  **(** :ref:`float<class_float>` value, :ref:`float<class_float>` amount, :ref:`float<class_float>` step  **)**
 
-Decreases time by a specified amount.
+Returns the result of ``value`` decreased by ``step`` \* ``amount``.
+
+::
+
+    # a = 59
+    a = dectime(60, 10, 0.1))
 
 .. _class_@GDScript_deg2rad:
 
 - :ref:`float<class_float>`  **deg2rad**  **(** :ref:`float<class_float>` deg  **)**
 
-Convert from degrees to radians.
+Returns degrees converted to radians.
+
+::
+
+    # r is 3.141593
+    r = deg2rad(180)
 
 .. _class_@GDScript_dict2inst:
 
 - :ref:`Object<class_object>`  **dict2inst**  **(** :ref:`Dictionary<class_dictionary>` dict  **)**
 
-Convert a previously converted instances to dictionary back into an instance. Useful for deserializing.
+Converts a previously converted instance to a dictionary, back into an instance. Useful for deserializing.
 
 .. _class_@GDScript_ease:
 
@@ -313,117 +425,226 @@ Easing function, based on exponent. 0 is constant, 1 is linear, 0 to 1 is ease-i
 
 - :ref:`float<class_float>`  **exp**  **(** :ref:`float<class_float>` s  **)**
 
-Returns the base-e exponential function of s, which is e raised to the power s: e^s.
+Raises the Euler's constant **e** to the power of ``s`` and returns it. **e** has an approximate value of 2.71828.
+
+::
+
+    a = exp(2) # approximately 7.39
 
 .. _class_@GDScript_floor:
 
 - :ref:`float<class_float>`  **floor**  **(** :ref:`float<class_float>` s  **)**
 
-Rounds s downward, returning the largest integral value that is not greater than s.
+Rounds ``s`` to the closest smaller integer and returns it.
+
+::
+
+    # a is 2
+    a = floor(2.99)
+    # a is -3
+    a = floor(-2.99)
 
 .. _class_@GDScript_fmod:
 
 - :ref:`float<class_float>`  **fmod**  **(** :ref:`float<class_float>` x, :ref:`float<class_float>` y  **)**
 
-Returns the floating-point remainder of x/y (rounded towards zero):
+Returns the floating-point remainder of ``x/y``.
 
 ::
 
-    fmod = x - tquot \* y
-
-Where tquot is the truncated (i.e., rounded towards zero) result of: x/y.
+    # remainder is 1.5
+    var remainder = fmod(7, 5.5)
 
 .. _class_@GDScript_fposmod:
 
 - :ref:`float<class_float>`  **fposmod**  **(** :ref:`float<class_float>` x, :ref:`float<class_float>` y  **)**
 
-Module (remainder of x/y) that wraps equally in positive and negative.
+Returns the floating-point remainder of ``x/y`` that wraps equally in positive and negative.
+
+::
+
+    var i = -10;
+    while i < 0:
+        prints(i, fposmod(i, 10))
+        i += 1
+
+Produces:
+
+::
+
+    -10 10
+    -9 1
+    -8 2
+    -7 3
+    -6 4
+    -5 5
+    -4 6
+    -3 7
+    -2 8
+    -1 9
 
 .. _class_@GDScript_funcref:
 
 - :ref:`Object<class_object>`  **funcref**  **(** :ref:`Object<class_object>` instance, :ref:`String<class_string>` funcname  **)**
 
-Return a reference to the specified function.
+Returns a reference to the specified function ``funcname`` in the ``instance`` node. As functions aren't first-class objects in GDscript, use ``funcref`` to store a :ref:`FuncRef<class_funcref>` in a variable and call it later.
+
+::
+
+    func foo():
+        return("bar")
+    
+    a = funcref(self, "foo")
+    print(a.call_func()) # prints bar
 
 .. _class_@GDScript_hash:
 
 - :ref:`int<class_int>`  **hash**  **(** :ref:`Variant<class_variant>` var  **)**
 
-Hash the variable passed and return an integer.
+Returns the integer hash of the variable passed.
+
+::
+
+    print(hash("a")) # prints 177670
 
 .. _class_@GDScript_inst2dict:
 
 - :ref:`Dictionary<class_dictionary>`  **inst2dict**  **(** :ref:`Object<class_object>` inst  **)**
 
-Convert a script class instance to a dictionary (useful for serializing).
+Returns the passed instance converted to a dictionary (useful for serializing).
+
+::
+
+    var foo = "bar"
+    func _ready():
+        var d = inst2dict(self)
+        print(d.keys())
+        print(d.values())
+
+Prints out:
+
+::
+
+    [@subpath, @path, foo]
+    [, res://test.gd, bar]
 
 .. _class_@GDScript_instance_from_id:
 
 - :ref:`Object<class_object>`  **instance_from_id**  **(** :ref:`int<class_int>` instance_id  **)**
 
-Get an object by its ID.
+Returns the Object that corresponds to ``instance_id``. All Objects have a unique instance ID.
+
+::
+
+    var foo = "bar"
+    func _ready():
+        var id = get_instance_id()
+        var inst = instance_from_id(id)
+        print(inst.foo) # prints bar
 
 .. _class_@GDScript_inverse_lerp:
 
 - :ref:`float<class_float>`  **inverse_lerp**  **(** :ref:`float<class_float>` from, :ref:`float<class_float>` to, :ref:`float<class_float>` value  **)**
 
+Returns a normalized value considering the given range.
+
+::
+
+    inverse_lerp(3, 5, 4) # returns 0.5
+
 .. _class_@GDScript_is_inf:
 
-- :ref:`float<class_float>`  **is_inf**  **(** :ref:`float<class_float>` s  **)**
+- :ref:`bool<class_bool>`  **is_inf**  **(** :ref:`float<class_float>` s  **)**
 
-Returns whether s is an infinity value (either positive infinity or negative infinity).
+Returns True/False whether ``s`` is an infinity value (either positive infinity or negative infinity).
 
 .. _class_@GDScript_is_nan:
 
-- :ref:`float<class_float>`  **is_nan**  **(** :ref:`float<class_float>` s  **)**
+- :ref:`bool<class_bool>`  **is_nan**  **(** :ref:`float<class_float>` s  **)**
 
-Returns whether s is a NaN (Not-A-Number) value.
+Returns True/False whether ``s`` is a NaN (Not-A-Number) value.
 
 .. _class_@GDScript_len:
 
 - :ref:`int<class_int>`  **len**  **(** :ref:`Variant<class_variant>` var  **)**
 
+Returns length of Variant ``var``. Length is the character count of String, element count of Array, size of Dictionary, etc. Note: Generates a fatal error if Variant can not provide a length.
+
+::
+
+    a = [1, 2, 3, 4]
+    len(a) # returns 4
+
 .. _class_@GDScript_lerp:
 
 - :ref:`float<class_float>`  **lerp**  **(** :ref:`float<class_float>` from, :ref:`float<class_float>` to, :ref:`float<class_float>` weight  **)**
 
-Linear interpolates between two values by a normalized value.
+Linearly interpolates between two values by a normalized value.
+
+::
+
+    lerp(1, 3, 0.5) # returns 2
 
 .. _class_@GDScript_linear2db:
 
 - :ref:`float<class_float>`  **linear2db**  **(** :ref:`float<class_float>` nrg  **)**
 
-Convert from linear energy to decibels (audio).
+Converts from linear energy to decibels (audio).
 
 .. _class_@GDScript_load:
 
 - :ref:`Object<class_object>`  **load**  **(** :ref:`String<class_string>` path  **)**
 
-Load a resource from the filesystem, pass a valid path as argument.
+Loads a resource from the filesystem located at 'path'. Note: resource paths can be obtained by right clicking on a resource in the Assets Panel and choosing "Copy Path".
+
+::
+
+    # load a scene called main located in the root of the project directory
+    var main = load("res://main.tscn")
 
 .. _class_@GDScript_log:
 
 - :ref:`float<class_float>`  **log**  **(** :ref:`float<class_float>` s  **)**
 
-Natural logarithm.
+Natural logarithm. The amount of time needed to reach a certain level of continuous growth. Note: This is not the same as the log function on your calculator which is a base 10 logarithm.
+
+::
+
+    log(10) # returns 2.302585
 
 .. _class_@GDScript_max:
 
 - :ref:`float<class_float>`  **max**  **(** :ref:`float<class_float>` a, :ref:`float<class_float>` b  **)**
 
-Return the maximum of two values.
+Returns the maximum of two values.
+
+::
+
+    max(1,2) # returns 2
+    max(-3.99, -4) # returns -3.99
 
 .. _class_@GDScript_min:
 
 - :ref:`float<class_float>`  **min**  **(** :ref:`float<class_float>` a, :ref:`float<class_float>` b  **)**
 
-Return the minimum of two values.
+Returns the minimum of two values.
+
+::
+
+    min(1,2) # returns 1
+    min(-3.99, -4) # returns -4
 
 .. _class_@GDScript_nearest_po2:
 
 - :ref:`int<class_int>`  **nearest_po2**  **(** :ref:`int<class_int>` val  **)**
 
-Return the nearest larger power of 2 for an integer.
+Returns the nearest larger power of 2 for integer ``val``.
+
+::
+
+    nearest_po2(3) # returns 4
+    nearest_po2(4) # returns 4
+    nearest_po2(5) # returns 8
 
 .. _class_@GDScript_parse_json:
 
@@ -431,207 +652,401 @@ Return the nearest larger power of 2 for an integer.
 
 Parse JSON text to a Variant (use :ref:`typeof<class_@GDScript_typeof>` to check if it is what you expect).
 
-Be aware that the JSON specification does not define integer or float types, but only a number type. Therefore, parsing a JSON text will convert every numerical values to :ref:`float<class_float>` types.
+Be aware that the JSON specification does not define integer or float types, but only a number type. Therefore, parsing a JSON text will convert all numerical values to :ref:`float<class_float>` types.
+
+::
+
+    p = parse_json('["a", "b", "c"]')
+    if typeof(p) == TYPE_ARRAY:
+        print(p[0]) # prints a
+    else:
+        print("unexpected results")
 
 .. _class_@GDScript_pow:
 
 - :ref:`float<class_float>`  **pow**  **(** :ref:`float<class_float>` x, :ref:`float<class_float>` y  **)**
 
-Power function, x elevate to y.
+Returns the result of ``x`` raised to the power of ``y``.
+
+::
+
+    pow(2,5) # returns 32
 
 .. _class_@GDScript_preload:
 
 - :ref:`Resource<class_resource>`  **preload**  **(** :ref:`String<class_string>` path  **)**
 
-Preload a resource from the filesystem. The resource is loaded during script parsing.
+Returns a resource from the filesystem that is loaded during script parsing. Note: resource paths can be obtained by right clicking on a resource in the Assets Panel and choosing "Copy Path".
+
+::
+
+    # load a scene called main located in the root of the project directory
+    var main = preload("res://main.tscn")
 
 .. _class_@GDScript_print:
 
 - void  **print**  **(** **)** vararg
 
-Print one or more arguments to strings in the best way possible to a console line.
+Converts one or more arguments to strings in the best way possible and prints them to the console.
+
+::
+
+    a = [1,2,3]
+    print("a","b",a) # prints ab[1, 2, 3]
 
 .. _class_@GDScript_print_stack:
 
 - void  **print_stack**  **(** **)**
 
-Print a stack track at code location, only works when running with debugger turned on.
+Prints a stack track at code location, only works when running with debugger turned on.
+
+Output in the console would look something like this:
+
+::
+
+    Frame 0 - res://test.gd:16 in function '_process'
 
 .. _class_@GDScript_printerr:
 
 - void  **printerr**  **(** **)** vararg
 
-Print one or more arguments to strings in the best way possible to standard error line.
+Prints one or more arguments to strings in the best way possible to standard error line.
+
+::
+
+    printerr("prints to stderr")
 
 .. _class_@GDScript_printraw:
 
 - void  **printraw**  **(** **)** vararg
 
-Print one or more arguments to strings in the best way possible to console. No newline is added at the end.
+Prints one or more arguments to strings in the best way possible to console. No newline is added at the end.
+
+::
+
+    printraw("A")
+    printraw("B")
+    # prints AB
 
 .. _class_@GDScript_prints:
 
 - void  **prints**  **(** **)** vararg
 
-Print one or more arguments to the console with a space between each argument.
+Prints one or more arguments to the console with a space between each argument.
+
+::
+
+    prints("A", "B", "C") # prints A B C
 
 .. _class_@GDScript_printt:
 
 - void  **printt**  **(** **)** vararg
 
-Print one or more arguments to the console with a tab between each argument.
+Prints one or more arguments to the console with a tab between each argument.
+
+::
+
+    printt("A", "B", "C") # prints A       B       C
 
 .. _class_@GDScript_rad2deg:
 
 - :ref:`float<class_float>`  **rad2deg**  **(** :ref:`float<class_float>` rad  **)**
 
-Convert from radians to degrees.
+Converts from radians to degrees.
+
+::
+
+    rad2deg(0.523599) # returns 30
 
 .. _class_@GDScript_rand_range:
 
 - :ref:`float<class_float>`  **rand_range**  **(** :ref:`float<class_float>` from, :ref:`float<class_float>` to  **)**
 
-Random range, any floating point value between 'from' and 'to'.
+Random range, any floating point value between ``from`` and ``to``.
+
+::
+
+    prints(rand_range(0, 1), rand_range(0, 1)) # prints 0.135591 0.405263
 
 .. _class_@GDScript_rand_seed:
 
 - :ref:`Array<class_array>`  **rand_seed**  **(** :ref:`int<class_int>` seed  **)**
 
-Random from seed: pass a seed, and an array with both number and new seed is returned. "Seed" here refers to the internal state of the pseudo random number generator. The internal state of the current implementation is 64 bits.
+Random from seed: pass a ``seed``, and an array with both number and new seed is returned. "Seed" here refers to the internal state of the pseudo random number generator. The internal state of the current implementation is 64 bits.
 
 .. _class_@GDScript_randf:
 
 - :ref:`float<class_float>`  **randf**  **(** **)**
 
-Return a random floating point value between 0 and 1.
+Returns a random floating point value between 0 and 1.
+
+::
+
+    randf() # returns 0.375671
 
 .. _class_@GDScript_randi:
 
 - :ref:`int<class_int>`  **randi**  **(** **)**
 
-Return a random 32 bits integer value. To obtain a random value between 0 to N (where N is smaller than 2^32 - 1), you can use remainder. For example, to get a random integer between 0 and 19 inclusive, you can use randi() % 20.
+Returns a random 32 bit integer. Use remainder to obtain a random value between 0 and N (where N is smaller than 2^32 -1).
+
+::
+
+    randi() % 20      # returns random number between 0 and 19
+    randi() % 100     # returns random number between 0 and 99
+    randi() % 100 + 1 # returns random number between 1 and 100
 
 .. _class_@GDScript_randomize:
 
 - void  **randomize**  **(** **)**
 
-Randomize the seed (or the internal state) of the random number generator. Current implementation reseeds using a number based on time.
+Randomizes the seed (or the internal state) of the random number generator. Current implementation reseeds using a number based on time.
+
+::
+
+    func _ready():
+        randomize()
 
 .. _class_@GDScript_range:
 
 - :ref:`Array<class_array>`  **range**  **(** **)** vararg
 
-Return an array with the given range. Range can be 1 argument N (0 to N-1), two arguments (initial, final-1) or three arguments (initial, final-1, increment).
+Returns an array with the given range. Range can be 1 argument N (0 to N-1), two arguments (initial, final-1) or three arguments (initial, final-1, increment).
+
+::
+
+    for i in range(4):
+        print(i)
+    for i in range(2, 5):
+        print(i)
+    for i in range(0, 6, 2):
+        print(i)
+
+Output:
+
+::
+
+    0
+    1
+    2
+    3
+    
+    2
+    3
+    4
+    
+    0
+    2
+    4
 
 .. _class_@GDScript_range_lerp:
 
 - :ref:`float<class_float>`  **range_lerp**  **(** :ref:`float<class_float>` value, :ref:`float<class_float>` istart, :ref:`float<class_float>` istop, :ref:`float<class_float>` ostart, :ref:`float<class_float>` ostop  **)**
 
+Maps a ``value`` from range ``[istart, istop]`` to ``[ostart, ostop]``.
+
+::
+
+    range_lerp(75, 0, 100, -1, 1) # returns 0.5
+
 .. _class_@GDScript_round:
 
 - :ref:`float<class_float>`  **round**  **(** :ref:`float<class_float>` s  **)**
 
-Returns the integral value that is nearest to s, with halfway cases rounded away from zero.
+Returns the integral value that is nearest to ``s``, with halfway cases rounded away from zero.
+
+::
+
+    round(2.6) # returns 3
 
 .. _class_@GDScript_seed:
 
 - void  **seed**  **(** :ref:`int<class_int>` seed  **)**
 
-Set seed for the random number generator.
+Sets seed for the random number generator.
+
+::
+
+    my_seed = "Godot Rocks"
+    seed(my_seed.hash())
 
 .. _class_@GDScript_sign:
 
 - :ref:`float<class_float>`  **sign**  **(** :ref:`float<class_float>` s  **)**
 
-Return sign (-1 or +1).
+Returns sign of ``s`` -1 or 1.
+
+::
+
+    sign(-6) # returns -1
+    sign(6)  # returns 1
 
 .. _class_@GDScript_sin:
 
 - :ref:`float<class_float>`  **sin**  **(** :ref:`float<class_float>` s  **)**
 
-Returns the sine of an angle of s radians.
+Returns the sine of angle ``s`` in radians.
+
+::
+
+    sin(0.523599) # returns 0.5
 
 .. _class_@GDScript_sinh:
 
 - :ref:`float<class_float>`  **sinh**  **(** :ref:`float<class_float>` s  **)**
 
-Returns the hyperbolic sine of s.
+Returns the hyperbolic sine of ``s``.
+
+::
+
+    a = log(2.0) # returns 0.693147
+    sinh(a) # returns 0.75
 
 .. _class_@GDScript_sqrt:
 
 - :ref:`float<class_float>`  **sqrt**  **(** :ref:`float<class_float>` s  **)**
 
-Returns the square root of s.
+Returns the square root of ``s``.
+
+::
+
+    sqrt(9) # returns 3
 
 .. _class_@GDScript_stepify:
 
 - :ref:`float<class_float>`  **stepify**  **(** :ref:`float<class_float>` s, :ref:`float<class_float>` step  **)**
 
-Snap float value to a given step.
+Snaps float value ``s`` to a given ``step``.
 
 .. _class_@GDScript_str:
 
 - :ref:`String<class_string>`  **str**  **(** **)** vararg
 
-Convert one or more arguments to string in the best way possible.
+Converts one or more arguments to string in the best way possible.
+
+::
+
+    var a = [10, 20, 30]
+    var b = str(a);
+    len(a) # returns 3
+    len(b) # returns 12
 
 .. _class_@GDScript_str2var:
 
 - :ref:`Variant<class_variant>`  **str2var**  **(** :ref:`String<class_string>` string  **)**
 
-Convert a formatted string that was returned by :ref:`var2str<class_@GDScript_var2str>` to the original value.
+Converts a formatted string that was returned by :ref:`var2str<class_@GDScript_var2str>` to the original value.
+
+::
+
+    a = '{ "a": 1, "b": 2 }'
+    b = str2var(a)
+    print(b['a']) # prints 1
 
 .. _class_@GDScript_tan:
 
 - :ref:`float<class_float>`  **tan**  **(** :ref:`float<class_float>` s  **)**
 
-Returns the tangent of an angle of s radians.
+Returns the tangent of angle ``s`` in radians.
+
+::
+
+    tan( deg2rad(45) ) # returns 1
 
 .. _class_@GDScript_tanh:
 
 - :ref:`float<class_float>`  **tanh**  **(** :ref:`float<class_float>` s  **)**
 
-Returns the hyperbolic tangent of s.
+Returns the hyperbolic tangent of ``s``.
+
+::
+
+    a = log(2.0) # returns 0.693147
+    tanh(a)      # returns 0.6
 
 .. _class_@GDScript_to_json:
 
 - :ref:`String<class_string>`  **to_json**  **(** :ref:`Variant<class_variant>` var  **)**
 
-Convert a Variant to json text.
+Converts a Variant ``var`` to JSON text and return the result. Useful for serializing data to store or send over the network.
+
+::
+
+    a = { 'a': 1, 'b': 2 }
+    b = to_json(a)
+    print(b) # {"a":1, "b":2}
 
 .. _class_@GDScript_type_exists:
 
 - :ref:`bool<class_bool>`  **type_exists**  **(** :ref:`String<class_string>` type  **)**
 
+Returns whether the given class exists in :ref:`ClassDB<class_classdb>`.
+
+::
+
+    type_exists("Sprite") # returns true
+    type_exists("Variant") # returns false
+
 .. _class_@GDScript_typeof:
 
 - :ref:`int<class_int>`  **typeof**  **(** :ref:`Variant<class_variant>` what  **)**
 
-Return the internal type of the given Variant object, using the TYPE\_\* enum in :ref:`@Global Scope<class_@global scope>`.
+Returns the internal type of the given Variant object, using the TYPE\_\* enum in :ref:`@Global Scope<class_@global scope>`.
+
+::
+
+    p = parse_json('["a", "b", "c"]')
+    if typeof(p) == TYPE_ARRAY:
+        print(p[0]) # prints a
+    else:
+        print("unexpected results")
 
 .. _class_@GDScript_validate_json:
 
 - :ref:`String<class_string>`  **validate_json**  **(** :ref:`String<class_string>` json  **)**
 
-This method is used to validate the structure and data types of a piece of JSON, similar to XML Schema for XML.
+Checks that ``json`` is valid JSON data. Returns empty string if valid. Returns error message if not valid.
+
+::
+
+    j = to_json([1, 2, 3])
+    v = validate_json(j)
+    if not v:
+        print("valid")
+    else:
+        prints("invalid", v)
 
 .. _class_@GDScript_var2bytes:
 
 - :ref:`PoolByteArray<class_poolbytearray>`  **var2bytes**  **(** :ref:`Variant<class_variant>` var  **)**
 
-Encode a variable value to a byte array.
+Encodes a variable value to a byte array.
 
 .. _class_@GDScript_var2str:
 
 - :ref:`String<class_string>`  **var2str**  **(** :ref:`Variant<class_variant>` var  **)**
 
-Convert a value to a formatted string that can later be parsed using :ref:`str2var<class_@GDScript_str2var>`.
+Converts a Variant ``var`` to a formatted string that can later be parsed using :ref:`str2var<class_@GDScript_str2var>`.
+
+::
+
+    a = { 'a': 1, 'b': 2 }
+    print(var2str(a))
+
+prints
+
+::
+
+    {
+    "a": 1,
+    "b": 2
+    }
 
 .. _class_@GDScript_weakref:
 
 - :ref:`Object<class_object>`  **weakref**  **(** :ref:`Object<class_object>` obj  **)**
 
-Return a weak reference to an object.
+Returns a weak reference to an object.
 
 A weak reference to an object is not enough to keep the object alive: when the only remaining references to a referent are weak references, garbage collection is free to destroy the referent and reuse its memory for something else. However, until the object is actually destroyed the weak reference may return the object even if there are no strong references to it.
 
@@ -639,7 +1054,7 @@ A weak reference to an object is not enough to keep the object alive: when the o
 
 - :ref:`GDFunctionState<class_gdfunctionstate>`  **yield**  **(** :ref:`Object<class_object>` object, :ref:`String<class_string>` signal  **)**
 
-Stop the function execution and return the current state. Call :ref:`GDFunctionState.resume<class_GDFunctionState_resume>` on the state to resume execution. This invalidates the state.
+Stops the function execution and returns the current state. Call :ref:`GDFunctionState.resume<class_GDFunctionState_resume>` on the state to resume execution. This invalidates the state.
 
 Returns anything that was passed to the resume function call. If passed an object and a signal, the execution is resumed when the object's signal is emitted.
 

classes/class_@global scope.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the @Global Scope.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_@Global Scope:
 
@@ -16,7 +17,7 @@ Global scope constants and variables.
 Member Variables
 ----------------
 
-- :ref:`ARVRServer<class_arvrserver>` **ARVRServer**
+- :ref:`ARVRServer<class_arvrserver>` **ARVRServer** - [ARVRServer] singleton
 - :ref:`AudioServer<class_audioserver>` **AudioServer** - [AudioServer] singleton
 - :ref:`ClassDB<class_classdb>` **ClassDB** - [ClassDB] singleton
 - :ref:`Engine<class_engine>` **Engine** - [Engine] singleton
@@ -24,6 +25,7 @@ Member Variables
 - :ref:`IP<class_ip>` **IP** - [IP] singleton
 - :ref:`Input<class_input>` **Input** - [Input] singleton
 - :ref:`InputMap<class_inputmap>` **InputMap** - [InputMap] singleton
+- :ref:`JSON<class_json>` **JSON**
 - :ref:`Reference<class_reference>` **Marshalls** - [Marshalls] singleton
 - :ref:`OS<class_os>` **OS** - [OS] singleton
 - :ref:`Performance<class_performance>` **Performance** - [Performance] singleton
@@ -394,7 +396,7 @@ Numeric Constants
 - **ERR_ALREADY_IN_USE** = **22**
 - **ERR_LOCKED** = **23**
 - **ERR_TIMEOUT** = **24**
-- **ERR_CANT_AQUIRE_RESOURCE** = **28**
+- **ERR_CANT_ACQUIRE_RESOURCE** = **28**
 - **ERR_INVALID_DATA** = **30**
 - **ERR_INVALID_PARAMETER** = **31**
 - **ERR_ALREADY_EXISTS** = **32**
@@ -476,13 +478,13 @@ Numeric Constants
 - **TYPE_OBJECT** = **17** --- Variable is of type :ref:`Object<class_object>`.
 - **TYPE_DICTIONARY** = **18** --- Variable is of type :ref:`Dictionary<class_dictionary>`.
 - **TYPE_ARRAY** = **19** --- Variable is of type :ref:`Array<class_array>`.
-- **TYPE_RAW_ARRAY** = **20**
-- **TYPE_INT_ARRAY** = **21**
-- **TYPE_REAL_ARRAY** = **22**
-- **TYPE_STRING_ARRAY** = **23**
-- **TYPE_VECTOR2_ARRAY** = **24**
-- **TYPE_VECTOR3_ARRAY** = **25**
-- **TYPE_COLOR_ARRAY** = **26**
+- **TYPE_RAW_ARRAY** = **20** --- Variable is of type :ref:`PoolByteArray<class_poolbytearray>`.
+- **TYPE_INT_ARRAY** = **21** --- Variable is of type :ref:`PoolIntArray<class_poolintarray>`.
+- **TYPE_REAL_ARRAY** = **22** --- Variable is of type :ref:`PoolRealArray<class_poolrealarray>`.
+- **TYPE_STRING_ARRAY** = **23** --- Variable is of type :ref:`PoolStringArray<class_poolstringarray>`.
+- **TYPE_VECTOR2_ARRAY** = **24** --- Variable is of type :ref:`PoolVector2Array<class_poolvector2array>`.
+- **TYPE_VECTOR3_ARRAY** = **25** --- Variable is of type :ref:`PoolVector3Array<class_poolvector3array>`.
+- **TYPE_COLOR_ARRAY** = **26** --- Variable is of type :ref:`PoolColorArray<class_poolcolorarray>`.
 - **TYPE_MAX** = **27**
 
 Description

classes/[email protected]

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the @NativeScript.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_@NativeScript:
 

classes/[email protected]

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the @VisualScript.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_@VisualScript:
 

classes/class_acceptdialog.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AcceptDialog.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AcceptDialog:
 
@@ -44,10 +45,10 @@ Signals
 -------
 
 -  **confirmed**  **(** **)**
-Emitted when accepted.
+Emitted when the dialog is accepted.
 
 -  **custom_action**  **(** :ref:`String<class_string>` action  **)**
-Emitted with a custom button is added.
+Emitted when a custom button is pressed. See :ref:`add_button<class_AcceptDialog_add_button>`.
 
 
 Member Variables
@@ -68,15 +69,15 @@ Member Function Description
 
 - :ref:`Button<class_button>`  **add_button**  **(** :ref:`String<class_string>` text, :ref:`bool<class_bool>` right=false, :ref:`String<class_string>` action=""  **)**
 
-Add custom button to the dialog and return the created button.
+Adds a button with label *text* and a custom *action* to the dialog and returns the created button. *action* will be passed to the custom_action signal when pressed.
 
-The button titled with *text* and the *action* will be passed to custom_action signal when it is pressed.
+If ``true``, *right* will place the button to the right of any sibling buttons. Default value: ``false``.
 
 .. _class_AcceptDialog_add_cancel:
 
 - :ref:`Button<class_button>`  **add_cancel**  **(** :ref:`String<class_string>` name  **)**
 
-Add custom cancel button to the dialog and return the created button.
+Adds a button with label *name* and a cancel action to the dialog and returns the created button.
 
 .. _class_AcceptDialog_get_hide_on_ok:
 
@@ -106,7 +107,7 @@ Return the built-in label text.
 
 - void  **register_text_enter**  **(** :ref:`Node<class_node>` line_edit  **)**
 
-Register a :ref:`LineEdit<class_lineedit>` in the dialog. When the enter key is pressed, the dialog will be accepted.
+Registers a :ref:`LineEdit<class_lineedit>` in the dialog. When the enter key is pressed, the dialog will be accepted.
 
 .. _class_AcceptDialog_set_hide_on_ok:
 

classes/class_animatedsprite.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AnimatedSprite.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AnimatedSprite:
 

classes/class_animatedsprite3d.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AnimatedSprite3D.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AnimatedSprite3D:
 

classes/class_animation.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the Animation.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_Animation:
 
@@ -18,87 +19,87 @@ Contains data used to animate everything in the engine.
 Member Functions
 ----------------
 
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`int<class_int>`                    | :ref:`add_track<class_Animation_add_track>`  **(** :ref:`int<class_int>` type, :ref:`int<class_int>` at_pos=-1  **)**                                                                                                                                      |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                     | :ref:`clear<class_Animation_clear>`  **(** **)**                                                                                                                                                                                                           |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`int<class_int>`                    | :ref:`find_track<class_Animation_find_track>`  **(** :ref:`NodePath<class_nodepath>` path  **)** const                                                                                                                                                     |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`float<class_float>`                | :ref:`get_length<class_Animation_get_length>`  **(** **)** const                                                                                                                                                                                           |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`float<class_float>`                | :ref:`get_step<class_Animation_get_step>`  **(** **)** const                                                                                                                                                                                               |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`int<class_int>`                    | :ref:`get_track_count<class_Animation_get_track_count>`  **(** **)** const                                                                                                                                                                                 |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`bool<class_bool>`                  | :ref:`has_loop<class_Animation_has_loop>`  **(** **)** const                                                                                                                                                                                               |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`PoolIntArray<class_poolintarray>`  | :ref:`method_track_get_key_indices<class_Animation_method_track_get_key_indices>`  **(** :ref:`int<class_int>` idx, :ref:`float<class_float>` time_sec, :ref:`float<class_float>` delta  **)** const                                                       |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`String<class_string>`              | :ref:`method_track_get_name<class_Animation_method_track_get_name>`  **(** :ref:`int<class_int>` idx, :ref:`int<class_int>` key_idx  **)** const                                                                                                           |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`Array<class_array>`                | :ref:`method_track_get_params<class_Animation_method_track_get_params>`  **(** :ref:`int<class_int>` idx, :ref:`int<class_int>` key_idx  **)** const                                                                                                       |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                     | :ref:`remove_track<class_Animation_remove_track>`  **(** :ref:`int<class_int>` idx  **)**                                                                                                                                                                  |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                     | :ref:`set_length<class_Animation_set_length>`  **(** :ref:`float<class_float>` time_sec  **)**                                                                                                                                                             |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                     | :ref:`set_loop<class_Animation_set_loop>`  **(** :ref:`bool<class_bool>` enabled  **)**                                                                                                                                                                    |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                     | :ref:`set_step<class_Animation_set_step>`  **(** :ref:`float<class_float>` size_sec  **)**                                                                                                                                                                 |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`int<class_int>`                    | :ref:`track_find_key<class_Animation_track_find_key>`  **(** :ref:`int<class_int>` idx, :ref:`float<class_float>` time, :ref:`bool<class_bool>` exact=false  **)** const                                                                                   |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`bool<class_bool>`                  | :ref:`track_get_interpolation_loop_wrap<class_Animation_track_get_interpolation_loop_wrap>`  **(** :ref:`int<class_int>` idx  **)** const                                                                                                                  |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`int<class_int>`                    | :ref:`track_get_interpolation_type<class_Animation_track_get_interpolation_type>`  **(** :ref:`int<class_int>` idx  **)** const                                                                                                                            |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`int<class_int>`                    | :ref:`track_get_key_count<class_Animation_track_get_key_count>`  **(** :ref:`int<class_int>` idx  **)** const                                                                                                                                              |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`float<class_float>`                | :ref:`track_get_key_time<class_Animation_track_get_key_time>`  **(** :ref:`int<class_int>` idx, :ref:`int<class_int>` key_idx  **)** const                                                                                                                 |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`float<class_float>`                | :ref:`track_get_key_transition<class_Animation_track_get_key_transition>`  **(** :ref:`int<class_int>` idx, :ref:`int<class_int>` key_idx  **)** const                                                                                                     |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`Variant<class_variant>`            | :ref:`track_get_key_value<class_Animation_track_get_key_value>`  **(** :ref:`int<class_int>` idx, :ref:`int<class_int>` key_idx  **)** const                                                                                                               |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`NodePath<class_nodepath>`          | :ref:`track_get_path<class_Animation_track_get_path>`  **(** :ref:`int<class_int>` idx  **)** const                                                                                                                                                        |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`int<class_int>`                    | :ref:`track_get_type<class_Animation_track_get_type>`  **(** :ref:`int<class_int>` idx  **)** const                                                                                                                                                        |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                     | :ref:`track_insert_key<class_Animation_track_insert_key>`  **(** :ref:`int<class_int>` idx, :ref:`float<class_float>` time, :ref:`Variant<class_variant>` key, :ref:`float<class_float>` transition=1  **)**                                               |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`bool<class_bool>`                  | :ref:`track_is_imported<class_Animation_track_is_imported>`  **(** :ref:`int<class_int>` idx  **)** const                                                                                                                                                  |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                     | :ref:`track_move_down<class_Animation_track_move_down>`  **(** :ref:`int<class_int>` idx  **)**                                                                                                                                                            |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                     | :ref:`track_move_up<class_Animation_track_move_up>`  **(** :ref:`int<class_int>` idx  **)**                                                                                                                                                                |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                     | :ref:`track_remove_key<class_Animation_track_remove_key>`  **(** :ref:`int<class_int>` idx, :ref:`int<class_int>` key_idx  **)**                                                                                                                           |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                     | :ref:`track_remove_key_at_pos<class_Animation_track_remove_key_at_pos>`  **(** :ref:`int<class_int>` idx, :ref:`float<class_float>` pos  **)**                                                                                                             |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                     | :ref:`track_set_imported<class_Animation_track_set_imported>`  **(** :ref:`int<class_int>` idx, :ref:`bool<class_bool>` imported  **)**                                                                                                                    |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                     | :ref:`track_set_interpolation_loop_wrap<class_Animation_track_set_interpolation_loop_wrap>`  **(** :ref:`int<class_int>` idx, :ref:`bool<class_bool>` interpolation  **)**                                                                                 |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                     | :ref:`track_set_interpolation_type<class_Animation_track_set_interpolation_type>`  **(** :ref:`int<class_int>` idx, :ref:`int<class_int>` interpolation  **)**                                                                                             |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                     | :ref:`track_set_key_transition<class_Animation_track_set_key_transition>`  **(** :ref:`int<class_int>` idx, :ref:`int<class_int>` key_idx, :ref:`float<class_float>` transition  **)**                                                                     |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                     | :ref:`track_set_key_value<class_Animation_track_set_key_value>`  **(** :ref:`int<class_int>` idx, :ref:`int<class_int>` key, :ref:`Variant<class_variant>` value  **)**                                                                                    |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                     | :ref:`track_set_path<class_Animation_track_set_path>`  **(** :ref:`int<class_int>` idx, :ref:`NodePath<class_nodepath>` path  **)**                                                                                                                        |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`int<class_int>`                    | :ref:`transform_track_insert_key<class_Animation_transform_track_insert_key>`  **(** :ref:`int<class_int>` idx, :ref:`float<class_float>` time, :ref:`Vector3<class_vector3>` loc, :ref:`Quat<class_quat>` rot, :ref:`Vector3<class_vector3>` scale  **)** |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`Array<class_array>`                | :ref:`transform_track_interpolate<class_Animation_transform_track_interpolate>`  **(** :ref:`int<class_int>` idx, :ref:`float<class_float>` time_sec  **)** const                                                                                          |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`PoolIntArray<class_poolintarray>`  | :ref:`value_track_get_key_indices<class_Animation_value_track_get_key_indices>`  **(** :ref:`int<class_int>` idx, :ref:`float<class_float>` time_sec, :ref:`float<class_float>` delta  **)** const                                                         |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`int<class_int>`                    | :ref:`value_track_get_update_mode<class_Animation_value_track_get_update_mode>`  **(** :ref:`int<class_int>` idx  **)** const                                                                                                                              |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                     | :ref:`value_track_set_update_mode<class_Animation_value_track_set_update_mode>`  **(** :ref:`int<class_int>` idx, :ref:`int<class_int>` mode  **)**                                                                                                        |
-+------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`int<class_int>`                    | :ref:`add_track<class_Animation_add_track>`  **(** :ref:`int<class_int>` type, :ref:`int<class_int>` at_position=-1  **)**                                                                                                                                           |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                     | :ref:`clear<class_Animation_clear>`  **(** **)**                                                                                                                                                                                                                     |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`int<class_int>`                    | :ref:`find_track<class_Animation_find_track>`  **(** :ref:`NodePath<class_nodepath>` path  **)** const                                                                                                                                                               |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`float<class_float>`                | :ref:`get_length<class_Animation_get_length>`  **(** **)** const                                                                                                                                                                                                     |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`float<class_float>`                | :ref:`get_step<class_Animation_get_step>`  **(** **)** const                                                                                                                                                                                                         |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`int<class_int>`                    | :ref:`get_track_count<class_Animation_get_track_count>`  **(** **)** const                                                                                                                                                                                           |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`bool<class_bool>`                  | :ref:`has_loop<class_Animation_has_loop>`  **(** **)** const                                                                                                                                                                                                         |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`PoolIntArray<class_poolintarray>`  | :ref:`method_track_get_key_indices<class_Animation_method_track_get_key_indices>`  **(** :ref:`int<class_int>` idx, :ref:`float<class_float>` time_sec, :ref:`float<class_float>` delta  **)** const                                                                 |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`String<class_string>`              | :ref:`method_track_get_name<class_Animation_method_track_get_name>`  **(** :ref:`int<class_int>` idx, :ref:`int<class_int>` key_idx  **)** const                                                                                                                     |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`Array<class_array>`                | :ref:`method_track_get_params<class_Animation_method_track_get_params>`  **(** :ref:`int<class_int>` idx, :ref:`int<class_int>` key_idx  **)** const                                                                                                                 |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                     | :ref:`remove_track<class_Animation_remove_track>`  **(** :ref:`int<class_int>` idx  **)**                                                                                                                                                                            |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                     | :ref:`set_length<class_Animation_set_length>`  **(** :ref:`float<class_float>` time_sec  **)**                                                                                                                                                                       |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                     | :ref:`set_loop<class_Animation_set_loop>`  **(** :ref:`bool<class_bool>` enabled  **)**                                                                                                                                                                              |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                     | :ref:`set_step<class_Animation_set_step>`  **(** :ref:`float<class_float>` size_sec  **)**                                                                                                                                                                           |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`int<class_int>`                    | :ref:`track_find_key<class_Animation_track_find_key>`  **(** :ref:`int<class_int>` idx, :ref:`float<class_float>` time, :ref:`bool<class_bool>` exact=false  **)** const                                                                                             |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`bool<class_bool>`                  | :ref:`track_get_interpolation_loop_wrap<class_Animation_track_get_interpolation_loop_wrap>`  **(** :ref:`int<class_int>` idx  **)** const                                                                                                                            |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`int<class_int>`                    | :ref:`track_get_interpolation_type<class_Animation_track_get_interpolation_type>`  **(** :ref:`int<class_int>` idx  **)** const                                                                                                                                      |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`int<class_int>`                    | :ref:`track_get_key_count<class_Animation_track_get_key_count>`  **(** :ref:`int<class_int>` idx  **)** const                                                                                                                                                        |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`float<class_float>`                | :ref:`track_get_key_time<class_Animation_track_get_key_time>`  **(** :ref:`int<class_int>` idx, :ref:`int<class_int>` key_idx  **)** const                                                                                                                           |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`float<class_float>`                | :ref:`track_get_key_transition<class_Animation_track_get_key_transition>`  **(** :ref:`int<class_int>` idx, :ref:`int<class_int>` key_idx  **)** const                                                                                                               |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`Variant<class_variant>`            | :ref:`track_get_key_value<class_Animation_track_get_key_value>`  **(** :ref:`int<class_int>` idx, :ref:`int<class_int>` key_idx  **)** const                                                                                                                         |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`NodePath<class_nodepath>`          | :ref:`track_get_path<class_Animation_track_get_path>`  **(** :ref:`int<class_int>` idx  **)** const                                                                                                                                                                  |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`int<class_int>`                    | :ref:`track_get_type<class_Animation_track_get_type>`  **(** :ref:`int<class_int>` idx  **)** const                                                                                                                                                                  |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                     | :ref:`track_insert_key<class_Animation_track_insert_key>`  **(** :ref:`int<class_int>` idx, :ref:`float<class_float>` time, :ref:`Variant<class_variant>` key, :ref:`float<class_float>` transition=1  **)**                                                         |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`bool<class_bool>`                  | :ref:`track_is_imported<class_Animation_track_is_imported>`  **(** :ref:`int<class_int>` idx  **)** const                                                                                                                                                            |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                     | :ref:`track_move_down<class_Animation_track_move_down>`  **(** :ref:`int<class_int>` idx  **)**                                                                                                                                                                      |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                     | :ref:`track_move_up<class_Animation_track_move_up>`  **(** :ref:`int<class_int>` idx  **)**                                                                                                                                                                          |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                     | :ref:`track_remove_key<class_Animation_track_remove_key>`  **(** :ref:`int<class_int>` idx, :ref:`int<class_int>` key_idx  **)**                                                                                                                                     |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                     | :ref:`track_remove_key_at_position<class_Animation_track_remove_key_at_position>`  **(** :ref:`int<class_int>` idx, :ref:`float<class_float>` position  **)**                                                                                                        |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                     | :ref:`track_set_imported<class_Animation_track_set_imported>`  **(** :ref:`int<class_int>` idx, :ref:`bool<class_bool>` imported  **)**                                                                                                                              |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                     | :ref:`track_set_interpolation_loop_wrap<class_Animation_track_set_interpolation_loop_wrap>`  **(** :ref:`int<class_int>` idx, :ref:`bool<class_bool>` interpolation  **)**                                                                                           |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                     | :ref:`track_set_interpolation_type<class_Animation_track_set_interpolation_type>`  **(** :ref:`int<class_int>` idx, :ref:`int<class_int>` interpolation  **)**                                                                                                       |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                     | :ref:`track_set_key_transition<class_Animation_track_set_key_transition>`  **(** :ref:`int<class_int>` idx, :ref:`int<class_int>` key_idx, :ref:`float<class_float>` transition  **)**                                                                               |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                     | :ref:`track_set_key_value<class_Animation_track_set_key_value>`  **(** :ref:`int<class_int>` idx, :ref:`int<class_int>` key, :ref:`Variant<class_variant>` value  **)**                                                                                              |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                     | :ref:`track_set_path<class_Animation_track_set_path>`  **(** :ref:`int<class_int>` idx, :ref:`NodePath<class_nodepath>` path  **)**                                                                                                                                  |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`int<class_int>`                    | :ref:`transform_track_insert_key<class_Animation_transform_track_insert_key>`  **(** :ref:`int<class_int>` idx, :ref:`float<class_float>` time, :ref:`Vector3<class_vector3>` location, :ref:`Quat<class_quat>` rotation, :ref:`Vector3<class_vector3>` scale  **)** |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`Array<class_array>`                | :ref:`transform_track_interpolate<class_Animation_transform_track_interpolate>`  **(** :ref:`int<class_int>` idx, :ref:`float<class_float>` time_sec  **)** const                                                                                                    |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`PoolIntArray<class_poolintarray>`  | :ref:`value_track_get_key_indices<class_Animation_value_track_get_key_indices>`  **(** :ref:`int<class_int>` idx, :ref:`float<class_float>` time_sec, :ref:`float<class_float>` delta  **)** const                                                                   |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`int<class_int>`                    | :ref:`value_track_get_update_mode<class_Animation_value_track_get_update_mode>`  **(** :ref:`int<class_int>` idx  **)** const                                                                                                                                        |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                     | :ref:`value_track_set_update_mode<class_Animation_value_track_set_update_mode>`  **(** :ref:`int<class_int>` idx, :ref:`int<class_int>` mode  **)**                                                                                                                  |
++------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 
 Numeric Constants
 -----------------
@@ -109,9 +110,9 @@ Numeric Constants
 - **INTERPOLATION_NEAREST** = **0** --- No interpolation (nearest value).
 - **INTERPOLATION_LINEAR** = **1** --- Linear interpolation.
 - **INTERPOLATION_CUBIC** = **2** --- Cubic interpolation.
-- **UPDATE_CONTINUOUS** = **0**
-- **UPDATE_DISCRETE** = **1**
-- **UPDATE_TRIGGER** = **2**
+- **UPDATE_CONTINUOUS** = **0** --- Update between keyframes.
+- **UPDATE_DISCRETE** = **1** --- Update at the keyframes and hold the value.
+- **UPDATE_TRIGGER** = **2** --- Update at the keyframes.
 
 Description
 -----------
@@ -125,7 +126,7 @@ Member Function Description
 
 .. _class_Animation_add_track:
 
-- :ref:`int<class_int>`  **add_track**  **(** :ref:`int<class_int>` type, :ref:`int<class_int>` at_pos=-1  **)**
+- :ref:`int<class_int>`  **add_track**  **(** :ref:`int<class_int>` type, :ref:`int<class_int>` at_position=-1  **)**
 
 Add a track to the Animation. The track type must be specified as any of the values in the TYPE\_\* enumeration.
 
@@ -289,9 +290,9 @@ Move a track up.
 
 Remove a key by index in a given track.
 
-.. _class_Animation_track_remove_key_at_pos:
+.. _class_Animation_track_remove_key_at_position:
 
-- void  **track_remove_key_at_pos**  **(** :ref:`int<class_int>` idx, :ref:`float<class_float>` pos  **)**
+- void  **track_remove_key_at_position**  **(** :ref:`int<class_int>` idx, :ref:`float<class_float>` position  **)**
 
 Remove a key by position (seconds) in a given track.
 
@@ -331,7 +332,7 @@ Set the path of a track. Paths must be valid scene-tree paths to a node, and mus
 
 .. _class_Animation_transform_track_insert_key:
 
-- :ref:`int<class_int>`  **transform_track_insert_key**  **(** :ref:`int<class_int>` idx, :ref:`float<class_float>` time, :ref:`Vector3<class_vector3>` loc, :ref:`Quat<class_quat>` rot, :ref:`Vector3<class_vector3>` scale  **)**
+- :ref:`int<class_int>`  **transform_track_insert_key**  **(** :ref:`int<class_int>` idx, :ref:`float<class_float>` time, :ref:`Vector3<class_vector3>` location, :ref:`Quat<class_quat>` rotation, :ref:`Vector3<class_vector3>` scale  **)**
 
 Insert a transform key for a transform track.
 
@@ -351,8 +352,12 @@ Return all the key indices of a value track, given a position and delta time.
 
 - :ref:`int<class_int>`  **value_track_get_update_mode**  **(** :ref:`int<class_int>` idx  **)** const
 
+Return the update mode of a value track.
+
 .. _class_Animation_value_track_set_update_mode:
 
 - void  **value_track_set_update_mode**  **(** :ref:`int<class_int>` idx, :ref:`int<class_int>` mode  **)**
 
+Set the update mode (UPDATE\_\*) of a value track.
+
 

classes/class_animationplayer.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AnimationPlayer.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AnimationPlayer:
 
@@ -47,11 +48,11 @@ Member Functions
 +------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`float<class_float>`                      | :ref:`get_current_animation_length<class_AnimationPlayer_get_current_animation_length>`  **(** **)** const                                                                                                               |
 +------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`float<class_float>`                      | :ref:`get_current_animation_pos<class_AnimationPlayer_get_current_animation_pos>`  **(** **)** const                                                                                                                     |
+| :ref:`float<class_float>`                      | :ref:`get_current_animation_position<class_AnimationPlayer_get_current_animation_position>`  **(** **)** const                                                                                                           |
 +------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`float<class_float>`                      | :ref:`get_default_blend_time<class_AnimationPlayer_get_default_blend_time>`  **(** **)** const                                                                                                                           |
 +------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`float<class_float>`                      | :ref:`get_pos<class_AnimationPlayer_get_pos>`  **(** **)** const                                                                                                                                                         |
+| :ref:`float<class_float>`                      | :ref:`get_position<class_AnimationPlayer_get_position>`  **(** **)** const                                                                                                                                               |
 +------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`NodePath<class_nodepath>`                | :ref:`get_root<class_AnimationPlayer_get_root>`  **(** **)** const                                                                                                                                                       |
 +------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@@ -73,7 +74,7 @@ Member Functions
 +------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | void                                           | :ref:`rename_animation<class_AnimationPlayer_rename_animation>`  **(** :ref:`String<class_string>` name, :ref:`String<class_string>` newname  **)**                                                                      |
 +------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                           | :ref:`seek<class_AnimationPlayer_seek>`  **(** :ref:`float<class_float>` pos_sec, :ref:`bool<class_bool>` update=false  **)**                                                                                            |
+| void                                           | :ref:`seek<class_AnimationPlayer_seek>`  **(** :ref:`float<class_float>` seconds, :ref:`bool<class_bool>` update=false  **)**                                                                                            |
 +------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | void                                           | :ref:`set_active<class_AnimationPlayer_set_active>`  **(** :ref:`bool<class_bool>` active  **)**                                                                                                                         |
 +------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@@ -146,10 +147,14 @@ Used to skip ahead or skip back in an animation. Delta is the time in seconds to
 
 - :ref:`String<class_string>`  **animation_get_next**  **(** :ref:`String<class_string>` anim_from  **)** const
 
+Return the name of the next animation in the queue.
+
 .. _class_AnimationPlayer_animation_set_next:
 
 - void  **animation_set_next**  **(** :ref:`String<class_string>` anim_from, :ref:`String<class_string>` anim_to  **)**
 
+Set the name of an animation that will be played after.
+
 .. _class_AnimationPlayer_clear_caches:
 
 - void  **clear_caches**  **(** **)**
@@ -210,9 +215,9 @@ Return the name of the animation being played.
 
 Get the length (in seconds) of the currently being played animation.
 
-.. _class_AnimationPlayer_get_current_animation_pos:
+.. _class_AnimationPlayer_get_current_animation_position:
 
-- :ref:`float<class_float>`  **get_current_animation_pos**  **(** **)** const
+- :ref:`float<class_float>`  **get_current_animation_position**  **(** **)** const
 
 Get the position (in seconds) of the currently being played animation.
 
@@ -222,9 +227,9 @@ Get the position (in seconds) of the currently being played animation.
 
 Return the default blend time between animations.
 
-.. _class_AnimationPlayer_get_pos:
+.. _class_AnimationPlayer_get_position:
 
-- :ref:`float<class_float>`  **get_pos**  **(** **)** const
+- :ref:`float<class_float>`  **get_position**  **(** **)** const
 
 Return the playback position (in seconds) in an animation channel (or channel 0 if none is provided).
 
@@ -290,7 +295,7 @@ Rename an existing animation.
 
 .. _class_AnimationPlayer_seek:
 
-- void  **seek**  **(** :ref:`float<class_float>` pos_sec, :ref:`bool<class_bool>` update=false  **)**
+- void  **seek**  **(** :ref:`float<class_float>` seconds, :ref:`bool<class_bool>` update=false  **)**
 
 Seek the animation to a given position in time (in seconds). If 'update' is true, the animation will be updated too, otherwise it will be updated at process time.
 

classes/class_animationtreeplayer.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AnimationTreePlayer.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AnimationTreePlayer:
 
@@ -73,13 +74,13 @@ Member Functions
 +------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`String<class_string>`                    | :ref:`node_get_input_source<class_AnimationTreePlayer_node_get_input_source>`  **(** :ref:`String<class_string>` id, :ref:`int<class_int>` idx  **)** const                                                                   |
 +------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`Vector2<class_vector2>`                  | :ref:`node_get_pos<class_AnimationTreePlayer_node_get_pos>`  **(** :ref:`String<class_string>` id  **)** const                                                                                                                |
+| :ref:`Vector2<class_vector2>`                  | :ref:`node_get_position<class_AnimationTreePlayer_node_get_position>`  **(** :ref:`String<class_string>` id  **)** const                                                                                                      |
 +------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`int<class_int>`                          | :ref:`node_get_type<class_AnimationTreePlayer_node_get_type>`  **(** :ref:`String<class_string>` id  **)** const                                                                                                              |
 +------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`int<class_int>`                          | :ref:`node_rename<class_AnimationTreePlayer_node_rename>`  **(** :ref:`String<class_string>` node, :ref:`String<class_string>` new_name  **)**                                                                                |
 +------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                           | :ref:`node_set_pos<class_AnimationTreePlayer_node_set_pos>`  **(** :ref:`String<class_string>` id, :ref:`Vector2<class_vector2>` screen_pos  **)**                                                                            |
+| void                                           | :ref:`node_set_position<class_AnimationTreePlayer_node_set_position>`  **(** :ref:`String<class_string>` id, :ref:`Vector2<class_vector2>` screen_position  **)**                                                             |
 +------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`float<class_float>`                      | :ref:`oneshot_node_get_autorestart_delay<class_AnimationTreePlayer_oneshot_node_get_autorestart_delay>`  **(** :ref:`String<class_string>` id  **)** const                                                                    |
 +------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@@ -127,7 +128,7 @@ Member Functions
 +------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | void                                           | :ref:`timescale_node_set_scale<class_AnimationTreePlayer_timescale_node_set_scale>`  **(** :ref:`String<class_string>` id, :ref:`float<class_float>` scale  **)**                                                             |
 +------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                           | :ref:`timeseek_node_seek<class_AnimationTreePlayer_timeseek_node_seek>`  **(** :ref:`String<class_string>` id, :ref:`float<class_float>` pos_sec  **)**                                                                       |
+| void                                           | :ref:`timeseek_node_seek<class_AnimationTreePlayer_timeseek_node_seek>`  **(** :ref:`String<class_string>` id, :ref:`float<class_float>` seconds  **)**                                                                       |
 +------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | void                                           | :ref:`transition_node_delete_input<class_AnimationTreePlayer_transition_node_delete_input>`  **(** :ref:`String<class_string>` id, :ref:`int<class_int>` input_idx  **)**                                                     |
 +------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@@ -156,16 +157,18 @@ Member Variables
 Numeric Constants
 -----------------
 
-- **NODE_OUTPUT** = **0**
-- **NODE_ANIMATION** = **1**
-- **NODE_ONESHOT** = **2**
-- **NODE_MIX** = **3**
-- **NODE_BLEND2** = **4**
-- **NODE_BLEND3** = **5**
-- **NODE_BLEND4** = **6**
-- **NODE_TIMESCALE** = **7**
-- **NODE_TIMESEEK** = **8**
-- **NODE_TRANSITION** = **9**
+- **NODE_OUTPUT** = **0** --- Output node.
+- **NODE_ANIMATION** = **1** --- Animation node.
+- **NODE_ONESHOT** = **2** --- OneShot node.
+- **NODE_MIX** = **3** --- Mix node.
+- **NODE_BLEND2** = **4** --- Blend2 node.
+- **NODE_BLEND3** = **5** --- Blend3 node.
+- **NODE_BLEND4** = **6** --- Blend4 node.
+- **NODE_TIMESCALE** = **7** --- TimeScale node.
+- **NODE_TIMESEEK** = **8** --- TimeSeek node.
+- **NODE_TRANSITION** = **9** --- Transition node.
+- **ANIMATION_PROCESS_FIXED** = **0**
+- **ANIMATION_PROCESS_IDLE** = **1**
 
 Description
 -----------
@@ -189,6 +192,8 @@ Add a node of a given type in the graph with given id.
 
 - :ref:`Animation<class_animation>`  **animation_node_get_animation**  **(** :ref:`String<class_string>` id  **)** const
 
+Returns an animation given its name.
+
 .. _class_AnimationTreePlayer_animation_node_get_master_animation:
 
 - :ref:`String<class_string>`  **animation_node_get_master_animation**  **(** :ref:`String<class_string>` id  **)** const
@@ -211,14 +216,20 @@ Set the animation for an animation node.
 
 - :ref:`bool<class_bool>`  **are_nodes_connected**  **(** :ref:`String<class_string>` id, :ref:`String<class_string>` dst_id, :ref:`int<class_int>` dst_input_idx  **)** const
 
+Returns whether node ``id`` and ``dst_id`` are connected at the specified slot.
+
 .. _class_AnimationTreePlayer_blend2_node_get_amount:
 
 - :ref:`float<class_float>`  **blend2_node_get_amount**  **(** :ref:`String<class_string>` id  **)** const
 
+Returns the blend amount of a Blend2 node given its name.
+
 .. _class_AnimationTreePlayer_blend2_node_set_amount:
 
 - void  **blend2_node_set_amount**  **(** :ref:`String<class_string>` id, :ref:`float<class_float>` blend  **)**
 
+Sets the blend amount of a Blend2 node given its name and value.
+
 .. _class_AnimationTreePlayer_blend2_node_set_filter_path:
 
 - void  **blend2_node_set_filter_path**  **(** :ref:`String<class_string>` id, :ref:`NodePath<class_nodepath>` path, :ref:`bool<class_bool>` enable  **)**
@@ -227,30 +238,44 @@ Set the animation for an animation node.
 
 - :ref:`float<class_float>`  **blend3_node_get_amount**  **(** :ref:`String<class_string>` id  **)** const
 
+Returns the blend amount of a Blend3 node given its name.
+
 .. _class_AnimationTreePlayer_blend3_node_set_amount:
 
 - void  **blend3_node_set_amount**  **(** :ref:`String<class_string>` id, :ref:`float<class_float>` blend  **)**
 
+Sets the blend amount of a Blend3 node given its name and value.
+
 .. _class_AnimationTreePlayer_blend4_node_get_amount:
 
 - :ref:`Vector2<class_vector2>`  **blend4_node_get_amount**  **(** :ref:`String<class_string>` id  **)** const
 
+Returns the blend amount of a Blend4 node given its name.
+
 .. _class_AnimationTreePlayer_blend4_node_set_amount:
 
 - void  **blend4_node_set_amount**  **(** :ref:`String<class_string>` id, :ref:`Vector2<class_vector2>` blend  **)**
 
+Sets the blend amount of a Blend4 node given its name and value.
+
 .. _class_AnimationTreePlayer_connect_nodes:
 
 - :ref:`int<class_int>`  **connect_nodes**  **(** :ref:`String<class_string>` id, :ref:`String<class_string>` dst_id, :ref:`int<class_int>` dst_input_idx  **)**
 
+Connects node ``id`` to ``dst_id`` at the specified input slot.
+
 .. _class_AnimationTreePlayer_disconnect_nodes:
 
 - void  **disconnect_nodes**  **(** :ref:`String<class_string>` id, :ref:`int<class_int>` dst_input_idx  **)**
 
+Disconnects nodes connected to ``id`` at the specified input slot.
+
 .. _class_AnimationTreePlayer_get_animation_process_mode:
 
 - :ref:`int<class_int>`  **get_animation_process_mode**  **(** **)** const
 
+Returns playback process mode of this AnimationTreePlayer.
+
 .. _class_AnimationTreePlayer_get_base_path:
 
 - :ref:`NodePath<class_nodepath>`  **get_base_path**  **(** **)** const
@@ -263,18 +288,26 @@ Set the animation for an animation node.
 
 - :ref:`PoolStringArray<class_poolstringarray>`  **get_node_list**  **(** **)**
 
+Returns a PoolStringArray containing the name of all nodes.
+
 .. _class_AnimationTreePlayer_is_active:
 
 - :ref:`bool<class_bool>`  **is_active**  **(** **)** const
 
+Returns whether this AnimationTreePlayer is active.
+
 .. _class_AnimationTreePlayer_mix_node_get_amount:
 
 - :ref:`float<class_float>`  **mix_node_get_amount**  **(** :ref:`String<class_string>` id  **)** const
 
+Returns mix amount of a Mix node given its name.
+
 .. _class_AnimationTreePlayer_mix_node_set_amount:
 
 - void  **mix_node_set_amount**  **(** :ref:`String<class_string>` id, :ref:`float<class_float>` ratio  **)**
 
+Sets mix amount of a Mix node given its name and value.
+
 .. _class_AnimationTreePlayer_node_exists:
 
 - :ref:`bool<class_bool>`  **node_exists**  **(** :ref:`String<class_string>` node  **)** const
@@ -293,9 +326,11 @@ Return the input count for a given node. Different types of nodes have different
 
 Return the input source for a given node input.
 
-.. _class_AnimationTreePlayer_node_get_pos:
+.. _class_AnimationTreePlayer_node_get_position:
 
-- :ref:`Vector2<class_vector2>`  **node_get_pos**  **(** :ref:`String<class_string>` id  **)** const
+- :ref:`Vector2<class_vector2>`  **node_get_position**  **(** :ref:`String<class_string>` id  **)** const
+
+Returns position of a node in the graph given its name.
 
 .. _class_AnimationTreePlayer_node_get_type:
 
@@ -309,54 +344,78 @@ Get the node type, will return from NODE\_\* enum.
 
 Rename a node in the graph.
 
-.. _class_AnimationTreePlayer_node_set_pos:
+.. _class_AnimationTreePlayer_node_set_position:
+
+- void  **node_set_position**  **(** :ref:`String<class_string>` id, :ref:`Vector2<class_vector2>` screen_position  **)**
 
-- void  **node_set_pos**  **(** :ref:`String<class_string>` id, :ref:`Vector2<class_vector2>` screen_pos  **)**
+Sets position of a node in the graph given its name and position.
 
 .. _class_AnimationTreePlayer_oneshot_node_get_autorestart_delay:
 
 - :ref:`float<class_float>`  **oneshot_node_get_autorestart_delay**  **(** :ref:`String<class_string>` id  **)** const
 
+Returns autostart delay of a OneShot node given its name.
+
 .. _class_AnimationTreePlayer_oneshot_node_get_autorestart_random_delay:
 
 - :ref:`float<class_float>`  **oneshot_node_get_autorestart_random_delay**  **(** :ref:`String<class_string>` id  **)** const
 
+Returns autostart random delay of a OneShot node given its name.
+
 .. _class_AnimationTreePlayer_oneshot_node_get_fadein_time:
 
 - :ref:`float<class_float>`  **oneshot_node_get_fadein_time**  **(** :ref:`String<class_string>` id  **)** const
 
+Returns fade in time of a OneShot node given its name.
+
 .. _class_AnimationTreePlayer_oneshot_node_get_fadeout_time:
 
 - :ref:`float<class_float>`  **oneshot_node_get_fadeout_time**  **(** :ref:`String<class_string>` id  **)** const
 
+Returns fade out time of a OneShot node given its name.
+
 .. _class_AnimationTreePlayer_oneshot_node_has_autorestart:
 
 - :ref:`bool<class_bool>`  **oneshot_node_has_autorestart**  **(** :ref:`String<class_string>` id  **)** const
 
+Returns whether a OneShot node will auto restart given its name.
+
 .. _class_AnimationTreePlayer_oneshot_node_is_active:
 
 - :ref:`bool<class_bool>`  **oneshot_node_is_active**  **(** :ref:`String<class_string>` id  **)** const
 
+Returns whether a OneShot node is active given its name.
+
 .. _class_AnimationTreePlayer_oneshot_node_set_autorestart:
 
 - void  **oneshot_node_set_autorestart**  **(** :ref:`String<class_string>` id, :ref:`bool<class_bool>` enable  **)**
 
+Sets autorestart property of a OneShot node given its name and value.
+
 .. _class_AnimationTreePlayer_oneshot_node_set_autorestart_delay:
 
 - void  **oneshot_node_set_autorestart_delay**  **(** :ref:`String<class_string>` id, :ref:`float<class_float>` delay_sec  **)**
 
+Sets autorestart delay of a OneShot node given its name and value in seconds.
+
 .. _class_AnimationTreePlayer_oneshot_node_set_autorestart_random_delay:
 
 - void  **oneshot_node_set_autorestart_random_delay**  **(** :ref:`String<class_string>` id, :ref:`float<class_float>` rand_sec  **)**
 
+Sets autorestart random delay of a OneShot node given its name and value in seconds.
+
 .. _class_AnimationTreePlayer_oneshot_node_set_fadein_time:
 
 - void  **oneshot_node_set_fadein_time**  **(** :ref:`String<class_string>` id, :ref:`float<class_float>` time_sec  **)**
 
+Sets fade in time of a OneShot node given its name and value in seconds.
+
 .. _class_AnimationTreePlayer_oneshot_node_set_fadeout_time:
 
 - void  **oneshot_node_set_fadeout_time**  **(** :ref:`String<class_string>` id, :ref:`float<class_float>` time_sec  **)**
 
+Sets fade out time of a OneShot node given its name and value in seconds.
+
 .. _class_AnimationTreePlayer_oneshot_node_set_filter_path:
 
 - void  **oneshot_node_set_filter_path**  **(** :ref:`String<class_string>` id, :ref:`NodePath<class_nodepath>` path, :ref:`bool<class_bool>` enable  **)**
@@ -365,10 +424,14 @@ Rename a node in the graph.
 
 - void  **oneshot_node_start**  **(** :ref:`String<class_string>` id  **)**
 
+Starts a OneShot node given its name.
+
 .. _class_AnimationTreePlayer_oneshot_node_stop:
 
 - void  **oneshot_node_stop**  **(** :ref:`String<class_string>` id  **)**
 
+Stops a OneShot node given its name.
+
 .. _class_AnimationTreePlayer_recompute_caches:
 
 - void  **recompute_caches**  **(** **)**
@@ -381,18 +444,26 @@ Rename a node in the graph.
 
 - void  **reset**  **(** **)**
 
+Resets this AnimationTreePlayer.
+
 .. _class_AnimationTreePlayer_set_active:
 
 - void  **set_active**  **(** :ref:`bool<class_bool>` enabled  **)**
 
+Sets whether this AnimationTreePlayer is active. AnimationTreePlayer will start processing if set to active.
+
 .. _class_AnimationTreePlayer_set_animation_process_mode:
 
 - void  **set_animation_process_mode**  **(** :ref:`int<class_int>` mode  **)**
 
+Sets process mode (ANIMATION_PROCESS\_\*) of this AnimationTreePlayer.
+
 .. _class_AnimationTreePlayer_set_base_path:
 
 - void  **set_base_path**  **(** :ref:`NodePath<class_nodepath>` path  **)**
 
+Sets base path of this AnimationTreePlayer.
+
 .. _class_AnimationTreePlayer_set_master_player:
 
 - void  **set_master_player**  **(** :ref:`NodePath<class_nodepath>` nodepath  **)**
@@ -401,13 +472,19 @@ Rename a node in the graph.
 
 - :ref:`float<class_float>`  **timescale_node_get_scale**  **(** :ref:`String<class_string>` id  **)** const
 
+Returns time scale value of a TimeScale node given its name.
+
 .. _class_AnimationTreePlayer_timescale_node_set_scale:
 
 - void  **timescale_node_set_scale**  **(** :ref:`String<class_string>` id, :ref:`float<class_float>` scale  **)**
 
+Sets time scale value of a TimeScale node given its name and value.
+
 .. _class_AnimationTreePlayer_timeseek_node_seek:
 
-- void  **timeseek_node_seek**  **(** :ref:`String<class_string>` id, :ref:`float<class_float>` pos_sec  **)**
+- void  **timeseek_node_seek**  **(** :ref:`String<class_string>` id, :ref:`float<class_float>` seconds  **)**
+
+Sets time seek value of a TimeSeek node given its name and value.
 
 .. _class_AnimationTreePlayer_transition_node_delete_input:
 

classes/class_area.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the Area.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_Area:
 
@@ -158,6 +159,15 @@ Member Variables
 - :ref:`float<class_float>` **reverb_bus_uniformity**
 - :ref:`int<class_int>` **space_override**
 
+Numeric Constants
+-----------------
+
+- **SPACE_OVERRIDE_DISABLED** = **0**
+- **SPACE_OVERRIDE_COMBINE** = **1**
+- **SPACE_OVERRIDE_COMBINE_REPLACE** = **2**
+- **SPACE_OVERRIDE_REPLACE** = **3**
+- **SPACE_OVERRIDE_REPLACE_COMBINE** = **4**
+
 Description
 -----------
 

classes/class_area2d.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the Area2D.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_Area2D:
 
@@ -13,7 +14,7 @@ Area2D
 Brief Description
 -----------------
 
-General purpose area detection and influence for 2D physics.
+2D area that detects nodes that enter or exit it. Can override 2D physics properties within range.
 
 Member Functions
 ----------------
@@ -21,7 +22,7 @@ Member Functions
 +--------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`float<class_float>`      | :ref:`get_angular_damp<class_Area2D_get_angular_damp>`  **(** **)** const                                                                   |
 +--------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`String<class_string>`    | :ref:`get_audio_bus<class_Area2D_get_audio_bus>`  **(** **)** const                                                                         |
+| :ref:`String<class_string>`    | :ref:`get_audio_bus_name<class_Area2D_get_audio_bus_name>`  **(** **)** const                                                               |
 +--------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`int<class_int>`          | :ref:`get_collision_layer<class_Area2D_get_collision_layer>`  **(** **)** const                                                             |
 +--------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
@@ -61,7 +62,7 @@ Member Functions
 +--------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
 | void                           | :ref:`set_angular_damp<class_Area2D_set_angular_damp>`  **(** :ref:`float<class_float>` angular_damp  **)**                                 |
 +--------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
-| void                           | :ref:`set_audio_bus<class_Area2D_set_audio_bus>`  **(** :ref:`String<class_string>` name  **)**                                             |
+| void                           | :ref:`set_audio_bus_name<class_Area2D_set_audio_bus_name>`  **(** :ref:`String<class_string>` name  **)**                                   |
 +--------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
 | void                           | :ref:`set_audio_bus_override<class_Area2D_set_audio_bus_override>`  **(** :ref:`bool<class_bool>` enable  **)**                             |
 +--------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
@@ -89,7 +90,7 @@ Member Functions
 +--------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
 | void                           | :ref:`set_priority<class_Area2D_set_priority>`  **(** :ref:`float<class_float>` priority  **)**                                             |
 +--------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
-| void                           | :ref:`set_space_override_mode<class_Area2D_set_space_override_mode>`  **(** :ref:`int<class_int>` enable  **)**                             |
+| void                           | :ref:`set_space_override_mode<class_Area2D_set_space_override_mode>`  **(** :ref:`int<class_int>` space_override_mode  **)**                |
 +--------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------+
 
 Signals
@@ -123,25 +124,37 @@ This signal triggers only once when a body exits this area. The first parameter
 Member Variables
 ----------------
 
-- :ref:`float<class_float>` **angular_damp**
-- :ref:`String<class_string>` **audio_bus_name**
-- :ref:`bool<class_bool>` **audio_bus_override**
-- :ref:`int<class_int>` **collision_layer**
-- :ref:`int<class_int>` **collision_mask**
-- :ref:`float<class_float>` **gravity**
-- :ref:`float<class_float>` **gravity_distance_scale**
-- :ref:`bool<class_bool>` **gravity_point**
-- :ref:`Vector2<class_vector2>` **gravity_vec**
-- :ref:`float<class_float>` **linear_damp**
-- :ref:`bool<class_bool>` **monitorable**
-- :ref:`bool<class_bool>` **monitoring**
-- :ref:`float<class_float>` **priority**
-- :ref:`int<class_int>` **space_override**
+- :ref:`float<class_float>` **angular_damp** - The rate at which objects stop spinning in this area. Represents the amount of speed lost per second. If 1.0, physics bodies in the area stop rotating immediately. If 0.0, they never slow down. Does not incorporate external forces. The physics-update's rate affects 'angular_damp'.
+- :ref:`String<class_string>` **audio_bus_name** - The name of the Area2D's audio bus.
+- :ref:`bool<class_bool>` **audio_bus_override** - If [code]true[/code], overrides the default audio bus with the Area2D's. Defaults to [code]false[/code].
+- :ref:`int<class_int>` **collision_layer** - The physics layer this Area2D is in.
+			Collidable objects can exist in any of 32 different layers. These layers are not visual, but more of a tagging system instead. A collidable can use these layers/tags to select with which objects it can collide, using [method set_collision_mask].
+			A contact is detected if object A is in any of the layers that object B scans, or object B is in any layers that object A scans.
+- :ref:`int<class_int>` **collision_mask** - The physics layers this Area2D scans to determine collision detections.
+- :ref:`float<class_float>` **gravity** - The gravity intensity within the Area2D (ranges -1024 to 1024). This is useful to alter the force of gravity without altering its direction.
+			This value multiplies the gravity vector, whether it is the given vector ([method set_gravity_vector]), or a calculated one (when using a center of gravity).
+- :ref:`float<class_float>` **gravity_distance_scale** - The falloff factor for point gravity. The greater this value is, the faster the strength of gravity decreases with the square of distance.
+- :ref:`bool<class_bool>` **gravity_point** - If [code]true[/code], calculates gravity from a particular point during a space override (see [method set_space_override_mode]). If a point, [Vector2] position is set with [method set_gravity_vector]. Defaults to [code]false[/code].
+- :ref:`Vector2<class_vector2>` **gravity_vec** - The gravitational direction/strength as a vector (not normalized). If gravity is a point (see [method is_gravity_a_point]), this will be the attraction center.
+- :ref:`float<class_float>` **linear_damp** - The rate at which objects stop spinning in this area. Represents the amount of speed lost per second. If 1.0, physics bodies in the area stop rotating immediately. If 0.0, they never slow down. Does not incorporate external forces. The physics-update's rate affects 'angular_damp'.
+- :ref:`bool<class_bool>` **monitorable** - If [code]true[/code], other monitoring areas can detect this Area2D (is it undetectable at the moment?). Defaults to [code]true[/code].
+- :ref:`bool<class_bool>` **monitoring** - If [code]true[/code], this detects bodies/areas entering/exiting it (can it detect others at the moment?). Defaults to [code]true[/code].
+- :ref:`float<class_float>` **priority** - The processing order for this priority. Ranges from 0 to 128. Defaults to 0. Higher priorities are processed first.
+- :ref:`int<class_int>` **space_override** - How to override gravity and damping calculations within this Area2D, if at all. Consult the SPACE_OVERRIDE_* constants for available options.
+
+Numeric Constants
+-----------------
+
+- **SPACE_OVERRIDE_DISABLED** = **0** --- This area does not affect gravity/damp. These are areas that exist only to detect collisions and objects entering or exiting them.
+- **SPACE_OVERRIDE_COMBINE** = **1** --- This area adds its gravity/damp values to whatever has been calculated so far. This way, many overlapping areas can combine their physics to make interesting effects.
+- **SPACE_OVERRIDE_COMBINE_REPLACE** = **2** --- This area adds its gravity/damp values to whatever has been calculated so far. Then stops taking into account the rest of the areas, even the default one.
+- **SPACE_OVERRIDE_REPLACE** = **3** --- This area replaces any gravity/damp, even the default one, and stops taking into account the rest of the areas.
+- **SPACE_OVERRIDE_REPLACE_COMBINE** = **4** --- This area replaces any gravity/damp calculated so far, but keeps calculating the rest of the areas, down to the default one.
 
 Description
 -----------
 
-General purpose area detection for 2D physics. Areas can be used for detection of objects that enter/exit them, as well as overriding space parameters (changing gravity, damping, etc). For this, use any space override different from AREA_SPACE_OVERRIDE_DISABLE and point gravity at the center of mass.
+2D area that detects nodes that enter or exit it. Change  the 'space_override' property SPACE_OVERRIDE\_\* to override physics parameters for nodes like Rigidbody2D. E.g. gravity, damping... See :ref:`CollisionObject2D<class_collisionobject2d>` for usage.
 
 Member Function Description
 ---------------------------
@@ -152,9 +165,9 @@ Member Function Description
 
 Return the angular damp rate.
 
-.. _class_Area2D_get_audio_bus:
+.. _class_Area2D_get_audio_bus_name:
 
-- :ref:`String<class_string>`  **get_audio_bus**  **(** **)** const
+- :ref:`String<class_string>`  **get_audio_bus_name**  **(** **)** const
 
 .. _class_Area2D_get_collision_layer:
 
@@ -166,19 +179,19 @@ Return the physics layer this area is in.
 
 - :ref:`bool<class_bool>`  **get_collision_layer_bit**  **(** :ref:`int<class_int>` bit  **)** const
 
-Return an individual bit on the layer mask.
+Return an individual bit on the layer mask. Describes whether other areas will collide with this one on the given layer.
 
 .. _class_Area2D_get_collision_mask:
 
 - :ref:`int<class_int>`  **get_collision_mask**  **(** **)** const
 
-Return the physics layers this area can scan for collisions.
+Return the physics layers this area will scan to determine collisions.
 
 .. _class_Area2D_get_collision_mask_bit:
 
 - :ref:`bool<class_bool>`  **get_collision_mask_bit**  **(** :ref:`int<class_int>` bit  **)** const
 
-Return an individual bit on the collision mask.
+Return an individual bit on the collision mask. Describes whether this area will collide with others on the given layer.
 
 .. _class_Area2D_get_gravity:
 
@@ -208,13 +221,13 @@ Return the linear damp rate.
 
 - :ref:`Array<class_array>`  **get_overlapping_areas**  **(** **)** const
 
-Return a list of the areas that are totally or partially inside this area.
+Returns a list of the :ref:`Area2D<class_area2d>`s that intersect with this area.
 
 .. _class_Area2D_get_overlapping_bodies:
 
 - :ref:`Array<class_array>`  **get_overlapping_bodies**  **(** **)** const
 
-Return a list of the bodies (:ref:`PhysicsBody2D<class_physicsbody2d>`) that are totally or partially inside this area.
+Return a list of the :ref:`PhysicsBody2D<class_physicsbody2d>`s that intersect with this area.
 
 .. _class_Area2D_get_priority:
 
@@ -270,9 +283,9 @@ Set the rate at which objects stop spinning in this area, if there are not any o
 
 In practice, as the fraction of speed lost gets smaller with each frame, a value of 1.0 does not mean the object will stop in exactly one second. Only when the physics calculations are done at 1 frame per second, it does stop in a second.
 
-.. _class_Area2D_set_audio_bus:
+.. _class_Area2D_set_audio_bus_name:
 
-- void  **set_audio_bus**  **(** :ref:`String<class_string>` name  **)**
+- void  **set_audio_bus_name**  **(** :ref:`String<class_string>` name  **)**
 
 .. _class_Area2D_set_audio_bus_override:
 
@@ -364,7 +377,7 @@ Areas with the same priority value get evaluated in an unpredictable order, and
 
 .. _class_Area2D_set_space_override_mode:
 
-- void  **set_space_override_mode**  **(** :ref:`int<class_int>` enable  **)**
+- void  **set_space_override_mode**  **(** :ref:`int<class_int>` space_override_mode  **)**
 
 Set the space override mode. This mode controls how an area affects gravity and damp.
 

classes/class_array.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the Array.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_Array:
 
@@ -39,6 +40,8 @@ Member Functions
 +----------------------------+-----------------------------------------------------------------------------------------------------------------------------+
 | :ref:`int<class_int>`      | :ref:`count<class_Array_count>`  **(** var value  **)**                                                                     |
 +----------------------------+-----------------------------------------------------------------------------------------------------------------------------+
+| :ref:`Array<class_array>`  | :ref:`duplicate<class_Array_duplicate>`  **(** **)**                                                                        |
++----------------------------+-----------------------------------------------------------------------------------------------------------------------------+
 | :ref:`bool<class_bool>`    | :ref:`empty<class_Array_empty>`  **(** **)**                                                                                |
 +----------------------------+-----------------------------------------------------------------------------------------------------------------------------+
 | void                       | :ref:`erase<class_Array_erase>`  **(** var value  **)**                                                                     |
@@ -53,7 +56,7 @@ Member Functions
 +----------------------------+-----------------------------------------------------------------------------------------------------------------------------+
 | :ref:`int<class_int>`      | :ref:`hash<class_Array_hash>`  **(** **)**                                                                                  |
 +----------------------------+-----------------------------------------------------------------------------------------------------------------------------+
-| void                       | :ref:`insert<class_Array_insert>`  **(** :ref:`int<class_int>` pos, var value  **)**                                        |
+| void                       | :ref:`insert<class_Array_insert>`  **(** :ref:`int<class_int>` position, var value  **)**                                   |
 +----------------------------+-----------------------------------------------------------------------------------------------------------------------------+
 | void                       | :ref:`invert<class_Array_invert>`  **(** **)**                                                                              |
 +----------------------------+-----------------------------------------------------------------------------------------------------------------------------+
@@ -65,9 +68,9 @@ Member Functions
 +----------------------------+-----------------------------------------------------------------------------------------------------------------------------+
 | void                       | :ref:`push_front<class_Array_push_front>`  **(** var value  **)**                                                           |
 +----------------------------+-----------------------------------------------------------------------------------------------------------------------------+
-| void                       | :ref:`remove<class_Array_remove>`  **(** :ref:`int<class_int>` pos  **)**                                                   |
+| void                       | :ref:`remove<class_Array_remove>`  **(** :ref:`int<class_int>` position  **)**                                              |
 +----------------------------+-----------------------------------------------------------------------------------------------------------------------------+
-| void                       | :ref:`resize<class_Array_resize>`  **(** :ref:`int<class_int>` pos  **)**                                                   |
+| void                       | :ref:`resize<class_Array_resize>`  **(** :ref:`int<class_int>` size  **)**                                                  |
 +----------------------------+-----------------------------------------------------------------------------------------------------------------------------+
 | :ref:`int<class_int>`      | :ref:`rfind<class_Array_rfind>`  **(** var what, :ref:`int<class_int>` from=-1  **)**                                       |
 +----------------------------+-----------------------------------------------------------------------------------------------------------------------------+
@@ -152,6 +155,10 @@ Clear the array (resize to 0).
 
 Return the amount of times an element is in the array.
 
+.. _class_Array_duplicate:
+
+- :ref:`Array<class_array>`  **duplicate**  **(** **)**
+
 .. _class_Array_empty:
 
 - :ref:`bool<class_bool>`  **empty**  **(** **)**
@@ -203,7 +210,7 @@ Return a hashed integer value representing the array contents.
 
 .. _class_Array_insert:
 
-- void  **insert**  **(** :ref:`int<class_int>` pos, var value  **)**
+- void  **insert**  **(** :ref:`int<class_int>` position, var value  **)**
 
 Insert a new element at a given position in the array. The position must be valid, or at the end of the array (pos==size()).
 
@@ -239,13 +246,13 @@ Add an element at the beginning of the array.
 
 .. _class_Array_remove:
 
-- void  **remove**  **(** :ref:`int<class_int>` pos  **)**
+- void  **remove**  **(** :ref:`int<class_int>` position  **)**
 
 Remove an element from the array by index.
 
 .. _class_Array_resize:
 
-- void  **resize**  **(** :ref:`int<class_int>` pos  **)**
+- void  **resize**  **(** :ref:`int<class_int>` size  **)**
 
 Resize the array to contain a different number of elements. If the array size is smaller, elements are cleared, if bigger, new elements are Null.
 

classes/class_arraymesh.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the ArrayMesh.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_ArrayMesh:
 
@@ -47,6 +48,10 @@ Member Functions
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`int<class_int>`            | :ref:`surface_get_array_len<class_ArrayMesh_surface_get_array_len>`  **(** :ref:`int<class_int>` surf_idx  **)** const                                                                                                                           |
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`Array<class_array>`        | :ref:`surface_get_arrays<class_ArrayMesh_surface_get_arrays>`  **(** :ref:`int<class_int>` surf_idx  **)** const                                                                                                                                 |
++----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`Array<class_array>`        | :ref:`surface_get_blend_shape_arrays<class_ArrayMesh_surface_get_blend_shape_arrays>`  **(** :ref:`int<class_int>` surf_idx  **)** const                                                                                                         |
++----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`int<class_int>`            | :ref:`surface_get_format<class_ArrayMesh_surface_get_format>`  **(** :ref:`int<class_int>` surf_idx  **)** const                                                                                                                                 |
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`Material<class_material>`  | :ref:`surface_get_material<class_ArrayMesh_surface_get_material>`  **(** :ref:`int<class_int>` surf_idx  **)** const                                                                                                                             |
@@ -156,6 +161,14 @@ Return the length in indices of the index array in the requested surface (see :r
 
 Return the length in vertices of the vertex array in the requested surface (see :ref:`add_surface<class_ArrayMesh_add_surface>`).
 
+.. _class_ArrayMesh_surface_get_arrays:
+
+- :ref:`Array<class_array>`  **surface_get_arrays**  **(** :ref:`int<class_int>` surf_idx  **)** const
+
+.. _class_ArrayMesh_surface_get_blend_shape_arrays:
+
+- :ref:`Array<class_array>`  **surface_get_blend_shape_arrays**  **(** :ref:`int<class_int>` surf_idx  **)** const
+
 .. _class_ArrayMesh_surface_get_format:
 
 - :ref:`int<class_int>`  **surface_get_format**  **(** :ref:`int<class_int>` surf_idx  **)** const

classes/class_arvranchor.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the ARVRAnchor.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_ARVRAnchor:
 
@@ -13,7 +14,7 @@ ARVRAnchor
 Brief Description
 -----------------
 
-
+Anchor point in AR Space
 
 Member Functions
 ----------------
@@ -35,6 +36,15 @@ Member Variables
 
 - :ref:`int<class_int>` **anchor_id**
 
+Description
+-----------
+
+The ARVR Anchor point is a spatial node that maps a real world location identified by the AR platform to a position within the game world. For example, as long as plane detection in ARKit is on, ARKit will identify and update the position of planes (tables, floors, etc) and create anchors for them.
+
+This node is mapped to one of the anchors through its unique id. When you receive a signal that a new anchor is available you should add this node to your scene for that anchor. You can predefine nodes and set the id and the nodes will simply remain on 0,0,0 until a plane is recognised.
+
+Keep in mind that as long as plane detection is enable the size, placing and orientation of an anchor will be updates as the detection logic learns more about the real world out there especially if only part of the surface is in view.
+
 Member Function Description
 ---------------------------
 
@@ -42,20 +52,30 @@ Member Function Description
 
 - :ref:`int<class_int>`  **get_anchor_id**  **(** **)** const
 
+Returns the anchor id for this anchor.
+
 .. _class_ARVRAnchor_get_anchor_name:
 
 - :ref:`String<class_string>`  **get_anchor_name**  **(** **)** const
 
+Returns the name given to this anchor.
+
 .. _class_ARVRAnchor_get_is_active:
 
 - :ref:`bool<class_bool>`  **get_is_active**  **(** **)** const
 
+Returns true if the anchor is being tracked and false if no anchor with this id is currently known.
+
 .. _class_ARVRAnchor_get_size:
 
 - :ref:`Vector3<class_vector3>`  **get_size**  **(** **)** const
 
+Returns the estimated size of the plane that was detected. Say when the anchor relates to a table in the real world, this is the estimated size of the surface of that table.
+
 .. _class_ARVRAnchor_set_anchor_id:
 
 - void  **set_anchor_id**  **(** :ref:`int<class_int>` anchor_id  **)**
 
+Binds this anchor node to an anchor with this id. You can set this before the anchor itself exists. The first anchor that is identified gets id 1, the second id 2, etc. When anchors get removed that slot remains free and can be assigned to the next anchor that is identified. The most common situation where anchors 'disappear' is when the AR server identifies that two anchors represent different parts of the same plane and merge them.
+
 

classes/class_arvrcamera.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the ARVRCamera.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_ARVRCamera:
 
@@ -13,5 +14,12 @@ ARVRCamera
 Brief Description
 -----------------
 
+A camera node with a few overrules for AR/VR applied such as location tracking.
 
+Description
+-----------
+
+This is a helper spatial node for our camera, note that if stereoscopic rendering is applicable (VR-HMD) most of the camera properties are ignored as the HMD information overrides them. The only properties that can be trusted are the near and far planes.
+
+The position and orientation of this node is automatically updated by the ARVR Server to represent the location of the HMD if such tracking is available and can thus be used by game logic. Note that in contrast to the ARVR Controller the render thread has access to the most up to date tracking data of the HMD and the location of the ARVRCamera can lag a few milliseconds behind what is used for rendering as a result.
 

classes/class_arvrcontroller.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the ARVRController.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_ARVRController:
 
@@ -13,7 +14,7 @@ ARVRController
 Brief Description
 -----------------
 
-
+A spatial node representing a spatially tracked controller.
 
 Member Functions
 ----------------
@@ -23,6 +24,8 @@ Member Functions
 +------------------------------+--------------------------------------------------------------------------------------------------------------------+
 | :ref:`String<class_string>`  | :ref:`get_controller_name<class_ARVRController_get_controller_name>`  **(** **)** const                            |
 +------------------------------+--------------------------------------------------------------------------------------------------------------------+
+| :ref:`int<class_int>`        | :ref:`get_hand<class_ARVRController_get_hand>`  **(** **)** const                                                  |
++------------------------------+--------------------------------------------------------------------------------------------------------------------+
 | :ref:`bool<class_bool>`      | :ref:`get_is_active<class_ARVRController_get_is_active>`  **(** **)** const                                        |
 +------------------------------+--------------------------------------------------------------------------------------------------------------------+
 | :ref:`float<class_float>`    | :ref:`get_joystick_axis<class_ARVRController_get_joystick_axis>`  **(** :ref:`int<class_int>` axis  **)** const    |
@@ -38,13 +41,26 @@ Signals
 -------
 
 -  **button_pressed**  **(** :ref:`int<class_int>` button  **)**
+When a button on this controller is pressed, this signal is given.
+
 -  **button_release**  **(** :ref:`int<class_int>` button  **)**
+When a button on this controller is released, this signal is given.
+
 
 Member Variables
 ----------------
 
 - :ref:`int<class_int>` **controller_id**
 
+Description
+-----------
+
+This is a helper spatial node that is linked to the tracking of controllers. It also offers several handy pass throughs to the state of buttons and such on the controllers.
+
+Controllers are linked by their id. You can create controller nodes before the controllers are available. Say your game always uses two controllers (one for each hand) you can predefine the controllers with id 1 and 2 and they will become active as soon as the controllers are identified. If you expect additional controllers to be used you should react to the signals and add ARVRController nodes to your scene.
+
+The position of the controller node is automatically updated by the ARVR Server. This makes this node ideal to add child  nodes to visualise the controller.
+
 Member Function Description
 ---------------------------
 
@@ -52,28 +68,46 @@ Member Function Description
 
 - :ref:`int<class_int>`  **get_controller_id**  **(** **)** const
 
+Returns the controller id currently assigned to this node.
+
 .. _class_ARVRController_get_controller_name:
 
 - :ref:`String<class_string>`  **get_controller_name**  **(** **)** const
 
+If active, returns the name of the associated controller if provided by the AR/VR SDK used.
+
+.. _class_ARVRController_get_hand:
+
+- :ref:`int<class_int>`  **get_hand**  **(** **)** const
+
 .. _class_ARVRController_get_is_active:
 
 - :ref:`bool<class_bool>`  **get_is_active**  **(** **)** const
 
+Returns true if the controller bound to this node is currently active and being tracked.
+
 .. _class_ARVRController_get_joystick_axis:
 
 - :ref:`float<class_float>`  **get_joystick_axis**  **(** :ref:`int<class_int>` axis  **)** const
 
+Returns the value of the given axis for things like triggers, touchpads, etc. that are embedded into the controller.
+
 .. _class_ARVRController_get_joystick_id:
 
 - :ref:`int<class_int>`  **get_joystick_id**  **(** **)** const
 
+Returns the ID of the joystick object bound to this. Every controller tracked by the ARVR Server that has buttons and axis will also be registered as a joystick within Godot. This means that all the normal joystick tracking and input mapping will work for buttons and axis found on the AR/VR controllers. This ID is purely offered as information so you can link up the controller with its joystick entry.
+
 .. _class_ARVRController_is_button_pressed:
 
 - :ref:`int<class_int>`  **is_button_pressed**  **(** :ref:`int<class_int>` button  **)** const
 
+Is the given button currently pressed?
+
 .. _class_ARVRController_set_controller_id:
 
 - void  **set_controller_id**  **(** :ref:`int<class_int>` controller_id  **)**
 
+Changes the id that identifies the controller bound to this node. The first controller that the ARVR Server detects will have id 1, the second id 2, the third id 3, etc. When a controller is turned off that slot is freed ensuring that controllers will keep the same id while it is turned on even when controllers with lower ids are turned off.
+
 

classes/class_arvrinterface.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the ARVRInterface.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_ARVRInterface:
 
@@ -15,7 +16,7 @@ ARVRInterface
 Brief Description
 -----------------
 
-
+Base class for ARVR interface implementation.
 
 Member Functions
 ----------------
@@ -50,9 +51,16 @@ Member Variables
 Numeric Constants
 -----------------
 
-- **EYE_MONO** = **0**
-- **EYE_LEFT** = **1**
-- **EYE_RIGHT** = **2**
+- **EYE_MONO** = **0** --- Mono output, this is mostly used internally when retrieving positioning information for our camera node or when stereo scopic rendering is not supported.
+- **EYE_LEFT** = **1** --- Left eye output, this is mostly used internally when rendering the image for the left eye and obtaining positioning and projection information.
+- **EYE_RIGHT** = **2** --- Right eye output, this is mostly used internally when rendering the image for the right eye and obtaining positioning and projection information.
+
+Description
+-----------
+
+This class needs to be implemented to make an AR or VR platform available to Godot and these should be implemented as C++ modules or GDNative modules (note that for GDNative the subclass ARVRScriptInterface should be used). Part of the interface is exposed to GDScript so you can detect, enable and configure an AR or VR platform.
+
+Interfaces should be written in such a way that simply enabling them will give us a working setup. You can query the available interfaces through ARVRServer.
 
 Member Function Description
 ---------------------------
@@ -61,40 +69,68 @@ Member Function Description
 
 - :ref:`String<class_string>`  **get_name**  **(** **)** const
 
+Returns the name of this interface (OpenVR, OpenHMD, ARKit, etc).
+
 .. _class_ARVRInterface_get_recommended_render_targetsize:
 
 - :ref:`Vector2<class_vector2>`  **get_recommended_render_targetsize**  **(** **)**
 
+Returns the resolution at which we should render our intermediate results before things like lens distortion are applied by the VR platform.
+
 .. _class_ARVRInterface_hmd_is_present:
 
 - :ref:`bool<class_bool>`  **hmd_is_present**  **(** **)**
 
+Returns true if an HMD is available for this interface.
+
 .. _class_ARVRInterface_initialize:
 
 - :ref:`bool<class_bool>`  **initialize**  **(** **)**
 
+Call this to initialize this interface. The first interface that is initialized is identified as the primary interface and it will be used for rendering output.
+
+After initializing the interface you want to use you then need to enable the AR/VR mode of a viewport and rendering should commence. 
+
+Note that you must enable the AR/VR mode on the main viewport for any device that uses the main output of Godot such as for mobile VR. 
+
+If you do this for a platform that handles its own output (such as OpenVR) Godot will show just one eye without distortion on screen. Alternatively you can add a separate viewport node to your scene and enable AR/VR on that viewport and it will be used to output to the HMD leaving you free to do anything you like in the main window such as using a separate camera as a spectator camera or render out something completely different.
+
+While currently not used you can activate additional interfaces, you may wish to do this if you want to track controllers from other platforms. However at this point in time only one interface can render to an HMD.
+
 .. _class_ARVRInterface_is_initialized:
 
 - :ref:`bool<class_bool>`  **is_initialized**  **(** **)**
 
+Returns true if this interface is active.
+
 .. _class_ARVRInterface_is_installed:
 
 - :ref:`bool<class_bool>`  **is_installed**  **(** **)**
 
+Returns true if this interface has been installed. Say your game is designed to work with OpenVR so you are using the OpenVR interface but the user hasn't installed SteamVR, this would return false.
+
 .. _class_ARVRInterface_is_primary:
 
 - :ref:`bool<class_bool>`  **is_primary**  **(** **)**
 
+Returns true if this interface is currently the primary interface (the interface responsible for showing the output).
+
 .. _class_ARVRInterface_set_is_primary:
 
 - void  **set_is_primary**  **(** :ref:`bool<class_bool>` enable  **)**
 
+Set this interface to the primary interface (unset the old one).
+
 .. _class_ARVRInterface_supports_hmd:
 
 - :ref:`bool<class_bool>`  **supports_hmd**  **(** **)**
 
+Returns true if this interface supports HMDs and by extension uses stereo scopic rendering.
+
 .. _class_ARVRInterface_uninitialize:
 
 - void  **uninitialize**  **(** **)**
 
+Turns the interface off.
+
 

classes/class_arvrorigin.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the ARVROrigin.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_ARVROrigin:
 
@@ -13,7 +14,7 @@ ARVROrigin
 Brief Description
 -----------------
 
-
+Our origin point in AR/VR.
 
 Member Functions
 ----------------
@@ -29,6 +30,17 @@ Member Variables
 
 - :ref:`float<class_float>` **world_scale**
 
+Description
+-----------
+
+This is a special node within the AR/VR system that maps the physical location of the center of our tracking space to the virtual location within our game world.
+
+There should be only one of these nodes in your scene and you must have one. All the ARVRCamera, ARVRController and ARVRAnchor nodes should be direct children of this node for spatial tracking to work correctly.
+
+It is the position of this node that you update when you're character needs to move through your game world while we're not moving in the real world. Movement in the real world is always in relation to this origin point.
+
+So say that your character is driving a car, the ARVROrigin node should be a child node of this car. If you implement a teleport system to move your character, you change the position of this node. Etc.
+
 Member Function Description
 ---------------------------
 
@@ -36,8 +48,16 @@ Member Function Description
 
 - :ref:`float<class_float>`  **get_world_scale**  **(** **)** const
 
+Get the world scale applied to our positioning.
+
 .. _class_ARVROrigin_set_world_scale:
 
 - void  **set_world_scale**  **(** :ref:`float<class_float>` world_scale  **)**
 
+Changes the world scaling factor.
+
+Most AR/VR platforms will assume a unit size of 1 unit in your game world = 1 meter in the real world. This scale allows you to adjust this to the unit system you use in your game. 
+
+Note that this method is a passthrough to the ARVRServer itself.
+
 

classes/class_arvrpositionaltracker.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the ARVRPositionalTracker.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_ARVRPositionalTracker:
 
@@ -13,11 +14,13 @@ ARVRPositionalTracker
 Brief Description
 -----------------
 
-
+A tracked object
 
 Member Functions
 ----------------
 
++------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`int<class_int>`              | :ref:`get_hand<class_ARVRPositionalTracker_get_hand>`  **(** **)** const                                                              |
 +------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`int<class_int>`              | :ref:`get_joy_id<class_ARVRPositionalTracker_get_joy_id>`  **(** **)** const                                                          |
 +------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
@@ -36,39 +39,75 @@ Member Functions
 | :ref:`int<class_int>`              | :ref:`get_type<class_ARVRPositionalTracker_get_type>`  **(** **)** const                                                              |
 +------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------+
 
+Numeric Constants
+-----------------
+
+- **TRACKER_HAND_UNKNOWN** = **0**
+- **TRACKER_LEFT_HAND** = **1**
+- **TRACKER_RIGHT_HAND** = **2**
+
+Description
+-----------
+
+An instance of this object represents a device that is tracked such as a controller or anchor point. HMDs aren't represented here as they are fully handled internally.
+
+As controllers are turned on and the AR/VR interface detects them instances of this object are automatically added to this list of active tracking objects accessible through the ARVRServer
+
+The ARVRController and ARVRAnchor both consume objects of this type and should be the objects you use in game. The positional trackers are just the under the hood objects that make this all work and are mostly exposed so GDNative based interfaces can interact with them.
+
 Member Function Description
 ---------------------------
 
+.. _class_ARVRPositionalTracker_get_hand:
+
+- :ref:`int<class_int>`  **get_hand**  **(** **)** const
+
 .. _class_ARVRPositionalTracker_get_joy_id:
 
 - :ref:`int<class_int>`  **get_joy_id**  **(** **)** const
 
+If this is a controller that is being tracked the controller will also be represented by a joystick entry with this id.
+
 .. _class_ARVRPositionalTracker_get_name:
 
 - :ref:`String<class_string>`  **get_name**  **(** **)** const
 
+If available this returns the name of the controller or anchor point.
+
 .. _class_ARVRPositionalTracker_get_orientation:
 
 - :ref:`Basis<class_basis>`  **get_orientation**  **(** **)** const
 
+Returns the orientation matrix of the controller.
+
 .. _class_ARVRPositionalTracker_get_position:
 
 - :ref:`Vector3<class_vector3>`  **get_position**  **(** **)** const
 
+Returns the position of the controller adjusted by world scale.
+
 .. _class_ARVRPositionalTracker_get_tracks_orientation:
 
 - :ref:`bool<class_bool>`  **get_tracks_orientation**  **(** **)** const
 
+Returns true if the orientation of this device is being tracked.
+
 .. _class_ARVRPositionalTracker_get_tracks_position:
 
 - :ref:`bool<class_bool>`  **get_tracks_position**  **(** **)** const
 
+Returns true if the position of this device is being tracked.
+
 .. _class_ARVRPositionalTracker_get_transform:
 
 - :ref:`Transform<class_transform>`  **get_transform**  **(** :ref:`bool<class_bool>` adjust_by_reference_frame  **)** const
 
+Returns the transform combining the orientation and position of this device.
+
 .. _class_ARVRPositionalTracker_get_type:
 
 - :ref:`int<class_int>`  **get_type**  **(** **)** const
 
+Type of tracker.
+
 

classes/class_arvrscriptinterface.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the ARVRScriptInterface.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_ARVRScriptInterface:
 
@@ -13,7 +14,7 @@ ARVRScriptInterface
 Brief Description
 -----------------
 
-
+Base class for GDNative based ARVR interfaces.
 
 Member Functions
 ----------------
@@ -44,6 +45,11 @@ Member Functions
 | void                               | :ref:`uninitialize<class_ARVRScriptInterface_uninitialize>`  **(** **)** virtual                                                                                               |
 +------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 
+Description
+-----------
+
+This class is used as a base class/interface class for implementing GDNative based ARVR interfaces and as a result exposes more of the internals of the ARVR server.
+
 Member Function Description
 ---------------------------
 
@@ -51,48 +57,72 @@ Member Function Description
 
 - void  **_get_projection_for_eye**  **(** **)** virtual
 
+Should return the projection 4x4 matrix for the requested eye.
+
 .. _class_ARVRScriptInterface_commit_for_eye:
 
 - void  **commit_for_eye**  **(** :ref:`int<class_int>` eye, :ref:`RID<class_rid>` render_target  **)** virtual
 
+Outputs a finished render buffer to the AR/VR device for the given eye.
+
 .. _class_ARVRScriptInterface_get_recommended_render_targetsize:
 
 - :ref:`Vector2<class_vector2>`  **get_recommended_render_targetsize**  **(** **)** virtual
 
+Returns the size at which we should render our scene to get optimal quality on the output device.
+
 .. _class_ARVRScriptInterface_get_transform_for_eye:
 
 - :ref:`Transform<class_transform>`  **get_transform_for_eye**  **(** :ref:`int<class_int>` eye, :ref:`Transform<class_transform>` cam_transform  **)** virtual
 
+Get the location and orientation transform used when rendering a specific eye.
+
 .. _class_ARVRScriptInterface_hmd_is_present:
 
 - :ref:`bool<class_bool>`  **hmd_is_present**  **(** **)** virtual
 
+Return true is an HMD is available.
+
 .. _class_ARVRScriptInterface_initialize:
 
 - :ref:`bool<class_bool>`  **initialize**  **(** **)** virtual
 
+Initialize this interface.
+
 .. _class_ARVRScriptInterface_is_initialized:
 
 - :ref:`bool<class_bool>`  **is_initialized**  **(** **)** virtual
 
+Returns true if this interface has been initialized and is active.
+
 .. _class_ARVRScriptInterface_is_installed:
 
 - :ref:`bool<class_bool>`  **is_installed**  **(** **)** virtual
 
+Returns true if the required middleware is installed.
+
 .. _class_ARVRScriptInterface_is_stereo:
 
 - :ref:`bool<class_bool>`  **is_stereo**  **(** **)** virtual
 
+Returns true if we require stereoscopic rendering for this interface.
+
 .. _class_ARVRScriptInterface_process:
 
 - void  **process**  **(** **)** virtual
 
+Gets called before rendering each frame so tracking data gets updated in time.
+
 .. _class_ARVRScriptInterface_supports_hmd:
 
 - :ref:`bool<class_bool>`  **supports_hmd**  **(** **)** virtual
 
+Returns true if this interface supports HMDs.
+
 .. _class_ARVRScriptInterface_uninitialize:
 
 - void  **uninitialize**  **(** **)** virtual
 
+Turn this interface off.
+
 

classes/class_arvrserver.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the ARVRServer.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_ARVRServer:
 
@@ -13,7 +14,7 @@ ARVRServer
 Brief Description
 -----------------
 
-
+This is our AR/VR Server.
 
 Member Functions
 ----------------
@@ -48,9 +49,17 @@ Signals
 -------
 
 -  **interface_added**  **(** :ref:`String<class_string>` name  **)**
+Signal send when a new interface has been added.
+
 -  **interface_removed**  **(** :ref:`String<class_string>` name  **)**
--  **tracker_added**  **(** :ref:`String<class_string>` name, :ref:`int<class_int>` type  **)**
--  **tracker_removed**  **(** :ref:`String<class_string>` name  **)**
+Signal send when an interface is removed.
+
+-  **tracker_added**  **(** :ref:`String<class_string>` name, :ref:`int<class_int>` type, :ref:`int<class_int>` id  **)**
+Signal send when a new tracker has been added. If you don't use a fixed number of controllers or if you're using ARVRAnchors for an AR solution it is important to react to this signal and add the appropriate ARVRController or ARVRAnchor node related to this new tracker.
+
+-  **tracker_removed**  **(** :ref:`String<class_string>` name, :ref:`int<class_int>` type, :ref:`int<class_int>` id  **)**
+Signal send when a tracker is removed, you should remove any ARVRController or ARVRAnchor points if applicable. This is not mandatory, the nodes simply become inactive and will be made active again when a new tracker becomes available (i.e. a new controller is switched on that takes the place of the previous one).
+
 
 Member Variables
 ----------------
@@ -60,12 +69,17 @@ Member Variables
 Numeric Constants
 -----------------
 
-- **TRACKER_CONTROLLER** = **1**
-- **TRACKER_BASESTATION** = **2**
-- **TRACKER_ANCHOR** = **4**
-- **TRACKER_UNKNOWN** = **128**
-- **TRACKER_ANY_KNOWN** = **127**
-- **TRACKER_ANY** = **255**
+- **TRACKER_CONTROLLER** = **1** --- Our tracker tracks the location of a controller.
+- **TRACKER_BASESTATION** = **2** --- Our tracker tracks the location of a base station.
+- **TRACKER_ANCHOR** = **4** --- Our tracker tracks the location and size of an AR anchor.
+- **TRACKER_UNKNOWN** = **128** --- Used internally if we haven't set the tracker type yet.
+- **TRACKER_ANY_KNOWN** = **127** --- Used internally to filter trackers of any known type.
+- **TRACKER_ANY** = **255** --- Used interally to select all trackers.
+
+Description
+-----------
+
+The AR/VR Server is the heart of our AR/VR solution and handles all the processing.
 
 Member Function Description
 ---------------------------
@@ -74,48 +88,82 @@ Member Function Description
 
 - void  **add_interface**  **(** :ref:`ARVRInterface<class_arvrinterface>` arg0  **)**
 
+Mostly exposed for GDNative based interfaces, this is called to register an available interface with the AR/VR server.
+
 .. _class_ARVRServer_find_interface:
 
 - :ref:`ARVRInterface<class_arvrinterface>`  **find_interface**  **(** :ref:`String<class_string>` name  **)** const
 
+Find an interface by its name. Say that you're making a game that uses specific capabilities of an AR/VR platform you can find the interface for that platform by name and initialize it.
+
 .. _class_ARVRServer_get_interface:
 
 - :ref:`ARVRInterface<class_arvrinterface>`  **get_interface**  **(** :ref:`int<class_int>` idx  **)** const
 
+Get the interface registered at a given index in our list of interfaces.
+
 .. _class_ARVRServer_get_interface_count:
 
 - :ref:`int<class_int>`  **get_interface_count**  **(** **)** const
 
+Get the number of interfaces currently registered with the AR/VR server. If you're game supports multiple AR/VR platforms you can look throught the available interface and either present the user with a selection or simply try an initialize each interface and use the first one that returns true.
+
 .. _class_ARVRServer_get_reference_frame:
 
 - :ref:`Transform<class_transform>`  **get_reference_frame**  **(** **)** const
 
+Gets our reference frame transform, mostly used internally and exposed for GDNative build interfaces.
+
 .. _class_ARVRServer_get_tracker:
 
 - :ref:`ARVRPositionalTracker<class_arvrpositionaltracker>`  **get_tracker**  **(** :ref:`int<class_int>` idx  **)** const
 
+Get the positional tracker at the given ID.
+
 .. _class_ARVRServer_get_tracker_count:
 
 - :ref:`int<class_int>`  **get_tracker_count**  **(** **)** const
 
+Get the number of trackers currently registered.
+
 .. _class_ARVRServer_get_world_scale:
 
 - :ref:`float<class_float>`  **get_world_scale**  **(** **)** const
 
+Returns our world scale (see ARVROrigin for more information).
+
 .. _class_ARVRServer_remove_interface:
 
 - void  **remove_interface**  **(** :ref:`ARVRInterface<class_arvrinterface>` arg0  **)**
 
+Removes a registered interface, again exposed mostly for GDNative based interfaces.
+
 .. _class_ARVRServer_request_reference_frame:
 
 - void  **request_reference_frame**  **(** :ref:`bool<class_bool>` ignore_tilt, :ref:`bool<class_bool>` keep_height  **)**
 
+This is a really important function to understand correctly. AR and VR platforms all handle positioning slightly differently.
+
+For platforms that do not offer spatial tracking our origin point (0,0,0) is the location of our HMD but you have little control over the direction the player is facing in the real world.
+
+For platforms that do offer spatial tracking our origin point depends very much on the system. For OpenVR our origin point is usually the center of the tracking space, on the ground. For other platforms its often the location of the tracking camera.
+
+This method allows you to create a reference frame, it will take the current location of the HMD and use that to adjust all our tracking data in essence realigning the real world to your players current position in your game world.
+
+For this method to produce usable results tracking information should be available and this often takes a few frames after starting your game.
+
+You should call this method after a few seconds have passed, when the user requests a realignment of the display holding a designated button on a controller for a short period of time, and when implementing a teleport mechanism.
+
 .. _class_ARVRServer_set_primary_interface:
 
 - void  **set_primary_interface**  **(** :ref:`ARVRInterface<class_arvrinterface>` arg0  **)**
 
+Changes the primary interface to the specified interface. Again mostly exposed for GDNative interfaces.
+
 .. _class_ARVRServer_set_world_scale:
 
 - void  **set_world_scale**  **(** :ref:`float<class_float>` arg0  **)**
 
+Changing the world scale, see the ARVROrigin documentation for more information.
+
 

classes/class_astar.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AStar.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AStar:
 
@@ -18,39 +19,41 @@ AStar class representation that uses vectors as edges.
 Member Functions
 ----------------
 
-+--------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                             | :ref:`_compute_cost<class_AStar__compute_cost>`  **(** :ref:`int<class_int>` from_id, :ref:`int<class_int>` to_id  **)** virtual                                  |
-+--------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                             | :ref:`_estimate_cost<class_AStar__estimate_cost>`  **(** :ref:`int<class_int>` from_id, :ref:`int<class_int>` to_id  **)** virtual                                |
-+--------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                             | :ref:`add_point<class_AStar_add_point>`  **(** :ref:`int<class_int>` id, :ref:`Vector3<class_vector3>` pos, :ref:`float<class_float>` weight_scale=1.0  **)**     |
-+--------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`bool<class_bool>`                          | :ref:`are_points_connected<class_AStar_are_points_connected>`  **(** :ref:`int<class_int>` id, :ref:`int<class_int>` to_id  **)** const                           |
-+--------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                             | :ref:`clear<class_AStar_clear>`  **(** **)**                                                                                                                      |
-+--------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                             | :ref:`connect_points<class_AStar_connect_points>`  **(** :ref:`int<class_int>` id, :ref:`int<class_int>` to_id, :ref:`bool<class_bool>` bidirectional=true  **)** |
-+--------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                             | :ref:`disconnect_points<class_AStar_disconnect_points>`  **(** :ref:`int<class_int>` id, :ref:`int<class_int>` to_id  **)**                                       |
-+--------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`int<class_int>`                            | :ref:`get_available_point_id<class_AStar_get_available_point_id>`  **(** **)** const                                                                              |
-+--------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`int<class_int>`                            | :ref:`get_closest_point<class_AStar_get_closest_point>`  **(** :ref:`Vector3<class_vector3>` to_pos  **)** const                                                  |
-+--------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`Vector3<class_vector3>`                    | :ref:`get_closest_pos_in_segment<class_AStar_get_closest_pos_in_segment>`  **(** :ref:`Vector3<class_vector3>` to_pos  **)** const                                |
-+--------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`PoolIntArray<class_poolintarray>`          | :ref:`get_id_path<class_AStar_get_id_path>`  **(** :ref:`int<class_int>` from_id, :ref:`int<class_int>` to_id  **)**                                              |
-+--------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`PoolVector3Array<class_poolvector3array>`  | :ref:`get_point_path<class_AStar_get_point_path>`  **(** :ref:`int<class_int>` from_id, :ref:`int<class_int>` to_id  **)**                                        |
-+--------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`Vector3<class_vector3>`                    | :ref:`get_point_pos<class_AStar_get_point_pos>`  **(** :ref:`int<class_int>` id  **)** const                                                                      |
-+--------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`float<class_float>`                        | :ref:`get_point_weight_scale<class_AStar_get_point_weight_scale>`  **(** :ref:`int<class_int>` id  **)** const                                                    |
-+--------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`bool<class_bool>`                          | :ref:`has_point<class_AStar_has_point>`  **(** :ref:`int<class_int>` id  **)** const                                                                              |
-+--------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                             | :ref:`remove_point<class_AStar_remove_point>`  **(** :ref:`int<class_int>` id  **)**                                                                              |
-+--------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------+
++--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                             | :ref:`_compute_cost<class_AStar__compute_cost>`  **(** :ref:`int<class_int>` from_id, :ref:`int<class_int>` to_id  **)** virtual                                   |
++--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                             | :ref:`_estimate_cost<class_AStar__estimate_cost>`  **(** :ref:`int<class_int>` from_id, :ref:`int<class_int>` to_id  **)** virtual                                 |
++--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                             | :ref:`add_point<class_AStar_add_point>`  **(** :ref:`int<class_int>` id, :ref:`Vector3<class_vector3>` position, :ref:`float<class_float>` weight_scale=1.0  **)** |
++--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`bool<class_bool>`                          | :ref:`are_points_connected<class_AStar_are_points_connected>`  **(** :ref:`int<class_int>` id, :ref:`int<class_int>` to_id  **)** const                            |
++--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                             | :ref:`clear<class_AStar_clear>`  **(** **)**                                                                                                                       |
++--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                             | :ref:`connect_points<class_AStar_connect_points>`  **(** :ref:`int<class_int>` id, :ref:`int<class_int>` to_id, :ref:`bool<class_bool>` bidirectional=true  **)**  |
++--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                             | :ref:`disconnect_points<class_AStar_disconnect_points>`  **(** :ref:`int<class_int>` id, :ref:`int<class_int>` to_id  **)**                                        |
++--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`int<class_int>`                            | :ref:`get_available_point_id<class_AStar_get_available_point_id>`  **(** **)** const                                                                               |
++--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`int<class_int>`                            | :ref:`get_closest_point<class_AStar_get_closest_point>`  **(** :ref:`Vector3<class_vector3>` to_position  **)** const                                              |
++--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`Vector3<class_vector3>`                    | :ref:`get_closest_position_in_segment<class_AStar_get_closest_position_in_segment>`  **(** :ref:`Vector3<class_vector3>` to_position  **)** const                  |
++--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`PoolIntArray<class_poolintarray>`          | :ref:`get_id_path<class_AStar_get_id_path>`  **(** :ref:`int<class_int>` from_id, :ref:`int<class_int>` to_id  **)**                                               |
++--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`PoolVector3Array<class_poolvector3array>`  | :ref:`get_point_path<class_AStar_get_point_path>`  **(** :ref:`int<class_int>` from_id, :ref:`int<class_int>` to_id  **)**                                         |
++--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`Vector3<class_vector3>`                    | :ref:`get_point_position<class_AStar_get_point_position>`  **(** :ref:`int<class_int>` id  **)** const                                                             |
++--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`float<class_float>`                        | :ref:`get_point_weight_scale<class_AStar_get_point_weight_scale>`  **(** :ref:`int<class_int>` id  **)** const                                                     |
++--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`Array<class_array>`                        | :ref:`get_points<class_AStar_get_points>`  **(** **)**                                                                                                             |
++--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`bool<class_bool>`                          | :ref:`has_point<class_AStar_has_point>`  **(** :ref:`int<class_int>` id  **)** const                                                                               |
++--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                             | :ref:`remove_point<class_AStar_remove_point>`  **(** :ref:`int<class_int>` id  **)**                                                                               |
++--------------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 
 Description
 -----------
@@ -66,90 +69,148 @@ Member Function Description
 
 - void  **_compute_cost**  **(** :ref:`int<class_int>` from_id, :ref:`int<class_int>` to_id  **)** virtual
 
+Called when computing the cost between two connected points.
+
 .. _class_AStar__estimate_cost:
 
 - void  **_estimate_cost**  **(** :ref:`int<class_int>` from_id, :ref:`int<class_int>` to_id  **)** virtual
 
+Called when estimating the cost between a point and the path's ending point.
+
 .. _class_AStar_add_point:
 
-- void  **add_point**  **(** :ref:`int<class_int>` id, :ref:`Vector3<class_vector3>` pos, :ref:`float<class_float>` weight_scale=1.0  **)**
+- void  **add_point**  **(** :ref:`int<class_int>` id, :ref:`Vector3<class_vector3>` position, :ref:`float<class_float>` weight_scale=1.0  **)**
+
+Adds a new point at the given position with the given identifier. The algorithm prefers points with lower ``weight_scale`` to form a path. The ``id`` must be 0 or larger, and the ``weight_scale`` must be 1 or larger.
+
+::
 
-Add a new point at the given position ``pos`` with the given identifier ``id``. The ``weight_scale`` has to be 1 or larger.
+    var as = AStar.new()
+    
+    as.add_point(1, Vector3(1,0,0), 4) # Adds the point (1,0,0) with weight_scale=4 and id=1
 
 .. _class_AStar_are_points_connected:
 
 - :ref:`bool<class_bool>`  **are_points_connected**  **(** :ref:`int<class_int>` id, :ref:`int<class_int>` to_id  **)** const
 
-Returns if there is a connection/segment between points ``id`` and ``from_id``
+Returns whether there is a connection/segment between the given points.
 
 .. _class_AStar_clear:
 
 - void  **clear**  **(** **)**
 
-Clear all the points and segments from AStar instance.
+Clears all the points and segments.
 
 .. _class_AStar_connect_points:
 
 - void  **connect_points**  **(** :ref:`int<class_int>` id, :ref:`int<class_int>` to_id, :ref:`bool<class_bool>` bidirectional=true  **)**
 
-Create a segment between points ``id`` and ``to_id``.
+Creates a segment between the given points.
+
+::
+
+    var as = AStar.new()
+    
+    as.add_point(1, Vector3(1,1,0))
+    as.add_point(2, Vector3(0,5,0))
+    
+    as.connect_points(1, 2, false) # If bidirectional=false it's only possible to go from point 1 to point 2
+                                   # and not from point 2 to point 1.
 
 .. _class_AStar_disconnect_points:
 
 - void  **disconnect_points**  **(** :ref:`int<class_int>` id, :ref:`int<class_int>` to_id  **)**
 
-Deletes a segment between points ``id`` and ``to_id``.
+Deletes the segment between the given points.
 
 .. _class_AStar_get_available_point_id:
 
 - :ref:`int<class_int>`  **get_available_point_id**  **(** **)** const
 
+Returns an id with no point associated to it.
+
 .. _class_AStar_get_closest_point:
 
-- :ref:`int<class_int>`  **get_closest_point**  **(** :ref:`Vector3<class_vector3>` to_pos  **)** const
+- :ref:`int<class_int>`  **get_closest_point**  **(** :ref:`Vector3<class_vector3>` to_position  **)** const
+
+Returns the id of the closest point to ``to_position``. Returns -1 if there are no points in the points pool.
 
-Returns the id of closest point of given point.  -1 is returned if there are no points on AStar.
+.. _class_AStar_get_closest_position_in_segment:
 
-.. _class_AStar_get_closest_pos_in_segment:
+- :ref:`Vector3<class_vector3>`  **get_closest_position_in_segment**  **(** :ref:`Vector3<class_vector3>` to_position  **)** const
 
-- :ref:`Vector3<class_vector3>`  **get_closest_pos_in_segment**  **(** :ref:`Vector3<class_vector3>` to_pos  **)** const
+Returns the closest position to ``to_position`` that resides inside a segment between two connected points.
 
-Returns the position of closest point that has segments.
+::
+
+    var as = AStar.new()
+    
+    as.add_point(1, Vector3(0,0,0))
+    as.add_point(2, Vector3(0,5,0))
+    
+    as.connect_points(1, 2)
+    
+    var res = as.get_closest_position_in_segment(Vector3(3,3,0)) # returns (0, 3, 0)
+
+The result is in the segment that goes from ``y=0`` to ``y=5``. It's the closest position in the segment to the given point.
 
 .. _class_AStar_get_id_path:
 
 - :ref:`PoolIntArray<class_poolintarray>`  **get_id_path**  **(** :ref:`int<class_int>` from_id, :ref:`int<class_int>` to_id  **)**
 
-Returns an array with the point ids of path found by AStar between two given points.
+Returns an array with the ids of the points that form the path found by AStar between the given points. The array is ordered from the starting point to the ending point of the path.
+
+::
+
+    var as = AStar.new()
+    
+    as.add_point(1, Vector3(0,0,0))
+    as.add_point(2, Vector3(0,1,0), 1) # default weight is 1
+    as.add_point(3, Vector3(1,1,0))
+    as.add_point(4, Vector3(2,0,0))
+    
+    as.connect_points(1, 2, false)
+    as.connect_points(2, 3, false)
+    as.connect_points(4, 3, false)
+    as.connect_points(1, 4, false)
+    as.connect_points(5, 4, false)
+    
+    var res = as.get_id_path(1, 3) # returns [1, 2, 3]
+
+If you change the 2nd point's weight to 3, then the result will be ``[1, 4, 3]`` instead, because now even though the distance is longer, it's "easier" to get through point 4 than through point 2.
 
 .. _class_AStar_get_point_path:
 
 - :ref:`PoolVector3Array<class_poolvector3array>`  **get_point_path**  **(** :ref:`int<class_int>` from_id, :ref:`int<class_int>` to_id  **)**
 
-Returns an array with the points of path found by AStar between two given points.
+Returns an array with the points that are in the path found by AStar between the given points. The array is ordered from the starting point to the ending point of the path.
 
-.. _class_AStar_get_point_pos:
+.. _class_AStar_get_point_position:
 
-- :ref:`Vector3<class_vector3>`  **get_point_pos**  **(** :ref:`int<class_int>` id  **)** const
+- :ref:`Vector3<class_vector3>`  **get_point_position**  **(** :ref:`int<class_int>` id  **)** const
 
-Returns the position of point with given id.
+Returns the position of the point associated with the given id.
 
 .. _class_AStar_get_point_weight_scale:
 
 - :ref:`float<class_float>`  **get_point_weight_scale**  **(** :ref:`int<class_int>` id  **)** const
 
-Returns the weight scale of point with given id.
+Returns the weight scale of the point associated with the given id.
+
+.. _class_AStar_get_points:
+
+- :ref:`Array<class_array>`  **get_points**  **(** **)**
 
 .. _class_AStar_has_point:
 
 - :ref:`bool<class_bool>`  **has_point**  **(** :ref:`int<class_int>` id  **)** const
 
-Returns if the point with given id exists on AStar;
+Returns whether a point associated with the given id exists.
 
 .. _class_AStar_remove_point:
 
 - void  **remove_point**  **(** :ref:`int<class_int>` id  **)**
 
-Removes the point with given id.
+Removes the point associated with the given id from the points pool.
 
 

classes/class_atlastexture.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AtlasTexture.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AtlasTexture:
 
@@ -13,7 +14,7 @@ AtlasTexture
 Brief Description
 -----------------
 
-
+Packs multiple small textures in a single, bigger one. Helps to optimize video memory costs and render calls.
 
 Member Functions
 ----------------
@@ -35,9 +36,16 @@ Member Functions
 Member Variables
 ----------------
 
-- :ref:`Texture<class_texture>` **atlas**
-- :ref:`Rect2<class_rect2>` **margin**
-- :ref:`Rect2<class_rect2>` **region**
+- :ref:`Texture<class_texture>` **atlas** - The texture that contains the atlas. Can be any [Texture] subtype.
+- :ref:`Rect2<class_rect2>` **margin** - The margin around the region. The [Rect2]'s 'size' parameter ('w' and 'h' in the editor) resizes the texture so it fits within the margin.
+- :ref:`Rect2<class_rect2>` **region** - The AtlasTexture's used region.
+
+Description
+-----------
+
+:ref:`Texture<class_texture>` resource aimed at managing big textures files that pack multiple smaller textures. Consists of a :ref:`Texture<class_texture>`, a margin that defines the border width,
+
+and a region that defines the actual area of the AtlasTexture.
 
 Member Function Description
 ---------------------------

classes/class_audiobuslayout.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioBusLayout.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioBusLayout:
 

classes/class_audioeffect.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioEffect.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioEffect:
 
@@ -8,12 +9,17 @@ AudioEffect
 
 **Inherits:** :ref:`Resource<class_resource>` **<** :ref:`Reference<class_reference>` **<** :ref:`Object<class_object>`
 
-**Inherited By:** :ref:`AudioEffectCompressor<class_audioeffectcompressor>`, :ref:`AudioEffectAmplify<class_audioeffectamplify>`, :ref:`AudioEffectFilter<class_audioeffectfilter>`, :ref:`AudioEffectDistortion<class_audioeffectdistortion>`, :ref:`AudioEffectLimiter<class_audioeffectlimiter>`, :ref:`AudioEffectDelay<class_audioeffectdelay>`, :ref:`AudioEffectStereoEnhance<class_audioeffectstereoenhance>`, :ref:`AudioEffectPanner<class_audioeffectpanner>`, :ref:`AudioEffectReverb<class_audioeffectreverb>`, :ref:`AudioEffectEQ<class_audioeffecteq>`, :ref:`AudioEffectChorus<class_audioeffectchorus>`, :ref:`AudioEffectPitchShift<class_audioeffectpitchshift>`, :ref:`AudioEffectPhaser<class_audioeffectphaser>`
+**Inherited By:** :ref:`AudioEffectCompressor<class_audioeffectcompressor>`, :ref:`AudioEffectLimiter<class_audioeffectlimiter>`, :ref:`AudioEffectAmplify<class_audioeffectamplify>`, :ref:`AudioEffectFilter<class_audioeffectfilter>`, :ref:`AudioEffectDistortion<class_audioeffectdistortion>`, :ref:`AudioEffectDelay<class_audioeffectdelay>`, :ref:`AudioEffectStereoEnhance<class_audioeffectstereoenhance>`, :ref:`AudioEffectReverb<class_audioeffectreverb>`, :ref:`AudioEffectPanner<class_audioeffectpanner>`, :ref:`AudioEffectEQ<class_audioeffecteq>`, :ref:`AudioEffectPitchShift<class_audioeffectpitchshift>`, :ref:`AudioEffectChorus<class_audioeffectchorus>`, :ref:`AudioEffectPhaser<class_audioeffectphaser>`
 
 **Category:** Core
 
 Brief Description
 -----------------
 
+Audio Effect For Audio.
 
+Description
+-----------
+
+Base resource for audio bus. Applies an audio effect on the bus that the resource is applied on.
 

classes/class_audioeffectamplify.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioEffectAmplify.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioEffectAmplify:
 
@@ -13,7 +14,7 @@ AudioEffectAmplify
 Brief Description
 -----------------
 
-
+Amplifies the volume of an audio source.
 
 Member Functions
 ----------------
@@ -27,7 +28,12 @@ Member Functions
 Member Variables
 ----------------
 
-- :ref:`float<class_float>` **volume_db**
+- :ref:`float<class_float>` **volume_db** - The effect's volume limit.
+
+Description
+-----------
+
+Amplifies the volume of an audio source. Increase gain of the audio being routed through the bus.
 
 Member Function Description
 ---------------------------
@@ -36,8 +42,12 @@ Member Function Description
 
 - :ref:`float<class_float>`  **get_volume_db**  **(** **)** const
 
+Returns the set maximum volume.
+
 .. _class_AudioEffectAmplify_set_volume_db:
 
 - void  **set_volume_db**  **(** :ref:`float<class_float>` volume  **)**
 
+Sets the maximum volume.
+
 

classes/class_audioeffectbandlimitfilter.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioEffectBandLimitFilter.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioEffectBandLimitFilter:
 

classes/class_audioeffectbandpassfilter.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioEffectBandPassFilter.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioEffectBandPassFilter:
 

classes/class_audioeffectchorus.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioEffectChorus.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioEffectChorus:
 
@@ -13,7 +14,7 @@ AudioEffectChorus
 Brief Description
 -----------------
 
-
+Adds a chorus audio effect.
 
 Member Functions
 ----------------
@@ -59,33 +60,38 @@ Member Functions
 Member Variables
 ----------------
 
-- :ref:`float<class_float>` **dry**
-- :ref:`float<class_float>` **voice/1/cutoff_hz**
-- :ref:`float<class_float>` **voice/1/delay_ms**
-- :ref:`float<class_float>` **voice/1/depth_ms**
-- :ref:`float<class_float>` **voice/1/level_db**
-- :ref:`float<class_float>` **voice/1/pan**
-- :ref:`float<class_float>` **voice/1/rate_hz**
-- :ref:`float<class_float>` **voice/2/cutoff_hz**
-- :ref:`float<class_float>` **voice/2/delay_ms**
-- :ref:`float<class_float>` **voice/2/depth_ms**
-- :ref:`float<class_float>` **voice/2/level_db**
-- :ref:`float<class_float>` **voice/2/pan**
-- :ref:`float<class_float>` **voice/2/rate_hz**
-- :ref:`float<class_float>` **voice/3/cutoff_hz**
-- :ref:`float<class_float>` **voice/3/delay_ms**
-- :ref:`float<class_float>` **voice/3/depth_ms**
-- :ref:`float<class_float>` **voice/3/level_db**
-- :ref:`float<class_float>` **voice/3/pan**
-- :ref:`float<class_float>` **voice/3/rate_hz**
-- :ref:`float<class_float>` **voice/4/cutoff_hz**
-- :ref:`float<class_float>` **voice/4/delay_ms**
-- :ref:`float<class_float>` **voice/4/depth_ms**
-- :ref:`float<class_float>` **voice/4/level_db**
-- :ref:`float<class_float>` **voice/4/pan**
-- :ref:`float<class_float>` **voice/4/rate_hz**
-- :ref:`int<class_int>` **voice_count**
-- :ref:`float<class_float>` **wet**
+- :ref:`float<class_float>` **dry** - The effect's raw signal.
+- :ref:`float<class_float>` **voice/1/cutoff_hz** - The voice's cutoff frequency.
+- :ref:`float<class_float>` **voice/1/delay_ms** - The voice's signal delay.
+- :ref:`float<class_float>` **voice/1/depth_ms** - The voice filter's depth.
+- :ref:`float<class_float>` **voice/1/level_db** - The voice's volume.
+- :ref:`float<class_float>` **voice/1/pan** - The voice's pan level.
+- :ref:`float<class_float>` **voice/1/rate_hz** - The voice's filter rate.
+- :ref:`float<class_float>` **voice/2/cutoff_hz** - The voice's cutoff frequency.
+- :ref:`float<class_float>` **voice/2/delay_ms** - The voice's signal delay.
+- :ref:`float<class_float>` **voice/2/depth_ms** - The voice filter's depth.
+- :ref:`float<class_float>` **voice/2/level_db** - The voice's volume.
+- :ref:`float<class_float>` **voice/2/pan** - The voice's pan level.
+- :ref:`float<class_float>` **voice/2/rate_hz** - The voice's filter rate.
+- :ref:`float<class_float>` **voice/3/cutoff_hz** - The voice's cutoff frequency.
+- :ref:`float<class_float>` **voice/3/delay_ms** - The voice's signal delay.
+- :ref:`float<class_float>` **voice/3/depth_ms** - The voice filter's depth.
+- :ref:`float<class_float>` **voice/3/level_db** - The voice's volume.
+- :ref:`float<class_float>` **voice/3/pan** - The voice's pan level.
+- :ref:`float<class_float>` **voice/3/rate_hz** - The voice's filter rate.
+- :ref:`float<class_float>` **voice/4/cutoff_hz** - The voice's cutoff frequency.
+- :ref:`float<class_float>` **voice/4/delay_ms** - The voice's signal delay.
+- :ref:`float<class_float>` **voice/4/depth_ms** - The voice filter's depth.
+- :ref:`float<class_float>` **voice/4/level_db** - The voice's volume.
+- :ref:`float<class_float>` **voice/4/pan** - The voice's pan level.
+- :ref:`float<class_float>` **voice/4/rate_hz** - The voice's filter rate.
+- :ref:`int<class_int>` **voice_count** - The amount of voices in the effect.
+- :ref:`float<class_float>` **wet** - The effect's processed signal.
+
+Description
+-----------
+
+Adds a chorus audio effect. The effect applies a filter with voices to duplicate the audio source and manipulate it through the filter.
 
 Member Function Description
 ---------------------------
@@ -94,72 +100,108 @@ Member Function Description
 
 - :ref:`float<class_float>`  **get_dry**  **(** **)** const
 
+Returns the set dry ratio.
+
 .. _class_AudioEffectChorus_get_voice_count:
 
 - :ref:`int<class_int>`  **get_voice_count**  **(** **)** const
 
+Returns the set voice count.
+
 .. _class_AudioEffectChorus_get_voice_cutoff_hz:
 
 - :ref:`float<class_float>`  **get_voice_cutoff_hz**  **(** :ref:`int<class_int>` voice_idx  **)** const
 
+Returns the voice's set cutoff frequency.
+
 .. _class_AudioEffectChorus_get_voice_delay_ms:
 
 - :ref:`float<class_float>`  **get_voice_delay_ms**  **(** :ref:`int<class_int>` voice_idx  **)** const
 
+Returns the voice's set delay.
+
 .. _class_AudioEffectChorus_get_voice_depth_ms:
 
 - :ref:`float<class_float>`  **get_voice_depth_ms**  **(** :ref:`int<class_int>` voice_idx  **)** const
 
+Returns the voice's set filter depth.
+
 .. _class_AudioEffectChorus_get_voice_level_db:
 
 - :ref:`float<class_float>`  **get_voice_level_db**  **(** :ref:`int<class_int>` voice_idx  **)** const
 
+Returns the voice's set maximum volume.
+
 .. _class_AudioEffectChorus_get_voice_pan:
 
 - :ref:`float<class_float>`  **get_voice_pan**  **(** :ref:`int<class_int>` voice_idx  **)** const
 
+Returns the voice's set pan.
+
 .. _class_AudioEffectChorus_get_voice_rate_hz:
 
 - :ref:`float<class_float>`  **get_voice_rate_hz**  **(** :ref:`int<class_int>` voice_idx  **)** const
 
+Returns the voice filter's set rate in cycles.
+
 .. _class_AudioEffectChorus_get_wet:
 
 - :ref:`float<class_float>`  **get_wet**  **(** **)** const
 
+Returns the set applied wetness of the effect.
+
 .. _class_AudioEffectChorus_set_dry:
 
 - void  **set_dry**  **(** :ref:`float<class_float>` amount  **)**
 
+Returns the set applied dryness of the effect.
+
 .. _class_AudioEffectChorus_set_voice_count:
 
 - void  **set_voice_count**  **(** :ref:`int<class_int>` voices  **)**
 
+Set the number of voices in the effect's filter.
+
 .. _class_AudioEffectChorus_set_voice_cutoff_hz:
 
 - void  **set_voice_cutoff_hz**  **(** :ref:`int<class_int>` voice_idx, :ref:`float<class_float>` cutoff_hz  **)**
 
+Set the cutoff frequency of the voice. The maximum frequency the voice may affect.
+
 .. _class_AudioEffectChorus_set_voice_delay_ms:
 
 - void  **set_voice_delay_ms**  **(** :ref:`int<class_int>` voice_idx, :ref:`float<class_float>` delay_ms  **)**
 
+Set the delay of the voice's signal.
+
 .. _class_AudioEffectChorus_set_voice_depth_ms:
 
 - void  **set_voice_depth_ms**  **(** :ref:`int<class_int>` voice_idx, :ref:`float<class_float>` depth_ms  **)**
 
+Set the filter depth of the voice's signal.
+
 .. _class_AudioEffectChorus_set_voice_level_db:
 
 - void  **set_voice_level_db**  **(** :ref:`int<class_int>` voice_idx, :ref:`float<class_float>` level_db  **)**
 
+Set the volume level of the voice.
+
 .. _class_AudioEffectChorus_set_voice_pan:
 
 - void  **set_voice_pan**  **(** :ref:`int<class_int>` voice_idx, :ref:`float<class_float>` pan  **)**
 
+Set the pan level of the voice.
+
 .. _class_AudioEffectChorus_set_voice_rate_hz:
 
 - void  **set_voice_rate_hz**  **(** :ref:`int<class_int>` voice_idx, :ref:`float<class_float>` rate_hz  **)**
 
+Set the voice filter's rate.
+
 .. _class_AudioEffectChorus_set_wet:
 
 - void  **set_wet**  **(** :ref:`float<class_float>` amount  **)**
 
+Set the amount of effect.
+
 

classes/class_audioeffectcompressor.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioEffectCompressor.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioEffectCompressor:
 

classes/class_audioeffectdelay.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioEffectDelay.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioEffectDelay:
 

classes/class_audioeffectdistortion.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioEffectDistortion.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioEffectDistortion:
 
@@ -49,6 +50,15 @@ Member Variables
 - :ref:`float<class_float>` **post_gain**
 - :ref:`float<class_float>` **pre_gain**
 
+Numeric Constants
+-----------------
+
+- **MODE_CLIP** = **0**
+- **MODE_ATAN** = **1**
+- **MODE_LOFI** = **2**
+- **MODE_OVERDRIVE** = **3**
+- **MODE_WAVESHAPE** = **4**
+
 Member Function Description
 ---------------------------
 

classes/class_audioeffecteq.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioEffectEQ.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioEffectEQ:
 

classes/class_audioeffecteq10.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioEffectEQ10.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioEffectEQ10:
 

classes/class_audioeffecteq21.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioEffectEQ21.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioEffectEQ21:
 

classes/class_audioeffecteq6.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioEffectEQ6.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioEffectEQ6:
 

classes/class_audioeffectfilter.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioEffectFilter.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioEffectFilter:
 
@@ -46,6 +47,14 @@ Member Variables
 - :ref:`float<class_float>` **gain**
 - :ref:`float<class_float>` **resonance**
 
+Numeric Constants
+-----------------
+
+- **FILTER_6DB** = **0**
+- **FILTER_12DB** = **1**
+- **FILTER_18DB** = **2**
+- **FILTER_24DB** = **3**
+
 Member Function Description
 ---------------------------
 

classes/class_audioeffecthighpassfilter.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioEffectHighPassFilter.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioEffectHighPassFilter:
 

classes/class_audioeffecthighshelffilter.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioEffectHighShelfFilter.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioEffectHighShelfFilter:
 

classes/class_audioeffectlimiter.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioEffectLimiter.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioEffectLimiter:
 

classes/class_audioeffectlowpassfilter.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioEffectLowPassFilter.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioEffectLowPassFilter:
 

classes/class_audioeffectlowshelffilter.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioEffectLowShelfFilter.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioEffectLowShelfFilter:
 

classes/class_audioeffectnotchfilter.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioEffectNotchFilter.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioEffectNotchFilter:
 

classes/class_audioeffectpanner.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioEffectPanner.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioEffectPanner:
 

classes/class_audioeffectphaser.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioEffectPhaser.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioEffectPhaser:
 

classes/class_audioeffectpitchshift.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioEffectPitchShift.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioEffectPitchShift:
 

classes/class_audioeffectreverb.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioEffectReverb.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioEffectReverb:
 

classes/class_audioeffectstereoenhance.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioEffectStereoEnhance.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioEffectStereoEnhance:
 

classes/class_audioserver.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioServer.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioServer:
 
@@ -18,79 +19,86 @@ Server interface for low level audio access.
 Member Functions
 ----------------
 
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                         | :ref:`add_bus<class_AudioServer_add_bus>`  **(** :ref:`int<class_int>` at_pos=-1  **)**                                                                                                |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                         | :ref:`add_bus_effect<class_AudioServer_add_bus_effect>`  **(** :ref:`int<class_int>` bus_idx, :ref:`AudioEffect<class_audioeffect>` effect, :ref:`int<class_int>` at_pos=-1  **)**     |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`AudioBusLayout<class_audiobuslayout>`  | :ref:`generate_bus_layout<class_AudioServer_generate_bus_layout>`  **(** **)** const                                                                                                   |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`int<class_int>`                        | :ref:`get_bus_count<class_AudioServer_get_bus_count>`  **(** **)** const                                                                                                               |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`AudioEffect<class_audioeffect>`        | :ref:`get_bus_effect<class_AudioServer_get_bus_effect>`  **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx  **)**                                                  |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`int<class_int>`                        | :ref:`get_bus_effect_count<class_AudioServer_get_bus_effect_count>`  **(** :ref:`int<class_int>` bus_idx  **)**                                                                        |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`int<class_int>`                        | :ref:`get_bus_index<class_AudioServer_get_bus_index>`  **(** :ref:`String<class_string>` bus_name  **)** const                                                                         |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`String<class_string>`                  | :ref:`get_bus_name<class_AudioServer_get_bus_name>`  **(** :ref:`int<class_int>` bus_idx  **)** const                                                                                  |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`float<class_float>`                    | :ref:`get_bus_peak_volume_left_db<class_AudioServer_get_bus_peak_volume_left_db>`  **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` channel  **)** const                     |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`float<class_float>`                    | :ref:`get_bus_peak_volume_right_db<class_AudioServer_get_bus_peak_volume_right_db>`  **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` channel  **)** const                   |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`String<class_string>`                  | :ref:`get_bus_send<class_AudioServer_get_bus_send>`  **(** :ref:`int<class_int>` bus_idx  **)** const                                                                                  |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`float<class_float>`                    | :ref:`get_bus_volume_db<class_AudioServer_get_bus_volume_db>`  **(** :ref:`int<class_int>` bus_idx  **)** const                                                                        |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`float<class_float>`                    | :ref:`get_mix_rate<class_AudioServer_get_mix_rate>`  **(** **)** const                                                                                                                 |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`int<class_int>`                        | :ref:`get_speaker_mode<class_AudioServer_get_speaker_mode>`  **(** **)** const                                                                                                         |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`bool<class_bool>`                      | :ref:`is_bus_bypassing_effects<class_AudioServer_is_bus_bypassing_effects>`  **(** :ref:`int<class_int>` bus_idx  **)** const                                                          |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`bool<class_bool>`                      | :ref:`is_bus_effect_enabled<class_AudioServer_is_bus_effect_enabled>`  **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx  **)** const                              |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`bool<class_bool>`                      | :ref:`is_bus_mute<class_AudioServer_is_bus_mute>`  **(** :ref:`int<class_int>` bus_idx  **)** const                                                                                    |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`bool<class_bool>`                      | :ref:`is_bus_solo<class_AudioServer_is_bus_solo>`  **(** :ref:`int<class_int>` bus_idx  **)** const                                                                                    |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                         | :ref:`lock<class_AudioServer_lock>`  **(** **)**                                                                                                                                       |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                         | :ref:`move_bus<class_AudioServer_move_bus>`  **(** :ref:`int<class_int>` index, :ref:`int<class_int>` to_index  **)**                                                                  |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                         | :ref:`remove_bus<class_AudioServer_remove_bus>`  **(** :ref:`int<class_int>` index  **)**                                                                                              |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                         | :ref:`remove_bus_effect<class_AudioServer_remove_bus_effect>`  **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx  **)**                                            |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                         | :ref:`set_bus_bypass_effects<class_AudioServer_set_bus_bypass_effects>`  **(** :ref:`int<class_int>` bus_idx, :ref:`bool<class_bool>` enable  **)**                                    |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                         | :ref:`set_bus_count<class_AudioServer_set_bus_count>`  **(** :ref:`int<class_int>` amount  **)**                                                                                       |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                         | :ref:`set_bus_effect_enabled<class_AudioServer_set_bus_effect_enabled>`  **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx, :ref:`bool<class_bool>` enabled  **)** |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                         | :ref:`set_bus_layout<class_AudioServer_set_bus_layout>`  **(** :ref:`AudioBusLayout<class_audiobuslayout>` bus_layout  **)**                                                           |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                         | :ref:`set_bus_mute<class_AudioServer_set_bus_mute>`  **(** :ref:`int<class_int>` bus_idx, :ref:`bool<class_bool>` enable  **)**                                                        |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                         | :ref:`set_bus_name<class_AudioServer_set_bus_name>`  **(** :ref:`int<class_int>` bus_idx, :ref:`String<class_string>` name  **)**                                                      |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                         | :ref:`set_bus_send<class_AudioServer_set_bus_send>`  **(** :ref:`int<class_int>` bus_idx, :ref:`String<class_string>` send  **)**                                                      |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                         | :ref:`set_bus_solo<class_AudioServer_set_bus_solo>`  **(** :ref:`int<class_int>` bus_idx, :ref:`bool<class_bool>` enable  **)**                                                        |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                         | :ref:`set_bus_volume_db<class_AudioServer_set_bus_volume_db>`  **(** :ref:`int<class_int>` bus_idx, :ref:`float<class_float>` volume_db  **)**                                         |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                         | :ref:`swap_bus_effects<class_AudioServer_swap_bus_effects>`  **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx, :ref:`int<class_int>` by_effect_idx  **)**         |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                         | :ref:`unlock<class_AudioServer_unlock>`  **(** **)**                                                                                                                                   |
-+----------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                         | :ref:`add_bus<class_AudioServer_add_bus>`  **(** :ref:`int<class_int>` at_position=-1  **)**                                                                                            |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                         | :ref:`add_bus_effect<class_AudioServer_add_bus_effect>`  **(** :ref:`int<class_int>` bus_idx, :ref:`AudioEffect<class_audioeffect>` effect, :ref:`int<class_int>` at_position=-1  **)** |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`AudioBusLayout<class_audiobuslayout>`  | :ref:`generate_bus_layout<class_AudioServer_generate_bus_layout>`  **(** **)** const                                                                                                    |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`int<class_int>`                        | :ref:`get_bus_count<class_AudioServer_get_bus_count>`  **(** **)** const                                                                                                                |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`AudioEffect<class_audioeffect>`        | :ref:`get_bus_effect<class_AudioServer_get_bus_effect>`  **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx  **)**                                                   |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`int<class_int>`                        | :ref:`get_bus_effect_count<class_AudioServer_get_bus_effect_count>`  **(** :ref:`int<class_int>` bus_idx  **)**                                                                         |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`int<class_int>`                        | :ref:`get_bus_index<class_AudioServer_get_bus_index>`  **(** :ref:`String<class_string>` bus_name  **)** const                                                                          |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`String<class_string>`                  | :ref:`get_bus_name<class_AudioServer_get_bus_name>`  **(** :ref:`int<class_int>` bus_idx  **)** const                                                                                   |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`float<class_float>`                    | :ref:`get_bus_peak_volume_left_db<class_AudioServer_get_bus_peak_volume_left_db>`  **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` channel  **)** const                      |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`float<class_float>`                    | :ref:`get_bus_peak_volume_right_db<class_AudioServer_get_bus_peak_volume_right_db>`  **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` channel  **)** const                    |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`String<class_string>`                  | :ref:`get_bus_send<class_AudioServer_get_bus_send>`  **(** :ref:`int<class_int>` bus_idx  **)** const                                                                                   |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`float<class_float>`                    | :ref:`get_bus_volume_db<class_AudioServer_get_bus_volume_db>`  **(** :ref:`int<class_int>` bus_idx  **)** const                                                                         |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`float<class_float>`                    | :ref:`get_mix_rate<class_AudioServer_get_mix_rate>`  **(** **)** const                                                                                                                  |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`int<class_int>`                        | :ref:`get_speaker_mode<class_AudioServer_get_speaker_mode>`  **(** **)** const                                                                                                          |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`bool<class_bool>`                      | :ref:`is_bus_bypassing_effects<class_AudioServer_is_bus_bypassing_effects>`  **(** :ref:`int<class_int>` bus_idx  **)** const                                                           |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`bool<class_bool>`                      | :ref:`is_bus_effect_enabled<class_AudioServer_is_bus_effect_enabled>`  **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx  **)** const                               |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`bool<class_bool>`                      | :ref:`is_bus_mute<class_AudioServer_is_bus_mute>`  **(** :ref:`int<class_int>` bus_idx  **)** const                                                                                     |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`bool<class_bool>`                      | :ref:`is_bus_solo<class_AudioServer_is_bus_solo>`  **(** :ref:`int<class_int>` bus_idx  **)** const                                                                                     |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                         | :ref:`lock<class_AudioServer_lock>`  **(** **)**                                                                                                                                        |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                         | :ref:`move_bus<class_AudioServer_move_bus>`  **(** :ref:`int<class_int>` index, :ref:`int<class_int>` to_index  **)**                                                                   |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                         | :ref:`remove_bus<class_AudioServer_remove_bus>`  **(** :ref:`int<class_int>` index  **)**                                                                                               |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                         | :ref:`remove_bus_effect<class_AudioServer_remove_bus_effect>`  **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx  **)**                                             |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                         | :ref:`set_bus_bypass_effects<class_AudioServer_set_bus_bypass_effects>`  **(** :ref:`int<class_int>` bus_idx, :ref:`bool<class_bool>` enable  **)**                                     |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                         | :ref:`set_bus_count<class_AudioServer_set_bus_count>`  **(** :ref:`int<class_int>` amount  **)**                                                                                        |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                         | :ref:`set_bus_effect_enabled<class_AudioServer_set_bus_effect_enabled>`  **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx, :ref:`bool<class_bool>` enabled  **)**  |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                         | :ref:`set_bus_layout<class_AudioServer_set_bus_layout>`  **(** :ref:`AudioBusLayout<class_audiobuslayout>` bus_layout  **)**                                                            |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                         | :ref:`set_bus_mute<class_AudioServer_set_bus_mute>`  **(** :ref:`int<class_int>` bus_idx, :ref:`bool<class_bool>` enable  **)**                                                         |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                         | :ref:`set_bus_name<class_AudioServer_set_bus_name>`  **(** :ref:`int<class_int>` bus_idx, :ref:`String<class_string>` name  **)**                                                       |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                         | :ref:`set_bus_send<class_AudioServer_set_bus_send>`  **(** :ref:`int<class_int>` bus_idx, :ref:`String<class_string>` send  **)**                                                       |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                         | :ref:`set_bus_solo<class_AudioServer_set_bus_solo>`  **(** :ref:`int<class_int>` bus_idx, :ref:`bool<class_bool>` enable  **)**                                                         |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                         | :ref:`set_bus_volume_db<class_AudioServer_set_bus_volume_db>`  **(** :ref:`int<class_int>` bus_idx, :ref:`float<class_float>` volume_db  **)**                                          |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                         | :ref:`swap_bus_effects<class_AudioServer_swap_bus_effects>`  **(** :ref:`int<class_int>` bus_idx, :ref:`int<class_int>` effect_idx, :ref:`int<class_int>` by_effect_idx  **)**          |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                                         | :ref:`unlock<class_AudioServer_unlock>`  **(** **)**                                                                                                                                    |
++----------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 
 Signals
 -------
 
 -  **bus_layout_changed**  **(** **)**
 
+Numeric Constants
+-----------------
+
+- **SPEAKER_MODE_STEREO** = **0**
+- **SPEAKER_SURROUND_51** = **2**
+- **SPEAKER_SURROUND_71** = **3**
+
 Description
 -----------
 
@@ -101,11 +109,11 @@ Member Function Description
 
 .. _class_AudioServer_add_bus:
 
-- void  **add_bus**  **(** :ref:`int<class_int>` at_pos=-1  **)**
+- void  **add_bus**  **(** :ref:`int<class_int>` at_position=-1  **)**
 
 .. _class_AudioServer_add_bus_effect:
 
-- void  **add_bus_effect**  **(** :ref:`int<class_int>` bus_idx, :ref:`AudioEffect<class_audioeffect>` effect, :ref:`int<class_int>` at_pos=-1  **)**
+- void  **add_bus_effect**  **(** :ref:`int<class_int>` bus_idx, :ref:`AudioEffect<class_audioeffect>` effect, :ref:`int<class_int>` at_position=-1  **)**
 
 .. _class_AudioServer_generate_bus_layout:
 

classes/class_audiostream.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioStream.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioStream:
 

classes/class_audiostreamoggvorbis.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioStreamOGGVorbis.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioStreamOGGVorbis:
 
@@ -35,9 +36,9 @@ Member Functions
 Member Variables
 ----------------
 
-- :ref:`PoolByteArray<class_poolbytearray>` **data**
-- :ref:`bool<class_bool>` **loop**
-- :ref:`float<class_float>` **loop_offset**
+- :ref:`PoolByteArray<class_poolbytearray>` **data** - Raw audio data.
+- :ref:`bool<class_bool>` **loop** - If [code]true[/code], audio will loop continuously. Default value: [code]false[/code].
+- :ref:`float<class_float>` **loop_offset** - If loop is [code]true[/code], loop starts from this position, in seconds.
 
 Description
 -----------

classes/class_audiostreamplayback.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioStreamPlayback.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioStreamPlayback:
 

classes/class_audiostreamplayer.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioStreamPlayer.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioStreamPlayer:
 
@@ -13,7 +14,7 @@ AudioStreamPlayer
 Brief Description
 -----------------
 
-
+Plays back audio.
 
 Member Functions
 ----------------
@@ -23,7 +24,7 @@ Member Functions
 +----------------------------------------+------------------------------------------------------------------------------------------------------------------+
 | :ref:`int<class_int>`                  | :ref:`get_mix_target<class_AudioStreamPlayer_get_mix_target>`  **(** **)** const                                 |
 +----------------------------------------+------------------------------------------------------------------------------------------------------------------+
-| :ref:`float<class_float>`              | :ref:`get_pos<class_AudioStreamPlayer_get_pos>`  **(** **)**                                                     |
+| :ref:`float<class_float>`              | :ref:`get_position<class_AudioStreamPlayer_get_position>`  **(** **)**                                           |
 +----------------------------------------+------------------------------------------------------------------------------------------------------------------+
 | :ref:`AudioStream<class_audiostream>`  | :ref:`get_stream<class_AudioStreamPlayer_get_stream>`  **(** **)** const                                         |
 +----------------------------------------+------------------------------------------------------------------------------------------------------------------+
@@ -33,9 +34,9 @@ Member Functions
 +----------------------------------------+------------------------------------------------------------------------------------------------------------------+
 | :ref:`bool<class_bool>`                | :ref:`is_playing<class_AudioStreamPlayer_is_playing>`  **(** **)** const                                         |
 +----------------------------------------+------------------------------------------------------------------------------------------------------------------+
-| void                                   | :ref:`play<class_AudioStreamPlayer_play>`  **(** :ref:`float<class_float>` from_pos=0.0  **)**                   |
+| void                                   | :ref:`play<class_AudioStreamPlayer_play>`  **(** :ref:`float<class_float>` from_position=0.0  **)**              |
 +----------------------------------------+------------------------------------------------------------------------------------------------------------------+
-| void                                   | :ref:`seek<class_AudioStreamPlayer_seek>`  **(** :ref:`float<class_float>` to_pos  **)**                         |
+| void                                   | :ref:`seek<class_AudioStreamPlayer_seek>`  **(** :ref:`float<class_float>` to_position  **)**                    |
 +----------------------------------------+------------------------------------------------------------------------------------------------------------------+
 | void                                   | :ref:`set_autoplay<class_AudioStreamPlayer_set_autoplay>`  **(** :ref:`bool<class_bool>` enable  **)**           |
 +----------------------------------------+------------------------------------------------------------------------------------------------------------------+
@@ -54,16 +55,30 @@ Signals
 -------
 
 -  **finished**  **(** **)**
+Emitted when the audio stops playing.
+
 
 Member Variables
 ----------------
 
-- :ref:`bool<class_bool>` **autoplay**
-- :ref:`String<class_string>` **bus**
+- :ref:`bool<class_bool>` **autoplay** - If [code]true[/code], audio plays when added to scene tree. Default value: [code]false[/code].
+- :ref:`String<class_string>` **bus** - Bus on which this audio is playing.
 - :ref:`int<class_int>` **mix_target**
-- :ref:`bool<class_bool>` **playing**
-- :ref:`AudioStream<class_audiostream>` **stream**
-- :ref:`float<class_float>` **volume_db**
+- :ref:`bool<class_bool>` **playing** - If [code]true[/code], audio is playing.
+- :ref:`AudioStream<class_audiostream>` **stream** - The [AudioStream] object to be played.
+- :ref:`float<class_float>` **volume_db** - Volume of sound, in dB.
+
+Numeric Constants
+-----------------
+
+- **MIX_TARGET_STEREO** = **0**
+- **MIX_TARGET_SURROUND** = **1**
+- **MIX_TARGET_CENTER** = **2**
+
+Description
+-----------
+
+Plays background audio.
 
 Member Function Description
 ---------------------------
@@ -76,9 +91,9 @@ Member Function Description
 
 - :ref:`int<class_int>`  **get_mix_target**  **(** **)** const
 
-.. _class_AudioStreamPlayer_get_pos:
+.. _class_AudioStreamPlayer_get_position:
 
-- :ref:`float<class_float>`  **get_pos**  **(** **)**
+- :ref:`float<class_float>`  **get_position**  **(** **)**
 
 .. _class_AudioStreamPlayer_get_stream:
 
@@ -98,11 +113,15 @@ Member Function Description
 
 .. _class_AudioStreamPlayer_play:
 
-- void  **play**  **(** :ref:`float<class_float>` from_pos=0.0  **)**
+- void  **play**  **(** :ref:`float<class_float>` from_position=0.0  **)**
+
+Plays the audio from the given position 'from_position', in seconds.
 
 .. _class_AudioStreamPlayer_seek:
 
-- void  **seek**  **(** :ref:`float<class_float>` to_pos  **)**
+- void  **seek**  **(** :ref:`float<class_float>` to_position  **)**
+
+Sets the position from which audio will be played, in seconds.
 
 .. _class_AudioStreamPlayer_set_autoplay:
 
@@ -128,4 +147,6 @@ Member Function Description
 
 - void  **stop**  **(** **)**
 
+Stops the audio.
+
 

classes/class_audiostreamplayer2d.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioStreamPlayer2D.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioStreamPlayer2D:
 
@@ -13,7 +14,7 @@ AudioStreamPlayer2D
 Brief Description
 -----------------
 
-
+Plays audio in 2D.
 
 Member Functions
 ----------------
@@ -27,8 +28,6 @@ Member Functions
 +----------------------------------------+--------------------------------------------------------------------------------------------------------------------+
 | :ref:`float<class_float>`              | :ref:`get_max_distance<class_AudioStreamPlayer2D_get_max_distance>`  **(** **)** const                             |
 +----------------------------------------+--------------------------------------------------------------------------------------------------------------------+
-| :ref:`float<class_float>`              | :ref:`get_pos<class_AudioStreamPlayer2D_get_pos>`  **(** **)**                                                     |
-+----------------------------------------+--------------------------------------------------------------------------------------------------------------------+
 | :ref:`AudioStream<class_audiostream>`  | :ref:`get_stream<class_AudioStreamPlayer2D_get_stream>`  **(** **)** const                                         |
 +----------------------------------------+--------------------------------------------------------------------------------------------------------------------+
 | :ref:`float<class_float>`              | :ref:`get_volume_db<class_AudioStreamPlayer2D_get_volume_db>`  **(** **)** const                                   |
@@ -37,9 +36,9 @@ Member Functions
 +----------------------------------------+--------------------------------------------------------------------------------------------------------------------+
 | :ref:`bool<class_bool>`                | :ref:`is_playing<class_AudioStreamPlayer2D_is_playing>`  **(** **)** const                                         |
 +----------------------------------------+--------------------------------------------------------------------------------------------------------------------+
-| void                                   | :ref:`play<class_AudioStreamPlayer2D_play>`  **(** :ref:`float<class_float>` from_pos=0.0  **)**                   |
+| void                                   | :ref:`play<class_AudioStreamPlayer2D_play>`  **(** :ref:`float<class_float>` from_position=0.0  **)**              |
 +----------------------------------------+--------------------------------------------------------------------------------------------------------------------+
-| void                                   | :ref:`seek<class_AudioStreamPlayer2D_seek>`  **(** :ref:`float<class_float>` to_pos  **)**                         |
+| void                                   | :ref:`seek<class_AudioStreamPlayer2D_seek>`  **(** :ref:`float<class_float>` to_position  **)**                    |
 +----------------------------------------+--------------------------------------------------------------------------------------------------------------------+
 | void                                   | :ref:`set_area_mask<class_AudioStreamPlayer2D_set_area_mask>`  **(** :ref:`int<class_int>` mask  **)**             |
 +----------------------------------------+--------------------------------------------------------------------------------------------------------------------+
@@ -62,18 +61,25 @@ Signals
 -------
 
 -  **finished**  **(** **)**
+Emitted when the audio stops playing.
+
 
 Member Variables
 ----------------
 
-- :ref:`int<class_int>` **area_mask**
-- :ref:`float<class_float>` **attenuation**
-- :ref:`bool<class_bool>` **autoplay**
-- :ref:`String<class_string>` **bus**
-- :ref:`float<class_float>` **max_distance**
-- :ref:`bool<class_bool>` **playing**
-- :ref:`AudioStream<class_audiostream>` **stream**
-- :ref:`float<class_float>` **volume_db**
+- :ref:`int<class_int>` **area_mask** - Areas in which this sound plays.
+- :ref:`float<class_float>` **attenuation** - Dampens audio over distance with this as an exponent.
+- :ref:`bool<class_bool>` **autoplay** - If [code]true[/code], audio plays when added to scene tree. Default value: [code]false[/code].
+- :ref:`String<class_string>` **bus** - Bus on which this audio is playing.
+- :ref:`float<class_float>` **max_distance** - Maximum distance from which audio is still hearable.
+- :ref:`bool<class_bool>` **playing** - If [code]true[/code], audio is playing.
+- :ref:`AudioStream<class_audiostream>` **stream** - The [AudioStream] object to be played.
+- :ref:`float<class_float>` **volume_db** - Base volume without dampening.
+
+Description
+-----------
+
+Plays audio that dampens with distance from screen center.
 
 Member Function Description
 ---------------------------
@@ -94,10 +100,6 @@ Member Function Description
 
 - :ref:`float<class_float>`  **get_max_distance**  **(** **)** const
 
-.. _class_AudioStreamPlayer2D_get_pos:
-
-- :ref:`float<class_float>`  **get_pos**  **(** **)**
-
 .. _class_AudioStreamPlayer2D_get_stream:
 
 - :ref:`AudioStream<class_audiostream>`  **get_stream**  **(** **)** const
@@ -116,11 +118,15 @@ Member Function Description
 
 .. _class_AudioStreamPlayer2D_play:
 
-- void  **play**  **(** :ref:`float<class_float>` from_pos=0.0  **)**
+- void  **play**  **(** :ref:`float<class_float>` from_position=0.0  **)**
+
+Plays the audio from the given position 'from_position', in seconds.
 
 .. _class_AudioStreamPlayer2D_seek:
 
-- void  **seek**  **(** :ref:`float<class_float>` to_pos  **)**
+- void  **seek**  **(** :ref:`float<class_float>` to_position  **)**
+
+Sets the position from which audio will be played, in seconds.
 
 .. _class_AudioStreamPlayer2D_set_area_mask:
 
@@ -154,4 +160,6 @@ Member Function Description
 
 - void  **stop**  **(** **)**
 
+Stops the audio.
+
 

classes/class_audiostreamplayer3d.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioStreamPlayer3D.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioStreamPlayer3D:
 
@@ -13,7 +14,7 @@ AudioStreamPlayer3D
 Brief Description
 -----------------
 
-
+Plays 3D sound in 3D space
 
 Member Functions
 ----------------
@@ -41,7 +42,7 @@ Member Functions
 +----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`int<class_int>`                  | :ref:`get_out_of_range_mode<class_AudioStreamPlayer3D_get_out_of_range_mode>`  **(** **)** const                                                               |
 +----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`float<class_float>`              | :ref:`get_pos<class_AudioStreamPlayer3D_get_pos>`  **(** **)**                                                                                                 |
+| :ref:`float<class_float>`              | :ref:`get_position<class_AudioStreamPlayer3D_get_position>`  **(** **)**                                                                                       |
 +----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`AudioStream<class_audiostream>`  | :ref:`get_stream<class_AudioStreamPlayer3D_get_stream>`  **(** **)** const                                                                                     |
 +----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
@@ -55,9 +56,9 @@ Member Functions
 +----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`bool<class_bool>`                | :ref:`is_playing<class_AudioStreamPlayer3D_is_playing>`  **(** **)** const                                                                                     |
 +----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                   | :ref:`play<class_AudioStreamPlayer3D_play>`  **(** :ref:`float<class_float>` from_pos=0.0  **)**                                                               |
+| void                                   | :ref:`play<class_AudioStreamPlayer3D_play>`  **(** :ref:`float<class_float>` from_position=0.0  **)**                                                          |
 +----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                   | :ref:`seek<class_AudioStreamPlayer3D_seek>`  **(** :ref:`float<class_float>` to_pos  **)**                                                                     |
+| void                                   | :ref:`seek<class_AudioStreamPlayer3D_seek>`  **(** :ref:`float<class_float>` to_position  **)**                                                                |
 +----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | void                                   | :ref:`set_area_mask<class_AudioStreamPlayer3D_set_area_mask>`  **(** :ref:`int<class_int>` mask  **)**                                                         |
 +----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------+
@@ -98,39 +99,46 @@ Signals
 -------
 
 -  **finished**  **(** **)**
+Fires when the audio stops playing.
+
 
 Member Variables
 ----------------
 
-- :ref:`int<class_int>` **area_mask**
-- :ref:`float<class_float>` **attenuation_filter_cutoff_hz**
-- :ref:`float<class_float>` **attenuation_filter_db**
-- :ref:`int<class_int>` **attenuation_model**
-- :ref:`bool<class_bool>` **autoplay**
-- :ref:`String<class_string>` **bus**
-- :ref:`int<class_int>` **doppler_tracking**
-- :ref:`float<class_float>` **emission_angle_degrees**
-- :ref:`bool<class_bool>` **emission_angle_enabled**
-- :ref:`float<class_float>` **emission_angle_filter_attenuation_db**
-- :ref:`float<class_float>` **max_db**
-- :ref:`float<class_float>` **max_distance**
-- :ref:`int<class_int>` **out_of_range_mode**
-- :ref:`bool<class_bool>` **playing**
-- :ref:`AudioStream<class_audiostream>` **stream**
-- :ref:`float<class_float>` **unit_db**
-- :ref:`float<class_float>` **unit_size**
+- :ref:`int<class_int>` **area_mask** - Areas in which this sound plays.
+- :ref:`float<class_float>` **attenuation_filter_cutoff_hz** - Dampens audio above this frequency, in Hz.
+- :ref:`float<class_float>` **attenuation_filter_db** - Amount how much the filter affects the loudness, in dB.
+- :ref:`int<class_int>` **attenuation_model** - Decides if audio should get quieter with distance linearly, quadratically or logarithmically.
+- :ref:`bool<class_bool>` **autoplay** - If [code]true[/code], audio plays audio plays when added to scene tree. Default value: [code]false[/code].
+- :ref:`String<class_string>` **bus** - Bus on which this audio is playing.
+- :ref:`int<class_int>` **doppler_tracking** - Decides in which step the Doppler effect should be calculated.
+- :ref:`float<class_float>` **emission_angle_degrees** - The angle in which the audio reaches cameras undampened.
+- :ref:`bool<class_bool>` **emission_angle_enabled** - If [code]true[/code], the audio should be dampened according to the direction of the sound.
+- :ref:`float<class_float>` **emission_angle_filter_attenuation_db** - dampens audio if camera is outside of 'emission_angle_degrees' and 'emission_angle_enabled' is set by this factor, in dB.
+- :ref:`float<class_float>` **max_db** - Sets the absolute maximum of the soundlevel, in dB.
+- :ref:`float<class_float>` **max_distance** - Sets the distance from wich the 'out_of_range_mode' takes effect. Has no effect if set to 0.
+- :ref:`int<class_int>` **out_of_range_mode** - Decides if audio should pause when source is outside of 'max_distance' range.
+- :ref:`bool<class_bool>` **playing** - If [code]true[/code], audio is playing.
+- :ref:`AudioStream<class_audiostream>` **stream** - The [AudioStream] object to be played.
+- :ref:`float<class_float>` **unit_db** - Base sound level unaffected by dampening, in dB.
+- :ref:`float<class_float>` **unit_size** - Factor for the attenuation effect.
 
 Numeric Constants
 -----------------
 
-- **ATTENUATION_INVERSE_DISTANCE** = **0**
-- **ATTENUATION_INVERSE_SQUARE_DISTANCE** = **1**
-- **ATTENUATION_LOGARITHMIC** = **2**
-- **OUT_OF_RANGE_MIX** = **0**
-- **OUT_OF_RANGE_PAUSE** = **1**
-- **DOPPLER_TRACKING_DISABLED** = **0**
-- **DOPPLER_TRACKING_IDLE_STEP** = **1**
-- **DOPPLER_TRACKING_FIXED_STEP** = **2**
+- **ATTENUATION_INVERSE_DISTANCE** = **0** --- Linear dampening of loudness according to distance.
+- **ATTENUATION_INVERSE_SQUARE_DISTANCE** = **1** --- Squared dampening of loudness according to distance.
+- **ATTENUATION_LOGARITHMIC** = **2** --- Logarithmic dampening of loudness according to distance.
+- **OUT_OF_RANGE_MIX** = **0** --- Mix this audio in, even when it's out of range.
+- **OUT_OF_RANGE_PAUSE** = **1** --- Pause this audio when it gets out of range.
+- **DOPPLER_TRACKING_DISABLED** = **0** --- Disables doppler tracking.
+- **DOPPLER_TRACKING_IDLE_STEP** = **1** --- Executes doppler trackin in idle step.
+- **DOPPLER_TRACKING_FIXED_STEP** = **2** --- Executes doppler tracking in fixed step.
+
+Description
+-----------
+
+Plays a sound effect with directed sound effects, dampens with distance if needed, generates effect of hearable position in space.
 
 Member Function Description
 ---------------------------
@@ -179,9 +187,9 @@ Member Function Description
 
 - :ref:`int<class_int>`  **get_out_of_range_mode**  **(** **)** const
 
-.. _class_AudioStreamPlayer3D_get_pos:
+.. _class_AudioStreamPlayer3D_get_position:
 
-- :ref:`float<class_float>`  **get_pos**  **(** **)**
+- :ref:`float<class_float>`  **get_position**  **(** **)**
 
 .. _class_AudioStreamPlayer3D_get_stream:
 
@@ -209,11 +217,15 @@ Member Function Description
 
 .. _class_AudioStreamPlayer3D_play:
 
-- void  **play**  **(** :ref:`float<class_float>` from_pos=0.0  **)**
+- void  **play**  **(** :ref:`float<class_float>` from_position=0.0  **)**
+
+Plays the audio from the given position 'from_position', in seconds.
 
 .. _class_AudioStreamPlayer3D_seek:
 
-- void  **seek**  **(** :ref:`float<class_float>` to_pos  **)**
+- void  **seek**  **(** :ref:`float<class_float>` to_position  **)**
+
+Sets the position from which audio will be played, in seconds.
 
 .. _class_AudioStreamPlayer3D_set_area_mask:
 
@@ -283,4 +295,6 @@ Member Function Description
 
 - void  **stop**  **(** **)**
 
+Stops the audio.
+
 

classes/class_audiostreamrandompitch.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioStreamRandomPitch.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioStreamRandomPitch:
 
@@ -13,7 +14,7 @@ AudioStreamRandomPitch
 Brief Description
 -----------------
 
-
+Plays audio with random pitch tweaking.
 
 Member Functions
 ----------------
@@ -31,8 +32,13 @@ Member Functions
 Member Variables
 ----------------
 
-- :ref:`AudioStream<class_audiostream>` **audio_stream**
-- :ref:`float<class_float>` **random_pitch**
+- :ref:`AudioStream<class_audiostream>` **audio_stream** - The current [AudioStream].
+- :ref:`float<class_float>` **random_pitch** - The intensity of random pitch variation.
+
+Description
+-----------
+
+Randomly varies pitch on each start.
 
 Member Function Description
 ---------------------------

classes/class_audiostreamsample.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the AudioStreamSample.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_AudioStreamSample:
 
@@ -13,7 +14,7 @@ AudioStreamSample
 Brief Description
 -----------------
 
-
+Plays audio.
 
 Member Functions
 ----------------
@@ -51,13 +52,28 @@ Member Functions
 Member Variables
 ----------------
 
-- :ref:`PoolByteArray<class_poolbytearray>` **data**
-- :ref:`int<class_int>` **format**
-- :ref:`int<class_int>` **loop_begin**
-- :ref:`int<class_int>` **loop_end**
-- :ref:`int<class_int>` **loop_mode**
-- :ref:`int<class_int>` **mix_rate**
-- :ref:`bool<class_bool>` **stereo**
+- :ref:`PoolByteArray<class_poolbytearray>` **data** - Raw audio data.
+- :ref:`int<class_int>` **format** - Audio format. See FORMAT_* constants for values.
+- :ref:`int<class_int>` **loop_begin** - Loop start in bytes.
+- :ref:`int<class_int>` **loop_end** - Loop end in bytes.
+- :ref:`int<class_int>` **loop_mode** - Loop mode. See LOOP_* constants for values.
+- :ref:`int<class_int>` **mix_rate** - The sample rate for mixing this audio.
+- :ref:`bool<class_bool>` **stereo** - If [code]true[/code], audio is stereo. Default value: [code]false[/code].
+
+Numeric Constants
+-----------------
+
+- **FORMAT_8_BITS** = **0** --- Audio codec 8 bit.
+- **FORMAT_16_BITS** = **1** --- Audio codec 16 bit.
+- **FORMAT_IMA_ADPCM** = **2** --- Audio codec IMA ADPCM.
+- **LOOP_DISABLED** = **0** --- Audio does not loop.
+- **LOOP_FORWARD** = **1** --- Audio loops the data between loop_begin and loop_end playing forward only.
+- **LOOP_PING_PONG** = **2** --- Audio loops the data between loop_begin and loop_end playing back and forth.
+
+Description
+-----------
+
+Plays audio, can loop.
 
 Member Function Description
 ---------------------------

classes/class_backbuffercopy.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the BackBufferCopy.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_BackBufferCopy:
 

classes/class_basebutton.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the BaseButton.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_BaseButton:
 

classes/class_basis.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the Basis.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_Basis:
 

classes/class_bitmap.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the BitMap.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_BitMap:
 
@@ -13,7 +14,7 @@ BitMap
 Brief Description
 -----------------
 
-
+Boolean matrix.
 
 Member Functions
 ----------------
@@ -23,13 +24,13 @@ Member Functions
 +--------------------------------+----------------------------------------------------------------------------------------------------------------------------+
 | void                           | :ref:`create_from_image_alpha<class_BitMap_create_from_image_alpha>`  **(** :ref:`Image<class_image>` image  **)**         |
 +--------------------------------+----------------------------------------------------------------------------------------------------------------------------+
-| :ref:`bool<class_bool>`        | :ref:`get_bit<class_BitMap_get_bit>`  **(** :ref:`Vector2<class_vector2>` pos  **)** const                                 |
+| :ref:`bool<class_bool>`        | :ref:`get_bit<class_BitMap_get_bit>`  **(** :ref:`Vector2<class_vector2>` position  **)** const                            |
 +--------------------------------+----------------------------------------------------------------------------------------------------------------------------+
 | :ref:`Vector2<class_vector2>`  | :ref:`get_size<class_BitMap_get_size>`  **(** **)** const                                                                  |
 +--------------------------------+----------------------------------------------------------------------------------------------------------------------------+
 | :ref:`int<class_int>`          | :ref:`get_true_bit_count<class_BitMap_get_true_bit_count>`  **(** **)** const                                              |
 +--------------------------------+----------------------------------------------------------------------------------------------------------------------------+
-| void                           | :ref:`set_bit<class_BitMap_set_bit>`  **(** :ref:`Vector2<class_vector2>` pos, :ref:`bool<class_bool>` bit  **)**          |
+| void                           | :ref:`set_bit<class_BitMap_set_bit>`  **(** :ref:`Vector2<class_vector2>` position, :ref:`bool<class_bool>` bit  **)**     |
 +--------------------------------+----------------------------------------------------------------------------------------------------------------------------+
 | void                           | :ref:`set_bit_rect<class_BitMap_set_bit_rect>`  **(** :ref:`Rect2<class_rect2>` p_rect, :ref:`bool<class_bool>` bit  **)** |
 +--------------------------------+----------------------------------------------------------------------------------------------------------------------------+
@@ -39,6 +40,11 @@ Member Variables
 
 - :ref:`Dictionary<class_dictionary>` **data**
 
+Description
+-----------
+
+A two-dimensional array of boolean values, can be used to efficiently store a binary matrix (every matrix element takes only one bit) and query the values using natural cartesian coordinates.
+
 Member Function Description
 ---------------------------
 
@@ -46,28 +52,42 @@ Member Function Description
 
 - void  **create**  **(** :ref:`Vector2<class_vector2>` size  **)**
 
+Creates a bitmap with the specified size, filled with false.
+
 .. _class_BitMap_create_from_image_alpha:
 
 - void  **create_from_image_alpha**  **(** :ref:`Image<class_image>` image  **)**
 
+Creates a bitmap that matches the given image dimensions, every element of the bitmap is set to false if the alpha value of the image at that position is 0, and true in other case.
+
 .. _class_BitMap_get_bit:
 
-- :ref:`bool<class_bool>`  **get_bit**  **(** :ref:`Vector2<class_vector2>` pos  **)** const
+- :ref:`bool<class_bool>`  **get_bit**  **(** :ref:`Vector2<class_vector2>` position  **)** const
+
+Returns bitmap's value at the specified position.
 
 .. _class_BitMap_get_size:
 
 - :ref:`Vector2<class_vector2>`  **get_size**  **(** **)** const
 
+Returns bitmap's dimensions.
+
 .. _class_BitMap_get_true_bit_count:
 
 - :ref:`int<class_int>`  **get_true_bit_count**  **(** **)** const
 
+Returns the amount of bitmap elements that are set to true.
+
 .. _class_BitMap_set_bit:
 
-- void  **set_bit**  **(** :ref:`Vector2<class_vector2>` pos, :ref:`bool<class_bool>` bit  **)**
+- void  **set_bit**  **(** :ref:`Vector2<class_vector2>` position, :ref:`bool<class_bool>` bit  **)**
+
+Sets the bitmap's element at the specified position, to the specified value.
 
 .. _class_BitMap_set_bit_rect:
 
 - void  **set_bit_rect**  **(** :ref:`Rect2<class_rect2>` p_rect, :ref:`bool<class_bool>` bit  **)**
 
+Sets a rectangular portion of the bitmap to the specified value.
+
 

classes/class_bitmapfont.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the BitmapFont.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_BitmapFont:
 

classes/class_boneattachment.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the BoneAttachment.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_BoneAttachment:
 
@@ -36,8 +37,12 @@ Member Function Description
 
 - :ref:`String<class_string>`  **get_bone_name**  **(** **)** const
 
+Returns the name of the bone node attached to.
+
 .. _class_BoneAttachment_set_bone_name:
 
 - void  **set_bone_name**  **(** :ref:`String<class_string>` bone_name  **)**
 
+Changes the name of the bone node
+
 

classes/class_bool.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the bool.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_bool:
 

classes/class_boxcontainer.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the BoxContainer.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_BoxContainer:
 
@@ -15,7 +16,7 @@ BoxContainer
 Brief Description
 -----------------
 
-Base class for Box containers.
+Base class for box containers.
 
 Member Functions
 ----------------
@@ -31,19 +32,19 @@ Member Functions
 Member Variables
 ----------------
 
-- :ref:`int<class_int>` **alignment**
+- :ref:`int<class_int>` **alignment** - The alignment of the container's children (must be one of ALIGN_BEGIN, ALIGN_CENTER, or ALIGN_END).
 
 Numeric Constants
 -----------------
 
-- **ALIGN_BEGIN** = **0** --- Align children with beginning of the container.
-- **ALIGN_CENTER** = **1** --- Align children with center of the container.
-- **ALIGN_END** = **2** --- Align children with end of the container.
+- **ALIGN_BEGIN** = **0** --- Aligns children with the beginning of the container.
+- **ALIGN_CENTER** = **1** --- Aligns children with the center of the container.
+- **ALIGN_END** = **2** --- Aligns children with the end of the container.
 
 Description
 -----------
 
-Base class for Box containers. It arranges children controls vertically or horizontally, and rearranges them automatically when their minimum size changes.
+Arranges child controls vertically or horizontally, and rearranges the controls automatically when their minimum size changes.
 
 Member Function Description
 ---------------------------
@@ -52,9 +53,7 @@ Member Function Description
 
 - void  **add_spacer**  **(** :ref:`bool<class_bool>` begin  **)**
 
-Add a control to the box as a spacer.
-
-If *begin* is true the spacer control will be inserted in front of other children.
+Adds a control to the box as a spacer. If ``true``, *begin* will insert the spacer control in front of other children.
 
 .. _class_BoxContainer_get_alignment:
 

classes/class_boxshape.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the BoxShape.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_BoxShape:
 
@@ -27,12 +28,12 @@ Member Functions
 Member Variables
 ----------------
 
-- :ref:`Vector3<class_vector3>` **extents**
+- :ref:`Vector3<class_vector3>` **extents** - The shape's half extents.
 
 Description
 -----------
 
-Box shape resource, which can be set into a :ref:`PhysicsBody<class_physicsbody>` or area.
+3D box shape that can be a child of a :ref:`PhysicsBody<class_physicsbody>` or :ref:`Area<class_area>`.
 
 Member Function Description
 ---------------------------

classes/class_button.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the Button.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_Button:
 
@@ -45,17 +46,17 @@ Member Functions
 Member Variables
 ----------------
 
-- :ref:`int<class_int>` **align**
-- :ref:`bool<class_bool>` **clip_text**
-- :ref:`bool<class_bool>` **flat**
-- :ref:`Texture<class_texture>` **icon**
-- :ref:`String<class_string>` **text**
+- :ref:`int<class_int>` **align** - Text alignment policy for the button's text, use one of the ALIGN_* constants.
+- :ref:`bool<class_bool>` **clip_text** - When this property is enabled, text that is too large to fit the button is clipped, when disabled the Button will always be wide enough to hold the text. This property is disabled by default.
+- :ref:`bool<class_bool>` **flat** - Flat buttons don't display decoration.
+- :ref:`Texture<class_texture>` **icon** - Button's icon, if text is present the icon will be placed before the text.
+- :ref:`String<class_string>` **text** - The button's text that will be displayed inside the button's area.
 
 Numeric Constants
 -----------------
 
 - **ALIGN_LEFT** = **0** --- Align the text to the left.
-- **ALIGN_CENTER** = **1** --- Center the text.
+- **ALIGN_CENTER** = **1** --- Align the text to the center.
 - **ALIGN_RIGHT** = **2** --- Align the text to the right.
 
 Description
@@ -70,60 +71,40 @@ Member Function Description
 
 - :ref:`Texture<class_texture>`  **get_button_icon**  **(** **)** const
 
-Return the button icon.
-
 .. _class_Button_get_clip_text:
 
 - :ref:`bool<class_bool>`  **get_clip_text**  **(** **)** const
 
-Return the state of the *clip_text* property (see :ref:`set_clip_text<class_Button_set_clip_text>`)
-
 .. _class_Button_get_text:
 
 - :ref:`String<class_string>`  **get_text**  **(** **)** const
 
-Return the button text.
-
 .. _class_Button_get_text_align:
 
 - :ref:`int<class_int>`  **get_text_align**  **(** **)** const
 
-Return the text alignment policy.
-
 .. _class_Button_is_flat:
 
 - :ref:`bool<class_bool>`  **is_flat**  **(** **)** const
 
-Return the state of the *flat* property (see :ref:`set_flat<class_Button_set_flat>`).
-
 .. _class_Button_set_button_icon:
 
 - void  **set_button_icon**  **(** :ref:`Texture<class_texture>` texture  **)**
 
-Set the icon that will be displayed next to the text inside the button area.
-
 .. _class_Button_set_clip_text:
 
 - void  **set_clip_text**  **(** :ref:`bool<class_bool>` enabled  **)**
 
-Set the *clip_text* property of a Button. When this property is enabled, text that is too large to fit the button is clipped, when disabled (default) the Button will always be wide enough to hold the text.
-
 .. _class_Button_set_flat:
 
 - void  **set_flat**  **(** :ref:`bool<class_bool>` enabled  **)**
 
-Set the *flat* property of a Button. Flat buttons don't display decoration unless hovered or pressed.
-
 .. _class_Button_set_text:
 
 - void  **set_text**  **(** :ref:`String<class_string>` text  **)**
 
-Set the button text, which will be displayed inside the button area.
-
 .. _class_Button_set_text_align:
 
 - void  **set_text_align**  **(** :ref:`int<class_int>` align  **)**
 
-Set the text alignment policy, using one of the ALIGN\_\* constants.
-
 

classes/class_buttongroup.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the ButtonGroup.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_ButtonGroup:
 

classes/class_camera.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the Camera.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_Camera:
 

classes/class_camera2d.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the Camera2D.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_Camera2D:
 
@@ -27,7 +28,7 @@ Member Functions
 +--------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`int<class_int>`          | :ref:`get_anchor_mode<class_Camera2D_get_anchor_mode>`  **(** **)** const                                                                    |
 +--------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`Vector2<class_vector2>`  | :ref:`get_camera_pos<class_Camera2D_get_camera_pos>`  **(** **)** const                                                                      |
+| :ref:`Vector2<class_vector2>`  | :ref:`get_camera_position<class_Camera2D_get_camera_position>`  **(** **)** const                                                            |
 +--------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`Vector2<class_vector2>`  | :ref:`get_camera_screen_center<class_Camera2D_get_camera_screen_center>`  **(** **)** const                                                  |
 +--------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------+
@@ -165,9 +166,9 @@ Force the camera to update scroll immediately.
 
 - :ref:`int<class_int>`  **get_anchor_mode**  **(** **)** const
 
-.. _class_Camera2D_get_camera_pos:
+.. _class_Camera2D_get_camera_position:
 
-- :ref:`Vector2<class_vector2>`  **get_camera_pos**  **(** **)** const
+- :ref:`Vector2<class_vector2>`  **get_camera_position**  **(** **)** const
 
 Return the camera position.
 

classes/class_canvasitem.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the CanvasItem.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_CanvasItem:
 
@@ -23,9 +24,9 @@ Member Functions
 +----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | void                                   | :ref:`_draw<class_CanvasItem__draw>`  **(** **)** virtual                                                                                                                                                                                                                                                                                                                                   |
 +----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`float<class_float>`              | :ref:`draw_char<class_CanvasItem_draw_char>`  **(** :ref:`Font<class_font>` font, :ref:`Vector2<class_vector2>` pos, :ref:`String<class_string>` char, :ref:`String<class_string>` next, :ref:`Color<class_color>` modulate=Color( 1, 1, 1, 1 )  **)**                                                                                                                                      |
+| :ref:`float<class_float>`              | :ref:`draw_char<class_CanvasItem_draw_char>`  **(** :ref:`Font<class_font>` font, :ref:`Vector2<class_vector2>` position, :ref:`String<class_string>` char, :ref:`String<class_string>` next, :ref:`Color<class_color>` modulate=Color( 1, 1, 1, 1 )  **)**                                                                                                                                 |
 +----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                   | :ref:`draw_circle<class_CanvasItem_draw_circle>`  **(** :ref:`Vector2<class_vector2>` pos, :ref:`float<class_float>` radius, :ref:`Color<class_color>` color  **)**                                                                                                                                                                                                                         |
+| void                                   | :ref:`draw_circle<class_CanvasItem_draw_circle>`  **(** :ref:`Vector2<class_vector2>` position, :ref:`float<class_float>` radius, :ref:`Color<class_color>` color  **)**                                                                                                                                                                                                                    |
 +----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | void                                   | :ref:`draw_colored_polygon<class_CanvasItem_draw_colored_polygon>`  **(** :ref:`PoolVector2Array<class_poolvector2array>` points, :ref:`Color<class_color>` color, :ref:`PoolVector2Array<class_poolvector2array>` uvs=PoolVector2Array(  ), :ref:`Texture<class_texture>` texture=null, :ref:`Texture<class_texture>` normal_map=null, :ref:`bool<class_bool>` antialiased=false  **)**    |
 +----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@@ -41,15 +42,15 @@ Member Functions
 +----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | void                                   | :ref:`draw_rect<class_CanvasItem_draw_rect>`  **(** :ref:`Rect2<class_rect2>` rect, :ref:`Color<class_color>` color, :ref:`bool<class_bool>` filled=true  **)**                                                                                                                                                                                                                             |
 +----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                   | :ref:`draw_set_transform<class_CanvasItem_draw_set_transform>`  **(** :ref:`Vector2<class_vector2>` pos, :ref:`float<class_float>` rot, :ref:`Vector2<class_vector2>` scale  **)**                                                                                                                                                                                                          |
+| void                                   | :ref:`draw_set_transform<class_CanvasItem_draw_set_transform>`  **(** :ref:`Vector2<class_vector2>` position, :ref:`float<class_float>` rotation, :ref:`Vector2<class_vector2>` scale  **)**                                                                                                                                                                                                |
 +----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | void                                   | :ref:`draw_set_transform_matrix<class_CanvasItem_draw_set_transform_matrix>`  **(** :ref:`Transform2D<class_transform2d>` xform  **)**                                                                                                                                                                                                                                                      |
 +----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                   | :ref:`draw_string<class_CanvasItem_draw_string>`  **(** :ref:`Font<class_font>` font, :ref:`Vector2<class_vector2>` pos, :ref:`String<class_string>` text, :ref:`Color<class_color>` modulate=Color( 1, 1, 1, 1 ), :ref:`int<class_int>` clip_w=-1  **)**                                                                                                                                   |
+| void                                   | :ref:`draw_string<class_CanvasItem_draw_string>`  **(** :ref:`Font<class_font>` font, :ref:`Vector2<class_vector2>` position, :ref:`String<class_string>` text, :ref:`Color<class_color>` modulate=Color( 1, 1, 1, 1 ), :ref:`int<class_int>` clip_w=-1  **)**                                                                                                                              |
 +----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | void                                   | :ref:`draw_style_box<class_CanvasItem_draw_style_box>`  **(** :ref:`StyleBox<class_stylebox>` style_box, :ref:`Rect2<class_rect2>` rect  **)**                                                                                                                                                                                                                                              |
 +----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                                   | :ref:`draw_texture<class_CanvasItem_draw_texture>`  **(** :ref:`Texture<class_texture>` texture, :ref:`Vector2<class_vector2>` pos, :ref:`Color<class_color>` modulate=Color( 1, 1, 1, 1 ), :ref:`Texture<class_texture>` normal_map=null  **)**                                                                                                                                            |
+| void                                   | :ref:`draw_texture<class_CanvasItem_draw_texture>`  **(** :ref:`Texture<class_texture>` texture, :ref:`Vector2<class_vector2>` position, :ref:`Color<class_color>` modulate=Color( 1, 1, 1, 1 ), :ref:`Texture<class_texture>` normal_map=null  **)**                                                                                                                                       |
 +----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | void                                   | :ref:`draw_texture_rect<class_CanvasItem_draw_texture_rect>`  **(** :ref:`Texture<class_texture>` texture, :ref:`Rect2<class_rect2>` rect, :ref:`bool<class_bool>` tile, :ref:`Color<class_color>` modulate=Color( 1, 1, 1, 1 ), :ref:`bool<class_bool>` transpose=false, :ref:`Texture<class_texture>` normal_map=null  **)**                                                              |
 +----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@@ -81,7 +82,7 @@ Member Functions
 +----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`int<class_int>`                  | :ref:`get_light_mask<class_CanvasItem_get_light_mask>`  **(** **)** const                                                                                                                                                                                                                                                                                                                   |
 +----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`Vector2<class_vector2>`          | :ref:`get_local_mouse_pos<class_CanvasItem_get_local_mouse_pos>`  **(** **)** const                                                                                                                                                                                                                                                                                                         |
+| :ref:`Vector2<class_vector2>`          | :ref:`get_local_mouse_position<class_CanvasItem_get_local_mouse_position>`  **(** **)** const                                                                                                                                                                                                                                                                                               |
 +----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`Material<class_material>`        | :ref:`get_material<class_CanvasItem_get_material>`  **(** **)** const                                                                                                                                                                                                                                                                                                                       |
 +----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@@ -113,7 +114,7 @@ Member Functions
 +----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`bool<class_bool>`                | :ref:`is_visible_in_tree<class_CanvasItem_is_visible_in_tree>`  **(** **)** const                                                                                                                                                                                                                                                                                                           |
 +----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`Vector2<class_vector2>`          | :ref:`make_canvas_pos_local<class_CanvasItem_make_canvas_pos_local>`  **(** :ref:`Vector2<class_vector2>` screen_point  **)** const                                                                                                                                                                                                                                                         |
+| :ref:`Vector2<class_vector2>`          | :ref:`make_canvas_position_local<class_CanvasItem_make_canvas_position_local>`  **(** :ref:`Vector2<class_vector2>` screen_point  **)** const                                                                                                                                                                                                                                               |
 +----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`InputEvent<class_inputevent>`    | :ref:`make_input_local<class_CanvasItem_make_input_local>`  **(** :ref:`InputEvent<class_inputevent>` event  **)** const                                                                                                                                                                                                                                                                    |
 +----------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@@ -208,13 +209,13 @@ Called (if exists) to draw the canvas item.
 
 .. _class_CanvasItem_draw_char:
 
-- :ref:`float<class_float>`  **draw_char**  **(** :ref:`Font<class_font>` font, :ref:`Vector2<class_vector2>` pos, :ref:`String<class_string>` char, :ref:`String<class_string>` next, :ref:`Color<class_color>` modulate=Color( 1, 1, 1, 1 )  **)**
+- :ref:`float<class_float>`  **draw_char**  **(** :ref:`Font<class_font>` font, :ref:`Vector2<class_vector2>` position, :ref:`String<class_string>` char, :ref:`String<class_string>` next, :ref:`Color<class_color>` modulate=Color( 1, 1, 1, 1 )  **)**
 
 Draw a string character using a custom font. Returns the advance, depending on the char width and kerning with an optional next char.
 
 .. _class_CanvasItem_draw_circle:
 
-- void  **draw_circle**  **(** :ref:`Vector2<class_vector2>` pos, :ref:`float<class_float>` radius, :ref:`Color<class_color>` color  **)**
+- void  **draw_circle**  **(** :ref:`Vector2<class_vector2>` position, :ref:`float<class_float>` radius, :ref:`Color<class_color>` color  **)**
 
 Draw a colored circle.
 
@@ -258,7 +259,7 @@ Draw a colored rectangle.
 
 .. _class_CanvasItem_draw_set_transform:
 
-- void  **draw_set_transform**  **(** :ref:`Vector2<class_vector2>` pos, :ref:`float<class_float>` rot, :ref:`Vector2<class_vector2>` scale  **)**
+- void  **draw_set_transform**  **(** :ref:`Vector2<class_vector2>` position, :ref:`float<class_float>` rotation, :ref:`Vector2<class_vector2>` scale  **)**
 
 Set a custom transform for drawing. Anything drawn afterwards will be transformed by this.
 
@@ -268,7 +269,7 @@ Set a custom transform for drawing. Anything drawn afterwards will be transforme
 
 .. _class_CanvasItem_draw_string:
 
-- void  **draw_string**  **(** :ref:`Font<class_font>` font, :ref:`Vector2<class_vector2>` pos, :ref:`String<class_string>` text, :ref:`Color<class_color>` modulate=Color( 1, 1, 1, 1 ), :ref:`int<class_int>` clip_w=-1  **)**
+- void  **draw_string**  **(** :ref:`Font<class_font>` font, :ref:`Vector2<class_vector2>` position, :ref:`String<class_string>` text, :ref:`Color<class_color>` modulate=Color( 1, 1, 1, 1 ), :ref:`int<class_int>` clip_w=-1  **)**
 
 Draw a string using a custom font.
 
@@ -280,7 +281,7 @@ Draw a styled rectangle.
 
 .. _class_CanvasItem_draw_texture:
 
-- void  **draw_texture**  **(** :ref:`Texture<class_texture>` texture, :ref:`Vector2<class_vector2>` pos, :ref:`Color<class_color>` modulate=Color( 1, 1, 1, 1 ), :ref:`Texture<class_texture>` normal_map=null  **)**
+- void  **draw_texture**  **(** :ref:`Texture<class_texture>` texture, :ref:`Vector2<class_vector2>` position, :ref:`Color<class_color>` modulate=Color( 1, 1, 1, 1 ), :ref:`Texture<class_texture>` normal_map=null  **)**
 
 Draw a texture at a given position.
 
@@ -372,9 +373,9 @@ Return a rect containing the editable boundaries of the item.
 
 Get this item's light mask number.
 
-.. _class_CanvasItem_get_local_mouse_pos:
+.. _class_CanvasItem_get_local_mouse_position:
 
-- :ref:`Vector2<class_vector2>`  **get_local_mouse_pos**  **(** **)** const
+- :ref:`Vector2<class_vector2>`  **get_local_mouse_position**  **(** **)** const
 
 Get the mouse position relative to this item's position.
 
@@ -462,9 +463,9 @@ Return true if this CanvasItem is visible. It may be invisible because itself or
 
 - :ref:`bool<class_bool>`  **is_visible_in_tree**  **(** **)** const
 
-.. _class_CanvasItem_make_canvas_pos_local:
+.. _class_CanvasItem_make_canvas_position_local:
 
-- :ref:`Vector2<class_vector2>`  **make_canvas_pos_local**  **(** :ref:`Vector2<class_vector2>` screen_point  **)** const
+- :ref:`Vector2<class_vector2>`  **make_canvas_position_local**  **(** :ref:`Vector2<class_vector2>` screen_point  **)** const
 
 .. _class_CanvasItem_make_input_local:
 

classes/class_canvasitemmaterial.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the CanvasItemMaterial.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_CanvasItemMaterial:
 

classes/class_canvaslayer.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the CanvasLayer.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_CanvasLayer:
 
@@ -15,7 +16,7 @@ CanvasLayer
 Brief Description
 -----------------
 
-Canvas Item layer.
+Canvas drawing layer.
 
 Member Functions
 ----------------
@@ -55,15 +56,15 @@ Member Functions
 Member Variables
 ----------------
 
-- :ref:`int<class_int>` **layer**
-- :ref:`Vector2<class_vector2>` **offset**
-- :ref:`float<class_float>` **rotation**
-- :ref:`Vector2<class_vector2>` **scale**
+- :ref:`int<class_int>` **layer** - Layer index for draw order. Lower values are drawn first. Default value: [code]1[/code].
+- :ref:`Vector2<class_vector2>` **offset** - The layer's base offset.
+- :ref:`float<class_float>` **rotation** - The layer's rotation in degrees.
+- :ref:`Vector2<class_vector2>` **scale** - The layer's scale.
 
 Description
 -----------
 
-Canvas Item layer. :ref:`CanvasItem<class_canvasitem>` nodes that are direct or indirect children of a :ref:`CanvasLayer<class_canvaslayer>` will be drawn in that layer. The layer is a numeric index that defines the draw order. The default 2D scene renders with index 0, so a :ref:`CanvasLayer<class_canvaslayer>` with index -1 will be drawn below, and one with index 1 will be drawn above. This is very useful for HUDs (in layer 1+ or above), or backgrounds (in layer -1 or below).
+Canvas drawing layer. :ref:`CanvasItem<class_canvasitem>` nodes that are direct or indirect children of a :ref:`CanvasLayer<class_canvaslayer>` will be drawn in that layer. The layer is a numeric index that defines the draw order. The default 2D scene renders with index 0, so a :ref:`CanvasLayer<class_canvaslayer>` with index -1 will be drawn below, and one with index 1 will be drawn above. This is very useful for HUDs (in layer 1+ or above), or backgrounds (in layer -1 or below).
 
 Member Function Description
 ---------------------------

classes/class_canvasmodulate.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the CanvasModulate.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_CanvasModulate:
 

classes/class_capsulemesh.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the CapsuleMesh.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_CapsuleMesh:
 
@@ -13,7 +14,7 @@ CapsuleMesh
 Brief Description
 -----------------
 
-
+Class representing a capsule-shaped :ref:`PrimitiveMesh<class_primitivemesh>`.
 
 Member Functions
 ----------------
@@ -39,10 +40,15 @@ Member Functions
 Member Variables
 ----------------
 
-- :ref:`float<class_float>` **mid_height**
-- :ref:`int<class_int>` **radial_segments**
-- :ref:`float<class_float>` **radius**
-- :ref:`int<class_int>` **rings**
+- :ref:`float<class_float>` **mid_height** - Height of the capsule mesh from the center point. Defaults to 1.0.
+- :ref:`int<class_int>` **radial_segments** - Number of radial segments on the capsule mesh. Defaults to 64.
+- :ref:`float<class_float>` **radius** - Radius of the capsule mesh. Defaults to 1.0.
+- :ref:`int<class_int>` **rings** - Number of rings along the height of the capsule. Defaults to 8.
+
+Description
+-----------
+
+Class representing a capsule-shaped :ref:`PrimitiveMesh<class_primitivemesh>`.
 
 Member Function Description
 ---------------------------

classes/class_capsuleshape.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the CapsuleShape.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_CapsuleShape:
 
@@ -13,7 +14,7 @@ CapsuleShape
 Brief Description
 -----------------
 
-Capsule shape resource.
+Capsule shape for collisions.
 
 Member Functions
 ----------------
@@ -31,13 +32,13 @@ Member Functions
 Member Variables
 ----------------
 
-- :ref:`float<class_float>` **height**
-- :ref:`float<class_float>` **radius**
+- :ref:`float<class_float>` **height** - The capsule's height.
+- :ref:`float<class_float>` **radius** - The capsule's radius.
 
 Description
 -----------
 
-Capsule shape resource, which can be set into a :ref:`PhysicsBody<class_physicsbody>` or area.
+Capsule shape for collisions.
 
 Member Function Description
 ---------------------------

classes/class_capsuleshape2d.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the CapsuleShape2D.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_CapsuleShape2D:
 
@@ -13,7 +14,7 @@ CapsuleShape2D
 Brief Description
 -----------------
 
-Capsule 2D shape resource for physics.
+Capsule shape for 2D collisions.
 
 Member Functions
 ----------------
@@ -31,13 +32,13 @@ Member Functions
 Member Variables
 ----------------
 
-- :ref:`float<class_float>` **height**
-- :ref:`float<class_float>` **radius**
+- :ref:`float<class_float>` **height** - The capsule's height.
+- :ref:`float<class_float>` **radius** - The capsules's radius.
 
 Description
 -----------
 
-Capsule 2D shape resource for physics. A capsule (or sometimes called "pill") is like a line grown in all directions. It has a radius and a height, and is often useful for modeling biped characters.
+Capsule shape for 2D collisions.
 
 Member Function Description
 ---------------------------

classes/class_centercontainer.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the CenterContainer.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_CenterContainer:
 

classes/class_checkbox.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the CheckBox.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_CheckBox:
 

classes/class_checkbutton.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the CheckButton.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_CheckButton:
 

classes/class_circleshape2d.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the CircleShape2D.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_CircleShape2D:
 
@@ -13,7 +14,7 @@ CircleShape2D
 Brief Description
 -----------------
 
-Circular Shape for 2D Physics.
+Circular shape for 2D collisions.
 
 Member Functions
 ----------------
@@ -27,12 +28,12 @@ Member Functions
 Member Variables
 ----------------
 
-- :ref:`float<class_float>` **radius**
+- :ref:`float<class_float>` **radius** - The circle's radius.
 
 Description
 -----------
 
-Circular Shape for 2D Physics. This shape is useful for modeling balls or small characters and its collision detection with everything else is very fast.
+Circular shape for 2D collisions. This shape is useful for modeling balls or small characters and its collision detection with everything else is very fast.
 
 Member Function Description
 ---------------------------

classes/class_classdb.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the ClassDB.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_ClassDB:
 
@@ -13,7 +14,7 @@ ClassDB
 Brief Description
 -----------------
 
-
+Class information repository.
 
 Member Functions
 ----------------
@@ -60,6 +61,11 @@ Member Functions
 | :ref:`bool<class_bool>`                        | :ref:`is_parent_class<class_ClassDB_is_parent_class>`  **(** :ref:`String<class_string>` class, :ref:`String<class_string>` inherits  **)** const                                               |
 +------------------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 
+Description
+-----------
+
+Provides access to metadata stored for every available class.
+
 Member Function Description
 ---------------------------
 
@@ -67,10 +73,14 @@ Member Function Description
 
 - :ref:`bool<class_bool>`  **can_instance**  **(** :ref:`String<class_string>` class  **)** const
 
+Returns true if you can instance objects from the specified 'class', false in other case.
+
 .. _class_ClassDB_class_exists:
 
 - :ref:`bool<class_bool>`  **class_exists**  **(** :ref:`String<class_string>` class  **)** const
 
+Returns whether the specified 'class' is available or not.
+
 .. _class_ClassDB_class_get_category:
 
 - :ref:`String<class_string>`  **class_get_category**  **(** :ref:`String<class_string>` class  **)** const
@@ -79,68 +89,102 @@ Member Function Description
 
 - :ref:`int<class_int>`  **class_get_integer_constant**  **(** :ref:`String<class_string>` class, :ref:`String<class_string>` name  **)** const
 
+Returns the value of the integer constant 'name' of 'class' or its ancestry. Always returns 0 when the constant could not be found.
+
 .. _class_ClassDB_class_get_integer_constant_list:
 
 - :ref:`PoolStringArray<class_poolstringarray>`  **class_get_integer_constant_list**  **(** :ref:`String<class_string>` class, :ref:`bool<class_bool>` no_inheritance=false  **)** const
 
+Returns an array with the names all the integer constants of 'class' or its ancestry.
+
 .. _class_ClassDB_class_get_method_list:
 
 - :ref:`Array<class_array>`  **class_get_method_list**  **(** :ref:`String<class_string>` class, :ref:`bool<class_bool>` no_inheritance=false  **)** const
 
+Returns an array with all the methods of 'class' or its ancestry if 'no_inheritance' is false. Every element of the array is a :ref:`Dictionary<class_dictionary>` with the following keys: args, default_args, flags, id, name, return: (class_name, hint, hint_string, name, type, usage).
+
 .. _class_ClassDB_class_get_property:
 
 - :ref:`Variant<class_variant>`  **class_get_property**  **(** :ref:`Object<class_object>` object, :ref:`String<class_string>` property  **)** const
 
+Returns the value of 'property' of 'class' or its ancestry.
+
 .. _class_ClassDB_class_get_property_list:
 
 - :ref:`Array<class_array>`  **class_get_property_list**  **(** :ref:`String<class_string>` class, :ref:`bool<class_bool>` no_inheritance=false  **)** const
 
+Returns an array with all the properties of 'class' or its ancestry if 'no_inheritance' is false.
+
 .. _class_ClassDB_class_get_signal:
 
 - :ref:`Dictionary<class_dictionary>`  **class_get_signal**  **(** :ref:`String<class_string>` class, :ref:`String<class_string>` signal  **)** const
 
+Returns the 'signal' data of 'class' or its ancestry. The returned value is a :ref:`Dictionary<class_dictionary>` with the following keys: args, default_args, flags, id, name, return: (class_name, hint, hint_string, name, type, usage).
+
 .. _class_ClassDB_class_get_signal_list:
 
 - :ref:`Array<class_array>`  **class_get_signal_list**  **(** :ref:`String<class_string>` class, :ref:`bool<class_bool>` no_inheritance=false  **)** const
 
+Returns an array with all the signals of 'class' or its ancestry if 'no_inheritance' is false. Every element of the array is a :ref:`Dictionary<class_dictionary>` as described in class_get_signal.
+
 .. _class_ClassDB_class_has_integer_constant:
 
 - :ref:`bool<class_bool>`  **class_has_integer_constant**  **(** :ref:`String<class_string>` class, :ref:`String<class_string>` name  **)** const
 
+Return whether 'class' or its ancestry has an integer constant called 'name' or not.
+
 .. _class_ClassDB_class_has_method:
 
 - :ref:`bool<class_bool>`  **class_has_method**  **(** :ref:`String<class_string>` class, :ref:`String<class_string>` method, :ref:`bool<class_bool>` no_inheritance=false  **)** const
 
+Return whether 'class' (or its ancestry if 'no_inheritance' is false) has a method called 'method' or not.
+
 .. _class_ClassDB_class_has_signal:
 
 - :ref:`bool<class_bool>`  **class_has_signal**  **(** :ref:`String<class_string>` class, :ref:`String<class_string>` signal  **)** const
 
+Return whether 'class' or its ancestry has a signal called 'signal' or not.
+
 .. _class_ClassDB_class_set_property:
 
 - :ref:`int<class_int>`  **class_set_property**  **(** :ref:`Object<class_object>` object, :ref:`String<class_string>` property, :ref:`Variant<class_variant>` value  **)** const
 
+Sets 'property' value of 'class' to 'value'.
+
 .. _class_ClassDB_get_class_list:
 
 - :ref:`PoolStringArray<class_poolstringarray>`  **get_class_list**  **(** **)** const
 
+Returns the names of all the classes available.
+
 .. _class_ClassDB_get_inheriters_from_class:
 
 - :ref:`PoolStringArray<class_poolstringarray>`  **get_inheriters_from_class**  **(** :ref:`String<class_string>` class  **)** const
 
+Returns the names of all the classes that directly or indirectly inherit from 'class'.
+
 .. _class_ClassDB_get_parent_class:
 
 - :ref:`String<class_string>`  **get_parent_class**  **(** :ref:`String<class_string>` class  **)** const
 
+Returns the parent class of 'class'.
+
 .. _class_ClassDB_instance:
 
 - :ref:`Variant<class_variant>`  **instance**  **(** :ref:`String<class_string>` class  **)** const
 
+Creates an instance of 'class'.
+
 .. _class_ClassDB_is_class_enabled:
 
 - :ref:`bool<class_bool>`  **is_class_enabled**  **(** :ref:`String<class_string>` class  **)** const
 
+Returns whether this class is enabled or not.
+
 .. _class_ClassDB_is_parent_class:
 
 - :ref:`bool<class_bool>`  **is_parent_class**  **(** :ref:`String<class_string>` class, :ref:`String<class_string>` inherits  **)** const
 
+Returns whether 'inherits' is an ancestor of 'class' or not.
+
 

classes/class_collisionobject.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the CollisionObject.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_CollisionObject:
 
@@ -20,54 +21,54 @@ Brief Description
 Member Functions
 ----------------
 
-+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                               | :ref:`_input_event<class_CollisionObject__input_event>`  **(** :ref:`Object<class_object>` camera, :ref:`InputEvent<class_inputevent>` event, :ref:`Vector3<class_vector3>` click_pos, :ref:`Vector3<class_vector3>` click_normal, :ref:`int<class_int>` shape_idx  **)** virtual |
-+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`int<class_int>`              | :ref:`create_shape_owner<class_CollisionObject_create_shape_owner>`  **(** :ref:`Object<class_object>` owner  **)**                                                                                                                                                               |
-+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`bool<class_bool>`            | :ref:`get_capture_input_on_drag<class_CollisionObject_get_capture_input_on_drag>`  **(** **)** const                                                                                                                                                                              |
-+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`RID<class_rid>`              | :ref:`get_rid<class_CollisionObject_get_rid>`  **(** **)** const                                                                                                                                                                                                                  |
-+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`Array<class_array>`          | :ref:`get_shape_owners<class_CollisionObject_get_shape_owners>`  **(** **)**                                                                                                                                                                                                      |
-+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`bool<class_bool>`            | :ref:`is_ray_pickable<class_CollisionObject_is_ray_pickable>`  **(** **)** const                                                                                                                                                                                                  |
-+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`bool<class_bool>`            | :ref:`is_shape_owner_disabled<class_CollisionObject_is_shape_owner_disabled>`  **(** :ref:`int<class_int>` owner_id  **)** const                                                                                                                                                  |
-+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                               | :ref:`remove_shape_owner<class_CollisionObject_remove_shape_owner>`  **(** :ref:`int<class_int>` owner_id  **)**                                                                                                                                                                  |
-+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                               | :ref:`set_capture_input_on_drag<class_CollisionObject_set_capture_input_on_drag>`  **(** :ref:`bool<class_bool>` enable  **)**                                                                                                                                                    |
-+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                               | :ref:`set_ray_pickable<class_CollisionObject_set_ray_pickable>`  **(** :ref:`bool<class_bool>` ray_pickable  **)**                                                                                                                                                                |
-+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`int<class_int>`              | :ref:`shape_find_owner<class_CollisionObject_shape_find_owner>`  **(** :ref:`int<class_int>` shape_index  **)** const                                                                                                                                                             |
-+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                               | :ref:`shape_owner_add_shape<class_CollisionObject_shape_owner_add_shape>`  **(** :ref:`int<class_int>` owner_id, :ref:`Shape<class_shape>` shape  **)**                                                                                                                           |
-+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                               | :ref:`shape_owner_clear_shapes<class_CollisionObject_shape_owner_clear_shapes>`  **(** :ref:`int<class_int>` owner_id  **)**                                                                                                                                                      |
-+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`Object<class_object>`        | :ref:`shape_owner_get_owner<class_CollisionObject_shape_owner_get_owner>`  **(** :ref:`int<class_int>` owner_id  **)** const                                                                                                                                                      |
-+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`Shape<class_shape>`          | :ref:`shape_owner_get_shape<class_CollisionObject_shape_owner_get_shape>`  **(** :ref:`int<class_int>` owner_id, :ref:`int<class_int>` shape_id  **)** const                                                                                                                      |
-+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`int<class_int>`              | :ref:`shape_owner_get_shape_count<class_CollisionObject_shape_owner_get_shape_count>`  **(** :ref:`int<class_int>` owner_id  **)** const                                                                                                                                          |
-+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`int<class_int>`              | :ref:`shape_owner_get_shape_index<class_CollisionObject_shape_owner_get_shape_index>`  **(** :ref:`int<class_int>` owner_id, :ref:`int<class_int>` shape_id  **)** const                                                                                                          |
-+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`Transform<class_transform>`  | :ref:`shape_owner_get_transform<class_CollisionObject_shape_owner_get_transform>`  **(** :ref:`int<class_int>` owner_id  **)** const                                                                                                                                              |
-+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                               | :ref:`shape_owner_remove_shape<class_CollisionObject_shape_owner_remove_shape>`  **(** :ref:`int<class_int>` owner_id, :ref:`int<class_int>` shape_id  **)**                                                                                                                      |
-+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                               | :ref:`shape_owner_set_disabled<class_CollisionObject_shape_owner_set_disabled>`  **(** :ref:`int<class_int>` owner_id, :ref:`bool<class_bool>` disabled  **)**                                                                                                                    |
-+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                               | :ref:`shape_owner_set_transform<class_CollisionObject_shape_owner_set_transform>`  **(** :ref:`int<class_int>` owner_id, :ref:`Transform<class_transform>` transform  **)**                                                                                                       |
-+------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
++------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                               | :ref:`_input_event<class_CollisionObject__input_event>`  **(** :ref:`Object<class_object>` camera, :ref:`InputEvent<class_inputevent>` event, :ref:`Vector3<class_vector3>` click_position, :ref:`Vector3<class_vector3>` click_normal, :ref:`int<class_int>` shape_idx  **)** virtual |
++------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`int<class_int>`              | :ref:`create_shape_owner<class_CollisionObject_create_shape_owner>`  **(** :ref:`Object<class_object>` owner  **)**                                                                                                                                                                    |
++------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`bool<class_bool>`            | :ref:`get_capture_input_on_drag<class_CollisionObject_get_capture_input_on_drag>`  **(** **)** const                                                                                                                                                                                   |
++------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`RID<class_rid>`              | :ref:`get_rid<class_CollisionObject_get_rid>`  **(** **)** const                                                                                                                                                                                                                       |
++------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`Array<class_array>`          | :ref:`get_shape_owners<class_CollisionObject_get_shape_owners>`  **(** **)**                                                                                                                                                                                                           |
++------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`bool<class_bool>`            | :ref:`is_ray_pickable<class_CollisionObject_is_ray_pickable>`  **(** **)** const                                                                                                                                                                                                       |
++------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`bool<class_bool>`            | :ref:`is_shape_owner_disabled<class_CollisionObject_is_shape_owner_disabled>`  **(** :ref:`int<class_int>` owner_id  **)** const                                                                                                                                                       |
++------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                               | :ref:`remove_shape_owner<class_CollisionObject_remove_shape_owner>`  **(** :ref:`int<class_int>` owner_id  **)**                                                                                                                                                                       |
++------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                               | :ref:`set_capture_input_on_drag<class_CollisionObject_set_capture_input_on_drag>`  **(** :ref:`bool<class_bool>` enable  **)**                                                                                                                                                         |
++------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                               | :ref:`set_ray_pickable<class_CollisionObject_set_ray_pickable>`  **(** :ref:`bool<class_bool>` ray_pickable  **)**                                                                                                                                                                     |
++------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`int<class_int>`              | :ref:`shape_find_owner<class_CollisionObject_shape_find_owner>`  **(** :ref:`int<class_int>` shape_index  **)** const                                                                                                                                                                  |
++------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                               | :ref:`shape_owner_add_shape<class_CollisionObject_shape_owner_add_shape>`  **(** :ref:`int<class_int>` owner_id, :ref:`Shape<class_shape>` shape  **)**                                                                                                                                |
++------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                               | :ref:`shape_owner_clear_shapes<class_CollisionObject_shape_owner_clear_shapes>`  **(** :ref:`int<class_int>` owner_id  **)**                                                                                                                                                           |
++------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`Object<class_object>`        | :ref:`shape_owner_get_owner<class_CollisionObject_shape_owner_get_owner>`  **(** :ref:`int<class_int>` owner_id  **)** const                                                                                                                                                           |
++------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`Shape<class_shape>`          | :ref:`shape_owner_get_shape<class_CollisionObject_shape_owner_get_shape>`  **(** :ref:`int<class_int>` owner_id, :ref:`int<class_int>` shape_id  **)** const                                                                                                                           |
++------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`int<class_int>`              | :ref:`shape_owner_get_shape_count<class_CollisionObject_shape_owner_get_shape_count>`  **(** :ref:`int<class_int>` owner_id  **)** const                                                                                                                                               |
++------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`int<class_int>`              | :ref:`shape_owner_get_shape_index<class_CollisionObject_shape_owner_get_shape_index>`  **(** :ref:`int<class_int>` owner_id, :ref:`int<class_int>` shape_id  **)** const                                                                                                               |
++------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`Transform<class_transform>`  | :ref:`shape_owner_get_transform<class_CollisionObject_shape_owner_get_transform>`  **(** :ref:`int<class_int>` owner_id  **)** const                                                                                                                                                   |
++------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                               | :ref:`shape_owner_remove_shape<class_CollisionObject_shape_owner_remove_shape>`  **(** :ref:`int<class_int>` owner_id, :ref:`int<class_int>` shape_id  **)**                                                                                                                           |
++------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                               | :ref:`shape_owner_set_disabled<class_CollisionObject_shape_owner_set_disabled>`  **(** :ref:`int<class_int>` owner_id, :ref:`bool<class_bool>` disabled  **)**                                                                                                                         |
++------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| void                               | :ref:`shape_owner_set_transform<class_CollisionObject_shape_owner_set_transform>`  **(** :ref:`int<class_int>` owner_id, :ref:`Transform<class_transform>` transform  **)**                                                                                                            |
++------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 
 Signals
 -------
 
--  **input_event**  **(** :ref:`Object<class_object>` camera, :ref:`Object<class_object>` event, :ref:`Vector3<class_vector3>` click_pos, :ref:`Vector3<class_vector3>` click_normal, :ref:`int<class_int>` shape_idx  **)**
+-  **input_event**  **(** :ref:`Object<class_object>` camera, :ref:`Object<class_object>` event, :ref:`Vector3<class_vector3>` click_position, :ref:`Vector3<class_vector3>` click_normal, :ref:`int<class_int>` shape_idx  **)**
 -  **mouse_entered**  **(** **)**
 -  **mouse_exited**  **(** **)**
 
@@ -82,7 +83,7 @@ Member Function Description
 
 .. _class_CollisionObject__input_event:
 
-- void  **_input_event**  **(** :ref:`Object<class_object>` camera, :ref:`InputEvent<class_inputevent>` event, :ref:`Vector3<class_vector3>` click_pos, :ref:`Vector3<class_vector3>` click_normal, :ref:`int<class_int>` shape_idx  **)** virtual
+- void  **_input_event**  **(** :ref:`Object<class_object>` camera, :ref:`InputEvent<class_inputevent>` event, :ref:`Vector3<class_vector3>` click_position, :ref:`Vector3<class_vector3>` click_normal, :ref:`int<class_int>` shape_idx  **)** virtual
 
 .. _class_CollisionObject_create_shape_owner:
 

classes/class_collisionobject2d.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the CollisionObject2D.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_CollisionObject2D:
 

classes/class_collisionpolygon.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the CollisionPolygon.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_CollisionPolygon:
 
@@ -13,7 +14,7 @@ CollisionPolygon
 Brief Description
 -----------------
 
-
+Editor-only class for defining a collision polygon in 3D space.
 
 Member Functions
 ----------------
@@ -35,9 +36,14 @@ Member Functions
 Member Variables
 ----------------
 
-- :ref:`float<class_float>` **depth**
-- :ref:`bool<class_bool>` **disabled**
-- :ref:`PoolVector2Array<class_poolvector2array>` **polygon**
+- :ref:`float<class_float>` **depth** - Length that the resulting collision extends in either direction perpendicular to its polygon.
+- :ref:`bool<class_bool>` **disabled** - If true, no collision will be produced.
+- :ref:`PoolVector2Array<class_poolvector2array>` **polygon** - Array of vertices which define the polygon.
+
+Description
+-----------
+
+Allows editing a collision polygon's vertices on a selected plane. Can also set a depth perpendicular to that plane. This class is only available in the editor. It will not appear in the scene tree at runtime. Creates a :ref:`Shape<class_shape>` for gameplay. Properties modified during gameplay will have no effect.
 
 Member Function Description
 ---------------------------

classes/class_collisionpolygon2d.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the CollisionPolygon2D.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_CollisionPolygon2D:
 
@@ -13,7 +14,7 @@ CollisionPolygon2D
 Brief Description
 -----------------
 
-Editor-only class for easy editing of collision polygons.
+Editor-only class for defining a collision polygon in 2D space.
 
 Member Functions
 ----------------
@@ -39,15 +40,21 @@ Member Functions
 Member Variables
 ----------------
 
-- :ref:`int<class_int>` **build_mode**
-- :ref:`bool<class_bool>` **disabled**
-- :ref:`bool<class_bool>` **one_way_collision**
-- :ref:`PoolVector2Array<class_poolvector2array>` **polygon**
+- :ref:`int<class_int>` **build_mode** - If BUILD_SOLIDS, the polygon and the area within it will have collision. If BUILD_SEGMENTS, only the edges of the polygon will have collision.
+- :ref:`bool<class_bool>` **disabled** - If true, no collision will be produced.
+- :ref:`bool<class_bool>` **one_way_collision** - If true, only edges that face up, relative to CollisionPolygon2D's rotation, will collide with other objects.
+- :ref:`PoolVector2Array<class_poolvector2array>` **polygon** - Array of vertices which define the polygon.
+
+Numeric Constants
+-----------------
+
+- **BUILD_SOLIDS** = **0**
+- **BUILD_SEGMENTS** = **1**
 
 Description
 -----------
 
-Editor-only class. This is not present when running the game. It's used in the editor to properly edit and position collision shapes in :ref:`CollisionObject2D<class_collisionobject2d>`. This is not accessible from regular code. This class is for editing custom shape polygons.
+Allows editing a collision polygon's vertices. This class is only available in the editor. It will not appear in the scene tree at runtime. Creates a :ref:`Shape2D<class_shape2d>` for gameplay. Properties modified during gameplay will have no effect.
 
 Member Function Description
 ---------------------------

classes/class_collisionshape.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the CollisionShape.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_CollisionShape:
 
@@ -13,7 +14,7 @@ CollisionShape
 Brief Description
 -----------------
 
-
+Node that represents collision shape data in 3D space.
 
 Member Functions
 ----------------
@@ -35,8 +36,13 @@ Member Functions
 Member Variables
 ----------------
 
-- :ref:`bool<class_bool>` **disabled**
-- :ref:`Shape<class_shape>` **shape**
+- :ref:`bool<class_bool>` **disabled** - A disabled collision shape has no effect in the world.
+- :ref:`Shape<class_shape>` **shape** - The actual shape owned by this collision shape.
+
+Description
+-----------
+
+Editor facility for creating and editing collision shapes in 3D space. You can use this node to represent all sorts of collision shapes, for example, add this to an :ref:`Area<class_area>` to give it a detection shape, or add it to a :ref:`PhysicsBody<class_physicsbody>` to give create solid object. **IMPORTANT**: this is an Editor-only helper to create shapes, use :ref:`get_shape<class_CollisionShape_get_shape>` to get the actual shape.
 
 Member Function Description
 ---------------------------
@@ -53,10 +59,14 @@ Member Function Description
 
 - void  **make_convex_from_brothers**  **(** **)**
 
+Sets the collision shape's shape to the addition of all its convexed :ref:`MeshInstance<class_meshinstance>` siblings geometry.
+
 .. _class_CollisionShape_resource_changed:
 
 - void  **resource_changed**  **(** :ref:`Resource<class_resource>` resource  **)**
 
+If this method exists within a script it will be called whenever the shape resource has been modified.
+
 .. _class_CollisionShape_set_disabled:
 
 - void  **set_disabled**  **(** :ref:`bool<class_bool>` enable  **)**

classes/class_collisionshape2d.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the CollisionShape2D.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_CollisionShape2D:
 
@@ -13,7 +14,7 @@ CollisionShape2D
 Brief Description
 -----------------
 
-Editor-only class for easy editing of shapes.
+Node that represents collision shape data in 2D space.
 
 Member Functions
 ----------------
@@ -35,14 +36,14 @@ Member Functions
 Member Variables
 ----------------
 
-- :ref:`bool<class_bool>` **disabled**
-- :ref:`bool<class_bool>` **one_way_collision**
-- :ref:`Shape2D<class_shape2d>` **shape**
+- :ref:`bool<class_bool>` **disabled** - A disabled collision shape has no effect in the world.
+- :ref:`bool<class_bool>` **one_way_collision** - Sets whether this collision shape should only detect collision on one side (top or bottom).
+- :ref:`Shape2D<class_shape2d>` **shape** - The actual shape owned by this collision shape.
 
 Description
 -----------
 
-Editor-only class. This is not present when running the game. It's used in the editor to properly edit and position collision shapes in :ref:`CollisionObject2D<class_collisionobject2d>`. This is not accessible from regular code.
+Editor facility for creating and editing collision shapes in 2D space. You can use this node to represent all sorts of collision shapes, for example, add this to an :ref:`Area2D<class_area2d>` to give it a detection shape, or add it to a :ref:`PhysicsBody2D<class_physicsbody2d>` to give create solid object. **IMPORTANT**: this is an Editor-only helper to create shapes, use :ref:`get_shape<class_CollisionShape2D_get_shape>` to get the actual shape.
 
 Member Function Description
 ---------------------------
@@ -51,8 +52,6 @@ Member Function Description
 
 - :ref:`Shape2D<class_shape2d>`  **get_shape**  **(** **)** const
 
-Return this shape's :ref:`Shape2D<class_shape2d>`.
-
 .. _class_CollisionShape2D_is_disabled:
 
 - :ref:`bool<class_bool>`  **is_disabled**  **(** **)** const
@@ -73,6 +72,4 @@ Return this shape's :ref:`Shape2D<class_shape2d>`.
 
 - void  **set_shape**  **(** :ref:`Shape2D<class_shape2d>` shape  **)**
 
-Set this shape's :ref:`Shape2D<class_shape2d>`. This will not appear as a node, but can be directly edited as a property.
-
 

classes/class_color.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the Color.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_Color:
 
@@ -11,7 +12,7 @@ Color
 Brief Description
 -----------------
 
-Color in RGBA format.
+Color in RGBA format with some support for ARGB format.
 
 Member Functions
 ----------------
@@ -35,12 +36,12 @@ Member Functions
 +------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`Color<class_color>`    | :ref:`linear_interpolate<class_Color_linear_interpolate>`  **(** :ref:`Color<class_color>` b, :ref:`float<class_float>` t  **)**                                 |
 +------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`int<class_int>`        | :ref:`to_32<class_Color_to_32>`  **(** **)**                                                                                                                     |
-+------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`int<class_int>`        | :ref:`to_ARGB32<class_Color_to_ARGB32>`  **(** **)**                                                                                                             |
+| :ref:`int<class_int>`        | :ref:`to_argb32<class_Color_to_argb32>`  **(** **)**                                                                                                             |
 +------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`String<class_string>`  | :ref:`to_html<class_Color_to_html>`  **(** :ref:`bool<class_bool>` with_alpha=True  **)**                                                                        |
 +------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
+| :ref:`int<class_int>`        | :ref:`to_rgba32<class_Color_to_rgba32>`  **(** **)**                                                                                                             |
++------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 
 Member Variables
 ----------------
@@ -60,7 +61,7 @@ Member Variables
 Description
 -----------
 
-A color is represented as red, green and blue (r,g,b) components. Additionally, "a" represents the alpha component, often used for transparency. Values are in floating point and usually range from 0 to 1.  Some methods (such as set_modulate() ) may accept values > 1.
+A color is represented as red, green and blue (r,g,b) components. Additionally, "a" represents the alpha component, often used for transparency. Values are in floating point and usually range from 0 to 1.  Some methods (such as set_modulate(color)) may accept values > 1.
 
 Member Function Description
 ---------------------------
@@ -69,72 +70,153 @@ Member Function Description
 
 - :ref:`Color<class_color>`  **Color**  **(** :ref:`float<class_float>` r, :ref:`float<class_float>` g, :ref:`float<class_float>` b, :ref:`float<class_float>` a  **)**
 
-Construct the color from an RGBA profile.
+Constructs a color from an RGBA profile using values between 0 and 1 (float).
+
+::
+
+    var c = Color(0.2, 1.0, .7, .8) # a color of an RGBA(51, 255, 178, 204)
 
 .. _class_Color_Color:
 
 - :ref:`Color<class_color>`  **Color**  **(** :ref:`float<class_float>` r, :ref:`float<class_float>` g, :ref:`float<class_float>` b  **)**
 
-Construct the color from an RGBA profile.
+Constructs a color from an RGB profile using values between 0 and 1 (float). Alpha will always be 1.
+
+::
+
+    var c = Color(0.2, 1.0, .7) # a color of an RGBA(51, 255, 178, 255)
 
 .. _class_Color_Color:
 
 - :ref:`Color<class_color>`  **Color**  **(** :ref:`int<class_int>` from  **)**
 
-Construct the color from an RGBA profile.
+Constructs a color from a 32-bit integer (each byte represents a component of the RGBA profile).
+
+::
+
+    var c = Color(274) # a color of an RGBA(0, 0, 1, 18)
 
 .. _class_Color_Color:
 
 - :ref:`Color<class_color>`  **Color**  **(** :ref:`String<class_string>` from  **)**
 
-Construct the color from an RGBA profile.
+Constructs a color from an HTML hexadecimal color string in ARGB or RGB format.
+
+The following string formats are supported:
+
+``"#ff00ff00"`` - ARGB format with '#'
+
+``"ff00ff00"`` - ARGB format
+
+``"#ff00ff"`` - RGB format with '#'
+
+``"ff00ff"`` - RGB format
+
+::
+
+    # The following code creates the same color of an RGBA(178, 217, 10, 255)
+    var c1 = Color("#ffb2d90a") # ARGB format with '#'
+    var c2 = Color("ffb2d90a")  # ARGB format
+    var c3 = Color("#b2d90a")   # RGB format with '#'
+    var c4 = Color("b2d90a")    # RGB format
 
 .. _class_Color_blend:
 
 - :ref:`Color<class_color>`  **blend**  **(** :ref:`Color<class_color>` over  **)**
 
-Return a new color blended with anothor one.
+Returns a new color resulting from blending this color over another color. If the color is opaque, the result would also be opaque. The other color could then take a range of values with different alpha values.
+
+::
+
+    var bg = Color(0.0, 1.0, 0.0, 0.5) # Green with alpha of 50%
+    var fg = Color(1.0, 0.0, 0.0, .5) # Red with alpha of 50%
+    var blendedColor = bg.blend(fg) # Brown with alpha of 75%
 
 .. _class_Color_contrasted:
 
 - :ref:`Color<class_color>`  **contrasted**  **(** **)**
 
-Return the most contrasting color with this one.
+Returns the most contrasting color.
+
+::
+
+    var c = Color(.3, .4, .9)
+    var contrastedColor = c.contrasted() # a color of an RGBA(204, 229, 102, 255)
 
 .. _class_Color_gray:
 
 - :ref:`float<class_float>`  **gray**  **(** **)**
 
-Convert the color to gray.
+Returns the color's grayscale.
+
+The gray is calculated by (r + g + b) / 3.
+
+::
+
+    var c = Color(0.2, 0.45, 0.82)
+    var gray = c.gray() # a value of 0.466667
 
 .. _class_Color_inverted:
 
 - :ref:`Color<class_color>`  **inverted**  **(** **)**
 
-Return the inverted color (1-r, 1-g, 1-b, 1-a).
+Returns the inverted color (1-r, 1-g, 1-b, 1-a).
+
+::
+
+    var c = Color(.3, .4, .9)
+    var invertedColor = c.inverted() # a color of an RGBA(178, 153, 26, 255)
 
 .. _class_Color_linear_interpolate:
 
 - :ref:`Color<class_color>`  **linear_interpolate**  **(** :ref:`Color<class_color>` b, :ref:`float<class_float>` t  **)**
 
-Return the linear interpolation with another color.
+Returns the color of the linear interpolation with another color. The value t is between 0 and 1 (float).
+
+::
 
-.. _class_Color_to_32:
+    var c1 = Color(1.0, 0.0, 0.0)
+    var c2 = Color(0.0, 1.0, 0.0)
+    var li_c = c1.linear_interpolate(c2, 0.5) # a color of an RGBA(128, 128, 0, 255)
 
-- :ref:`int<class_int>`  **to_32**  **(** **)**
+.. _class_Color_to_argb32:
 
-Convert the color to a 32 its integer (each byte represents a RGBA).
+- :ref:`int<class_int>`  **to_argb32**  **(** **)**
 
-.. _class_Color_to_ARGB32:
+Returns the color's 32-bit integer in ARGB format (each byte represents a component of the ARGB profile). More compatible with DirectX.
 
-- :ref:`int<class_int>`  **to_ARGB32**  **(** **)**
+::
 
-Convert color to ARGB32, more compatible with DirectX.
+    var c = Color(1, .5, .2)
+    print(str(c.to_32())) # prints 4294934323
 
 .. _class_Color_to_html:
 
 - :ref:`String<class_string>`  **to_html**  **(** :ref:`bool<class_bool>` with_alpha=True  **)**
 
-Return the HTML hexadecimal color string.
+Returns the color's HTML hexadecimal color string in ARGB format (ex: ``ff34f822``).
+
+Optionally flag 'false' to not include alpha in hexadecimal string.
+
+::
+
+    var c = Color(1, 1, 1, .5)
+    var s1 = c.to_html() # Results "7fffffff"
+    var s2 = c.to_html(false) # Results 'ffffff'
+
+.. _class_Color_to_rgba32:
+
+- :ref:`int<class_int>`  **to_rgba32**  **(** **)**
+
+Returns the color's 32-bit integer in ARGB format (each byte represents a component of the ARGB profile).
+
+::
+
+    var c = Color(1, .5, .2)
+    print(str(c.to_32())) # prints 4294934323
+
+
+
+*This is same as :ref:`to_ARGB32<class_Color_to_ARGB32>` but may be changed later to support RGBA format instead*.
 
 

classes/class_colorpicker.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the ColorPicker.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_ColorPicker:
 

classes/class_colorpickerbutton.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the ColorPickerButton.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_ColorPickerButton:
 
@@ -75,4 +76,13 @@ See :ref:`ColorPicker.set_edit_alpha<class_ColorPicker_set_edit_alpha>`
 
 - void  **set_pick_color**  **(** :ref:`Color<class_color>` color  **)**
 
+Set new color to ColorRect.
+
+
+
+::
+
+    var cr = get_node("colorrect_node")
+    cr.set_frame_color(Color(1, 0, 0, 1)) # Set color rect node to red
+
 

classes/class_colorrect.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the ColorRect.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_ColorRect:
 
@@ -13,7 +14,7 @@ ColorRect
 Brief Description
 -----------------
 
-
+Colored rect for canvas.
 
 Member Functions
 ----------------
@@ -29,6 +30,11 @@ Member Variables
 
 - :ref:`Color<class_color>` **color**
 
+Description
+-----------
+
+An object that is represented on the canvas as a rect with color. :ref:`Color<class_color>` is used to set or get color info for the rect.
+
 Member Function Description
 ---------------------------
 
@@ -36,8 +42,22 @@ Member Function Description
 
 - :ref:`Color<class_color>`  **get_frame_color**  **(** **)** const
 
+Return the color in RGBA format.
+
+::
+
+    var cr = get_node("colorrect_node")
+    var c = cr.get_frame_color() # Default color is white
+
 .. _class_ColorRect_set_frame_color:
 
 - void  **set_frame_color**  **(** :ref:`Color<class_color>` color  **)**
 
+Set new color to ColorRect.
+
+::
+
+    var cr = get_node("colorrect_node")
+    cr.set_frame_color(Color(1, 0, 0, 1)) # Set color rect node to red
+
 

classes/class_concavepolygonshape.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the ConcavePolygonShape.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_ConcavePolygonShape:
 

classes/class_concavepolygonshape2d.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the ConcavePolygonShape2D.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_ConcavePolygonShape2D:
 

classes/class_conetwistjoint.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the ConeTwistJoint.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_ConeTwistJoint:
 

classes/class_configfile.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the ConfigFile.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_ConfigFile:
 

classes/class_confirmationdialog.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the ConfirmationDialog.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_ConfirmationDialog:
 

classes/class_container.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the Container.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_Container:
 

classes/class_control.rst

@@ -1,5 +1,6 @@
 .. Generated automatically by doc/tools/makerst.py in Godot's source tree.
-.. DO NOT EDIT THIS FILE, but the doc/base/classes.xml source instead.
+.. DO NOT EDIT THIS FILE, but the Control.xml source instead.
+.. The source is found in doc/classes or modules/<name>/doc_classes.
 
 .. _class_Control:
 
@@ -8,14 +9,14 @@ Control
 
 **Inherits:** :ref:`CanvasItem<class_canvasitem>` **<** :ref:`Node<class_node>` **<** :ref:`Object<class_object>`
 
-**Inherited By:** :ref:`TextureRect<class_texturerect>`, :ref:`ColorRect<class_colorrect>`, :ref:`Label<class_label>`, :ref:`Tabs<class_tabs>`, :ref:`GraphEdit<class_graphedit>`, :ref:`VideoPlayer<class_videoplayer>`, :ref:`NinePatchRect<class_ninepatchrect>`, :ref:`LineEdit<class_lineedit>`, :ref:`Container<class_container>`, :ref:`TextEdit<class_textedit>`, :ref:`BaseButton<class_basebutton>`, :ref:`Popup<class_popup>`, :ref:`Tree<class_tree>`, :ref:`Separator<class_separator>`, :ref:`ReferenceRect<class_referencerect>`, :ref:`Panel<class_panel>`, :ref:`TabContainer<class_tabcontainer>`, :ref:`Range<class_range>`, :ref:`RichTextLabel<class_richtextlabel>`, :ref:`ItemList<class_itemlist>`
+**Inherited By:** :ref:`TextureRect<class_texturerect>`, :ref:`ColorRect<class_colorrect>`, :ref:`Label<class_label>`, :ref:`Tabs<class_tabs>`, :ref:`GraphEdit<class_graphedit>`, :ref:`VideoPlayer<class_videoplayer>`, :ref:`NinePatchRect<class_ninepatchrect>`, :ref:`LineEdit<class_lineedit>`, :ref:`TextEdit<class_textedit>`, :ref:`BaseButton<class_basebutton>`, :ref:`Popup<class_popup>`, :ref:`Tree<class_tree>`, :ref:`Separator<class_separator>`, :ref:`ReferenceRect<class_referencerect>`, :ref:`Container<class_container>`, :ref:`Panel<class_panel>`, :ref:`TabContainer<class_tabcontainer>`, :ref:`Range<class_range>`, :ref:`RichTextLabel<class_richtextlabel>`, :ref:`ItemList<class_itemlist>`
 
 **Category:** Core
 
 Brief Description
 -----------------
 
-Control is the base node for all the GUI components.
+Base node for all User Interface components.
 
 Member Functions
 ----------------
@@ -39,9 +40,9 @@ Member Functions
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | void                             | :ref:`add_style_override<class_Control_add_style_override>`  **(** :ref:`String<class_string>` name, :ref:`StyleBox<class_stylebox>` stylebox  **)**                                                                                 |
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`bool<class_bool>`          | :ref:`can_drop_data<class_Control_can_drop_data>`  **(** :ref:`Vector2<class_vector2>` pos, :ref:`Variant<class_variant>` data  **)** virtual                                                                                        |
+| :ref:`bool<class_bool>`          | :ref:`can_drop_data<class_Control_can_drop_data>`  **(** :ref:`Vector2<class_vector2>` position, :ref:`Variant<class_variant>` data  **)** virtual                                                                                   |
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                             | :ref:`drop_data<class_Control_drop_data>`  **(** :ref:`Vector2<class_vector2>` pos, :ref:`Variant<class_variant>` data  **)** virtual                                                                                                |
+| void                             | :ref:`drop_data<class_Control_drop_data>`  **(** :ref:`Vector2<class_vector2>` position, :ref:`Variant<class_variant>` data  **)** virtual                                                                                           |
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | void                             | :ref:`force_drag<class_Control_force_drag>`  **(** :ref:`Variant<class_variant>` data, :ref:`Control<class_control>` preview  **)**                                                                                                  |
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@@ -55,13 +56,13 @@ Member Functions
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`int<class_int>`            | :ref:`get_constant<class_Control_get_constant>`  **(** :ref:`String<class_string>` name, :ref:`String<class_string>` type=""  **)** const                                                                                            |
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`int<class_int>`            | :ref:`get_cursor_shape<class_Control_get_cursor_shape>`  **(** :ref:`Vector2<class_vector2>` pos=Vector2( 0, 0 )  **)** const                                                                                                        |
+| :ref:`int<class_int>`            | :ref:`get_cursor_shape<class_Control_get_cursor_shape>`  **(** :ref:`Vector2<class_vector2>` position=Vector2( 0, 0 )  **)** const                                                                                                   |
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`Vector2<class_vector2>`    | :ref:`get_custom_minimum_size<class_Control_get_custom_minimum_size>`  **(** **)** const                                                                                                                                             |
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`int<class_int>`            | :ref:`get_default_cursor_shape<class_Control_get_default_cursor_shape>`  **(** **)** const                                                                                                                                           |
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`Object<class_object>`      | :ref:`get_drag_data<class_Control_get_drag_data>`  **(** :ref:`Vector2<class_vector2>` pos  **)** virtual                                                                                                                            |
+| :ref:`Object<class_object>`      | :ref:`get_drag_data<class_Control_get_drag_data>`  **(** :ref:`Vector2<class_vector2>` position  **)** virtual                                                                                                                       |
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`Vector2<class_vector2>`    | :ref:`get_end<class_Control_get_end>`  **(** **)** const                                                                                                                                                                             |
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@@ -113,7 +114,7 @@ Member Functions
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`Theme<class_theme>`        | :ref:`get_theme<class_Control_get_theme>`  **(** **)** const                                                                                                                                                                         |
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| :ref:`String<class_string>`      | :ref:`get_tooltip<class_Control_get_tooltip>`  **(** :ref:`Vector2<class_vector2>` atpos=Vector2( 0, 0 )  **)** const                                                                                                                |
+| :ref:`String<class_string>`      | :ref:`get_tooltip<class_Control_get_tooltip>`  **(** :ref:`Vector2<class_vector2>` at_position=Vector2( 0, 0 )  **)** const                                                                                                          |
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | :ref:`int<class_int>`            | :ref:`get_v_grow_direction<class_Control_get_v_grow_direction>`  **(** **)** const                                                                                                                                                   |
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@@ -161,7 +162,7 @@ Member Functions
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | void                             | :ref:`set_area_as_parent_rect<class_Control_set_area_as_parent_rect>`  **(** :ref:`int<class_int>` margin=0  **)**                                                                                                                   |
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                             | :ref:`set_begin<class_Control_set_begin>`  **(** :ref:`Vector2<class_vector2>` pos  **)**                                                                                                                                            |
+| void                             | :ref:`set_begin<class_Control_set_begin>`  **(** :ref:`Vector2<class_vector2>` position  **)**                                                                                                                                       |
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | void                             | :ref:`set_clip_contents<class_Control_set_clip_contents>`  **(** :ref:`bool<class_bool>` enable  **)**                                                                                                                               |
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@@ -173,13 +174,13 @@ Member Functions
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | void                             | :ref:`set_drag_preview<class_Control_set_drag_preview>`  **(** :ref:`Control<class_control>` control  **)**                                                                                                                          |
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                             | :ref:`set_end<class_Control_set_end>`  **(** :ref:`Vector2<class_vector2>` pos  **)**                                                                                                                                                |
+| void                             | :ref:`set_end<class_Control_set_end>`  **(** :ref:`Vector2<class_vector2>` position  **)**                                                                                                                                           |
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | void                             | :ref:`set_focus_mode<class_Control_set_focus_mode>`  **(** :ref:`int<class_int>` mode  **)**                                                                                                                                         |
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | void                             | :ref:`set_focus_neighbour<class_Control_set_focus_neighbour>`  **(** :ref:`int<class_int>` margin, :ref:`NodePath<class_nodepath>` neighbour  **)**                                                                                  |
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                             | :ref:`set_global_position<class_Control_set_global_position>`  **(** :ref:`Vector2<class_vector2>` pos  **)**                                                                                                                        |
+| void                             | :ref:`set_global_position<class_Control_set_global_position>`  **(** :ref:`Vector2<class_vector2>` position  **)**                                                                                                                   |
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | void                             | :ref:`set_h_grow_direction<class_Control_set_h_grow_direction>`  **(** :ref:`int<class_int>` direction  **)**                                                                                                                        |
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@@ -191,7 +192,7 @@ Member Functions
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | void                             | :ref:`set_pivot_offset<class_Control_set_pivot_offset>`  **(** :ref:`Vector2<class_vector2>` pivot_offset  **)**                                                                                                                     |
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                             | :ref:`set_position<class_Control_set_position>`  **(** :ref:`Vector2<class_vector2>` pos  **)**                                                                                                                                      |
+| void                             | :ref:`set_position<class_Control_set_position>`  **(** :ref:`Vector2<class_vector2>` position  **)**                                                                                                                                 |
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | void                             | :ref:`set_rotation<class_Control_set_rotation>`  **(** :ref:`float<class_float>` radians  **)**                                                                                                                                      |
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
@@ -213,34 +214,34 @@ Member Functions
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 | void                             | :ref:`show_modal<class_Control_show_modal>`  **(** :ref:`bool<class_bool>` exclusive=false  **)**                                                                                                                                    |
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
-| void                             | :ref:`warp_mouse<class_Control_warp_mouse>`  **(** :ref:`Vector2<class_vector2>` to_pos  **)**                                                                                                                                       |
+| void                             | :ref:`warp_mouse<class_Control_warp_mouse>`  **(** :ref:`Vector2<class_vector2>` to_position  **)**                                                                                                                                  |
 +----------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
 
 Signals
 -------
 
 -  **focus_entered**  **(** **)**
-Emitted when keyboard focus is gained.
+Emitted when the node gains keyboard focus.
 
 -  **focus_exited**  **(** **)**
-Emitted when the keyboard focus is lost.
+Emitted when the node loses keyboard focus.
 
 -  **gui_input**  **(** :ref:`Object<class_object>` ev  **)**
 -  **minimum_size_changed**  **(** **)**
-Emitted when the minimum size of the control changed.
+Emitted when the node's minimum size changes.
 
 -  **modal_closed**  **(** **)**
 -  **mouse_entered**  **(** **)**
-Emitted when the mouse enters the control area.
+Emitted when the mouse enters the control's area.
 
 -  **mouse_exited**  **(** **)**
-Emitted when the mouse left the control area.
+Emitted when the mouse leaves the control's area.
 
 -  **resized**  **(** **)**
-Emitted when the control changed size.
+Emitted when the control changes size.
 
 -  **size_flags_changed**  **(** **)**
-Emitted when the size flags changed.
+Emitted when the size flags change.
 
 
 Member Variables
@@ -336,19 +337,19 @@ Numeric Constants
 Description
 -----------
 
-Control is the base class Node for all the GUI components. Every GUI component inherits from it, directly or indirectly. In this way, sections of the scene tree made of contiguous control nodes, become user interfaces.
+The base class Node for all User Interface components. Every UI node inherits from it. Any scene or portion of a scene tree composed of Control nodes is a User Interface.
 
-Controls are relative to the parent position and size by using anchors and margins. This ensures that they can adapt easily in most situation to changing dialog and screen sizes. When more flexibility is desired, :ref:`Container<class_container>` derived nodes can be used.
+Controls use anchors and margins to place themselves relative to their parent. They adapt automatically when their parent or the screen size changes. To build flexible UIs, use built-in :ref:`Container<class_container>` nodes or create your own.
 
 Anchors work by defining which margin do they follow, and a value relative to it. Allowed anchoring modes are ANCHOR_BEGIN, where the margin is relative to the top or left margins of the parent (in pixels), ANCHOR_END for the right and bottom margins of the parent and ANCHOR_RATIO, which is a ratio from 0 to 1 in the parent range.
 
-Input device events are first sent to the root controls via the :ref:`Node._input<class_Node__input>`, which distribute it through the tree, then delivers them to the adequate one (under cursor or keyboard focus based) by calling :ref:`MainLoop._input_event<class_MainLoop__input_event>`. There is no need to enable input processing on controls to receive such events. To ensure that no one else will receive the event (not even :ref:`Node._unhandled_input<class_Node__unhandled_input>`), the control can accept it by calling :ref:`accept_event<class_Control_accept_event>`.
+Godot sends Input events to the root node first, via :ref:`Node._input<class_Node__input>`. The method distributes it through the node tree and delivers the input events to the node under the mouse cursor or on focus with the keyboard. To do so, it calls :ref:`MainLoop._input_event<class_MainLoop__input_event>`. No need to enable :ref:`Node.set_process_input<class_Node_set_process_input>` on Controls to receive input events. Call :ref:`accept_event<class_Control_accept_event>` to ensure no other node receives the event, not even :ref:`Node._unhandled_input<class_Node__unhandled_input>`.
 
-Only one control can hold the keyboard focus (receiving keyboard events), for that the control must define the focus mode with :ref:`set_focus_mode<class_Control_set_focus_mode>`. Focus is lost when another control gains it, or the current focus owner is hidden.
+Only the one Control node in focus receives keyboard events. To do so, the Control must get the focus mode with :ref:`set_focus_mode<class_Control_set_focus_mode>`. It loses focus when another Control gets it, or if the current Control in focus is hidden.
 
-It is sometimes desired for a control to ignore mouse/pointer events. This is often the case when placing other controls on top of a button, in such cases. Calling :ref:`set_ignore_mouse<class_Control_set_ignore_mouse>` enables this function.
+You'll sometimes want Controls to ignore mouse or touch events. For example, if you place an icon on top of a button. Call :ref:`set_ignore_mouse<class_Control_set_ignore_mouse>` for that.
 
-Finally, controls are skinned according to a :ref:`Theme<class_theme>`. Setting a :ref:`Theme<class_theme>` on a control will propagate all the skinning down the tree. Optionally, skinning can be overridden per each control by calling the add\_\*_override functions, or from the editor.
+:ref:`Theme<class_theme>` resources change the Control's appearance. If you change the :ref:`Theme<class_theme>` on a parent Control node, it will propagate to all of its children. You can override parts of the theme on each Control with the add\_\*_override methods, like :ref:`add_font_override<class_Control_add_font_override>`. You can also override the theme from the editor.
 
 Member Function Description
 ---------------------------
@@ -357,7 +358,7 @@ Member Function Description
 
 - :ref:`Vector2<class_vector2>`  **_get_minimum_size**  **(** **)** virtual
 
-Return the minimum size this Control can shrink to. A control will never be displayed or resized smaller than its minimum size.
+Returns the minimum size this Control can shrink to. A control will never be displayed or resized smaller than its minimum size.
 
 .. _class_Control__gui_input:
 
@@ -367,7 +368,7 @@ Return the minimum size this Control can shrink to. A control will never be disp
 
 - void  **accept_event**  **(** **)**
 
-Handles the event, no other control will receive it and it will not be sent to nodes waiting on :ref:`Node._unhandled_input<class_Node__unhandled_input>` or :ref:`Node._unhandled_key_input<class_Node__unhandled_key_input>`.
+Marks the input event as handled. No other Control will receive it, and the input event will not propagate. Not even to nodes listening to :ref:`Node._unhandled_input<class_Node__unhandled_input>` or :ref:`Node._unhandled_key_input<class_Node__unhandled_key_input>`.
 
 .. _class_Control_add_color_override:
 
@@ -403,11 +404,11 @@ Override a single stylebox (Stylebox) in the theme of this Control. If stylebox
 
 .. _class_Control_can_drop_data:
 
-- :ref:`bool<class_bool>`  **can_drop_data**  **(** :ref:`Vector2<class_vector2>` pos, :ref:`Variant<class_variant>` data  **)** virtual
+- :ref:`bool<class_bool>`  **can_drop_data**  **(** :ref:`Vector2<class_vector2>` position, :ref:`Variant<class_variant>` data  **)** virtual
 
 .. _class_Control_drop_data:
 
-- void  **drop_data**  **(** :ref:`Vector2<class_vector2>` pos, :ref:`Variant<class_variant>` data  **)** virtual
+- void  **drop_data**  **(** :ref:`Vector2<class_vector2>` position, :ref:`Variant<class_variant>` data  **)** virtual
 
 .. _class_Control_force_drag:
 
@@ -437,7 +438,7 @@ Return the anchor type (ANCHOR_BEGIN, ANCHOR_END, ANCHOR_RATIO) for a given marg
 
 .. _class_Control_get_cursor_shape:
 
-- :ref:`int<class_int>`  **get_cursor_shape**  **(** :ref:`Vector2<class_vector2>` pos=Vector2( 0, 0 )  **)** const
+- :ref:`int<class_int>`  **get_cursor_shape**  **(** :ref:`Vector2<class_vector2>` position=Vector2( 0, 0 )  **)** const
 
 Return the cursor shape at a certain position in the control.
 
@@ -453,7 +454,7 @@ Return the default cursor shape for this control. See enum CURSOR\_\* for the li
 
 .. _class_Control_get_drag_data:
 
-- :ref:`Object<class_object>`  **get_drag_data**  **(** :ref:`Vector2<class_vector2>` pos  **)** virtual
+- :ref:`Object<class_object>`  **get_drag_data**  **(** :ref:`Vector2<class_vector2>` position  **)** virtual
 
 .. _class_Control_get_end:
 
@@ -591,7 +592,7 @@ Return a :ref:`Theme<class_theme>` override, if one exists (see :ref:`set_theme<
 
 .. _class_Control_get_tooltip:
 
-- :ref:`String<class_string>`  **get_tooltip**  **(** :ref:`Vector2<class_vector2>` atpos=Vector2( 0, 0 )  **)** const
+- :ref:`String<class_string>`  **get_tooltip**  **(** :ref:`Vector2<class_vector2>` at_position=Vector2( 0, 0 )  **)** const
 
 Return the tooltip, which will appear when the cursor is resting over this control.
 
@@ -699,7 +700,7 @@ Change all margins and anchors, so this Control always takes up the same area as
 
 .. _class_Control_set_begin:
 
-- void  **set_begin**  **(** :ref:`Vector2<class_vector2>` pos  **)**
+- void  **set_begin**  **(** :ref:`Vector2<class_vector2>` position  **)**
 
 Sets MARGIN_LEFT and MARGIN_TOP at the same time. This is a helper (see :ref:`set_margin<class_Control_set_margin>`).
 
@@ -727,7 +728,7 @@ Set the default cursor shape for this control. See enum CURSOR\_\* for the list
 
 .. _class_Control_set_end:
 
-- void  **set_end**  **(** :ref:`Vector2<class_vector2>` pos  **)**
+- void  **set_end**  **(** :ref:`Vector2<class_vector2>` position  **)**
 
 Sets MARGIN_RIGHT and MARGIN_BOTTOM at the same time. This is a helper (see :ref:`set_margin<class_Control_set_margin>`).
 
@@ -745,7 +746,7 @@ Force a neighbour for moving the input focus to. When pressing TAB or directiona
 
 .. _class_Control_set_global_position:
 
-- void  **set_global_position**  **(** :ref:`Vector2<class_vector2>` pos  **)**
+- void  **set_global_position**  **(** :ref:`Vector2<class_vector2>` position  **)**
 
 Move the Control to a new position, relative to the top-left corner of the *window* Control, and without changing current anchor mode. (see :ref:`set_margin<class_Control_set_margin>`).
 
@@ -777,7 +778,7 @@ Set when the control is ignoring mouse events (even touchpad events send mouse e
 
 .. _class_Control_set_position:
 
-- void  **set_position**  **(** :ref:`Vector2<class_vector2>` pos  **)**
+- void  **set_position**  **(** :ref:`Vector2<class_vector2>` position  **)**
 
 Move the Control to a new position, relative to the top-left corner of the parent Control, changing all margins if needed and without changing current anchor mode. This is a helper (see :ref:`set_margin<class_Control_set_margin>`).
 
@@ -839,6 +840,6 @@ Display a Control as modal. Control must be a subwindow. Modal controls capture
 
 .. _class_Control_warp_mouse:
 
-- void  **warp_mouse**  **(** :ref:`Vector2<class_vector2>` to_pos  **)**
+- void  **warp_mouse**  **(** :ref:`Vector2<class_vector2>` to_position  **)**