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 beseitigt Quellanfragen in roff(7) - und anderen Textdateien. Es ersetzt Zeilen der Form >>.so Einbindedatei<< innerhalb jeder Text-Eingabedatei rekursiv durch den Inhalt von Einbindedatei, um einen Baum an Dokumenten zu glatten. Standardmassig schreibt es auch roff 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. Das Programm schreibt in den Standardausgabendatenstrom. soelim liest das Argument Einbinde-Datei wie es GNU- troff(1) macht. Es ignoriert Leerzeichen direkt nach >>so<<. Um eine Abfolge von einem oder mehreren Leerzeichen am Anfang eines Arguments zu kodieren, stellen Sie der Abfolge ein neutrales englisches Anfuhrungszeichen (") voran. Leerzeichen, die nicht am Anfang sind, werden wortlich interpretiert. Ein Ruckwartsschragstrich, gefolgt von einem Leerzeichen (>>\ <<) kodiert auch ein Leerzeichen. Dies dient der Kompatibilitat mit fruheren Version von GNU soelim. Falls der eingebundene Dateiname einen Ruckwartsschragstrich benotigt, verwenden Sie zu dessen Einbettung \\ oder \e. Alle anderen Maskiersequenzen in Einbinde-Dateien, einschliesslich >>\[rs]<<, hindern soelim daran, die Quellanfrage zu ersetzen. AT&T und abgeleitete Versionen von soelim stellen keine Moglichkeit der Einbettung von Leerzeichen in Dateinamen bereit. Sie ersetzen das erste auftretende Leerzeichen durch einen Zeilenumbruch und beenden die Interpretation der Anforderung. 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 Einbinde-Datei 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. soelim wurde entwickelt, um mit Situationen umzugehen, bei denen das Ziel einer roff(7) -Quellanfrage die Verarbeitung durch einen Praprozesser wie eqn(1), pic(1), refer(1) oder tbl(1) verlangt, Die normale Verarbeitungssequenz von 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 Eingabe 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 das Verzeichnis Verz nach Eingabe- und Einbinde-Dateien. Falls mehr als einmal angegeben, wird jedes Verz 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. Ruckgabewert soelim beendet sich mit Status 0 bei erfolgreicher Aktion, Status 2, falls das Programm seine Befehlszeilenargumente nicht interpretieren kann und Status 1, falls es wahrend der Aktion auf einen Fehler trifft. 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.24.1 15. Marz 2026 soelim(1)