Hugo Locurcio
fe2f24c47c
Improve the documentation for ease()
and smoothstep()
...
This adds a cheatsheet for `ease()` and a comparison graph for
`smoothstep()`, among other things.
(cherry picked from commit 567b6436c9
)
2021-10-01 08:04:20 +02:00
Rémi Verschelde
f0b37b1519
doc: Point URLs to 3.4 version of the online docs
2021-08-12 17:08:10 +02:00
Rémi Verschelde
f5836b40d4
doc: Use self-closing tags for return
and argument
...
For the time being we don't support writing a description for those, preferring
having all details in the method's description.
Using self-closing tags saves half the lines, and prevents contributors from
thinking that they should write the argument or return documentation there.
(cherry picked from commit 7adf4cc9b5
)
2021-08-03 10:20:19 +02:00
Hugo Locurcio
069281d58f
Improve documentation for GDScript constants
...
(cherry picked from commit 8ff8c1e5f8
)
2021-07-24 00:59:35 +02:00
Rémi Verschelde
c3272997cd
doc: Update classref headers with 3.4 version
2021-04-26 13:15:29 +02:00
Rémi Verschelde
ed44e2806f
doc: Fix markup issues in classref
2021-04-07 11:52:44 +02:00
Rémi Verschelde
015973df04
doc: Make all tutorial links point to 3.3 branch of docs
2021-03-26 10:43:43 +01:00
Paul Joannon
596169d7df
class reference proofreading
...
(cherry picked from commit 8455e901f3
)
2021-03-26 09:49:07 +01:00
Rémi Verschelde
1aba997d75
doc: Sync classref with 3.3 version bump
2021-03-23 13:40:34 +01:00
Hugo Locurcio
ee8661158c
Document the valid input range for acos()
and atan()
...
(cherry picked from commit d359e159da
)
2021-03-16 11:37:26 +01:00
Angad Kambli
327586f582
fix minor issue in smooth step function's documentation
...
(cherry picked from commit 892060fa47
)
2021-02-22 14:16:42 +01:00
Meriipu
347a9df0a1
GDScript: Clarified/fixed inaccuracies in the built-in function docs.
...
The input to smoothstep is not actually a weight, and the decscription
of smoothstep was pretty hard to understand and easy to misinterpret.
Clarified what it means to be approximately equal.
nearest_po2 does not do what the descriptions says it does. For one,
it returns the same power if the input is a power of 2. Second, it
returns 0 if the input is negative or 0, while the smallest possible
integral power of 2 actually is 1 (2^0 = 1). Due to the implementation
and how it is used in a lot of places, it does not seem wise to change
such a core function however, and I decided it is better to alter the
description of the built-in.
Added a few examples/clarifications/edge-cases.
(cherry picked from commit 7f9bfee0ac
)
2021-02-11 13:12:06 +01:00
Rémi Verschelde
3d31433229
doc: Remove links to RNG tutorial, not yet in 3.2 branch
2021-01-07 14:33:36 +01:00
LoipesMas
0fc433d046
More explicit wording for str() and print() functions
...
(cherry picked from commit 9c65927aeb
)
2021-01-05 21:33:34 +01:00
skyace65
e072b3db82
Pow method doc fix
...
(cherry picked from commit 4fd20015f3
)
2020-12-29 16:01:59 +01:00
Danil Alexeev
6c3a0e3a5a
Several edits to the GDScript docs
...
(cherry picked from commit bf96056ad0
)
2020-12-09 11:22:03 +01:00
Hugo Locurcio
913afd843b
Clarify that code in assert()
should avoid side effects
...
(cherry picked from commit d6c7073bd7
)
2020-11-11 15:44:18 +01:00
Rémi Verschelde
4287af5148
doc: Make docs.godotengine.org links point to 3.2 branch
2020-10-19 16:10:01 +02:00
Hugo Locurcio
8d445f3f9f
Link the Random number generation tutorial in the class reference
...
(cherry picked from commit 802c1e4df1
)
2020-10-19 16:10:00 +02:00
Serhat
09a8dd7b3b
Fixed padding bug of sprintf function
...
(cherry picked from commit 9f2cdfea82
)
2020-10-04 20:51:58 +02:00
Andrii Doroshenko (Xrayez)
1a71792655
Cross-reference GDScript load
and ResourceLoader.load
in classref
...
The GDScript `load` mention is moved from the class `ResourceLoader`
description to the `ResourceLoader.load` method description instead,
where it is more likely to be found.
(cherry picked from commit a8404cf56c
)
2020-10-04 20:51:40 +02:00
Hugo Locurcio
880ab559ec
Improve documentation related to printing error/warning messages
...
(cherry picked from commit 50f3a8e312
)
2020-09-29 08:54:45 +02:00
Danil Alexeev
06f3cd8bd8
Several documentation improvements
...
(cherry picked from commit a4c5790350
)
2020-09-15 19:26:40 +02:00
Hugo Locurcio
afef89014b
Cross-reference GDScript built-in rounding methods to ease discovery
...
This closes #19315 .
(cherry picked from commit 20d0f5bbd7
)
2020-08-31 15:29:42 +02:00
Hugo Locurcio
fc7451204e
Improve JSON-related documentation
...
This closes https://github.com/godotengine/godot-docs/issues/3848 .
(cherry picked from commit 930e10ffff
)
2020-07-31 13:09:21 +02:00
Rémi Verschelde
6d2f8dd827
doc: Sync classref with current source
2020-07-30 16:26:45 +02:00
Aaron Franke
3ab5183ffa
[3.2] Backport core documentation changes to 3.2
...
Also add AABB.abs()
2020-07-21 21:22:54 -04:00
Tomasz Chabora
5b7eb3fd3f
Improve the preload and load descriptions
...
(cherry picked from commit 13298ed873
)
2020-06-29 10:58:25 +02:00
Rémi Verschelde
253fc093b8
DocData: Skip unexposed classes
...
Properly expose classes that we actually want accessible.
(cherry picked from commit 0ef8bcac4d
)
2020-04-21 14:15:34 +02:00
Thomas ten Cate
c2469d0c6d
Add missing docs for assert message in GDScript
...
Seems like this was overlooked in PR #31142 . See also issue #17082 .
(cherry picked from commit 4c3c73ef9c
)
2020-04-06 18:17:59 +02:00
Hugo Locurcio
d679edfa7f
Add a practical example for @GDScript.linear2db()
...
One of its most common applications in games is for volume sliders.
See https://www.dr-lex.be/info-stuff/volumecontrols.html for
more information.
(cherry picked from commit a6fd6b78dd
)
2020-03-04 12:40:14 +01:00
Hugo Locurcio
21a45dda7a
Improve the @GDScript.inverse_lerp()
documentation
...
This closes https://github.com/godotengine/godot-docs/issues/2589 .
(cherry picked from commit 6b5573700b
)
2020-03-04 12:40:14 +01:00
Rémi Verschelde
4cee1cda5e
Merge pull request #35589 from akien-mga/doc-drop-category-property
...
doc: Drop unused 'category' property from header
2020-01-26 16:34:13 +01:00
Rémi Verschelde
09ced94dd4
doc: Do not expose Variant::NIL as a type in the class reference
...
Fix signals Variant arguments incorrectly listed as Nil.
Fixes #12520 .
2020-01-26 16:08:11 +01:00
Rémi Verschelde
2d20fc39aa
doc: Drop unused 'category' property from header
...
We already removed it from the online docs with #35132 .
Currently it can only be "Built-In Types" (Variant types) or "Core"
(everything else), which is of limited use.
We might also want to consider dropping it from `ClassDB` altogether
in Godot 4.0.
2020-01-26 16:02:39 +01:00
Rémi Verschelde
cbdbfb00ca
doc: Document named color constants
...
Busywork but it's good for our completion rate :)
2020-01-26 12:08:16 +01:00
Rémi Verschelde
74977277fa
Merge pull request #34280 from zaksnet/fix-yield-documentation
...
Fix documentation for yield
2019-12-16 08:49:32 +01:00
Haoyu Qiu
468fcd80bb
Updates docs for GDScript built-in functions
...
* Adds description for `ord()`
* Adds relationship description between `char()` and `ord()`
* Describes the argument of `char()` as Unicode code point instead of ASCII code
* Fixes wrong interval notation in `randi()` description
2019-12-15 19:06:29 +08:00
Zak
0fd7186971
Fix documentation for yield
...
#33872 PR was misleading as i though inheritance from GDScriptFunctionState was optional.
2019-12-13 11:17:12 +02:00
Michael Alexsander
6cc3bb2d9b
Add note in 'load()' docs that the path must be absolute
2019-12-11 17:14:58 -03:00
Rémi Verschelde
4eff13d768
doc: Markup fixes for enums and constants
2019-12-06 23:09:20 +01:00
Hugo Locurcio
1fcdeaee39
Mention that int()
can be used as an alternative to floor()
2019-12-03 08:43:24 +01:00
Aaron Franke
3231fca934
Add docs for is_equal_approx on structures
2019-11-30 16:52:27 -05:00
miere43
d747c61187
Fixed typo in docs for Script and GDScript classes ("exends" -> "extends")
2019-11-30 21:16:11 +03:00
Hugo Locurcio
4f14a1f59c
Remove type hint from the @GDScript class documentation
...
The current consensus in the Godot documentation is to avoid using
type hints unless they're relevant to the behavior explained.
2019-11-26 19:13:55 +01:00
Zak Stam
5cfff77ca6
Added missing documentation for yield()
...
Added some missing documentation about yield() being able to wait for a function also. I cant believe something like that was missing from the docs, it would have saved me so much time (and others i assume).
2019-11-25 18:08:18 +02:00
Rémi Verschelde
91518defa5
Merge pull request #33257 from aaronfranke/printraw
...
Document behavior of GDScript printraw
2019-11-07 13:21:09 +01:00
Aaron Franke
c4e46b8800
Document behavior of printraw
2019-11-02 04:55:39 -04:00
Aaron Franke
b67f252016
Fix Color8 GDScript documentation
2019-11-02 04:48:08 -04:00
Yeongho Kim
d4a55fb639
Print errors when tab indent found in [codeblock]
2019-10-01 23:39:45 +09:00