soelim(1) General Commands Manual soelim(1) Name soelim - Quellanfragen in roff oder anderen Textdateien rekursiv interpolieren Ubersicht soelim [-Crt] [-I Verz] [Eingabedatei ] soelim --help soelim -v soelim --version Beschreibung GNU soelim ist ein Praprozessor fur das groff(7) Dokumentenformatierungssystem. soelim funktioniert als Filter, um Quellanfragen in roff(7) Eingabedateien zu beseitigen. Es ersetzt Zeilen der Form >>.so Einbindedatei<< innerhalb jeder Text-Eingabedatei rekursiv durch den Inhalt von Einbindedatei. Standardmassig schreibt es auch lf-Anfragen, um den Namen und die Zeilennummer jeder Eingabedatei und Einbindedatei aufzuzeichnen, so dass alle Diagnostikangaben, die in der spateren Verarbeitung auftreten, genau der Originaleingabe zugeordnet werden konnen. Optionen ermoglichen es, diese Informationen zu unterdrucken (-r) oder stattdessen in TeX-Kommentaren (-t) bereitzustellen. Falls keine Argumente fur Eingabedatei vorhanden sind, liest soelim den Standardeingabedatenstrom. Die Ausgabe wird in den Standardausgabendatenstrom geschrieben. Falls der Name der Makrodatei einen Ruckwartsschragstrich enthalt, verwenden Sie zu dessen Einbettung \\ oder \e. Um ein Leerzeichen einzubetten, schreiben Sie >>\ << (einen Ruckwartsschragstrich, gefolgt von einem Leerzeichen). Alle anderen Maskiersequenzen in Makrodatei, einschliesslich >>\[rs]<<, hindern soelim daran, die Quellanfrage zu ersetzen. Der Punkt muss am Zeilenanfang sein und ihm muss >>so<< ohne Leerzeichen oder Tabulatoren folgen, damit soelim damit umgehen kann. Diese Konvention erlaubt es, Quellanfragen vor der Verarbeitung durch soelim zu schutzen, zum Beispiel als Teil einer Makrodefinition oder >>if<<-Anfragen. Es muss auch mindestens ein Leerzeichen zwischen >>so<< und seinem Argument Makrodatei sein. Die Option -C setzt diese Anforderung ausser Kraft. Das Vorgestellte ist die Obergrenze des Verstandnisses von soelim von der Sprache roff. Es ersetzt beispielsweise die Eingabezeile .if 1 .so Anderedatei nicht durch den Inhalt der Anderendatei. Mit seiner Option -r kann soelim daher dazu verwandt werden, allgemeine Textdateien zu verarbeiten, um einen Baum an Eingabedokumenten zu glatten. soelim wurde entwickelt, um mit Situationen umzugehen, bei denen das Ziel einer roff-Quellanfrage die Verarbeitung durch einen Praprozesser verlangt, wie eqn(1), pic(1), refer(1), oder tbl(1). Die gewohnliche Verarbeitungssequenz von Groff groff(1) ist wie folgt: input sourced file file | | v v preprocessor --> troff --> postprocessor | v output file Das heisst, mit >>.so<< eingelesene Dateien werden normalerweise nur von troff(1) (dem eigentlichen Formatierungsprogramm) gelesen. soelim wird von troff(1) nicht fur Quelldateien benotigt. Falls eine eingelesene Datei auch vorverarbeitet werden soll, muss sie bereits gelesen worden sein, bevor die Eingabedatei durch den Praprozessor gegeben wird. soelim, aufgerufen mittels der Option -s von groff, erledigt dies. input file | v soelim --> preprocessor --> troff --> postprocessor ^ | | v sourced output file file Optionen --help zeigt eine Hilfe zur Verwendung an, wahrend -v und --version die Versionsinformation anzeigen. Alle drei beenden sich danach. -C Erkennt eine Eingabezeile, die mit .so beginnt, selbst wenn diesem kein Leerzeichen oder Zeilenumbruch folgt. -I Verz Durchsucht den Verzeichnispfad Verz nach Eingabe- und Einbinde-Dateien. -I kann mehr als einmal angegeben werden. Jedes Verz wird in der angegebenen Reihenfolge durchsucht. Um das aktuelle Arbeitsverzeichnis vor anderen zu durchsuchen, fugen Sie >>-I ." << an der gewunschten Stelle hinzu. Andernfalls wird es als letztes durchsucht. -r Schreibt Dateien >>roh<<. Fugt keine lf-Anfragen hinzu. -t Gibt mit >>%<< beginnende TeX-Kommentarzeilen aus, die die aktuelle Datei und Zeilennummer anzeigen, anstatt lf-Anfragen fur den gleichen Zweck. Falls sowohl -r als auch -t angegeben sind, steuert die zuletzt angegebene Option. Siehe auch groff(1) UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Helge Kreutzmann erstellt. Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG ubernommen. Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Ubersetzer . Groff 1.23.0 13. September 2023 soelim(1)