Allegro-C eXTensions (acxt)

Das Projekt “acxt” (Allegro-C eXTensions) importiert selektive Unterprojekte sowie eine Build-Umgebung.

Im Gegensatz zum Projekt tubs bzw. tubscheck mit Fehlerkorrekturen zu den Standard-Parameterdateien von allegro-C enthält acxt Funktionalitätserweiterungen (und in seltenen Fällen auch -abweichungen).

Generiert werden in den Verzeichnissen:

aconjob: Allgemeingültige (über Schalter in der Kommandozeile steuerbare) Job-Steuerdateien für acon.
enhancements: Parameterfragmente zum Austausch in den Standardparametern von allegro-C.
forms: Formularfolgen und einfacher konfigurierbare Neusatzbehandlung zum Austausch in den Standardparametern von allegro-C.
isbn: Maschinell generierte Routine zum Einfügen von "-" in ISBNs
mabexp: Verbesserte MAB-Exporte.
mabimp: Verbesserte MAB-Importe.
xmlexp: Verbesserte XML-Exporte

HOWTO

a) Auschecken

svn co https://svn.extra.gymel.com/repos/allegro/acxt/trunk acxt

b) Inititalisieren des Build-Verzeichnisses (./produkt)

cd acxt
Configure                          <1>

damit wird implizit ein neues Unterverzeichnis “produkt” zum Build-Verzeichnis

c) Generieren der Dateien

cd produkt
mingw32-make setup
mingw32-make

d) Optional: Vergleich mit Originalparametern in c:/allegro

diff --strip-trailing-cr checkdir c:/allegro | grep -v "^Only"

b') Alternative Build-Verzeichnisse:

mkdir p:/fad/to/newdir             <2>
cd p:/fad/to/newdir                <2>
f:/ad/to/acxt/Configure       <1>

Projekt sei ausgecheckt in f:/ad/to/acxt.
Dateien sollen in einem Verzeichnis p:/fad/to/newdir generiert werden.

SYSTEMVORAUSSETZUNGEN

Für die Build-Umgebung:

Perl (etwa ActivePerl, < http://www.activestate.com/Products/activeperl/ >)
zip und unzip (infozip, < http://www.info-zip.org/ >)
GNU make (auf Windows-Plattformen: stets die mingw-Version), vorzugsweise 3.82, vorzugsweise mingw32-make.exe (< http://www.mingw.org/download.shtm >)
zwingend weitere GNU coreutils: cp, echo, mv, mkdir, rm, rmdir, sh, touch
optional weitere Utilities: xsltproc, xmllint, asciidoc

Beispielsweise das Paket MSYS (< http://www.mingw.org/msys.shtml >) enthält alle benötigten GNU-Utilities, allerdings make v3.79.

In diesem Fall dann bitte angeben:

Configure --msys=path/to/MSYS

also etwa

Configure --msys=C:\MSYS --config=config.hint --prefix=x:\yz\acxt\produkt

und config.hint enthält (mindestens) die Zeile

make=make.exe --unix

Fallen:

wird das MSYS-Toolset benutzt, muss --msys=... angegeben werden, auch wenn das bin-Verzeichnis im PATH ist (es erfolgen sonst gewisse Anpassungen an den Hints nicht)
Cygwin’s make kommt mit Laufwerksbuchstaben in Pfaden nicht mehr klar, weil es in neueren Versionen zu sehr POSIX ist.
Ältere Versionen von make (3.79, 3.80)

sollten möglichst nicht genommen werden, sind aber u.U. Standard in gewissen Linux-Distributionen
- ältere Versionen kennen $(abspath ...) nicht, daher bitte stets den absoluten Pfad des Zielverzeichnisses als --prefix=... beim Configure angeben:

perl $projdir/Configure.cmd --prefix=$projdir/produkt

make v3.79 unterscheidet einen MAKE_MODE (Environmentvariable oder Aufrufschalter) zwischen Win32 und Unix. Die Makefiles sind auf unix eingestellt, d.h. entweder Vorbesetzung set MAKE_MODE=unix im Environment oder Angabe von --unix als Schalter in einer Hint-Datei
wird das make.exe aus MSYS (im Gegensatz zu mingw32-make.exe, das auf Stand v3.82 ist) eingesetzt, muss make im PATH sein (und damit tendenziell das gesamte MSYS-bin-Verzeichnis).

Fazit:

Schmerzfrei ist die Kombination

MSYS installieren (bin-Verzeichnis nicht in den PATH) bzw. minimales cygwin-System installieren.
mingw32-make installieren (es genügt, nur bin/mingw32-make.exe zu extrahieren und irgendwo in den Suchpfad abzulegen).
zip und unzip von InfoZip downloaden und in den Suchpfad legen.
Aufruf als