Install the j++ Compiler on Linux

Build the j++ compiler and install iodine libraries on Linux x86_64.

The j++ compiler builds i++ source files into Linux x86_64 programs. The make full-install target builds and installs the compiler. Install iodine library files into a PLIBS/iodine/ directory.

Before you install

Operating system

Linux x86_64 is the supported target.

Build tools

Install Python 3.14 or later, GCC, NASM, make, and pip.

The build target installs PyInstaller and Pyflakes with pip. On Debian or Ubuntu, install the system tools with:

sudo apt install gcc nasm make python3 python3-pip

Install from source

1. Clone the repository

   git clone https://github.com/setuser1/C-triangle.git
   cd C-triangle
   
2. Build and install

   make full-install
   

   The current make target installs the hypotenuse executable under /usr/local/bin when writable, or under ~/.local/bin otherwise.

3. Verify the compiler

   hypotenuse --help
   

Install iodine libraries

The current iodine library sources are in the plstd/ directory. Copy the selected source into a local iodine/ directory, change its .plib suffix to .ih, then install it:

hypotenuse -i iodine/printd.ih

The compiler places system libraries under /usr/lib/PLIBS/ and user libraries under ~/.local/lib/PLIBS/. Keep the iodine files in the iodine/ subdirectory so imports such as <iodine/printd> resolve.

The compiler is now named j++, but the C-triangle build scripts have not yet renamed the executable. Run hypotenuse until that change lands in the compiler repository.

If the compiler was installed in ~/.local/bin, add that directory to your PATH if needed:

export PATH="$HOME/.local/bin:$PATH"

Check your installation

From the repository directory, run the focused compiler tests:

make test

Run make lint to check the Python compiler sources with Pyflakes.

Run make test after changing compiler code. The suite exercises representative language, library, and assembly cases.

Uninstall

From the repository directory, run:

make uninstall

This removes the hypotenuse executable. It does not remove installed PLIBS libraries.

macOS support is being dropped. This guide covers Linux x86_64 only. Docker and Apple’s container CLI are not needed for a native Linux installation.