mirror of
https://github.com/zeldaret/mm.git
synced 2026-06-16 14:30:26 -04:00
Anghelo Carvajal
b6904aa2cc
* remove ZAPD submodule * git subrepo clone https://github.com/zeldaret/ZAPD.git tools/ZAPD subrepo: subdir: "tools/ZAPD" merged: "ca229f19" upstream: origin: "https://github.com/zeldaret/ZAPD.git" branch: "master" commit: "ca229f19" git-subrepo: version: "0.4.3" origin: "???" commit: "???" * git subrepo clone https://github.com/simonlindholm/decomp-permuter.git tools/decomp-permuter subrepo: subdir: "tools/decomp-permuter" merged: "1e4b85a7" upstream: origin: "https://github.com/simonlindholm/decomp-permuter.git" branch: "main" commit: "1e4b85a7" git-subrepo: version: "0.4.3" origin: "???" commit: "???" * Remove asm-differ * git subrepo clone https://github.com/simonlindholm/asm-differ.git tools/asm-differ subrepo: subdir: "tools/asm-differ" merged: "eaf72269" upstream: origin: "https://github.com/simonlindholm/asm-differ.git" branch: "master" commit: "eaf72269" git-subrepo: version: "0.4.3" origin: "???" commit: "???" * remove asm-processor * git subrepo clone https://github.com/simonlindholm/asm-processor.git tools/asm-processor subrepo: subdir: "tools/asm-processor" merged: "85288fcd" upstream: origin: "https://github.com/simonlindholm/asm-processor.git" branch: "master" commit: "85288fcd" git-subrepo: version: "0.4.3" origin: "???" commit: "???" * remove .gitmodules file * Update REAMDE * Update warnings
41 lines
1.6 KiB
Markdown
41 lines
1.6 KiB
Markdown
# asm-differ
|
|
|
|
Nice differ for assembly code (MIPS and AArch64; should be easy to hack to support other instruction sets).
|
|
|
|
|
|
|
|
## Dependencies
|
|
|
|
- Python >= 3.6
|
|
- `python3 -m pip install --user colorama ansiwrap watchdog python-Levenshtein`
|
|
|
|
## Usage
|
|
|
|
Create a file `diff-settings.sh` in some directory (see the one in this repo for an example). Then from that directory, run
|
|
|
|
```
|
|
/path/to/diff.sh [flags] (function|rom addr)
|
|
```
|
|
|
|
Recommended flags are `-mwo` (automatically run `make` on source file changes, and include symbols in diff). See `--help` for more details.
|
|
|
|
### Tab completion
|
|
|
|
[argcomplete](https://kislyuk.github.io/argcomplete/) can be optionally installed (with `python3 -m pip install argcomplete`) to enable tab completion in a bash shell, completing options and symbol names using the linker map. It also requires a bit more setup:
|
|
|
|
If invoking the script **exactly** as `./diff.py`, the following should be added to the `.bashrc` according to argcomplete's instructions:
|
|
|
|
```sh
|
|
eval "$(register-python-argcomplete ./diff.py)"
|
|
```
|
|
|
|
If that doesn't work, run `register-python-argcomplete ./diff.py` in your terminal and copy the output to `.bashrc`.
|
|
|
|
If setup correctly (don't forget to restart the shell), `complete | grep ./diff.py` should output:
|
|
|
|
```
|
|
complete -o bashdefault -o default -o nospace -F _python_argcomplete ./diff.py
|
|
```
|
|
|
|
Note for developers or for general troubleshooting: run `export _ARC_DEBUG=` to enable debug output during tab-completion, it may show otherwise silenced errors. Use `unset _ARC_DEBUG` or restart the terminal to disable.
|