add lua enum descriptions

Author: MjnMixael

code/scripting/api/objs/enums.cpp

@@ -292,6 +292,7 @@ struct enum_group_info {
 
 bool is_deprecated_enum_name(const char* enum_name);
 std::optional<enum_group_info> get_enum_group_info(const char* enum_name);
+const char* get_enum_description(const char* enum_name);
 
 
 struct enum_h {

code/scripting/api/objs/enums.h

@@ -622,7 +622,12 @@ void output_html_doc(const ScriptingDocumentation& doc, const SCP_string& filena
 		fprintf(fp, "<dd>%s</dd>", group_description.c_str());
 		fputs("<dd><dl>", fp);
 		for (const auto* enumeration : enum_groups[group_id]) {
-			fprintf(fp, "<dd><span style=\"font-size: 0.92em;\">%s</span></dd>", enumeration->name.c_str());
+			if (!enumeration->description.empty()) {
+				fprintf(fp, "<dd><span style=\"font-size: 0.92em;\"><b>%s</b> -; %s</span></dd>",
+					enumeration->name.c_str(), enumeration->description.c_str());
+			} else {
+				fprintf(fp, "<dd><span style=\"font-size: 0.92em;\"><b>%s</b></span></dd>", enumeration->name.c_str());
+			}
 		}
 		fputs("</dl></dd>", fp);
 	}

code/scripting/doc_html.cpp

@@ -626,6 +626,9 @@ void output_luastub_doc(const ScriptingDocumentation& doc, const SCP_string& fil
 			fputs("\n", fp);
 			fprintf(fp, "--- %s: %s\n", enumeration.group_title.c_str(), enumeration.group_description.c_str());
 		}
+		if (!enumeration.description.empty()) {
+			fprintf(fp, "--- %s\n", enumeration.description.c_str());
+		}
 		fprintf(fp, "--- @const %s\n", enumeration.name.c_str());
 		fprintf(fp, "%s = enumeration\n", enumeration.name.c_str());
 	}

code/scripting/doc_luastub.cpp

@@ -323,6 +323,10 @@ void script_state::OutputLuaDocumentation(ScriptingDocumentation& doc,
 			e.group_title = group->title;
 			e.group_description = group->description;
 		}
+		const char* desc = get_enum_description(Enumerations[i].name);
+		if (desc != nullptr) {
+			e.description = desc;
+		}
 
 		doc.enumerations.push_back(e);
 	}

code/scripting/lua.cpp

@@ -72,6 +72,7 @@ struct DocumentationEnum {
 	SCP_string group_id;
 	SCP_string group_title;
 	SCP_string group_description;
+	SCP_string description;
 };
 
 struct DocumentationOption {