.\" -*- coding: UTF-8 -*-
'\" p
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
.TH \%soelim 1 "16. Oktober 2023" "Groff 1.23.0" 
.SH Name
\%soelim \- Quellanfragen in \fIroff\fP oder anderen Textdateien rekursiv
interpolieren
.
.
.\" ====================================================================
.\" Legal Terms
.\" ====================================================================
.\"
.\" Copyright (C) 1989-2020 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
.
.
.SY \%soelim
\fB\-\-help\fP
.YS
.
.
.SY \%soelim
\fB\-v\fP
.
.SY \%soelim
\fB\-\-version\fP
.YS
.
.
.\" ====================================================================
.SH Beschreibung
.\" ====================================================================
.
.\" GNU
GNU \fIsoelim\fP ist ein Präprozessor für das
.MR groff 7
Dokumentenformatierungssystem.
.
\fI\%soelim\fP funktioniert als Filter, um Quellanfragen in
.MR roff 7
Eingabedateien zu beseitigen. Es ersetzt Zeilen der Form »\fB.so\fP
\fIEinbindedatei\fP« innerhalb jeder Text\-\fIEingabedatei\fP rekursiv durch den
Inhalt von \fIEinbindedatei\fP.
.
Standardmäßig schreibt es auch \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.
.
Die Ausgabe wird in den Standardausgabendatenstrom geschrieben.
.
.
.PP
Falls der Name der \fIMakrodatei\fP einen Rückwärtsschrägstrich enthält,
verwenden Sie zu dessen Einbettung \fB\[rs]\[rs]\fP oder \fB\[rs]e\fP.
.
Um ein Leerzeichen einzubetten, schreiben Sie »\fB\[rs]\~\fP« (einen
Rückwärtsschrägstrich, gefolgt von einem Leerzeichen).
.
Alle anderen Maskiersequenzen in \fIMakrodatei\fP, einschließlich
»\fB\[rs][rs]\fP«, hindern \fB\%soelim\fP daran, die Quellanfrage zu ersetzen.
.
.
.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
\fIMakrodatei\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 \fI\%soelim\fP daher dazu verwandt werden,
allgemeine Textdateien zu verarbeiten, um einen Baum an Eingabedokumenten zu
glätten.
.
.
.PP
.\" generic
.\" generic
\fIsoelim\fP wurde entwickelt, um mit Situationen umzugehen, bei denen das Ziel
einer \fIroff\fP\-Quellanfrage die Verarbeitung durch einen Präprozesser
verlangt, wie
.MR \%eqn 1 ,
.MR \%pic 1 ,
.MR \%refer 1 ,
oder
.MR \%tbl 1 .
.
Die gewöhnliche Verarbeitungssequenz von Groff
.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
\fBtroff\fP(1) (dem eigentlichen Formatierungsprogramm) gelesen.
.
\fB\%soelim\fP wird von \fB\%troff\fP(1) \fInicht\fP für Quelldateien benötigt.
.
.
.PP
Falls eine eingelesene Datei auch vorverarbeitet werden soll, muss sie
bereits gelesen worden sein, \fIbevor\fP die Eingabedatei 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.
.
.
.TP 
\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 den Verzeichnispfad \fIVerz\fP nach \fIEingabe\-\fP und
\fIEinbinde\-Dateien\fP.
.
\fB\-I\fP kann mehr als einmal angegeben werden. Jedes \fIVerz\fP wird 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 "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 .