2019-12-07 23:20:44 +00:00
|
|
|
Run all these from the top-level `mu/` directory.
|
|
|
|
|
2019-12-07 23:26:05 +00:00
|
|
|
### Some tools for Mu's build process
|
|
|
|
|
|
|
|
These are built automatically.
|
|
|
|
|
|
|
|
* `enumerate`: list numeric files in current directory, optionally `--until`
|
|
|
|
some prefix.
|
|
|
|
|
|
|
|
|
2019-12-07 23:20:44 +00:00
|
|
|
### Miscellaneous odds and ends
|
|
|
|
|
|
|
|
These are built lazily.
|
|
|
|
|
2019-12-08 00:36:40 +00:00
|
|
|
* `browse_trace`: debugging tool. See `browse_trace.readme.md` for details.
|
|
|
|
|
2019-12-08 00:19:38 +00:00
|
|
|
* `linkify`: inserts hyperlinks from variables to definitions in Mu's html
|
|
|
|
sources. Hacky; just see the number of tests. Invoked by `update_html`.
|
|
|
|
|
2019-12-07 23:20:44 +00:00
|
|
|
* `treeshake_all`: rebuild SubX binaries without tests and unused functions.
|
2019-12-08 00:19:38 +00:00
|
|
|
Hacky; just helps estimate the code needed to perform various tasks.
|
2019-12-07 23:20:44 +00:00
|
|
|
```
|
|
|
|
tools/treeshake_all
|
|
|
|
```
|
2019-12-09 07:16:33 +00:00
|
|
|
|
|
|
|
### 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.
|