====== Lyx – Compiler selbst kompilieren ======

Da der Lyx-Compiler in **Free Pascal (FPC)** implementiert ist, kann er leicht aus den Quellen erstellt werden. Dies ist notwendig, wenn Sie Änderungen am Compiler-Kern vornehmen oder Lyx auf einer neuen Plattform (Bootstrapping) installieren möchten.

===== 1. Voraussetzungen =====

Bevor Sie beginnen, stellen Sie sicher, dass folgende Komponenten installiert sind:

  * **Free Pascal Compiler (FPC)**: Version 3.2.2 oder höher wird empfohlen.
  * **Lazarus (Optional)**: Nur erforderlich, wenn Sie die IDE für die Entwicklung nutzen möchten. Die Kommandozeile reicht aus.
  * **Make**: Für die Automatisierung des Build-Prozesses.
  * **Binutils**: (as, ld) für das jeweilige Zielsystem (x86_64, ARM64 oder RISC-V).

===== 2. Projektstruktur =====

Das Repository ist wie folgt strukturiert:
  * **/src**: Quellcode des Compilers (``.pas``, ``.pp`` Dateien).
  * **lyxc.lpr**: Die Hauptprojektdatei (Pascal Project).
  * **/lib**: Abhängigkeiten und spezialisierte Units für die Backends.

===== 3. Kompilierung über die Kommandozeile =====

Der einfachste Weg, den Compiler zu bauen, ist die Nutzung von ''fpc'' direkt.

==== Für das Host-System (Native) ====
<code bash>
fpc -O3 -MObjFPC -Scghi -Sh -Tlinux -Px86_64 lyxc.lpr -olyxc
</code>

**Beispielufruf:**
<code>
mkdir -p lib && fpc -Mobjfpc -Sh -FUlib/ -Fuutil/ -Fufrontend/ -Fuir/ -Fubackend/ -Fubackend/x86_64/ -Fubackend/elf/ -Fubackend/pe/ -Fubackend/arm64/ -Fubackend/macho/ -Fubackend/xtensa/ -Fubackend/esp32/ -Fubackend/macosx64/ -Fubackend/win_arm64/ -Fubackend/riscv/ -Fubackend/arm_cm/ -O2 lyxc.lpr -olyxc 2>&1
</code>
**Erklärung der Parameter:**
^ Parameter ^ Bedeutung ^
| **-O3** | Maximale Optimierung des Compiler-Executables. |
| **-MObjFPC** | Nutzt den Object Pascal Dialekt. |
| **-Scghi** | Aktiviert fortgeschrittene Sprachfeatures (Generics, Operator Overloading). |
| **-T / -P** | Zielplattform (Target) und Architektur (Processor). |
| **-o** | Name der Ausgabedatei. |



===== 4. Cross-Kompilierung des Compilers =====

Wenn Sie den Lyx-Compiler auf einem x86_64-Rechner bauen, ihn aber auf einem Raspberry Pi (ARM64) ausführen möchten, nutzen Sie Cross-Kompilierung:

<code bash>
fpc -Tlinux -Parm64 -XParm-linux-gnueabihf- lyxc.lpr
</code>

===== 5. Integration der Standard-Library =====

Nachdem das Executable ''lyxc'' erstellt wurde, muss der Compiler wissen, wo sich die Lyx-Standard-Units befinden. Dies geschieht normalerweise über eine Umgebungsvariable:

<code bash>
export LYX_PATH=/usr/local/lib/lyx/units
./lyxc my_program.lyx
</code>

===== 6. Troubleshooting =====

  * **Unit not found**: Prüfen Sie, ob alle Pfade in der ''fpc.cfg'' korrekt gesetzt sind oder nutzen Sie den Parameter ''-Fu./src'', um das Quellverzeichnis explizit anzugeben.
  * **Linker Error**: Stellen Sie sicher, dass die statischen Bibliotheken für das Zielsystem vorhanden sind (besonders wichtig bei Cross-Builds für RISC-V).

<box gh>
> **Entwickler-Tipp:**
> Nutzen Sie den Debug-Build (''-g -gl -gh''), wenn Sie am Compiler selbst arbeiten, um aussagekräftige Stack-Traces bei Compiler-Abstürzen (Internal Errors) zu erhalten.
</box>