akkartik
/
mu
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
mu/tools
History
Kartik Agaram cf28645f8a 6610 - tweak the Linux boot image generator 
So far we hardcoded the translation process and it only supported SubX.
Now we pass in an ELF binary and outsource how it's generated.
 		2020-07-05 10:38:18 -07:00
..
iso 6610 - tweak the Linux boot image generator 2020-07-05 10:38:18 -07:00
termbox 5800 - move `browse_trace` to `tools/` dir 2019-12-07 18:15:49 -08:00
README.md 5868 2020-01-02 12:27:35 -08:00
browse_trace 5800 - move `browse_trace` to `tools/` dir 2019-12-07 18:15:49 -08:00
browse_trace.cc 5910 2020-01-20 02:58:31 -08:00
browse_trace.readme.md 5800 - move `browse_trace` to `tools/` dir 2019-12-07 18:15:49 -08:00
create_container 5891 2020-01-14 01:52:54 -08:00
enumerate.cc 5797 - move `enumerate/` to `tools/` directory 2019-12-07 18:06:16 -08:00
expand_string_handle - 2020-05-18 00:44:50 -07:00
linkify.cc 5799 - move html-generation to `tools/` directory 2019-12-07 18:06:17 -08:00
stack_array.subx 6123 - runtime helper for initializing arrays 2020-03-11 17:21:59 -07:00
tangle.cc 5801 - move `tangle` to `tools/` dir 2019-12-07 18:15:49 -08:00
tangle.readme.md 5801 - move `tangle` to `tools/` dir 2019-12-07 18:15:49 -08:00
test_treeshake_translate 5796 - move treeshake to a new tools/ directory 2019-12-07 18:05:06 -08:00
treeshake.cc 5796 - move treeshake to a new tools/ directory 2019-12-07 18:05:06 -08:00
treeshake_all 6003 2020-02-09 21:12:41 -08:00
treeshake_translate 5899 2020-01-19 17:52:25 -08:00
update_html 5900 2020-01-19 17:53:06 -08:00

README.md

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.