pretzel-it – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

pretzel-it – verwende Pretzel, um einen hübschen Drucker zu bauen

ZUSAMMENFASSUNG

pretzel-it [-iqvdnh] Sprach-PP-Name

BESCHREIBUNG

Pretzel-it ist ein Shell-Skript, das verwendet Brezel(1) um einen einfachen hübschen Drucker zu bauen
ausführbar. Dadurch wird die Erstellung eines Pretzel-Pretzel-Druckers auf nur einen Shell-Befehl reduziert. Sehen
Brezel(1) für einen allgemeinen Überblick und eine Beschreibung der Eingabedateien.

Sie müssen für pretzel-it die gleichen zwei Eingabedateien bereitstellen wie für pretzel. Diese beiden Dateien
heißen die formatiert Zeichen Datei (Suffix .ft) und das formatiert Grammatikkenntnisse Datei (Suffix
.fg). Beide Dateien müssen das gleiche Präfix haben Sprache. Aus dieser Eingabe, Brezel-it
generiert eine ausführbare Datei mit dem Namen „prettyprinter“. ppname.

Beispiel
Angenommen, Sie haben zwei Dateien geschrieben foo.ft und foo.fg die das Prettyprinting enthalten
Informationen zu Ihrer bevorzugten Programmiersprache foo. Um eine ausführbare Datei zu erhalten
hübscher Drucker foopp Geben Sie dazu einfach Folgendes ein:

Brezel-it foo foopp

OPTIONAL

Pretzel-it bietet folgende Möglichkeiten:

-i Entfernen Sie keine Brezelzwischenprodukte.

-q Lauf ruhig.

-v Ausführlicher Modus, Shell-Befehle vor dem Aufruf ausgeben (zum Debuggen).

-d Schalten Sie die Debugging-Funktionen von Prettyprinter standardmäßig ein. erstellen Sie auch eine detaillierte
Diagnosedatei (Suffix .Ausgang), das eine detaillierte Analyse der enthält
Grammatik und mögliche Probleme damit (um das Debuggen von Prettyprinting zu erleichtern
Grammatik).

-h Vollständige Nutzungsmeldung drucken.

-n Noweb-Modus. Siehe Sektion Anschluss mit noweb(1) unten mit.

ERZEUGT PRETTYPRINTER

Die generierte ausführbare Datei ist ein Programm, das Quellcode aus der Standardeingabe liest
und schreibt hübsch gedruckten Code in die Standardausgabe. Der hübsch gedruckte Code kann sein
setzen mit Latex zusammen mit dem Brezel-Latex Dokumentstil.

Beispiel
Sagen Sie, Sie haben gebaut foopp bereits und habe einen Teil des Quellcodes in einer Datei bar.foo. Art

foopp <bar.foo >bar.tex

und der Prettyprinter druckt den Code hübsch aus und schreibt LaTeX-Code darauf bar.tex. Benutzen
Fügen Sie diesen Code einfach in Ihre Dokumente ein Brezel-Latex Dokumentstil und Include
die Datei im neuen ppcode LaTeX-Umgebung. Hier ist eine minimale LaTeX-Datei zum Anschauen
der hübsch gedruckte Code:

\documenstyle[pretzel-latex]{article}
\begin{Dokument}
\begin{ppcode}
\input{foo.tex}
\end{ppcode}
\end{Dokument}

SCHNITTSTELLE MIT JETZT WEB

Verwendung der -n Diese Option erzeugt einen Prettyprinting-Filter ppname kompatibel zu Norman
Ramseys noweb(1) kompetentes Programmiersystem. Der Filter kann in das Noweb eingefügt werden
Pipeline mit Noweave's -Filter .

Sie können beispielsweise einen Noweb-Prettyprinting-Filter für Pascal erstellen, indem Sie Folgendes ausgeben

Brezel-it -n pascal Prettypascal

innerhalb der Sprachen/Pascal Verzeichnis, erhalten Sie einen Prettyprinting-Filter Prettypascal .
Dieser Filter kann dann innerhalb verwendet werden jetzt(1) mit den Worten:

jetzt -Filter Prettypascal foo.nw > foo.tex

Dadurch werden alle Codeblöcke mithilfe des Pascal-Prettyprinters hübsch gedruckt. Du wirst brauchen
umfassen die pretzel-noweb.sty LaTeX-Dokumentstil nach Einbindung von noweb.sty ( sehen
nowebstyle(1) ) um die Ausgabe von LaTeX korrekt zu formatieren.

Sie können Debugging-Ausgaben vom Prettyprinting-Filter erhalten, indem Sie die Umgebung festlegen
Variable PRETZEL_NOWEB_DEBUG auf einen Wert ungleich Null, z. B. im bash(1) Shell mit den Worten:

exportieren PRETZEL_NOWEB_DEBUG=ein

Die Debug-Ausgabe stoppt nur, wenn der Wert explizit deaktiviert wird (in bash(1) dies ist der ungesetzt
eingebauter Befehl.

Die Option noweb funktioniert derzeit nur für LaTeX als Zielschriftsetzer. Wenn die
Bei Prettyprinter treten beim Prettyprinting eines bestimmten Codeblocks Probleme auf
schaltet automatisch auf die standardmäßige wörtliche Ausgabe von noweb um. Durch die Einbindung von Code
Innerhalb der Regeln der formatierten Grammatikdatei ist es möglich, die Indizierung zu automatisieren. Für mehr
Informationen siehe Kapitel 3 und 4 des Brezelbuchs, enthalten in der Brezel
Verteilung.

VORSICHTEN

Das Pretzel-it-Shell-Skript kann nur ausgeführt werden, wenn die Umgebungsvariablen vorhanden sind PRETZEL_LIBDIR
und PRETZEL_INCLUDE sind auf das Pretzel-Bibliotheksverzeichnis (/usr/lib/pretzel unter Debian) eingestellt
Systeme) und das Pretzel-Include-Verzeichnis (/usr/include/pretzel auf Debian-Systemen).
Während der Ausführung kann pretzel-it Warnungen ausgeben, die auf die von ihm aufgerufenen Programme zurückzuführen sind
(Brezel-es ruft auf Brezel(1), biegen(1), Bison(1) und der GNU C++-Compiler).

Die -n Die Option (noweb) funktioniert nur für LaTeX als Zielschriftsetzer und ist immer noch sehr nützlich
Experimental.

Nutzen Sie pretzel-it online über die Dienste von onworks.net