From 23fd294d85959c6b476bcdc35ed6ad508cc99b8f Mon Sep 17 00:00:00 2001 From: Kartik Agaram Date: Wed, 1 Jan 2020 16:45:30 -0800 Subject: 5851 Rename a few scripts to be more consistent. I'm also starting to feel the urge to bud off `subx run` into its own program, say tools/emulate_x86. It doesn't really rely on the SubX notation at all. And then I could rename `subx translate` to `translate_subx_bootstrap`. Only problem: the commands in the Readme get verbose. But the Readme is gonna need surgery soon anyway to put translate_mu front and center. --- translate_subx_debug | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100755 translate_subx_debug (limited to 'translate_subx_debug') diff --git a/translate_subx_debug b/translate_subx_debug new file mode 100755 index 00000000..f5754f37 --- /dev/null +++ b/translate_subx_debug @@ -0,0 +1,31 @@ +#!/bin/sh +# Translate SubX files with debug information on Linux. +# +# Mu's core tooling has a gap: +# 0. The C++ translator 'subx translate' can generate debug information on +# Linux or BSD or Mac, but doesn't support any syntax sugar. +# 1. The self-hosted translator 'translate' runs in emulated mode and can +# run on Linux or BSD or Mac. However, syntax sugar passes (sigils and +# calls) can be very slow to run emulated. +# 2. The self-hosted translator 'translate_subx' runs natively on Linux. It is +# fast, but you get no trace for runs and zero error-checking on the code +# emitted by sigils and calls. Which could still be buggy. +# +# This script is a hack to get the best of all worlds. We run natively what we +# must, and leverage as much debug information as possible. This arrangement +# is snappy but requires Linux just like 'translate_subx'. You also are on your +# own to mentally map desugared instructions in traces and error messages back +# to the original sources. + +set -e + +echo " braces" +cat $* |apps/braces > a.braces +echo " calls" +cat a.braces |apps/calls > a.calls +echo " sigils" +cat a.calls |apps/sigils > a.sigils + +subx --debug translate a.sigils -o a.elf + +chmod +x a.elf -- cgit 1.4.1-2-gfad0