LegacyConsole/jpexs-decompiler
4
0
Fork 0
mirror of https://git.huckle.dev/Huckles-Minecraft-Archive/jpexs-decompiler.git synced 2026-06-19 05:41:55 +00:00
Code Issues Packages Projects Releases Wiki Activity

AS3 instruction documentation improvements

Browse Source 
Generate doc from commandline
HTML document with all AS3 instructions
This commit is contained in:
Jindra Petřík
2016-03-28 19:50:48 +02:00
parent 77b14abbea
commit 34d504434e
9 changed files with 491 additions and 66 deletions
Download Patch File Download Diff File Expand all files Collapse all files

94
src/com/jpexs/decompiler/flash/console/CommandLineArgumentParser.java
View File

@@ -45,6 +45,7 @@ import com.jpexs.decompiler.flash.action.parser.pcode.ASMParser;
import com.jpexs.decompiler.flash.action.parser.script.ActionScript2Parser;
import com.jpexs.decompiler.flash.configuration.Configuration;
import com.jpexs.decompiler.flash.configuration.ConfigurationItem;
import com.jpexs.decompiler.flash.docs.As3PCodeDocs;
import com.jpexs.decompiler.flash.exporters.BinaryDataExporter;
import com.jpexs.decompiler.flash.exporters.FontExporter;
import com.jpexs.decompiler.flash.exporters.FrameExporter;
@@ -163,6 +164,7 @@ import java.util.Arrays;
import java.util.Collections;
import java.util.HashMap;
import java.util.List;
import java.util.Locale;
import java.util.Map;
import java.util.Map.Entry;
import java.util.Stack;
@@ -501,6 +503,19 @@ public class CommandLineArgumentParser {
out.println(" ...Forwards all parameters after the -custom parameter to the plugins");
}
if (filter == null || filter.equals("doc")) {
out.println(" " + (cnt++) + ") -doc -type <type> [-out <outfile>] [-format <format>] [-locale <locale>]");
out.println(" ...Generate documentation");
out.println(" ...-type <type> Selects documentation type");
out.println(" ...<type> can be currently only: as3.pcode.instructions for list of ActionScript3 AVM2 instructions");
out.println(" ...-out <outfile> (optional) If specified, output is written to <outfile> instead of stdout");
out.println(" ...-format <format> (optional, html is default) Selects output format");
out.println(" ...<format> is currently only html");
out.println(" ...-locale <locale> (optional) Override default locale");
out.println(" ...<locale> is localization identifier, en for english for example");
out.println(" ...<format> is currently only html");
}
printCmdLineUsageExamples(out, filter);
}
@@ -562,6 +577,12 @@ public class CommandLineArgumentParser {
exampleFound = true;
}
if (filter == null || filter.equals("doc")) {
out.println("java -jar ffdec.jar -doc -type as3.pcode.instructions -format html");
out.println("java -jar ffdec.jar -doc -type as3.pcode.instructions -format html -locale en -out as3_docs_en.html");
exampleFound = true;
}
if (!exampleFound) {
out.println("Sorry, no example found for command " + filter + ", Let us know in issue tracker when you need it.");
}
@@ -734,6 +755,8 @@ public class CommandLineArgumentParser {
parseRemoveCharacter(args, false);
} else if (command.equals("removecharacterwithdependencies")) {
parseRemoveCharacter(args, true);
} else if (command.equals("doc")) {
parseDoc(args);
} else if (command.equals("importscript")) {
parseImportScript(args);
} else if (command.equals("importscript")) {
@@ -2535,6 +2558,77 @@ public class CommandLineArgumentParser {
}
}
private static void parseDoc(Stack<String> args) {
String type = null;
String format = null;
String out = null;
String locale = null;
while (!args.isEmpty()) {
String arg = args.pop();
switch (arg) {
case "-out":
if (args.isEmpty() || out != null) {
badArguments("doc");
}
out = arg;
break;
case "-type":
if (args.isEmpty() || type != null) {
badArguments("doc");
}
type = args.pop();
break;
case "-format":
if (args.isEmpty() || format != null) {
badArguments("doc");
}
format = args.pop();
break;
case "-locale":
if (args.isEmpty() || locale != null) {
badArguments("doc");
}
locale = args.pop();
break;
}
}
if (format == null) {
format = "html";
}
if (type == null) {
badArguments("doc");
} else if (!type.equals("as3.pcode.instructions")) {
badArguments("doc");
}
if (!format.equals("html")) {
badArguments("doc");
}
if (locale != null) {
Locale.setDefault(Locale.forLanguageTag(locale));
}
String doc = As3PCodeDocs.getAllInstructionDocs();
PrintStream outStream;
if (out == null) {
outStream = System.out;
} else {
try {
outStream = new PrintStream(out);
} catch (FileNotFoundException ex) {
Logger.getLogger(CommandLineArgumentParser.class.getName()).log(Level.SEVERE, ex.getLocalizedMessage());
System.exit(1);
return;
}
}
outStream.print(doc);
}
private static void parseRemoveCharacter(Stack<String> args, boolean removeDependencies) {
if (args.size() < 3) {
badArguments("removecharacter");