pival.pl
[ --verbose
| --no_verbose
] --pi
PI
--key
KEY
--mode
MODE
--maxlines
MAXLINES
< SOURCEFILE
--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 <?
ist normalerweise in einem Kommentar enthalten. Abhängig vom Typ der Datei haben Kommentare andere Formen. PI
KEY
= "VALUE
"?>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.
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
.
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.