Wie kann ich auf einfachem Weg eine Umgebung modifizieren?

Statt eine existierende Umgebung umzudefinieren, ist es oftmals sicherer eine neue Umgebung zu definieren, die auf einer existierenden Umgebung basiert. Grund dafür ist, dass einige Umgebungen auch intern in Klassen oder Paketen verwendet werden. Das trifft beispielsweise in hohem Maße auf die Umgebung tabular und auch auf quote oder quotation zu. Mit einem modernen Editor ist es meist auch kein Problem, im Quelltext alle Umgebungen foo durch fooneu zu ersetzen.

Für das Definieren einer eigenen Umgebung unter Verwendung einer existierenden, gibt es zwei unterschiedliche Möglichkeiten:

\newenvironment{fooneu}{%
  \begin{fooalt}%
    % Hier die gewünschten Ergänzungen einfügen.
}{%
  \end{fooalt}%
}

oder

\newenvironment{fooneu}{%
  \fooalt
}{%
  \csname endfooalt\endcsname
}

Die erste Möglichkeit entspricht dabei der reinen Lehre, dass man in LaTeX nur die LaTeX-Benutzerschnittstelle verwenden sollte, die bei Umgebungen nun einmal aus \begin{…} und \end{…} besteht. Allerdings hat sie einen Nachteil, wenn ein Anwender bei \end{fooneu} einen Fehler macht. Dazu ein Beispiel:

\documentclass{article}
\newenvironment{newquote}{%
  \begin{quote}%
  \small
}{%
  \end{quote}%
}
\begin{document}
\begin{newquote}
Dieses Beispiel erzeugt eine verwirrende Fehlermeldung.
\end{NEWQUOTE}% ← absichtlicher Fehler
\end{document}

Die zugehörige Fehlermeldung lautet:

! LaTeX Error: \begin{quote} on input line 9 ended by \end{NEWQUOTE}.

Für den eingeweihten Anwender, der um die Definition von newquote weiß, ist die Fehlermeldung einleuchtend, da hier tatsächlich die quote-Umgebung aus dem \begin-Teil von newquote mit \end{NEWQUOTE} beendet wird. Wer die Definition von newquote nichts in die Betrachtung mit einbezieht, wird allerdings verwirrt sein.

Vergleichen wir dieselbe Fehlanwendung mit der zweiten Form der Definition:

\documentclass{article}
\newenvironment{newquote}{%
  \quote
  \small
}{%
  \csname endquote\endcsname
}
\begin{document}
\begin{newquote}
Dieses Beispiel erzeugt eine verwirrende Fehlermeldung.
\end{NEWQUOTE}% ← absichtlicher Fehler
\end{document}

Hier lautet die Fehlermeldung:

! LaTeX Error: \begin{newquote} on input line 9 ended by \end{NEWQUOTE}.

Damit entspricht sie den Erwartungen eines durchschnittlichen Anwenders. Hier wurde die Tatsache genutzt, dass LaTeX intern eine Umgebung foo als Anweisungen \foo und \endfoo definiert, wobei der \begin-Code in \foo und der \end-Code in \endfoo abgelegt ist.

Um zu verstehen, warum im \end-Teil der Definition dann nicht einfach \endfoo statt \csname endfoo\endcsname verwendet wurde, muss man wissen, dass LaTeX innerhalb von \end nicht wirklich \endfoo, sondern selbst ebenfalls \csname foo\endcsname aufruft. Das funktioniert auch, falls \endfoo gar nicht definiert ist, weil \csname foo\endcsname in diesem Fall \endfoo auf \relax setzt. In einigen Paketen sind deshalb die zur einer Umgebung gehörenden \end-Anweisungen gar nicht erst definiert. Ein expliziter Aufruf von \endfoo würde in diesem Fall einen Fehler aufgrund einer undefined controll sequence, also einer nicht definierten Anweisung ergeben. Natürlich ist es kein guter Stil, eine Umgebung foo so zu definieren, dass die zugehörige Anweisung \endfoo nicht definiert ist.

Aber auch diese Form der Definition hat ihre Grenzen. So gibt es einige Umgebungen, die gar keine echten LaTeX-Umgebungen sind. Dazu gehören beispielsweise die Umgebungen von amsmath oder die Umgebungen die mit Hilfe des Pakets environ definiert wurden, aber auch die filecontents- oder die verbatim-Umgebung und vergleichbare Umgebungen. Bei all diesen Umgebungen wird der Inhalt der Umgebung eher wie das Argument eines Befehls als wie der Inhalt einer normalen Umgebung behandelt. Bei all diesen Umgebungen ist sowohl bei ihrer Verwendung in andere Umgebungen als auch bei ihrer Umdefinierung daher besondere Vorsicht walten zu lassen. Näheres ist ggf. den entsprechenden Anleitungen zu entnehmen.

Zu beachten ist auch, dass die lrbox-Umgebung von LaTeX selbst, ebenfalls eine besondere Umgebung ist, die explizit zur Verwendung in anderen Umgebungen entworfen ist. Sie ist daher immer in der Form \begin{lrbox} und \end{lrbox} zu verwenden.