.\" -*- coding: UTF-8 -*-
'\" p
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH \%soelim 1 "15. März 2026" "Groff 1.24.1" 
.SH Name
\%soelim \- Quellanfragen in \fIroff\fP oder anderen Textdateien rekursiv
interpolieren
.
.
.\" ====================================================================
.\" Legal Terms
.\" ====================================================================
.\"
.\" Copyright (C) 1989-2024 Free Software Foundation, Inc.
.\"
.\" Permission is granted to make and distribute verbatim copies of this
.\" manual provided the copyright notice and this permission notice are
.\" preserved on all copies.
.\"
.\" Permission is granted to copy and distribute modified versions of
.\" this manual under the conditions for verbatim copying, provided that
.\" the entire resulting derived work is distributed under the terms of
.\" a permission notice identical to this one.
.\"
.\" Permission is granted to copy and distribute translations of this
.\" manual into another language, under the above conditions for
.\" modified versions, except that this permission notice may be
.\" included in translations approved by the Free Software Foundation
.\" instead of in the original English.
.
.
.\" Save and disable compatibility mode (for, e.g., Solaris 10/11).
.do nr *groff_soelim_1_man_C \n[.cp]
.cp 0
.
.\" Define fallback for groff 1.23's MR macro if the system lacks it.
.nr do-fallback 0
.if  !\n(.f           .nr do-fallback 1 \" mandoc
.if   \n(.g .if !d MR .nr do-fallback 1 \" older groff
.if  !\n(.g           .nr do-fallback 1 \" non-groff *roff
.if  \n[do-fallback]  \{\
.  de MR
.    ie \\n(.$=1 \
.      I \%\\$1
.    el \
.      IR \%\\$1 (\\$2)\\$3
.  .
.\}
.rr do-fallback
.\" Man pages are seldom preprocessed with pic(1).
.mso pic.tmac
.
.
.\" ====================================================================
.\" Definitions
.\" ====================================================================
.
.ie  t .ds tx T\h'-.1667m'\v'.224m'E\v'-.224m'\h'-.125m'X
.el   .ds tx TeX
.
.
.\" ====================================================================
.SH Übersicht
.\" ====================================================================
.
.SY \%soelim
[\fB\-Crt\fP] [\fB\-I\fP \fIVerz\fP] [\fIEingabedatei\ \fP…]
.YS
.
.
.P
.SY \%soelim
\fB\-\-help\fP
.YS
.
.
.P
.SY \%soelim
\fB\-v\fP
.YS
.
.SY \%soelim
\fB\-\-version\fP
.YS
.
.
.\" ====================================================================
.SH Beschreibung
.\" ====================================================================
.
.\" GNU
GNU \fBsoelim\fP ist ein Präprozessor für das
.MR groff 7
\-Dokumentenformatierungssystem.
.
\fI\%soelim\fP beseitigt Quellanfragen in
.MR roff 7
\- und anderen
Textdateien. Es ersetzt Zeilen der Form »\fB.so\fP \fIEinbindedatei\fP« innerhalb
jeder Text\-\fIEingabedatei\fP rekursiv durch den Inhalt von \fIEinbindedatei\fP,
um einen Baum an Dokumenten zu glätten.
.
Standardmäßig schreibt es auch \fBroff\fP \fBlf\fP\-Anfragen, um den Namen und die
Zeilennummer jeder \fIEingabedatei\fP und \fIEinbindedatei\fP aufzuzeichnen, so
dass alle Diagnostikangaben, die in der späteren Verarbeitung auftreten,
genau der Originaleingabe zugeordnet werden können.
.
Optionen ermöglichen es, diese Informationen zu unterdrücken (\fB\-r\fP) oder
stattdessen in \*[tx]\-Kommentaren (\fB\-t\fP) bereitzustellen.
.
Falls keine Argumente für \fIEingabedatei\fP vorhanden sind, liest \fB\%soelim\fP
den Standardeingabedatenstrom.
.
Das Programm schreibt in den Standardausgabendatenstrom.
.
.
.PP
.\" GNU
\fB\%soelim\fP liest das Argument \fIEinbinde\-Datei\fP wie es GNU\-
.MR 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 Anführungszeichen (\fB\[dq]\fP) voran.
.
Leerzeichen, die nicht am Anfang sind, werden wörtlich interpretiert.
.
.\" GNU
Ein Rückwärtsschrägstrich, gefolgt von einem Leerzeichen (»\fB\[rs]\ \fP«)
kodiert auch ein Leerzeichen\&. Dies dient der Kompatibilität mit früheren
Version von GNU \fBsoelim\fP.
.
Falls der eingebundene Dateiname einen Rückwärtsschrägstrich benötigt,
verwenden Sie zu dessen Einbettung \fB\[rs]\[rs]\fP oder \fB\[rs]e\fP.
.
Alle anderen Maskiersequenzen in \fIEinbinde\-Dateien\fP, einschließlich
»\fB\[rs][rs]\fP«, hindern \fB\%soelim\fP daran, die Quellanfrage zu ersetzen.
.
AT&T und abgeleitete Versionen von \fBsoelim\fP stellen keine Möglichkeit der
Einbettung von Leerzeichen in Dateinamen bereit. Sie ersetzen das erste
auftretende Leerzeichen durch einen Zeilenumbruch und beenden die
Interpretation der Anforderung.
.
.
.PP
Der Punkt muss am Zeilenanfang sein und ihm muss »\fBso\fP« ohne Leerzeichen
oder Tabulatoren folgen, damit \fI\%soelim\fP damit umgehen kann.
.
Diese Konvention erlaubt es, Quellanfragen vor der Verarbeitung durch
\fI\%soelim\fP zu schützen, zum Beispiel als Teil einer Makrodefinition oder
»\fBif\fP\^«\-Anfragen.
.
.
.PP
Es muss auch mindestens ein Leerzeichen zwischen »\fBso\fP« und seinem Argument
\fIEinbinde\-Datei\fP sein.
.
Die Option \fB\-C\fP setzt diese Anforderung außer Kraft.
.
.
.PP
Das Vorgestellte ist die Obergrenze des Verständnisses von \fI\%soelim\fP von
der Sprache \fIroff\fP. Es ersetzt beispielsweise die Eingabezeile
.
.RS
.EX
\&.if 1 .so Anderedatei
.EE
.RE
.
nicht durch den Inhalt der \fIAnderendatei\fP.
.
Mit seiner Option \fB\-r\fP kann \fB\%soelim\fP daher dazu verwandt werden,
allgemeine Textdateien zu verarbeiten.
.
.
.PP
.\" generic
.\" generic
\fBsoelim\fP wurde entwickelt, um mit Situationen umzugehen, bei denen das Ziel
einer
.MR roff 7
\-Quellanfrage die Verarbeitung durch einen Präprozesser
wie
.MR \%eqn 1 ,
.MR \%pic 1 ,
.MR \%refer 1
oder
.MR \%tbl 1
verlangt,
.
Die normale Verarbeitungssequenz von
.MR groff 1
ist wie folgt:
.
.if  !'\%'\%' \{\
In the diagrams below,
the traditional names for
.I soelim
and
.I troff
are used;
on this system,
the GNU versions are installed as
.I \%soelim
and
.IR \%troff .
.\}
.\" Does this groff installation use a command prefix?  In installed
.\" pages, this comparison will not look like it needs to be dynamically
.\" decided.
.\"
.\" This is done so that the box sizes (in the pic(1) diagram) and arrow
.\" alignments (in the text alternative) can remain fixed.
.
.
.PP
.ie  t \{\
.PS
.ps 10
.vs 12
box invisible width 0.5 height 0.4 "input" "file";
move to last box .bottom;
down;
arrow 0.3;
box invisible width 0.8 height 0.2 "preprocessor";
move to last box .right
right;
arrow 0.3;
A: box invisible width 0.35 height 0.2 "troff";
move to last box .top;
up;
move 0.3;
box invisible width 0.6 height 0.4 "sourced" "file";
line <- up 0.3 from A.top;
move to A.right;
right;
arrow 0.3;
box invisible width 0.85 height 0.2 "postprocessor";
move to last box .bottom;
down;
arrow 0.3;
box invisible width 0.5 height 0.4 "output" "file"
.ps
.vs
.PE
.\}
.el \{\
.EX
          input        sourced
          file          file
            \[bv]             \[bv]
            \[da]             \[da]
        preprocessor \[an]\[->] troff \[an]\[->] postprocessor
                                      \[bv]
                                      \[da]
                                   output
                                    file
.EE
.\}
.PP
Das heißt, mit »\fB.so\fP« eingelesene Dateien werden normalerweise \fInur\fP von
.MR troff 1
(dem eigentlichen Formatierungsprogramm) gelesen.
.
\fB\%soelim\fP wird von
.MR \%troff 1
\fInicht\fP für Quelldateien benötigt.
.
.
.br
.ne 2v
.P
Falls eine eingelesene Datei auch vorverarbeitet werden soll, muss sie
bereits gelesen worden sein, \fIbevor\fP die Eingabe durch den Präprozessor
gegeben wird.
.
\fI\%soelim\fP, aufgerufen mittels der Option \fB\-s\fP von \fIgroff\fP, erledigt
dies.
.
.
.PP
.ie  t \{\
.PS
.ps 10
.vs 12
box invisible width 0.5 height 0.4 "input" "file";
move to last box .bottom;
down;
arrow 0.3;
A: box invisible width 0.5 height 0.2 "soelim";
line <- 0.3;
box invisible width 0.5 height 0.4 "sourced" "file";
move to A.right;
right;
arrow 0.3;
box invisible width 0.8 height 0.2 "preprocessor";
arrow 0.3;
box invisible width 0.35 height 0.2 "troff";
arrow 0.3
box invisible width 0.85 height 0.2 "postprocessor";
move to last box .bottom;
down;
arrow 0.3;
box invisible width 0.5 height 0.4 "output" "file"
.ps
.vs
.PE
.\}
.el \{\
.EX
          input
          file
            \[bv]
            \[da]
          soelim \[an]\[->] preprocessor \[an]\[->] troff \[an]\[->] \
postprocessor
            \[ua]                                     \[bv]
            \[bv]                                     \[da]
         sourced                               output
          file                                  file
.EE
.\}
.
.
.\" ====================================================================
.SH Optionen
.\" ====================================================================
.
\fB\-\-help\fP zeigt eine Hilfe zur Verwendung an, während \fB\-v\fP und \fB\-\-version\fP
die Versionsinformation anzeigen. Alle drei beenden sich danach.
.
.
.\" "-I dir" + 2n
.TP  8n 
\fB\-C\fP
Erkennt eine Eingabezeile, die mit \fB.so\fP beginnt, selbst wenn diesem kein
Leerzeichen oder Zeilenumbruch folgt.
.
.TP 
\fB\-I\ \fP\fIVerz\fP
Durchsucht das Verzeichnis \fIVerz\fP nach \fIEingabe\-\fP und \fIEinbinde\-Dateien\fP.
.
Falls mehr als einmal angegeben, wird jedes \fIVerz\fP in der angegebenen
Reihenfolge durchsucht.
.
Um das aktuelle Arbeitsverzeichnis vor anderen zu durchsuchen, fügen Sie
»\fB\-I .\&\fP« an der gewünschten Stelle hinzu. Andernfalls wird es als letztes
durchsucht.
.
.
.TP 
\fB\-r\fP
Schreibt Dateien »roh«. Fügt keine \fBlf\fP\-Anfragen hinzu.
.
.
.TP 
\fB\-t\fP
Gibt mit »\fB%\fP« beginnende \*[tx]\-Kommentarzeilen aus, die die aktuelle
Datei und Zeilennummer anzeigen, anstatt \fBlf\fP\-Anfragen für den gleichen
Zweck.
.
.
.PP
Falls sowohl \fB\-r\fP als auch \fB\-t\fP angegeben sind, steuert die zuletzt
angegebene Option.
.
.
.\" ====================================================================
.SH Rückgabewert
.\" ====================================================================
.
\fB\%soelim\fP beendet sich mit Status\ \fB0\fP bei erfolgreicher Aktion, Status\ \fB2\fP, falls das Programm seine Befehlszeilenargumente nicht interpretieren
kann und Status\ \fB1\fP, falls es während der Aktion auf einen Fehler trifft.
.
.
.\" ====================================================================
.SH "Siehe auch"
.\" ====================================================================
.
.MR groff 1
.
.
.\" Clean up.
.rm tx
.
.\" Restore compatibility mode (for, e.g., Solaris 10/11).
.cp \n[*groff_soelim_1_man_C]
.do rr *groff_soelim_1_man_C
.
.
.\" Local Variables:
.\" fill-column: 72
.\" mode: nroff
.\" End:
.\" vim: set filetype=groff textwidth=72:
.PP
.SH ÜBERSETZUNG
Die deutsche Übersetzung dieser Handbuchseite wurde von
Helge Kreutzmann <debian@helgefjell.de>
erstellt.
.PP
Diese Übersetzung ist Freie Dokumentation; lesen Sie die
.UR https://www.gnu.org/licenses/gpl-3.0.html
GNU General Public License Version 3
.UE
oder neuer bezüglich der
Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen.
.PP
Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden,
schicken Sie bitte eine E-Mail an die
.MT debian-l10n-german@lists.debian.org
Mailingliste der Übersetzer
.ME .