Kopfschmerzen - Online in der Cloud

PROGRAMM:

NAME/FUNKTION

Kopfschmerzen - Ein Programm zum Verwalten der Lizenz Ihrer Quelldatei.

ZUSAMMENFASSUNG

Kopfschmerzen [-H Datei] [-C Datei] [-r] [-Hilfe | --Hilfe] Datei...

BESCHREIBUNG

Diese Handbuchseite dokumentiert kurz die Kopfschmerzen Befehl.

Diese Handbuchseite wurde für die Debian GNU/Linux-Distribution geschrieben, weil das Original
Programm hat keine Handbuchseite.

Es ist üblich, am Anfang von Quellcodedateien einen kurzen Header zu setzen, der
zum Beispiel einige Copyright-Informationen. Kopfschmerzen ist ein einfaches und leichtes Werkzeug für
einfache Verwaltung dieser Header. Unter seinen Funktionalitäten kann man erwähnen:

· Header müssen generell als Kommentare in Quellcodedateien generiert werden. Kopfschmerzen Angebote
mit verschiedenen Dateitypen und generiert für jeden von ihnen Header in einer geeigneten
Format.

· Header erkennt automatisch vorhandene Header und entfernt sie. So können Sie es verwenden
um Header in einem Satz von Dateien zu aktualisieren.

COMMAND LINE OPTIONAL

Datei
Name einer zu verarbeitenden Datei

-h Datei
Erstellen Sie eine Kopfzeile mit Text aus der Datei

-c Datei
Lesen Sie die angegebene Konfigurationsdatei

-Hilfe Hilfe
Zeigen Sie die Optionsliste von . an Kopfschmerzen

ANWENDUNG

Lassen Sie uns die Verwendung dieses Tools an einem kleinen Beispiel veranschaulichen. Angenommen, Sie haben ein kleines
Projekt, das C- und Caml-Code mischt, bestehend aus den drei Dateien 'foo.c', 'bar.ml' und 'bar.mli'',
und Sie möchten sie mit einem Header ausstatten. Schreiben Sie zunächst eine Header-Datei, also a
Klartextdatei einschließlich der Informationskopfzeilen muss erwähnt werden. Ein Beispiel für eine solche Datei
ist in Abbildung 1 dargestellt. Im Folgenden gehen wir davon aus, dass diese Datei 'myheader' heißt und in
das gleiche Verzeichnis wie die Quelldateien.

Führen Sie dann zum Generieren von Headern einfach den Befehl aus: Kopfschmerzen -h meinheader foo.c
bar.ml bar.mli

Jede Datei ist mit einem Header ausgestattet, der den in der Header-Datei angegebenen Text enthält
'myheader', umgeben von einigen zusätzlichen Zeichen, abhängig von seinem Format, was es zu einem
Kommentar (zB '(*' und '*)' in '.ml'-Dateien). Wenn Sie die Header-Datei 'myheader' aktualisieren,
Sie müssen lediglich den obigen Befehl erneut ausführen, um Header in Quellcodedateien zu aktualisieren.

Ähnlich läuft: Kopfschmerzen -r foo.c bar.ml bar.mli entfernt alle vorhandenen in Dateien
'foo.c', 'bar.ml' und 'bar.mli'. Dateien, die keinen Header haben, bleiben unverändert.

CONFIGURATION FILE

Dateitypen und das Format des Headers können durch eine Konfigurationsdatei angegeben werden. Standardmäßig ist die
Die in Abbildung 2 angegebene standardmäßige eingebaute Konfigurationsdatei wird verwendet. Sie können auch Ihre eigenen verwenden
Konfigurationsdatei dank der -c Möglichkeit : Kopfschmerzen -c meineconfig -h meinheader foo.c bar.ml
bar.mli

Um Ihre eigene Konfiguration zu schreiben, können Sie dem Beispiel in Abbildung 2 folgen. A
Konfigurationsdatei besteht aus einer Liste von Einträgen, die durch das Zeichen '|' getrennt sind. Jeder von
sie besteht aus zwei Teilen, die durch ein '->' getrennt sind.

Der erste ist ein regulärer Ausdruck. (Reguläre Ausdrücke sind in double eingeschlossen
Anführungszeichen und haben dieselbe Syntax wie in Gnu Emacs.) Kopfschmerzen bestimmt Dateitypen
nach Dateibasisnamen; somit wird jede Datei mit der ersten Zeile ihres Namens behandelt
Streichhölzer.

Der zweite beschreibt das Format der Header für Dateien dieses Typs. Es besteht aus dem
Name eines Modells (zB 'frame'), eventuell gefolgt von einer Liste von Argumenten. Argumente sind
named: 'open:"(*"' bedeutet, dass der Wert des Arguments 'open' '(*' ist. Kopfschmerzen
unterstützt derzeit drei Modelle und ein spezielles Schlüsselwort:

Rahmen
Bei diesem Modell werden Header in einem Frame generiert. Dieses Modell erfordert drei
Argumente: 'open' und 'close' (die Eröffnungs- und Schlusssequenzen für Kommentare) und
'line' (das Zeichen, das verwendet wird, um die horizontalen Linien des Rahmens zu bilden). Zwei optional
Argumente können 'margin' verwendet werden (eine Zeichenfolge, die zwischen der linken und rechten Seite von
Rahmen und Rahmen, standardmäßig zwei Leerzeichen) und 'Breite' (die Breite der Innenseite)
des Rahmens, der Standardwert ist 68).

Linien
Kopfzeilen werden zwischen zwei Zeilen gesetzt. Drei Argumente müssen angegeben werden: 'offen' und
'close' (die Eröffnungs- und Schlusssequenz für Kommentare), 'line' (das verwendete Zeichen)
um die horizontalen Linien zu machen). Drei optionale Argumente sind erlaubt: 'begin' (ein String
am Anfang jeder Zeile gesetzt, standardmäßig zwei Leerzeichen), 'last' (eine Zeichenfolge
am Anfang der letzten Zeile gesetzt) ​​und 'width' (die Breite der Zeilen,
Standard ist 70).

nicht
Dieses Modell generiert keinen Header und hat kein Argument.

überspringen
Überspringe Zeile, die einem der "Match"-Parameter regexp entspricht. Für diese Art von
Zeile wird jedes erste Teilmuster berücksichtigt, das mit dem Dateibasisnamen übereinstimmt.

Nutzen Sie Kopfschmerzen online mit den onworks.net-Diensten