godotengine
/
godot
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Documentation: Treat deprecated/experimental members as documented

This commit is contained in:
Danil Alexeev 2024-02-16 16:28:05 +03:00
parent a9bb8509f2
commit 12c86c6716
No known key found for this signature in database
GPG Key ID: 124453E157DA8DC7
3 changed files with 262 additions and 203 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
doc/tools/doc_status.py
View File

@ -279,13 +279,18 @@ class ClassStatus:
elif tag.tag in ["methods", "signals", "operators", "constructors"]: elif tag.tag in ["methods", "signals", "operators", "constructors"]:
for sub_tag in list(tag): for sub_tag in list(tag):
is_deprecated = "deprecated" in sub_tag.attrib
is_experimental = "experimental" in sub_tag.attrib
descr = sub_tag.find("description") descr = sub_tag.find("description")
increment = (descr is not None) and (descr.text is not None) and len(descr.text.strip()) > 0 has_descr = (descr is not None) and (descr.text is not None) and len(descr.text.strip()) > 0
status.progresses[tag.tag].increment(increment) status.progresses[tag.tag].increment(is_deprecated or is_experimental or has_descr)
elif tag.tag in ["constants", "members", "theme_items"]: elif tag.tag in ["constants", "members", "theme_items"]:
for sub_tag in list(tag): for sub_tag in list(tag):
if not sub_tag.text is None: if not sub_tag.text is None:
status.progresses[tag.tag].increment(len(sub_tag.text.strip()) > 0) is_deprecated = "deprecated" in sub_tag.attrib
is_experimental = "experimental" in sub_tag.attrib
has_descr = len(sub_tag.text.strip()) > 0
status.progresses[tag.tag].increment(is_deprecated or is_experimental or has_descr)
elif tag.tag in ["tutorials"]: elif tag.tag in ["tutorials"]:
pass # Ignore those tags for now pass # Ignore those tags for now

16
doc/tools/make_rst.py
View File

@ -1098,7 +1098,7 @@ def make_rst_class(class_def: ClassDef, state: State, dry_run: bool, output_dir:
if signal.description is not None and signal.description.strip() != "": if signal.description is not None and signal.description.strip() != "":
f.write(f"{format_text_block(signal.description.strip(), signal, state)}\n\n") f.write(f"{format_text_block(signal.description.strip(), signal, state)}\n\n")
else: elif signal.deprecated is None and signal.experimental is None:
f.write(".. container:: contribute\n\n\t") f.write(".. container:: contribute\n\n\t")
f.write( f.write(
translate( translate(
@ -1145,7 +1145,7 @@ def make_rst_class(class_def: ClassDef, state: State, dry_run: bool, output_dir:
if value.text is not None and value.text.strip() != "": if value.text is not None and value.text.strip() != "":
f.write(f"{format_text_block(value.text.strip(), value, state)}") f.write(f"{format_text_block(value.text.strip(), value, state)}")
else: elif value.deprecated is None and value.experimental is None:
f.write(".. container:: contribute\n\n\t") f.write(".. container:: contribute\n\n\t")
f.write( f.write(
translate( translate(
@ -1178,7 +1178,7 @@ def make_rst_class(class_def: ClassDef, state: State, dry_run: bool, output_dir:
if constant.text is not None and constant.text.strip() != "": if constant.text is not None and constant.text.strip() != "":
f.write(f"{format_text_block(constant.text.strip(), constant, state)}") f.write(f"{format_text_block(constant.text.strip(), constant, state)}")
else: elif constant.deprecated is None and constant.experimental is None:
f.write(".. container:: contribute\n\n\t") f.write(".. container:: contribute\n\n\t")
f.write( f.write(
translate( translate(
@ -1274,7 +1274,7 @@ def make_rst_class(class_def: ClassDef, state: State, dry_run: bool, output_dir:
if property_def.text is not None and property_def.text.strip() != "": if property_def.text is not None and property_def.text.strip() != "":
f.write(f"{format_text_block(property_def.text.strip(), property_def, state)}\n\n") f.write(f"{format_text_block(property_def.text.strip(), property_def, state)}\n\n")
else: elif property_def.deprecated is None and property_def.experimental is None:
f.write(".. container:: contribute\n\n\t") f.write(".. container:: contribute\n\n\t")
f.write( f.write(
translate( translate(
@ -1314,7 +1314,7 @@ def make_rst_class(class_def: ClassDef, state: State, dry_run: bool, output_dir:
if m.description is not None and m.description.strip() != "": if m.description is not None and m.description.strip() != "":
f.write(f"{format_text_block(m.description.strip(), m, state)}\n\n") f.write(f"{format_text_block(m.description.strip(), m, state)}\n\n")
else: elif m.deprecated is None and m.experimental is None:
f.write(".. container:: contribute\n\n\t") f.write(".. container:: contribute\n\n\t")
f.write( f.write(
translate( translate(
@ -1357,7 +1357,7 @@ def make_rst_class(class_def: ClassDef, state: State, dry_run: bool, output_dir:
if m.description is not None and m.description.strip() != "": if m.description is not None and m.description.strip() != "":
f.write(f"{format_text_block(m.description.strip(), m, state)}\n\n") f.write(f"{format_text_block(m.description.strip(), m, state)}\n\n")
else: elif m.deprecated is None and m.experimental is None:
f.write(".. container:: contribute\n\n\t") f.write(".. container:: contribute\n\n\t")
f.write( f.write(
translate( translate(
@ -1399,7 +1399,7 @@ def make_rst_class(class_def: ClassDef, state: State, dry_run: bool, output_dir:
if m.description is not None and m.description.strip() != "": if m.description is not None and m.description.strip() != "":
f.write(f"{format_text_block(m.description.strip(), m, state)}\n\n") f.write(f"{format_text_block(m.description.strip(), m, state)}\n\n")
else: elif m.deprecated is None and m.experimental is None:
f.write(".. container:: contribute\n\n\t") f.write(".. container:: contribute\n\n\t")
f.write( f.write(
translate( translate(
@ -1438,7 +1438,7 @@ def make_rst_class(class_def: ClassDef, state: State, dry_run: bool, output_dir:
if theme_item_def.text is not None and theme_item_def.text.strip() != "": if theme_item_def.text is not None and theme_item_def.text.strip() != "":
f.write(f"{format_text_block(theme_item_def.text.strip(), theme_item_def, state)}\n\n") f.write(f"{format_text_block(theme_item_def.text.strip(), theme_item_def, state)}\n\n")
else: elif theme_item_def.deprecated is None and theme_item_def.experimental is None:
f.write(".. container:: contribute\n\n\t") f.write(".. container:: contribute\n\n\t")
f.write( f.write(
translate( translate(

438
editor/editor_help.cpp
View File

File diff suppressed because it is too large Load Diff