Allegro-C eXTensions (acxt) =========================== Thomas Berger $Id: README.txt 24284 2012-02-25 20:05:15Z ThB $ 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 http://www.allegro-c.de[_allegro-C_] enthält _acxt_ Funktionalitätserweiterungen (und in seltenen Fällen auch -abweichungen). Generiert werden in den Verzeichnissen: -- link:aconjobdir[aconjob]:: Allgemeingültige (über Schalter in der Kommandozeile steuerbare) Job-Steuerdateien für _acon_. link:enhancementsdir[enhancements]:: Parameterfragmente zum Austausch in den Standardparametern von http://www.allegro-c.de[_allegro-C_]. link:formsdir[forms]:: Formularfolgen und einfacher konfigurierbare Neusatzbehandlung zum Austausch in den Standardparametern von http://www.allegro-c.de[_allegro-C_]. link:isbndir[isbn]:: Maschinell generierte Routine zum Einfügen von "-" in ISBNs link:mabexpdir[mabexp]:: Verbesserte MAB-Exporte. link:mabimpdir[mabimp]:: Verbesserte MAB-Importe. link:xmlexpdir[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> ................................... <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> ................................... <1> Projekt sei ausgecheckt in _f:/ad/to/acxt_. <2> 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 a. http://www.mingw.org/msys.shtml[MSYS] installieren (bin-Verzeichnis nicht in den PATH) bzw. minimales cygwin-System installieren. b. http://www.mingw.org/download.shtm[mingw32-make] installieren (es genügt, nur +bin/mingw32-make.exe+ zu extrahieren und irgendwo in den Suchpfad abzulegen). c. _zip_ und _unzip_ von http://www.info-zip.org/[InfoZip] downloaden und in den Suchpfad legen. d. Aufruf als ................................... Configure --msys=Msys-Verzeichnis ................................... Adressen -------- .Notifications / Views * http://svn.extra.gymel.com/viewvc/allegro/acxt/?date=month&view=query&format=rss[] - Änderungen als RSS Feed * http://svn.gymel.com/viewvc/allegro/acxt/[http://svn.gymel.com/viewvc/allegro/acxt//] - Repository-Browser .SVN-Repository * https://svn.extra.gymel.com/repos/allegro/acxt/trunk/[https://svn.extra.gymel.com/repos/allegro/acxt/trunk/] (Repository-URL für das Wrapper-Projekt _acxt_) * https://svn.extra.gymel.com/repos/allegro/acxt/[https://svn.extra.gymel.com/repos/allegro/acxt//trunk/] (Repository-URL für konkrete _Unterprojekte_) * http://svn.gymel.com/repos/allegro/acxt/[http://svn.gymel.com/repos/allegro/acxt//trunk/] (dsgl. Readonly) .Ausgecheckte Kopie / Vorgenerierte Versionen * http://svn.gymel.com/acxt/[] (mehrmals täglich aktualisiert) * http://svn.gymel.com/acxt/produkt/[http://svn.gymel.com/acxt/produkt//] (Mit analyze.pl verarbeitete Parameterdateien) * bzw. gepackt unter http://svn.gymel.com/acxt/produkt/[.zip] (Download mit Standardvorgaben) Über dieses Dokument ~~~~~~~~~~~~~~~~~~~~ $HeadURL: https://svn.extra.gymel.com/repos/allegro/acxt/trunk/README.txt $ $Id: README.txt 24284 2012-02-25 20:05:15Z ThB $ Kontakt ~~~~~~~ ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ mailto:ThB@gymel.com[Thomas Berger < ThB (at) gymel (dot) com >] ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++