Nixyri/godot
1
0
Fork 0
mirror of https://github.com/godotengine/godot.git synced 2024-11-22 12:12:28 +00:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

Hide private enums from documentation

Browse Source
This commit is contained in:
QuirkyLemon 2023-11-02 22:36:04 -05:00
parent 26b1fd0d84
commit a5a8f0a881
1 changed files with 29 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

47
editor/editor_help.cpp
View File

@ -1379,7 +1379,17 @@ void EditorHelp::_update_doc() {
} }
// Enums // Enums
if (enums.size()) { bool has_enums = enums.size() && !cd.is_script_doc;
if (enums.size() && !has_enums) {
for (KeyValue<String, DocData::EnumDoc> &E : cd.enums) {
if (E.key.begins_with("_") && E.value.description.strip_edges().is_empty()) {
continue;
}
has_enums = true;
break;
}
}
if (has_enums) {
section_line.push_back(Pair<String, int>(TTR("Enumerations"), class_desc->get_paragraph_count() - 2)); section_line.push_back(Pair<String, int>(TTR("Enumerations"), class_desc->get_paragraph_count() - 2));
_push_title_font(); _push_title_font();
class_desc->add_text(TTR("Enumerations")); class_desc->add_text(TTR("Enumerations"));
@ -1389,8 +1399,17 @@ void EditorHelp::_update_doc() {
class_desc->add_newline(); class_desc->add_newline();
for (KeyValue<String, Vector<DocData::ConstantDoc>> &E : enums) { for (KeyValue<String, Vector<DocData::ConstantDoc>> &E : enums) {
enum_line[E.key] = class_desc->get_paragraph_count() - 2; String key = E.key;
if ((key.get_slice_count(".") > 1) && (key.get_slice(".", 0) == edited_class)) {
key = key.get_slice(".", 1);
}
if (cd.enums.has(key)) {
if (cd.is_script_doc && cd.enums[key].description.strip_edges().is_empty() && E.key.begins_with("_")) {
continue;
}
}
enum_line[E.key] = class_desc->get_paragraph_count() - 2;
_push_code_font(); _push_code_font();
class_desc->push_color(theme_cache.title_color); class_desc->push_color(theme_cache.title_color);
@ -1401,27 +1420,19 @@ void EditorHelp::_update_doc() {
} }
class_desc->pop(); class_desc->pop();
String e = E.key;
if ((e.get_slice_count(".") > 1) && (e.get_slice(".", 0) == edited_class)) {
e = e.get_slice(".", 1);
}
class_desc->push_color(theme_cache.headline_color); class_desc->push_color(theme_cache.headline_color);
class_desc->add_text(e); class_desc->add_text(key);
class_desc->pop(); class_desc->pop();
class_desc->push_color(theme_cache.symbol_color); class_desc->push_color(theme_cache.symbol_color);
class_desc->add_text(":"); class_desc->add_text(":");
class_desc->pop(); class_desc->pop();
if (cd.enums.has(e)) { if (cd.enums[key].is_deprecated) {
if (cd.enums[e].is_deprecated) { DEPRECATED_DOC_TAG;
DEPRECATED_DOC_TAG; }
} if (cd.enums[key].is_experimental) {
EXPERIMENTAL_DOC_TAG;
if (cd.enums[e].is_experimental) {
EXPERIMENTAL_DOC_TAG;
}
} }
_pop_code_font(); _pop_code_font();
@ -1430,11 +1441,11 @@ void EditorHelp::_update_doc() {
class_desc->add_newline(); class_desc->add_newline();
// Enum description. // Enum description.
if (e != "@unnamed_enums" && cd.enums.has(e) && !cd.enums[e].description.strip_edges().is_empty()) { if (key != "@unnamed_enums" && cd.enums.has(key) && !cd.enums[key].description.strip_edges().is_empty()) {
class_desc->push_color(theme_cache.text_color); class_desc->push_color(theme_cache.text_color);
_push_normal_font(); _push_normal_font();
class_desc->push_indent(1); class_desc->push_indent(1);
_add_text(cd.enums[e].description); _add_text(cd.enums[key].description);
class_desc->pop(); class_desc->pop();
_pop_normal_font(); _pop_normal_font();
class_desc->pop(); class_desc->pop();