docs - first chunk of work documenting the files I glossed over (#2130)

- started documenting the files I glossed over, some are totally done,
others are just partially done
- I changed the decompiler to automatically initialize the
art-group-info from the json file. This makes updating gsrc, even a
single file at a time, have consistent naming
- Though I disabled this functionality for jak 1, as I have no idea if
using the ntsc art groups will cause a regression for different versions
- fix indentation for docstrings -- it still doesn't look great, but
this is now a formatting concern, rather than the docstring having a
bunch of happen-stance leading whitespace.

decompiler/main.cpp

@@ -177,8 +177,7 @@ int main(int argc, char** argv) {
                          config.write_hex_near_instructions);
   }
 
-  // process art groups (used in decompilation)
-  if (config.decompile_code || config.process_art_groups) {
+  if (config.process_art_groups) {
     db.extract_art_info();
     // dumb art info to json if requested
     if (config.dump_art_group_info) {
@@ -188,6 +187,14 @@ int main(int argc, char** argv) {
       file_util::write_text_file(file_name, json.dump(-1));
       lg::info("[DUMP] Dumped art group info to {}", file_name.string());
     }
+  } else if (!config.art_group_info_dump.empty()) {
+    // process art groups (used in decompilation)
+    // - if the config has a path to the art info dump, just use that
+    // - otherwise (or if we want to dump it fresh) extract it
+    db.dts.art_group_info = config.art_group_info_dump;
+  } else {
+    lg::error("`process_art_groups` was false and no art-group-info dump was provided!");
+    return 1;
   }
 
   // main decompile.