This repository is part of an academic study project.
Its primary goal is to design and implement an interactive transpiler that translates COBOL code into Java, while allowing user-guided customization and integration of modern design patterns.

Requirements

Before using the provided commands, ensure you have the following installed on your system:

Docker
Used to build LaTeX documents inside a containerized environment.
Make
Used to execute the predefined commands in the Makefile.

Usage

The repository includes a Makefile with predefined commands.

To list all available commands, run:

make help

To build the pdf documents (thesis or exposé) from latex, run:

make build-thesis
make build-expose

Windwows-specific notes

On Windows, you may need to adjust the shell used by Make, especially if you are running PowerShell.
- It is recommended to use Git Bash as the shell for full compatibility.
You may also need to adjust the DIRECTORY variable in .env if Docker requires a Windows-style path (e.g., C:/Users/...).

Setting shell and directory

You can set the shell and project directory with Make targets:

make set-shell LOCAL_SHELL="C:/Program Files/Git/usr/bin/bash.exe" LOCAL_SHELLFLAGS="--login -i -c"
make set-directory LOCAL_DIRECTORY="C:/users/admin/project"

set-shell updates SHELL and SHELLFLAGS in .env.
You can run it like this:
set-directory updates DIRECTORY in .env.

Checking variables

You can check which variables Make is using:

make check-variables

Manual `.env` setup

If nothing works yet, you can manually create or edit .env in the project root:

SHELL=C:/Program Files/Git/usr/bin/bash.exe
SHELLFLAGS=--login -i -c
DIRECTORY=C:/users/admin/project

Project Structure

.
├── paper/            LaTeX sources for thesis and exposé
├── implementation/   Source code of the interactive COBOL-to-Java transpiler
└── final/            Finalized documents for submission (thesis, exposé, reports)

README.md

COBOL-to-Java Interactive Transpiler (Study Project)