Commit Graph

270 Commits

Author SHA1 Message Date
Max Hilbrunner
0464ade11c Merge pull request #6761 from Piralein/warnings
Update Invalid References
2023-02-12 18:34:53 +01:00
Raul Santos
62266a1634 Update C# exports documentation (#6746)
* Update C# exports documentation

- Node exports are supported in 4.0.
- Add documentation about exporting enums (and flag enums).
- Add more documentation about exporting collections.
- Changes to follow our style guide more closely.

---------

Co-authored-by: Hana <48352564+Piralein@users.noreply.github.com>
2023-02-12 18:31:38 +01:00
Hana
64476d96b4 update references 2023-02-10 19:13:03 +01:00
Max Hilbrunner
bbe291af42 Merge pull request #6750 from Calinou/gdscript-basics-unicode-identifiers
Document Unicode identifiers now being supported in GDScript reference
2023-02-09 10:12:32 +01:00
huulong
e7fbd0e136 Fix gdscript_exports @export_node_path example by adding quotes around class names to pass strings 2023-02-08 20:24:28 +01:00
Hugo Locurcio
0c9ac1fc42 Document Unicode identifiers now being supported in GDScript reference 2023-02-08 19:06:55 +01:00
Raul Santos
5010fa0d17 Add missing differences to C# documentation (#6739)
* Add missing differences to C# documentation

- Add `NodePath` section.
- Add `RID` section.
- Update `Transform2D` section.
- Add `Transform3D` section.
- Add `Rect2i` section.
- Add `AABB` section.
- Add `Projection` section.

---------

Co-authored-by: Paul Joannon <437025+paulloz@users.noreply.github.com>
2023-02-08 12:44:20 +01:00
Aaron Franke
370f936922 GDScript style guide: Improve type inference section (#6661) 2023-02-05 16:33:38 +03:00
31
8a9729d900 Add C# type test example (pattern matching) (#6732)
* Add C# type test example (pattern matching)
* Connect section to "is" section, put "advanced" note back
2023-02-05 16:22:07 +03:00
Jonathan Deiss
bec737cb75 Update gdscript_styleguide.rst (#6379)
Adds two changes:
- makes it clear where subclasses should go (at the bottom of the script)
- put the `_enter_tree()` method before `_ready()` but after `_init()` since that's the order in which the methods are executed
2023-02-05 16:19:27 +03:00
31
e155194384 C#: Replace "falsy" with "false" in C# "is" doc (#6733) 2023-02-05 16:08:39 +03:00
31
ec045a4342 Lowercase titles for C# exports and signals pages 2023-02-04 16:08:57 -08:00
Danil Alexeev
aa271f3aab Clarify @export_enum docs (#6704) 2023-02-04 23:13:33 +03:00
Raul Santos
7c014cfce6 Document Signal and Callable types in C# differences page (#6722) 2023-02-04 21:29:09 +03:00
Yuri Sizov
39ba707179 Merge pull request #6730 from raulsntos/dotnet/variant
Add a dedicated page about the C# Variant type
2023-02-04 20:37:54 +03:00
Raul Santos
1a118aed3a Apply suggestions from code review
Co-authored-by: Max Hilbrunner <mhilbrunner@users.noreply.github.com>
2023-02-04 18:08:54 +01:00
Raul Santos
e9389ccbe6 Add a dedicated page about the C# Variant type 2023-02-04 18:08:22 +01:00
Yuri Sizov
6d5adf61a8 Merge pull request #6677 from raulsntos/dotnet/array-docs
C#: Add table with equivalent Array methods
2023-02-04 19:56:16 +03:00
Raul Santos
84d7a0f8d8 C#: Add table with equivalent Array methods 2023-02-04 17:49:11 +01:00
Raul Santos
d7f4e6b607 C#: Add table with equivalent GlobalScope methods 2023-02-04 17:07:39 +01:00
Raul Santos
b319da3f07 Update some C# examples for 4.0 (#6693)
* Update some C# examples

- Rename members that have been renamed in Godot's C# API for 4.0.
- Change `delta` parameter type to `double`.
- Ensure parameters match base declaration.
- Other minor code fixes.

---------

Co-authored-by: Paul Joannon <437025+paulloz@users.noreply.github.com>
2023-02-04 17:03:03 +01:00
notPelf
beb5f02422 Clarify ternary operator in the style guide
In the current style guide, the example for ternary operators includes a "not" in the conditional which is the same text color as the preceding "if" giving the impression that the format for a ternary operation is "[some_value] if not [condition] else [other_value]" which is incorrect, and may be confusing to figure out. I'm new to Godot and I've never used python (which I understand GDScript is based on). My only experience is with c# which I don't believe has a "not" keyword so I was quite confused by this.

This change would remove "not" from the condition to eliminate confusion, and rearrange the values to keep the meaning of the example code the same. Any alternative that removes the "not" would also work.
2023-02-01 18:41:48 -05:00
Paul Joannon
ebdd928c06 C# signal delegates must be public 2023-01-30 10:27:03 +01:00
Matthew
e37fcde0af Merge pull request #6691 from paulloz/csharp/cs1612-and-basics-page-updates
Updates to C# basics (prerequisites / setup + start common errors section)
2023-01-28 18:20:14 -05:00
Paul Joannon
16d09985cd Updates to C# basics + explain CS1612
- Replace mentions to Mono with mentions to .NET 6
- Update prerequisites / setup instructions
- Update 'attach script' image
- Fix code guidelines
- Add a 'common errors' section with an explanation about CS1612
2023-01-28 22:37:44 +01:00
Yuri Sizov
da6dad7b18 Merge pull request #6678 from raulsntos/dotnet/quaternion-docs
C#: Remove outdated Quaternion documentation
2023-01-28 23:51:29 +03:00
Raul Santos
db63931309 C#: Add table with equivalent Dictionary methods (#6676) 2023-01-28 23:45:41 +03:00
Raul Santos
831dc13e1f C#: Remove outdated Quaternion documentation 2023-01-28 21:43:45 +01:00
Mach565
d089a504e9 Continue no longer works in a match statement (#6674) 2023-01-28 23:33:30 +03:00
Yuri Sizov
e2df72255a Merge pull request #6680 from raulsntos/dotnet/plane-docs
C#: Remove Plane section from C# differences page
2023-01-28 22:45:21 +03:00
Raul Santos
17ca353ae6 Add Color section to C# differences page 2023-01-28 18:43:29 +01:00
Raul Santos
55dd91b1e6 Update some of the C# documentation for 4.0 (#6681)
* Update C# documentation for 4.0

---------

Co-authored-by: Yuri Sizov <11782833+YuriSizov@users.noreply.github.com>
2023-01-28 01:17:38 +01:00
Raul Santos
ebd89d2569 C#: Add TOOLS define and remove custom features
- The `TOOLS` define wasn't documented anywhere.
- Add `GODOT_REAL_T_IS_DOUBLE` define to the list.
- Custom features as defines were removed and are no longer added.
2023-01-27 18:14:11 +01:00
Raul Santos
171cfc9a85 C#: Remove Plane section from C# differences page 2023-01-27 03:16:33 +01:00
mara
2b271ba33e tutorials/scripting: Mention % literal syntax
It was unclear to me what that '%' literal syntax does, add
examples in the appropriate places.
2023-01-25 20:16:48 +01:00
Max Hilbrunner
0c18a7cb67 Merge pull request #6643 from paulloz/csharp/signals
Create a dedicated "C# Signals" page
2023-01-23 19:22:15 +01:00
BlueStag
135ad68cab Use 4.0 method of connecting to and emitting signals (#6311)
Change docs to use the new method of connecting and emitting signals
2023-01-22 22:01:34 -05:00
Paul Joannon
3347df2edb Create a dedicated "C# Signals" page 2023-01-22 17:37:29 +01:00
Max Hilbrunner
7b21d5c293 GDScript basics: expand upon continue explanation (#6650)
Co-authored-by: DavidVereb <davidvereb@users.noreply.github.com>
2023-01-22 17:19:56 +01:00
Vince Nguyen
c8f45094b5 Removed outdated documentation 2023-01-21 21:24:51 -08:00
Matthew
eb25278373 Merge pull request #6534 from thiagola92/single_quote
Update string literal example
2023-01-18 21:09:26 -05:00
Matthew
55ca145bcd Merge pull request #6628 from adamscott/move-icon-to-top
Update icon annotation references in the documentation
2023-01-18 21:02:37 -05:00
Pedro Pais
232f359d05 Update Pause Mode documentation (#6624)
changed reference to "process" pause mode to "when paused"
2023-01-18 19:58:20 -05:00
Adam Scott
9ab272f94b Update icon annotation references in the documentation 2023-01-18 08:12:59 -05:00
Matthew
ad31850c36 Merge pull request #6617 from jmdejong/patch-6
link to appropriate Object._get() and Object._set() sections
2023-01-17 20:14:41 -05:00
DeadlyEssence01
9bc011a1df Fix C# ChangeScene Method Name in Scene Tree tutorial. 2023-01-16 21:02:22 -05:00
Paul Joannon
d70bc1b691 Document export grouping in C# (#6621)
Co-authored-by: Hugo Locurcio <hugo.locurcio@hugo.pro>
2023-01-17 02:45:47 +01:00
J.M. de Jong
6485c97491 link to appropriate Object._get() and Object._set() sections 2023-01-15 11:12:30 +01:00
Anthony Cossins
f994d270f8 Update references to Color constants for Godot 4 (#6602) 2023-01-14 00:19:09 +01:00
Paul Joannon
ac22d6e537 Update & fix C# blocks under tutorials/scripting/
- `_Process` and `_PhysicsProcess` take their delta argument as a `double`
- Use string interpolation instead of concatenating strings
- Use `string` instead of `String` (`using System` was removed from everywhere in a previous PR)
- Use `System.Array.Empty<T>()` to init empty arrays
- Use `SignalName.*` instead of `nameof(*)` for signals
- Do not use `event` as an argument name (that's a keyword)
- Match node paths to screenshots when retrieving nodes from the tree
- Add a C# example for scene unique nodes
- Update the "Cross language scripting" page
- Add a note about using `is` against `null`
2023-01-13 20:41:23 +01:00