diff options
author | KuroiIeWa5Da <tyuki@adu.me> | 2012-01-28 06:57:52 -0600 |
---|---|---|
committer | KuroiIeWa5Da <tyuki@adu.me> | 2012-01-28 06:57:52 -0600 |
commit | ef7a524b81b3ef48a341fcc4ae31ca5f78ae3291 (patch) | |
tree | 05abb3c47e47a1cc9a43eb78568763f600ba554f | |
parent | 2a46c247d9548c26d782d2fc6bcc6f7bf04101c2 (diff) |
Updated Music Disassembler README.txt file with output of new help parameter
hg-commit-id: a890db386130
-rw-r--r-- | music/pokeredmusicdisasm/README.txt | 48 |
1 files changed, 26 insertions, 22 deletions
diff --git a/music/pokeredmusicdisasm/README.txt b/music/pokeredmusicdisasm/README.txt index 995f0e5f..c1c659eb 100644 --- a/music/pokeredmusicdisasm/README.txt +++ b/music/pokeredmusicdisasm/README.txt @@ -1,22 +1,26 @@ -to compile you must have g++ installed
-type: make
-and it will install to the extras folder
-
-if you want to unmake
-type: make clean
-and it will remove make objects and the executable
-
-the program usage is: pokeredmusicdisasm [<offset> [<file> | --] [--stop]
-offset is the rom offset in hexidecimal (FFFF or 0xFFFF)
-file is the rom file, you can use -- for "../baserom.gbc"
---stop is the hexidecimal stop number
-
-to make things quick and easy you can just enter the hexidecimal offset
-pokeredmusicdisasm <offset>
-
-to use the stop parameter you must use it as the 3rd argument as below
-pokeredmusicdisasm <offset> -- --stop=FFFF
-pokeredmusicdisasm <offset> <file> --stop=FFFF
-
-you may enter limited interactive mode by not supplying any arguments
-pokeredmusicdisasm
\ No newline at end of file +Usage: [<offset> [<file> | --]] +Usage: [--offset=<offset> | -o <offset>] [--file=[<file> | --] | -f [<file> | --]] [--stop=<offset> | -s <offset>] +Usage: [-h | --help] + +Used without parameters will start in limited interactive mode where the program will ask you the file and offset +An offset is a requirement but the file may be blank or explicitly set, whenever the file is set you may use '--' to substitute for the default file '../baserom.gbc' +If parameter options are not used the ordering is important: +There is an intentional glitch in the program, since long paramaters must be specified with --xxx= with or without a value, you may use the short option instead -xxx even though it's suppose to be -xxx= + * <offset> <file> +If parameter options are used the ordering does not matter, ensure the <offset> parameter option or parameter is present +You may mix and match parameters and parameter options, keep in mind that bare parameters must be in a certain order +If the offset parameter is missing in any way the program will prompt you for it +The program will stop parsing when it encounters mus_end regardlessly +Parameter types + * <xxx> - Bare parameter, they must be in a certain order + * -xxx=xxx - Long parameter option, it can be in any order but is case sensitive, can contain no spaces, must contain the equal sign, and is read literally + * -xxx xxx - Short parameter option, it can be in any order but is case sensitive, must contain 1 space and is read literally +---- +Breakdown of parameters: +<offset> - A bare parameter, it must be in hexidecimal eith alone or prefixed with 0x and be the first parameter. It tells the parser where to start parsing +<file> - A bare parameter, it must be the second parameter and tells the parser which rom file to parse +-- - A special file path value meaning use the default file '../baserom.gbc' +--offset, -o - the parameterized offset in hexidecimal, It tells the parser where to start parsing +--file, -f - the parameterized file path, It tells the parser which rom file to parse +--stop, -s - tells the parser to stop at that hexidecimal address or until it reaches mus_end. +help, --help, -h - prints this info and exits, if the bare parameter is used it must be the first parameter |