akkartik
/
mu
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

5636

This commit is contained in:
Kartik Agaram 2019-09-07 10:20:44 -07:00
parent 571bf69fbc
commit 372a4259ae
3 changed files with 14 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
debug_translate
View File

@ -1,15 +1,18 @@
#!/bin/sh
# Translate SubX files with debug information.
# Translate SubX files with debug information on Linux.
#
# Mu's core tooling has a gap:
# 1. 'translate' can generate debug information, but syntax sugar passes
# (sigils and calls) have no C++ versions and take several minutes to run
# emulated.
# 2. 'ntranslate' 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.
# 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 'ntranslate' 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 both worlds. We run natively what
# we must, and leverage as much debug information as possible. This arrangement
# 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 'ntranslate'. You also are on your
# own to mentally map desugared instructions in traces and error messages back
# to the original sources.

2
ntranslate
View File

@ -1,5 +1,5 @@
#!/bin/sh
# Translate SubX using the self-hosted translator.
# Translate SubX by running the self-hosted translator natively on Linux.
#
# Possible knobs:
# Whether to run a phase natively or in emulated mode.

3
translate
View File

@ -1,5 +1,6 @@
#!/bin/sh
# Translate SubX using the self-hosted translator.
# Translate SubX by running the self-hosted translator in emulated mode on
# Linux or BSD or Mac.
#
# Possible knobs:
# Whether to run a phase natively or in emulated mode.