View source for Byblos

{{infobox swproj
|name=Byblos SDK
|image=Byblos.jpg
|by=Alexander Nicholi
|initialrel=<em>unreleased</em>
|langs={{wp|ANSI C}}, {{wp|Make (software)|Make}}, {{wp|Unix shell|POSIX sh}}
|systems={{wp|Darwin (operating system)|Darwin}}/{{wp|XNU}}, {{wp|Linux|GNU/Linux}}
|archs={{wp|Apple silicon}}, {{wp|x86-64}}
|lic=[[ASL|ASL 1.1]]
}}
'''Byblos''' is a software development kit developed for [[Sirius DOS]], [[A*]] and {{wp|Unix}}-based servers, with distinction for [[MILOTIX]] and Linux, BSD and Darwin (pan-Unix) support. It is divided into two versions: Byblos 1, a provisional SDK that uses existing compiler toolchains and host infrastructure of Unix-like operating systems, and Byblos 2, the proper SDK that provides [[Feeble C compiler|its own C compiler]], [[Oración|assembler]], and [[Sirius C*|the first C* compiler]].

==Byblos 1==
Byblos 1 is the provisional Byblos SDK, architected around Intel and Apple Silicon macOS as well as x86-64 GNU/Linux. Fortunately, all of our compiler toolchains (with the exception of OpenWatcom detailed later) have a relatively straightforward installation process on all of the supported host operating systems.

Byblos 1 should support compiling assembly, ANSI C and <tt>bin</tt>packed assets on all target platforms. Additionally, it supports host-only just-in-time compilation and running of Vala programs, enabling the creation of developer utilities with graphical interfaces. Vala only depends on the system toolchain and the Vala package of the native package manager.

===Platform support===
Byblos 1 is multi-platform. While it endeavours to target all systems of relevance to Xion Megatrends, only three host platforms are supported: GNU/Linux on Intel 64, Darwin/XNU on Intel 64 and Darwin/XNU on Apple silicon. Since Byblos 1 is a provisional SDK that leans on existing platform provisions for brevity, it additionally supports Vala for easily developing performant and optionally GUI-enabled applications for helping development.

====Supported targets====
{| class="wikitable" width="900px"
|-
! style="text-wrap:nowrap;width:30px" | <tt>i</tt>
! style="text-wrap:nowrap;width:60px" | Target
! style="text-wrap:nowrap;width:150px" | Full&nbsp;name
! style="text-wrap:nowrap;width:90px" | ISA
! style="text-wrap:nowrap;width:30px" | <small>Host</small>
! style="text-wrap:nowrap;width:30px" | <tt>ASM</tt>
! style="text-wrap:nowrap;width:30px" | C
! style="text-wrap:nowrap;width:30px" | <tt>bin</tt>
! style="text-align:left" | Notes
|-
| style="text-align:center" | [[File:agbhb.svg|28px]]
| style="text-align:center" | <tt>agbhb</tt>
| style="text-align:center" | GBA homebrew
| style="text-align:center" | ARMv4T
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| Scratch-building GBA ROMs.
|-
| style="text-align:center" | [[File:agbsp.svg|28px]]
| style="text-align:center" | <tt>agbsp</tt>
| style="text-align:center" | GBA sourcepage
| style="text-align:center" | ARMv4T
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| Source-patching existing GBA ROMs.
|-
| style="text-align:center" | [[File:astar.svg|28px]]
| style="text-align:center" | <tt>astar</tt>
| style="text-align:center" | [[A*|Anodyne A*]]
| style="text-align:center" | ''unknown''
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| Too early to specify.
|-
| style="text-align:center" | [[File:darwin86.svg|28px]]
| style="text-align:center" | <tt>darwin86</tt>
| style="text-align:center" | Intel Mac
| style="text-align:center" | x86-64 v1
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-yellow" | &ndash;
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-yellow" | &ndash;
| &nbsp;
|-
| style="text-align:center" | [[File:darwinm1.svg|28px]]
| style="text-align:center" | <tt>darwinm1</tt>
| style="text-align:center" | Apple Silicon Mac
| style="text-align:center" | ARMv8
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-yellow" | &ndash;
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-yellow" | &ndash;
| Only host that can target everything.
|-
| style="text-align:center" | [[File:freebsd.svg|28px]]
| style="text-align:center" | <tt>freebsd</tt>
| style="text-align:center" | FreeBSD
| style="text-align:center" | x86-64 v1
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-yellow" | &ndash;
| &nbsp;
|-
| style="text-align:center" | [[File:ibmpc.svg|28px]]
| style="text-align:center" | <tt>ibmpc</tt>
| style="text-align:center" | Real mode IBM-PC
| style="text-align:center" | Intel i286
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| Not specific to any DOS conventions.
|-
| style="text-align:center" | [[File:illumos.svg|28px]]
| style="text-align:center" | <tt>illumos</tt>
| style="text-align:center" | illumos/OpenIndiana
| style="text-align:center" | SPARC64 V9
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-yellow" | &ndash;
| &nbsp;
|-
| style="text-align:center" | [[File:linux32.svg|28px]]
| style="text-align:center" | <tt>linux32</tt>
| style="text-align:center" | GNU/Linux 32-bit
| style="text-align:center" | Intel i686
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-yellow" | &ndash;
| &nbsp;
|-
| style="text-align:center" | [[File:linux64.svg|28px]]
| style="text-align:center" | <tt>linux64</tt>
| style="text-align:center" | GNU/Linux 64-bit
| style="text-align:center" | x86-64 v1
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-yellow" | &ndash;
| &nbsp;
|-
| style="text-align:center" | [[File:milotix.svg|28px]]
| style="text-align:center" | <tt>milotix</tt>
| style="text-align:center" | [[MILOTIX]]
| style="text-align:center" | x86-64 v3
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-yellow" | &ndash;
| &nbsp;
|-
| style="text-align:center" | [[File:openbsd.svg|28px]]
| style="text-align:center" | <tt>openbsd</tt>
| style="text-align:center" | OpenBSD
| style="text-align:center" | x86-64 v1
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-yellow" | &ndash;
| &nbsp;
|-
| style="text-align:center" | [[File:pcdos.svg|28px]]
| style="text-align:center" | <tt>pcdos</tt>
| style="text-align:center" | Real mode PC-DOS
| style="text-align:center" | Intel i286
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| &nbsp;
|-
| style="text-align:center" | [[File:win311.svg|28px]]
| style="text-align:center" | <tt>win311</tt>
| style="text-align:center" | Windows 3.11
| style="text-align:center" | Intel i286
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| &nbsp;
|-
| style="text-align:center" | [[File:win95.svg|28px]]
| style="text-align:center" | <tt>win95</tt>
| style="text-align:center" | Windows 95, 98 &amp; Me
| style="text-align:center" | Intel i386
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-yellow" | &ndash;
| &nbsp;
|-
| style="text-align:center" | [[File:winnt32.svg|28px]]
| style="text-align:center" | <tt>winnt32</tt>
| style="text-align:center" | Windows NT 4.0 32-bit
| style="text-align:center" | Intel i386
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-yellow" | &ndash;
| &nbsp;
|-
| style="text-align:center" | [[File:winnt64.svg|28px]]
| style="text-align:center" | <tt>winnt64</tt>
| style="text-align:center" | Windows NT 5.1 64-bit
| style="text-align:center" | x86-64 v1
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-yellow" | &ndash;
| &nbsp;
|}

=====Notes=====
* '''<tt>bin</tt>packing''' is a highly portable method of compiling assets statically into binaries
* For assembly, uncertainty exists about toolchain support on macOS
* For <tt>bin</tt>packing, it may eventually work but needs further research

====Compile time support matrix====
{| class="wikitable" width="900px" style="text-align:center"
|-
! rowspan="2" width="132px" | Host
! colspan="6" width="768px" | Target
|-
| width="128px" | <tt>agbhb</tt>
| width="128px" | <tt>agbsp</tt>
| width="128px" | <tt>astar</tt>
| width="128px" | <tt>darwin86</tt>
| width="128px" | <tt>darwinm1</tt>
| width="128px" | <tt>freebsd</tt>
|-
| <tt>linux64</tt>
| devkitARM
| devkitARM
| ''unknown''
| ''none''
| ''none''
| LLVM
|-
| <tt>darwin86</tt>
| devkitARM
| devkitARM
| ''unknown''
| hb:LLVM
| hb:LLVM
| hb:LLVM
|-
| <tt>darwinm1</tt>
| devkitARM
| devkitARM
| ''unknown''
| hb:LLVM
| hb:LLVM
| hb:LLVM
|-
! rowspan="2" | Host
! colspan="6" | Target
|-
| <tt>ibmpc</tt>
| <tt>illumos</tt>
| <tt>linux32</tt>
| <tt>linux64</tt>
| <tt>milotix</tt>
| <tt>openbsd</tt>
|-
| <tt>linux64</tt>
| OpenWatcom
| LLVM
| LLVM
| LLVM
| ''unknown''
| LLVM
|-
| <tt>darwin86</tt>
| OpenWatcom
| hb:LLVM
| hb:LLVM
| hb:LLVM
| ''unknown''
| hb:LLVM
|-
| <tt>darwinm1</tt>
| OpenWatcom
| hb:LLVM
| hb:LLVM
| hb:LLVM
| ''unknown''
| hb:LLVM
|-
! rowspan="2" | Host
! colspan="6" | Target
|-
| <tt>pcdos</tt>
| <tt>win311</tt>
| <tt>win95</tt>
| <tt>winnt32</tt>
| <tt>winnt64</tt>
| &nbsp;
|-
| <tt>linux64</tt>
| OpenWatcom
| OpenWatcom
| MinGW
| MinGW
| MinGW
| &nbsp;
|-
| <tt>darwin86</tt>
| OpenWatcom
| OpenWatcom
| MinGW
| MinGW
| MinGW
| &nbsp;
|-
| <tt>darwinm1</tt>
| OpenWatcom
| OpenWatcom
| MinGW
| MinGW
| MinGW
| &nbsp;
|}

====Runtime support matrix====
{| class="wikitable" width="900px" style="text-align:center"
|-
! rowspan="2" width="132px" | Host
! colspan="6" width="768px" | Target
|-
| width="128px" | <tt>agbhb</tt>
| width="128px" | <tt>agbsp</tt>
| width="128px" | <tt>astar</tt>
| width="128px" | <tt>darwin86</tt>
| width="128px" | <tt>darwinm1</tt>
| width="128px" | <tt>freebsd</tt>
|-
| <tt>linux64</tt>
| mGBA
| mGBA
| ''unknown''
| ''none''
| ''none''
| QEMU/u
|-
| <tt>darwin86</tt>
| mGBA
| mGBA
| ''unknown''
| ''native''
| ''none''
| QEMU/u
|-
| <tt>darwinm1</tt>
| mGBA
| mGBA
| ''unknown''
| Rosetta 2
| ''native''
| QEMU/u
|-
! rowspan="2" | Host
! colspan="6" | Target
|-
| <tt>ibmpc</tt>
| <tt>illumos</tt>
| <tt>linux32</tt>
| <tt>linux64</tt>
| <tt>milotix</tt>
| <tt>openbsd</tt>
|-
| <tt>linux64</tt>
| Bochs
| QEMU/h
| ''native-ish''
| ''native''
| ''unknown''
| QEMU/u
|-
| <tt>darwin86</tt>
| Bochs
| QEMU/h
| QEMU/u
| QEMU/u
| ''unknown''
| QEMU/u
|-
| <tt>darwinm1</tt>
| Bochs
| QEMU/h
| QEMU/u
| QEMU/u
| ''unknown''
| QEMU/u
|-
! rowspan="2" | Host
! colspan="6" | Target
|-
| <tt>pcdos</tt>
| <tt>win311</tt>
| <tt>win95</tt>
| <tt>winnt32</tt>
| <tt>winnt64</tt>
| &nbsp;
|-
| <tt>linux64</tt>
| DOSBox
| DOSBox
| Wine
| Wine
| Wine
| &nbsp;
|-
| <tt>darwin86</tt>
| DOSBox
| DOSBox
| Wine
| Wine
| Wine
| &nbsp;
|-
| <tt>darwinm1</tt>
| DOSBox
| DOSBox
| Wine
| Wine
| Wine
| &nbsp;
|}

====Tool list====
{| class="wikitable" width="900px"
|-
! Tool name
! width="100%" | Description
|-
| devkitARM
| devkitPro's 32-bit ARM GCC toolchain.
|-
| hb:LLVM
| LLVM installed via Homebrew on macOS.
|-
| LLVM
| LLVM installed on a Unix-like.
|-
| OpenWatcom
| Open source continuation of the Watcom C compiler for 16-bit DOS systems.
|-
| MinGW
| Modified GCC for targeting Microsoft Windows.
|-
| mGBA
| Accurate GBA emulator.
|-
| QEMU/u
| QEMU virtualisation framework, in the low-friction userland virtualisation mode.
|-
| QEMU/h
| QEMU virtualisation framework, using a full-fat VM.
|-
| Bochs
| Accurate IBM-PC emulator.
|-
| Wine
| Translation layer for Windows programs to run on other operating systems.
|-
| Rosetta 2
| Apple's transition system for running Intel Mac programs on Apple Silicon.
|-
| DOSBox
| Accurate MS-DOS emulator with a focus on gaming.
|}

====Programs list====
{| class="wikitable" width="900px"
|-
! style="text-wrap:nowrap;width:30px" | <tt>i</tt>
! Utility
! style="text-wrap:nowrap;width:30px" | <span title="agbhb">[[File:agbhb.svg|28px]]</span>
! style="text-wrap:nowrap;width:30px" | <span title="agbsp">[[File:agbsp.svg|28px]]</span>
! style="text-wrap:nowrap;width:30px" | <span title="astar">[[File:astar.svg|28px]]</span>
! style="text-wrap:nowrap;width:30px" | <span title="darwin86">[[File:darwin86.svg|28px]]</span>
! style="text-wrap:nowrap;width:30px" | <span title="darwinm1">[[File:darwinm1.svg|28px]]</span>
! style="text-wrap:nowrap;width:30px" | <span title="freebsd">[[File:freebsd.svg|28px]]</span>
! style="text-wrap:nowrap;width:30px" | <span title="ibmpc">[[File:ibmpc.svg|28px]]</span>
! style="text-wrap:nowrap;width:30px" | <span title="illumos">[[File:illumos.svg|28px]]</span>
! style="text-wrap:nowrap;width:30px" | <span title="linux32">[[File:linux32.svg|28px]]</span>
! style="text-wrap:nowrap;width:30px" | <span title="linux64">[[File:linux64.svg|28px]]</span>
! style="text-wrap:nowrap;width:30px" | <span title="milotix">[[File:milotix.svg|28px]]</span>
! style="text-wrap:nowrap;width:30px" | <span title="openbsd">[[File:openbsd.svg|28px]]</span>
! style="text-wrap:nowrap;width:30px" | <span title="pcdos">[[File:pcdos.svg|28px]]</span>
! style="text-wrap:nowrap;width:30px" | <span title="win311">[[File:win311.svg|28px]]</span>
! style="text-wrap:nowrap;width:30px" | <span title="win95">[[File:win95.svg|28px]]</span>
! style="text-wrap:nowrap;width:30px" | <span title="winnt32">[[File:winnt32.svg|28px]]</span>
! style="text-wrap:nowrap;width:30px" | <span title="winnt64">[[File:winnt64.svg|28px]]</span>
|-
| style="text-align:center" | [[File:hinterlib.svg|28px]]
| style="text-align:center" | [[Hinterlib]]
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
|-
| style="text-align:center" | [[File:inbound.svg|28px]]
| style="text-align:center" | [[Inbound]]
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
|-
| style="text-align:center" | [[File:outbound.svg|28px]]
| style="text-align:center" | [[Outbound]]
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
|-
| style="text-align:center" | [[File:rebound.svg|28px]]
| style="text-align:center" | [[Rebound]]
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
|-
| style="text-align:center" | [[File:earthbound.svg|28px]]
| style="text-align:center" | [[Earthbound]]
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
|-
| style="text-align:center" | [[File:forerunner.svg|28px]]
| style="text-align:center" | [[Forerunner]]
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
|-
| style="text-align:center" | [[File:precursor.svg|28px]]
| style="text-align:center" | [[Precursor]]
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
|-
| style="text-align:center" | [[File:simbel.svg|28px]]
| style="text-align:center" | [[Simbel]]
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
|-
| style="text-align:center" | [[File:oracion.svg|28px]]
| style="text-align:center" | [[Oración]]
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
|-
| style="text-align:center" | [[File:fcc.svg|28px]]
| style="text-align:center" | [[Feeble C compiler|FCC]]
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
|-
| style="text-align:center" | [[File:quindle.svg|28px]]
| style="text-align:center" | [[Quindle]]
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
|-
| style="text-align:center" | [[File:gauntlet.svg|28px]]
| style="text-align:center" | [[Gauntlet]]
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
|-
| style="text-align:center" | [[File:senusrets.svg|28px]]
| style="text-align:center" | [[Senusret's browser|Senusret's]]
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
|-
| style="text-align:center" | [[File:sirius.svg|28px]]
| style="text-align:center" | [[Sirius C*]]
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
|-
| style="text-align:center" | [[File:natpython.svg|28px]]
| style="text-align:center" | [[NatPython]]
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
|-
| style="text-align:center" | [[File:blank.png|28px]]
| style="text-align:center" | [[SablMap]]
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
|-
| style="text-align:center" | [[File:blank.png|28px]]
| style="text-align:center" | [[CheckASCII]]
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
|-
| style="text-align:center" | [[File:blank.png|28px]]
| style="text-align:center" | [[Checkline]]
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
|-
| style="text-align:center" | [[File:blank.png|28px]]
| style="text-align:center" | [[Flow72]]
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-green" | ✔
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
| style="text-align:center" class="cell-red" | ✖
|}

===Getting the toolchains===
Byblos 1 depends on devkitARM, MinGW, LLVM and OpenWatcom to compile code for the various targets it supports. All but OpenWatcom can be installed in binary form using package managers.

Follow [//devkitpro.org/wiki/devkitPro_pacman devkitPro's wiki page] to install devkitARM on macOS or GNU/Linux with respect to your distro. Once you have <code>{dkp-,}pacman</code>, run <code>{dkp-,}pacman -S devkit-env devkitARM devkitARM-gdb gba-tools general-tools grit</code> to obtain all necessary tools and scripts for Byblos' <code>agbhb</code> and <code>agbsp</code> platforms.

MinGW and LLVM can be installed in the typical way with your package manager. '''Do not confuse LLVM with Xcode's clang on macOS!''' Byblos on macOS uses LLVM as installed with Homebrew. The system toolchain is '''only''' used to bootstrap OpenWatcom and compile Vala code for developers.

====Getting OpenWatcom====
Unfortunately the OpenWatcom 2 project does not provide distro packages or macOS binaries, so it must be built from source. Arch Linux users have the benefit of [//aur.archlinux.org/packages/openwatcom-v2 an AUR package] that mostly automates this, and the pathing dictated by our step-by-step process here should be consistent with that script so there are no quirks in usage.

# Run <code>xcode-select --install</code>
# Follow [//brew.sh/#install brew.sh#install]
# Run <code>brew install dosbox-x</code>
# Manually choose the latest release from [//github.com/open-watcom/open-watcom-v2/releases the repository]
#* Select the source code <tt>.tar.gz</tt> in particular
# <tt>un</tt><code>tar</code> the source into a <code>$dir</code> of your choice
# Set environment variable <code>OWTOOLS=CLANG</code>
# Set environment variable <code>OWDOSBOX=dosbox-x</code>
# Run <code>export OWTOOLS OWDOSBOX</code>
# Run <code>cd $dir</code>
# Run <code>./build.sh</code>
# Run <code>./build.sh rel</code>
# Run <code>sudo mkdir /opt/watcom</code>
# Run <code>sudo cp -a rel/. /opt/watcom/</code>
# Append the following lines to your <tt>.profile</tt> (or your equivalent to <tt>.profile</tt>):
#* <code>WATCOM=/opt/watcom</code>
#* <code>EDDAT=$WATCOM/eddat</code>
#* <code>PATH="$PATH:$WATCOM/armo64"</code>
#* <code>export WATCOM EDDAT PATH</code>
# Run <code>source .profile</code> (or your equivalent to <tt>.profile</tt>)
# Verify this all worked by running <code>wcl386 -h</code>

===Installing the SDK===
With the toolchains installed, setting up the rest of the Byblos SDK is a relatively ''anodyne'' affair. In general, all utilities honour the value of <code>$BYBLOS</code> as provenance of the SDK root. If it is empty or undefined, the value defaults to <code>/opt/byblos</code>. In any case, the <code>$BYBLOS</code> root has the following hierarchy:

: <tt><u>$BYBLOS</u>/</tt> &ndash; SDK root
:: <tt><u>$BYBLOS</u>/conf/</tt> &ndash; configuration settings
:: <tt><u>$BYBLOS</u>/include/</tt> &ndash; header files (<tt>.h</tt>) and assembly headers (<tt>.inc</tt>)
:: <tt><u>$BYBLOS</u>/man/</tt> &ndash; manuals
:: <tt><u>$BYBLOS</u>/sbin/</tt> &ndash; script binaries (architecture independent)
:: <tt><u>$BYBLOS</u>/share/</tt> &ndash; shared resources and miscellanea
:: <tt><u>$BYBLOS</u>/slib/</tt> &ndash; script dependencies/libraries (architecture independent)
:: <tt><u>$BYBLOS</u>/system/</tt> &ndash; private folder for internal SDK business
:: <tt><u>$BYBLOS</u>/target/<u>$t</u>/</tt> &ndash; parent folder for target-specific sub-hierarchies (<tt><u>$t</u></tt> is the target ident)
::: <tt><u>$BYBLOS</u>/target/<u>$t</u>/bin/</tt> &ndash; runnable binaries
::: <tt><u>$BYBLOS</u>/target/<u>$t</u>/lib/</tt> &ndash; static libraries
::: <tt><u>$BYBLOS</u>/target/<u>$t</u>/share/</tt> &ndash; target-specific miscellanea (e.g. associated production materials, emulator settings, etc.)

Byblos 1 entirely avoids pre-compiling native programs, instead leaning on the externally-provided toolchains to run C code and Vala code in utilities as necessary. So, it lacks a host <code>bin/</code> folder or associated <code>lib/</code> folder, which are replaced by <code>sbin/</code> and <code>slib/</code> respectively. Hashbangs are used to achieve program invocation.

The SDK operates on the premise that the working development directory can be anywhere. SDK-specific helper scripts have provenance in <code>$BYBLOS</code> and those helper scripts should be written to correctly guess the necessary host toolchains and their locations or error out quickly on failure to find them. <!--

XXX: pending rewrite about Byblos 2
===Removable media and RAM drives on DOS===
What <code>$BYBLOS</code> resolves to and its underlying media are distinguished intelligently on Unices, where the canonical resolution of <code>/opt/byblos</code> and its contents can be mount points or symbolic links to just about anything. This is not the case on DOSes, since drive letters come into play. Fortunately, the variance that we wish to accommodate is limited to those drive letters.

It is important to be able to use Byblos from a floppy diskette, or to have an arbitrary portion of its files on a RAM drive to speed up performance. Byblos could also be located on a network-mapped drive. To support all of this, the <code>$BYBLOS</code> variable is instead defined as an absolute path without its drive letter, and another environment variable, <code>$BYBDRV</code>, contains a comma-separated ordered list of which drives its files may be available on. When Byblos tools look for a program, library or other file, they will search each drive in the list in order, and use whichever path comes up valid first. Here is an example:

Say that Alice has a computer with a 3½" floppy diskette drive <code>A:</code>, a 5¼" floppy disk drive <code>B:</code>, a main hard disk <code>C:</code>, a CD-ROM drive <code>D:</code>, a 2MiB RAM drive <code>E:</code>, and a network-attached storage drive <code>Z:</code>. Her main Byblos installation is at <code>C:/BYBLOS</code>, but she also has a newer minor-version release on a 3½" diskette that contains an updated [[Oración]] assembler providing a feature she needs to use no matter what. She also has some extra support libraries she authored on a loaded 5¼" disk, and a huge third-party SDK integrated with Byblos on a CD-ROM. Finally, her workplace provides company-specific headers and project tooling on the network drive. She has Batch scripts that she manually runs at startup to place her most important files onto the RAM drive. She will probably want to have a setup like this:

* <code>$BYBLOS</code> = <tt>/BYBLOS</tt>
* <code>$BYBDRV</code> = <tt>E,A,B,D,C,Z</tt>

The SDK, along with any and all programs that use its support library, will have file I/O subroutines that stitch together the base path with the drive letters to try when resolving paths. Byblos will also provide dynamic, hands-free integration with the <code>$PATH</code> executable resolution approach and will know where to look for <code>#include</code>s, libraries and other data automatically, using support library subroutines.
-->
==Byblos 2==
Byblos 2 is a purpose-built SDK that includes dedicated stand-alone tools for compiling code and assets for all supported targets. Initially it will run on the same hosts supported by Byblos 1, with wider support to coincide with the porting of Vala to liberate it from conventional host support structures. Its core is comprised of the following programs:
* [[Oración]], an assembler and desymboliser
** Intel 8086, i286, i486, i686, x86-64 v1-v4, ARMv4T, ARMv5TE, ARMv6, ARMv7, ARMv8, SPARC64 V9, Motorola 68000, MOS 6502, MOS 65816, and Itanium/IA-64 are the supported architectures
* [[Feeble C compiler|FCC]], an expressly non-optimising ANSI C compiler
** Uses Oración as its backend
* [[Sirius C*]], a provisional [[C*]] compiler
** Derived from FCC, also uses Oración as its backend
* [[Inbound]], a software build system
** Derived from Make, uses a cut-down in-house derivative
* [[Outbound]], a software packaging system
* [[NatPython]], a scripting interpreter
** Hard fork of Python 3.3
* [[Simbel]], a documentation authoring and generation toolset
* [[Precursor]], a hub-and-spoke version control system
* [[Forerunner]], a source code management system built on top of Precursor
* [[Gauntlet]], a public key cryptosystem for signing and verifying code
* [[Quindle]], a graphical editor program for authoring code
* [[Cigarbochs]], an emulator for debugging and testing code
** Simulates x86, ARM, 68000, 65(02/816) and any bespoke A* ISAs
* Various helper utilities for sanitising and analysing code

===Language classes===
The Byblos compiler suite has a rigidly-dictated list of "first-class programming languages", chosen holistically by Alexander for their combination of ubiquity, expressive power and heritage. Currently, they are as follows:
* ANSI C
* [[C*]]
* FORTRAN, revision 1977 (F77)
* Verilog, revision 2005 (V05)

Additionally, Byblos 2 integrates support for Vala using the default system compiler toolchain and libraries. This makes for an accessible and painless path to quickly writing GUI and CLI programs alike for use by developers to help author large, complex programs.

[[Category:Applications of mechanicalism]][[Category:Unix developments]]