Das Perl-Skript analyze.pl analysiert allegro-Parameterdateien (und auch Konfigurationsdateien) auf nichtexistierende und doppelt benutzte Sprungmarken, benutzte Zwischenteile und auch auf die Ziele von relativen Sprünge hin, möglichst auch unter Einbeziehung von Includetabellen. Resultat der Analyse ist eine neue Parameterdatei mit Aufstellungen über die benutzten Marken etc. in Form von Kommentarzeilen.
analyze.pl ist leider im wesentlichen undokumentiert
perl analyze.pl cat.apiDie Datei cat.api im aktuellen Verzeichnis wird analysiert. Es wird erzeugt
| cat.new | Variante von cat.api mit Headerzeilen, auch vor Includebefehlen, falls die zugehrigen .xdt-Dateien vorhanden waren |
| cat.xii | Index dazu |
| cat.xdi | Interne Merkdatei: Enthlt den Kopf sowie Informationen fr die Indexierung |
| cat.xdb | eventuelle Fehlermeldungen |
Warnhinweise werden ausgegeben, wenn einzubindende Includetabellen xxx.apt nicht gefunden werden können oder vorher noch nicht analysiert wurden (deren Auswertungen aus xxx.xdt werden benötigt).
perl analyze.pl c:\allegro\d-1.aprDie Datei d-1.apr im Verzeichnis c:\allegro wird analysiert (aktuelles Verzeichnis sei dabei nicht c:\allegro, sondern ein anderes, etwa c:\temp). Es wird erzeugt
| d-1.apr | Variante von d-1.apr mit Headerzeilen, auch vor Includebefehlen, falls die zugehörigen .xdt-Dateien vorhanden waren |
| d-1.xdr | Interne Merkdatei: Enthält den Kopf und Index sowie komprimierte Informationen für die Indexierung |
| d-1.xdb | eventuelle Fehlermeldungen |
| -? | Kurzhilfe bezüglich der Aufrufoptionen |
| -o[utput] | Dateipfad / Name für die Ausgabe |
| -i[nput] | Dateipfad / Name der Quelldatei |
| -2 | zwei Durchläufe veranstalten (damit Zeilennummern des Index mit der Ausgabedatei stimmen) |
| -cfg | Quelldatei ist .CFG-Datei |
| -ind[ex] | erzeugter Index wird an die Ausgabedatei angehängt |
| -t[ouch] | Ausgabedatei bekommt das aktuelle Datum |
| -st[riponly] | Keine Analyse durchführen |
| -su[perstrip] | Keine Kommentare in die Ausgabedatei einfügen |
| -nog[en] | Generierungsoptionen nicht auswerten (Resultat ist dann keine Parameterdatei) |
| -reg[en] | Generierungsoptionen erneut auswerten (bei Parameterdateien, in denen Generierungsoptionen bereits ausgewertet und inaktiv sind) |
| -var | $(...)-Makros expandieren |
| -r[ecurse] | Include-Tabellen werden in die Ausgabedatei integriert |
| -not Datei | Datei Datei nie einbinden |
| -do Datei | Datei Datei immer einbinden |
| -x Datei | mehr Schalter und Generierungsoptionen in der Datei Datei |
| -y Datei | Zusaetzliche Kopf-Kommentare aus der Datei Datei in die Ausgabedatei montieren |
| -mu[te] | Weniger Animation |
| -q[uick] | reine Analyse: Nur Warnungen und Index werden erzeugt |
Die Umgebungsvariable -D und -P werden berücksichtigt, ebenso eine Umgebungsvariable -W (steht für das Arbeitsverzeichnis).
Standardmässig werden Generierungsoptionen aus der Datei analyze.opt berücksichtigt, diese Datei wird im aktuellen Verzeichnis oder im Verzeichnis von analyze.pl gesucht.
^Top