GDScript documentation comments: description tooltips are omitted when applied to @export variables with multiline arguments, as well as @export_category

[Yerdun]

Godot version

4.1.rc2.mono.official

System information

Godot v4.1.rc2.mono - EndeavourOS #1 SMP PREEMPT_DYNAMIC Thu, 11 May 2023 16:40:42 +0000 - Vulkan (Forward+) - integrated Intel(R) HD Graphics 4400 (HSW GT2) () - Intel(R) Core(TM) i7-4500U CPU @ 1.80GHz (4 Threads)

Issue description

When using GDScript documentation comments to create description tooltips for @export variables, they do not show up in the editor if:

• The export variable requires arguments (eg. @export_enum), and the arguments are declared across more than 2 lines. (recommended by GDScript style guide)
• A description is applied to an @export_category.
  • This error also applies to all variables within the category

To illustrate, here are some screenshots from the included minimal reproduction project.

Steps to reproduce

Copy-paste this code into a new node's script. A minimal reproduction project with all this prepared is included below for convenience.

extends Node


## This shows up in the editor.
@export_enum("example1", "example2",) var good_enum


## [i]This shows up in the editor, but goes against recommended practices.[/i]
@export_enum(
	"example1", "example2",) var poor_practice_multiline


## THIS DOES NOT SHOW UP IN THE EDITOR.
@export_enum(
	"example1",
	"example2",
) var bad_enum

## THIS DOES NOT SHOW UP IN THE EDITOR.
@export_category("Categories truncate comments")

## THIS DOES NOT SHOW UP IN THE EDITOR.
@export var bad: int

Minimal reproduction project

tooltip-bug.zip

[akien-mga]

Confirmed reproducible with the MRP.

[LinqLover]

Description tooltips are also missing when the variable is exported by overriding _get_property_list instead of using @export.

Edit: No, I was wrong. Seems like descriptions are only updated after reloading the project?

[louis-vinchon]

While it apparently has been fixed when exactly one @export_category() is used, it is still broken when multiple are in use; all descriptions disappear as soon as you have two.

v4.2.1.stable.official [b09f793]

[TechnoLukas]

@louis-vinchon It also depends on placement of @export_category(). I described it here => #64432 (comment)

[dalexeev]

@louis-vinchon See #88318. For the future, feel free to open a new issue instead of commenting on a closed old one.