diff options
author | Kartik Agaram <vc@akkartik.com> | 2020-01-02 12:27:35 -0800 |
---|---|---|
committer | Kartik Agaram <vc@akkartik.com> | 2020-01-02 12:27:35 -0800 |
commit | 7fd4a87066115f0e04267bde15c251215bb53efc (patch) | |
tree | 057599c0df12be48feebc182c5db5f289a9595b2 /tools/README.md | |
parent | cdcf5d71c0a879bbe4895e6c82b985eff9244d05 (diff) | |
download | mu-7fd4a87066115f0e04267bde15c251215bb53efc.tar.gz |
5868
Follow stupid GNU convention, because why not: https://www.gnu.org/prep/standards/html_node/Releases.html
Diffstat (limited to 'tools/README.md')
-rw-r--r-- | tools/README.md | 36 |
1 files changed, 36 insertions, 0 deletions
diff --git a/tools/README.md b/tools/README.md new file mode 100644 index 00000000..9e59dabe --- /dev/null +++ b/tools/README.md @@ -0,0 +1,36 @@ +Run all these from the top-level `mu/` directory. + +### Some tools for Mu's build process + +These are built automatically. + +* `enumerate`: list numeric files in current directory, optionally `--until` + some prefix. + + +### Miscellaneous odds and ends + +These are built lazily. + +* `browse_trace`: debugging tool. See `browse_trace.readme.md` for details. + +* `linkify`: inserts hyperlinks from variables to definitions in Mu's html + sources. Hacky; just see the number of tests. Invoked by `update_html`. + +* `treeshake_all`: rebuild SubX binaries without tests and unused functions. + Hacky; just helps estimate the code needed to perform various tasks. + ``` + tools/treeshake_all + ``` + +### Notes to self: constraints on the tools/ directory +* Don't overwhelm the initial view of the project with lots of crap in the + root directory. +* Directories go up top in the github view, so too many sub-directories are + also overwhelming. +* Don't increase increase build time too much; everything in `tools/` shouldn't + be automatically built. + * stuff needed all the time is built from root directory. +* `tools/` contains many independent things; don't make it hard to see + boundaries. Ideally just one source file per tool. If not, give related + files similar name prefixes. |