Übersicht

pival.pl --help | --version

pival.pl [ --verbose | --no_verbose ] --pi PI --key KEY --mode MODE --maxlines MAXLINES < SOURCEFILE

Optionen

--help

Gibt eine kurze Hilfe aus

--version

Gibt kurze Hinweise zum Programm und die Version aus.

--verbose

Meldungen nach STDERR

--no_verbose

Keine Meldungen nach STDERR

--pi PI

PI ist der Name der Verarbeitungsanweisung.

--key KEY

KEY ist ein Schlüssel zu der Verarbeitungsanweisung.

--mode MODE

Die gesamte Verarbeitungsanweisung <?PI KEY = "VALUE"?> ist normalerweise in einem Kommentar enthalten. Abhängig vom Typ der Datei haben Kommentare andere Formen. MODE bestimmt die Art des Kommentars. Die Verarbeitungsanweisung wird nur dann ausgewertet, wenn sie in einer passenden Kommentar-Zeile steht.

MODE ist einer der folgenden Werte. Zu dem Wert ist die Form der Zeile angegeben. Am Anfang und Ende der Zeile können Leerzeichen stehen, sofern nichts anderes angegeben ist.

script

# <?PI KEY = "VALUE"?>
            

lisp

; <?PI KEY = "VALUE"?>
            

Das Semikolon steht für eine Folge von einem oder mehreren Semikola.

c

/* <?PI KEY = "VALUE"?> */
            

sql

--  <?PI KEY = "VALUE"?>
            

Die Zeile beginnt mit zwei oder mehr Minus-Zeichen.

xml

<?PI KEY = "VALUE"?>
            

auto

Anhand der ersten Zeile der Datei wird einer der zuvor genannten Werte bestimmt. Wenn das nicht möglich ist, wird lax angenommen.

strict

<?PI KEY = "VALUE"?>
            

Hier sind keine Leerzeichen am Anfang oder Ende der Zeile erlaubt, im Unterschied zu xml.

lax

Die Zeile kann beliebigen Text vor und nach der Verarbeitungsanweisung enthalten.

--maxlines MAXLINES

Die Verarbeitungsanweisung wird nur in den ersten MAXLINES Zeilen der Datei gesucht.

Beschreibung

Manche Dateien enthalten im Kopf eine Zeile der Form

<?install location = "INSTALL_PATH"?>

INSTALL_PATH ist ein Dateipfad, unter dem die Datei oder eine abhängige Datei angelegt wird. Dieses Skript gibt INSTALL_PATH nach STDOUT aus, so dass ein Installations-Skript INSTALL_PATH auswerten kann.

Statt des Verarbeitungsanweisungs-Namens install und der Schlüssels location können andere Zeichenketten angegeben werden, s. PI und KEY.

Software-Voraussetzungen

Das Programm ist mit Perl Version 5.24.1 entwickelt. Es benutzt das folgende Modul:

Herbaer::Readargs

Die Funktionen read_args aus diesem Modul verarbeitet die Befehlszeilenargumente, die Funktion print_message_with_values gibt die Hilfe mit den aktuellen Einstellungen aus.