<html><head><meta name="color-scheme" content="light dark"></head><body><pre style="word-wrap: break-word; white-space: pre-wrap;">%^^A ---- introduction
\section{Einleitung}

Dieses Paket dient dazu, manuelle Ã„nderungsmarkierung zu ermÃ¶glichen.

VerbesserungsvorschlÃ¤ge, Gedanken oder Kritik sind willkommen.
Das Paket wird auf \emph{gitlab} gehalten, bitte gehen Sie zu

\url{https://edgesoft.de/projects/changes/}

fÃ¼r Links zum Quellcodezugang, Fehler- und Featuretracker etc.
Wenn Sie mich direkt kontaktieren wollen, mailen Sie bitte an \href{mailto:ekleinod@edgesoft.de}{ekleinod@edgesoft.de}.
Bitte starten Sie Ihr Mail-Subject mit \texttt{[changes]}.

\begin{quote}
	Das changes-Paket dient zur manuellen Markierung von geÃ¤ndertem Text, insbesondere EinfÃ¼gungen, LÃ¶schungen und Ersetzungen.
	Der geÃ¤nderte Text wird farbig markiert und, bei gelÃ¶schtem Text, durchgestrichen.
	ZusÃ¤tzlich kann Text hervorgehoben und/oder kommentiert werden.
	Das Paket ermÃ¶glicht die freie Definition von Autoren und deren zugeordneten Farben.
	Es erlaubt zusÃ¤tzlich die Ã„nderung des Ã„nderungs-, Autor-, Hervorhebungs- und Kommentarmarkups.
\end{quote}

Ein kurzes Beispiel fÃ¼r Ã„nderungsmarkierung:

\begin{quote}
	Das ist \added[id=EK, comment={fehlendes Wort}]{zugefÃ¼gter} Text.
	In diesem Satz ersetze ich ein \replaced[id=EK]{gutes}{schlechtes} Wort.
	Und jetzt noch ein \deleted[id=EK]{schlechtes} Wort zum LÃ¶schen.
	Text kann auch \highlight[id=EK]{hervorgehoben} oder nur \comment[id=EK]{Aus SpaÃŸ!} kommentiert werden.
\end{quote}

Im gleichen Ordner wie dieses Handbuch befindet sich ein Ordner "`examples"', der eine reichhaltige Auswahl an Anwendungsbeispielen fÃ¼r das Paket und dessen Befehle enthÃ¤lt.
Bitte sehen Sie die Beispiele als Inspiration oder erste FehlerlÃ¶sungsquelle an.


%^^A ---- usage
\cleardoublepage
\section{Benutzung des \docpackage{changes}-Pakets}
\label{sec:usage}

In diesem Kapitel wird die Nutzung des \docpackage{changes}-Pakets beschrieben.
Dabei wird ein typischer Anwendungsfall geschildert.
Die ausfÃ¼hrliche Beschreibung der Paketoptionen und neuen Befehle finden Sie nicht hier, sondern in \autoref{sec:ui}.

Ausgangslage ist ein Text, an dem Ã„nderungen vorgenommen werden sollen.
Diese Ã„nderungen sollen markiert werden, und zwar fÃ¼r jeden Autor einzeln.
Eine solche Ã„nderungsmarkierung ist \zB von WYSIWYG-Textprogrammen wie \emph{LibreOffice}, \emph{OpenOffice} oder \emph{Word} bekannt.

Zu diesem Zweck wurde das \docpackage{changes}-Paket entwickelt.
Das Paket stellt Befehle zur VerfÃ¼gung, um verschiedene Autoren zu definieren und Text als zugefÃ¼gt, gelÃ¶scht oder geÃ¤ndert zu markieren.
ZusÃ¤tzlich kann Text hervorgehoben oder kommentiert werden.
Um das Paket zu nutzen, sollten Sie folgende Schritte ausfÃ¼hren:

\begin{enumerate}
	\item \docpackage{changes}-Paket einbinden
	\item Autoren definieren
	\item TextÃ¤nderungen markieren
	\item Text hervorheben und kommentieren
	\item Dokument mit \hologo{LaTeX} setzen
	\item Liste von Ã„nderungen anzeigen lassen
	\item Markierungen entfernen
\end{enumerate}

\minisec{\docpackage{changes}-Paket einbinden}

Um die Ã„nderungsverfolgung zu aktivieren, ist das \docpackage{changes}-Paket wie folgt einzubinden:

\chinline{usepackage_changes}

bzw.

\chinline{usepackage_options_changes}

Mit den verfÃ¼gbaren Optionen bestimmen Sie hauptsÃ¤chlich das Aussehen der Ã„nderungsmarkierungen.
Sie kÃ¶nnen das Aussehen der Ã„nderungsmarkierungen auch nach Einbinden des \docpackage{changes}-Pakets verÃ¤ndern.

FÃ¼r Details lesen Sie bitte \autoref{sec:ui:options} und \autoref{sec:ui:customizingoutput}.

\minisec{Autoren definieren}

Das \docpackage{changes}-Paket stellt einen vordefinierten anonymen Autor zur VerfÃ¼gung.
Wenn Sie jedoch die Ã„nderungen per Autor\_in verfolgen wollen, mÃ¼ssen Sie die entsprechenden Autor\_innen definieren.
Dies geht wie folgt:

\chinline{definechangesauthor}

Ãœber die ID werden der/die Autor\_in und die zugehÃ¶rigen TextÃ¤nderungen eindeutig identifiziert.
Optional kÃ¶nnen Sie einen Namen angeben und dem/der Autor\_in eine eigene Farbe zuweisen.

FÃ¼r Details lesen Sie bitte \autoref{sec:ui:authormanagement}.

\minisec{TextÃ¤nderungen markieren}

Jetzt ist alles vorbereitet, um den geÃ¤nderten Text zu markieren.
Benutzen Sie bitte je nach Ã„nderung die folgenden Befehle:

fÃ¼r neu zugefÃ¼gten Text:

\chinline{added}

fÃ¼r gelÃ¶schten Text:

\chinline{deleted}

fÃ¼r geÃ¤nderten Text:

\chinline{replaced}

Die Angabe von Autoren-ID und eines Kommentars ist optional.

FÃ¼r Details lesen Sie bitte \autoref{sec:ui:changemanagement}.


\minisec{Text hervorheben und kommentieren}

Vielleicht mÃ¶chten Sie noch Text hervorheben oder kommentieren?

Text hervorheben:

\chinline{highlight}

Text kommentieren:

\chinline{comment}

Die Angabe der Autoren-ID und des Kommentars fÃ¼r Hervorhebungen ist optional.

FÃ¼r Details lesen Sie bitte \autoref{sec:ui:comment}.


\minisec{Dokument mit \hologo{LaTeX} setzen}

Nachdem Sie die Ã„nderungen im \hologo{LaTeX}-Text markiert haben, kÃ¶nnen Sie sie im erzeugten Dokument sichtbar machen, indem Sie das Dokument ganz normal Ã¼bersetzen.
Durch die Ãœbersetzung wird der geÃ¤nderte Text so markiert, wie Sie das mittels der Optionen bzw.\ speziellen Befehle eingestellt haben.

\minisec{Liste von Ã„nderungen anzeigen lassen}

Sie kÃ¶nnen sich eine Liste der Ã„nderungen ausgeben lassen.
Dies erfolgt mit dem Kommando:

\chinline{listofchanges}

Die Ausgabe ist gedacht als Analogon zur Liste von Tabellen oder Abbildungen.

Die Angabe des Stils ist optional, standardmÃ¤ÃŸig wird \docoption{style=list} gewÃ¤hlt.
Um einen schnellen Ãœberblick Ã¼ber Art und Anzahl der Ã„nderungen abhÃ¤ngig von dem/der Autor\_in zu bekommen, verwenden Sie den Befehl mit der Option \docoption{style=summary} oder \docoption{style=compactsummary}.
Zeigen Sie nur bestimme Ã„nderungstypen mit der \docoption{show}-Option.

Bei jedem \hologo{LaTeX}-Lauf werden die Daten fÃ¼r diese Liste in eine Hilfsdatei geschrieben.
Beim nÃ¤chsten \hologo{LaTeX}-Lauf werden dann diese Daten genutzt, um die Ã„nderungsliste anzuzeigen.
Daher sind nach jeder Ã„nderung zwei \hologo{LaTeX}-LÃ¤ufe notwendig, um eine aktuelle Ã„nderungsliste anzuzeigen.

FÃ¼r Details lesen Sie bitte \autoref{sec:ui:overview}.

\minisec{Markierungen entfernen}

Oft ist es der Fall, dass die Ã„nderungen eines Dokuments angenommen oder abgelehnt werden und nach diesem Prozess die Ã„nderungsmarkierungen entfernt werden sollen.
Sie kÃ¶nnen die Ausgabe der Ã„nderungsmarkierungen per Option beim Einbinden des \docpackage{changes}-Pakets unterdrÃ¼cken:

\chinline{usepackage_final_changes}

Die Entfernung der Markierungen aus dem Quelltext mÃ¼ssen Sie von Hand vornehmen, dafÃ¼r steht auch ein Script von Yvon Cui zur VerfÃ¼gung.
Das Script liegt im Verzeichnis:

\chinline[, language=bash]{path_script}

Das Script entfernt alle Markierungen, indem die Ã„nderungen angenommen oder abgelehnt werden.
Sie kÃ¶nnen die zu entfernenden Markierungen individuell im interaktiven Modus selektieren bzw.\ selektieren, indem Sie das Skript ohne Optionen starten.

FÃ¼r Details lesen Sie bitte \autoref{sec:remove-markup}.



%^^A ---- limitations
\cleardoublepage
\section{EinschrÃ¤nkungen und ErweiterungsmÃ¶glichkeiten}
\label{sec:limitations}

Das \docpackage{changes}-Paket ist sorgfÃ¤ltig programmiert und getestet worden.
Dennoch kann es vorkommen, dass Fehler im Paket sind, dass die Benutzung problematisch ist oder dass eine Funktion fehlt, die Sie gerne hÃ¤tten.

Eine Ãœbersicht Ã¼ber die wichtigsten mir bekannten Probleme und eventuell vorhandenen LÃ¶sungen finden Sie in \autoref{sec:known-problems}.
Bitte sehen Sie dort zunÃ¤chst nach, ob Ihr Problem schon bekannt ist und es eine LÃ¶sung gibt.
Weitere Fehler, Probleme und LÃ¶sungen finden Sie auf:

\url{https://edgesoft.de/projects/changes/}

or

\url{https://gitlab.com/ekleinod/changes/-/issues}

Sie kÃ¶nnen mir auch eine Mail schreiben an \href{mailto:ekleinod@edgesoft.de}{ekleinod@edgesoft.de}, in diesem Fall starten Sie bitte Ihr Mail-Subject mit \texttt{[changes]}.

Die Ã„nderungsmarkierung von Text funktioniert recht gut, es kÃ¶nnen auch ganze AbsÃ¤tze markiert werden.
Die Markierung ist eingeschrÃ¤nkt oder nicht mÃ¶glich fÃ¼r:

\begin{itemize}
	\item Abbildungen
	\item Tabellen
	\item Ãœberschriften
	\item manche Kommandos
	\item mehrere AbsÃ¤tze (manchmal)
\end{itemize}

Sie kÃ¶nnen versuchen, solchen Text in eine eigene Datei auszulagern, und diese mit \texttt{input} einzubinden.
Manchmal hilft das, oft ist es einen Versuch wert.
Danke an Charly Arenz fÃ¼r diesen Tip.

Wenn Sie Fehler wegen bereits vorhandener Makros bekommen, schauen Sie sich bitte die Option \docoption{commandnameprefix} in \autoref{sec:ui:options:commandnameprefix} an.


%^^A ---- user interface
\cleardoublepage
\section{Die Benutzerschnittstelle des \docpackage{changes}-Pakets}
\label{sec:ui}

In diesem Kapitel wird die Nutzerschnittstelle des \docpackage{changes}-Pakets vorgestellt, \dh alle Optionen und Kommandos.
Jede Option bzw. jedes neue Kommando werden beschrieben.
Wenn Sie die Optionen und Kommandos im Beispiel sehen wollen, sehen Sie bitte in das Beispielverzeichnis unter

\chinline[, language=bash]{path_doc_examples}

Die Beispieldateien sind mit der benutzten Option bzw. dem benutzten Kommando benannt.

%^^A -- options
\subsection{Paketoptionen}
\label{sec:ui:options}

\chinline{usepackage_options_changes}

Die Paketoptionen bestimmen das Verhalten des Gesamtpakets, \dh aller Befehle.

Die folgenden Optionen sind definiert:

\localtableofcontents



\subsubsection{draft}

\chinline{usepackage_draft_changes}

Die \docoption{draft}-Option bewirkt, dass alle Ã„nderungen markiert werden.
Die Ã„nderungsliste kann durch \doccommand{listofchanges} ausgegeben werden.
Diese Option ist automatisch voreingestellt.

Die Angabe von \docoption{draft} in \doccommand{documentclass} wird vom \docpackage{changes}-Paket mitgenutzt.
Die lokale Angabe von \docoption{final} Ã¼berstimmt die Angabe von \docoption{draft} in \doccommand{documentclass}.


\subsubsection{final}

\chinline{usepackage_final_changes}

Die \docoption{final}-Option bewirkt, dass alle Ã„nderungsmarkierungen ausgeblendet werden und nur noch der korrekte Text ausgegeben wird.
Die Ã„nderungsliste wird ebenfalls unterdrÃ¼ckt.

Die Angabe von \docoption{final} in \doccommand{documentclass} wird vom \docpackage{changes}-Paket mitgenutzt.
Die lokale Angabe von \docoption{draft} Ã¼berstimmt die Angabe von \docoption{final} in \doccommand{documentclass}.


\subsubsection{commandnameprefix}
\label{sec:ui:options:commandnameprefix}

\chinline{usepackage_commandnameprefix_changes}

Die \docoption{commandnameprefix}-Option legt die PrÃ¤fix-Strategie fÃ¼r die Hervorhebungskommandos fest.
Das ist hilfreich, wenn ein anderes Paket bereits ein Kommando definiert hat, \zB \doccommand{comment} oder \doccommand{highlight}.

StandardmÃ¤ÃŸig wird in diesem Fall ein Fehler ausgegeben und kein PrÃ¤fix vergeben (Option ist nicht oder auf \docoption{none} gesetzt).

Wenn eine PrÃ¤fix-Strategie angegeben ist, wird dem betreffenden Kommando ein "`ch"' vorangestellt.
Die Strategie legt fest, welche Kommandos einen PrÃ¤fix bekommen.

Diese Option wirkt sich nur auf die Ã„nderungs- und Hervorhebungkommandos aus:

\begin{itemize}
	\item \doccommand{added} \ensuremath{\to} \doccommand{chadded}
	\item \doccommand{deleted} \ensuremath{\to} \doccommand{chdeleted}
	\item \doccommand{replaced} \ensuremath{\to} \doccommand{chreplaced}
	\item \doccommand{highlight} \ensuremath{\to} \doccommand{chhighlight}
	\item \doccommand{comment} \ensuremath{\to} \doccommand{chcomment}
\end{itemize}

Folgende Strategien stehen zur VerfÃ¼gung:

\begin{description}
	\item [\docoption{none}] kein PrÃ¤fix, wenn ein Kommando bereits definiert ist, wird eine Fehlermeldung ausgegeben (Standardstrategie)
	\item [\docoption{ifneeded}] falls ein Kommando bereits definiert ist, bekommt es ein PrÃ¤fix und eine Warnung wird ausgegeben.
		Je nachdem, welche Kommandos bereits definiert sind, wird das Dokument eine Mischung von Kommandos mit und ohne PrÃ¤fix enthalten.
		Diese Strategie ist vor allem nÃ¼tzlich, wenn nur die Kommandos \doccommand{comment} oder \doccommand{highlight} bereits definiert sind und fÃ¼r die Ã„nderungsmarkierung die normalen Kommandos \doccommand{added}, \doccommand{deleted} und \doccommand{replaced} genutzt werden sollen.
	\item [\docoption{always}] alle Kommandos bekommen ein PrÃ¤fix, eine entsprechende Nachricht wird ins Log geschrieben
\end{description}

\chexample{usepackage_commandnameprefix_changes}


\subsubsection{markup}

\chinline{usepackage_markup_changes}

Die \docoption{markup}-Option wÃ¤hlt ein vordefiniertes visuelles Markup fÃ¼r geÃ¤nderten Text.
Das default-Markup wird gewÃ¤hlt, wenn die Option nicht gesetzt wird.
Das mit \docoption{markup} gewÃ¤hlte Markup kann mit den spezielleren Optionen \docoption{addedmarkup}, \docoption{deletedmarkup}, \docoption{commentmarkup} oder \docoption{highlightmarkup} geÃ¤ndert werden.

Die folgenden Werte fÃ¼r \emph{markup} sind definiert:
\begin{description}
	\item [\docoption{default}] default fÃ¼r zugefÃ¼gten, gelÃ¶schten und hervorgehobenen Text sowie Kommentare (default)
	\item [\docoption{underlined}] zugefÃ¼gter Text wird unterstrichen, gewellt unterstrichen fÃ¼r Hervorhebungen, default fÃ¼r gelÃ¶schten Text sowie Kommentare
	\item [\docoption{bfit}] fetter zugefÃ¼gter Text, schrÃ¤ger gelÃ¶schter Text, default fÃ¼r hervorgehobenen Text sowie Kommentare
	\item [\docoption{nocolor}] es werden keine Farben verwendet, zugefÃ¼gter Text wird unterstrichen, gewellt unterstrichen fÃ¼r Hervorhebungen, default fÃ¼r gelÃ¶schten Text sowie Kommentare
\end{description}

\chexample{usepackage_markup_changes}

Wenn von farbigem zu nichtfarbigem Markup oder umgekehrt gewechselt wird und eine Hilfsdatei existiert werden einige Kompilierfehler angezeigt.
Ãœber diese ist hinwegzuspringen, beim zweiten Durchlauf sollten die Fehler verschwunden sein.


\subsubsection{addedmarkup}

\chinline{usepackage_addedmarkup_changes}

Die \docoption{addedmarkup}-Option wÃ¤hlt ein vordefiniertes visuelles Markup fÃ¼r zugefÃ¼gten Text.
Das default-Markup wird gewÃ¤hlt, wenn die Option nicht gesetzt wird.
Die Option \docoption{addedmarkup} Ã¼berschreibt das mit \docoption{markup} gewÃ¤hlte Markup.

Die folgenden Werte fÃ¼r \emph{addedmarkup} sind definiert:
\begin{description}
	\item [\docoption{colored}] kein Textmarkup, nur farbige Kennzeichnung -- {\color{orange} Beispiel} (default)
	\item [\docoption{uline}] unterstrichener Text -- \uline{Beispiel}
	\item [\docoption{uuline}] doppelt unterstrichener Text -- \uuline{Beispiel}
	\item [\docoption{uwave}] gewellt unterstrichener Text -- \uwave{Beispiel}
	\item [\docoption{dashuline}] gestrichelt unterstrichener Text -- \dashuline{Beispiel}
	\item [\docoption{dotuline}] gepunktet unterstrichener Text -- \dotuline{Beispiel}
	\item [\docoption{bf}] fetter Text -- \textbf{Beispiel}
	\item [\docoption{it}] italic Text -- \textit{Beispiel}
	\item [\docoption{sl}] schrÃ¤ger Text -- \textsl{Beispiel}
	\item [\docoption{em}] hervorgehobener Text -- \emph{Beispiel}
\end{description}

Die Ausgabe ersetzten Texts ist ein Kombination von zugefÃ¼gtem und gelÃ¶schten Text, daher beeinflusst deren LayoutÃ¤nderung auch das Layout ersetzen Texts.

\chexample{usepackage_addedmarkup_changes}


\subsubsection{deletedmarkup}
\label{sec:ui:options:deletedmarkup}

\chinline{usepackage_deletedmarkup_changes}

Die \docoption{addedmarkup}-Option wÃ¤hlt ein vordefiniertes visuelles Markup fÃ¼r zugefÃ¼gten Text.
Die \docoption{deletedmarkup}-Option wÃ¤hlt analog ein vordefiniertes visuelles Markup fÃ¼r gelÃ¶schten Text.
Das default-Markup wird gewÃ¤hlt, wenn die Option nicht gesetzt wird.
Die Optionen \docoption{addedmarkup} und \docoption{deletedmarkup} Ã¼berschreiben das mit \docoption{markup} gewÃ¤hlte Markup.

Die folgenden Werte fÃ¼r \emph{addedmarkup} sind definiert:

\begin{description}
	\item [\docoption{sout}] durchgestrichener Text -- \sout{Beispiel} (default)
	\item [\docoption{xout}] schrÃ¤g durchgestrichener Text -- \xout{Beispiel}
	\item [\docoption{colored}] kein Textmarkup, nur farbige Kennzeichnung -- {\color{orange} Beispiel}
	\item [\docoption{uline}] unterstrichener Text -- \uline{Beispiel}
	\item [\docoption{uuline}] doppelt unterstrichener Text -- \uuline{Beispiel}
	\item [\docoption{uwave}] gewellt unterstrichener Text -- \uwave{Beispiel}
	\item [\docoption{dashuline}] gestrichelt unterstrichener Text -- \dashuline{Beispiel}
	\item [\docoption{dotuline}] gepunktet unterstrichener Text -- \dotuline{Beispiel}
	\item [\docoption{bf}] fetter Text -- \textbf{Beispiel}
	\item [\docoption{it}] italic Text -- \textit{Beispiel}
	\item [\docoption{sl}] schrÃ¤ger Text -- \textsl{Beispiel}
	\item [\docoption{em}] hervorgehobener Text -- \emph{Beispiel}
\end{description}

Die Ausgabe ersetzten Texts ist ein Kombination von zugefÃ¼gtem und gelÃ¶schten Text, daher beeinflusst deren LayoutÃ¤nderung auch das Layout ersetzen Texts.

\chexample{usepackage_deletedmarkup_changes}


\subsubsection{highlightmarkup}

\chinline{usepackage_highlightmarkup_changes}

Die \docoption{highlightmarkup}-Option wÃ¤hlt ein vordefiniertes visuelles Markup fÃ¼r hervorgehobenen Text.
Das default-Markup wird gewÃ¤hlt, wenn die Option nicht gesetzt wird.
Die Option \docoption{highlightmarkup} Ã¼berschreibt das mit \docoption{markup} gewÃ¤hlte Markup.

Die folgenden Werte fÃ¼r \emph{highlightmarkup} sind definiert:

\begin{description}
	\item [\docoption{background}] Hervorhebung durch Hintergrundfarbe -- \colorbox{orange!30}{Beispiel} (default)
	\item [\docoption{uuline}] doppelt unterstrichener Text -- \uuline{Beispiel}
	\item [\docoption{uwave}] gewellt unterstrichener Text -- \uwave{Beispiel}
\end{description}

\chexample{usepackage_highlightmarkup_changes}


\subsubsection{commentmarkup}

\chinline{usepackage_commentmarkup_changes}

Die \docoption{commentmarkup}-Option wÃ¤hlt ein vordefiniertes visuelles Markup fÃ¼r Kommentare.
Das default-Markup wird gewÃ¤hlt, wenn die Option nicht gesetzt wird.
Die Option \docoption{commentmarkup} Ã¼berschreibt das mit \docoption{markup} gewÃ¤hlte Markup.

Die folgenden Werte fÃ¼r \emph{commentmarkup} sind definiert:

\begin{description}
	\item [\docoption{todo}] Kommentar als ToDo-Notiz, die nicht in der Liste der ToDos erscheint\todo{Beispielkommentar} (default)
	\item [\docoption{margin}] Kommentar im Seitenrand\marginpar{Beispielkommentar}
	\item [\docoption{footnote}] Kommentar als FuÃŸnote\footnote{Beispielkommentar}
	\item [\docoption{uwave}] gewellt unterstrichener Text -- \uwave{Beispielkommentar}
\end{description}

\chexample{usepackage_commentmarkup_changes}


\subsubsection{authormarkup}

\chinline{usepackage_authormarkup_changes}

Die \docoption{authormarkup}-Option wÃ¤hlt ein vordefiniertes visuelles Markup fÃ¼r die Autor-Identifizierung.
Das default-Markup wird gewÃ¤hlt, wenn die Option nicht gesetzt wird.

Die folgenden Werte fÃ¼r \emph{authormarkup} sind definiert:

\begin{description}
	\item [\docoption{superscript}] hochgestellter Text -- Text\textsuperscript{Autor} (default)
	\item [\docoption{subscript}] tiefgestellter Text -- Text\textsubscript{Autor}
	\item [\docoption{brackets}] Text in Klammern -- Text(Autor)
	\item [\docoption{footnote}] Text in einer FuÃŸnote -- Text\footnote{Autor}
	\item [\docoption{none}] keine Autor-Identifizierung
\end{description}

\chexample{usepackage_authormarkup_changes}


\subsubsection{authormarkupposition}

\chinline{usepackage_authormarkupposition_changes}

Die \docoption{authormarkupposition}-Option gibt an, wo die Autor-Identifizierung gesetzt wird.
Der default-Wert wird gewÃ¤hlt, wenn die Option nicht gesetzt wird.

Die folgenden Werte fÃ¼r \emph{authormarkupposition} sind definiert:

\begin{description}
	\item [\docoption{right}] rechts vom Text -- Text\textsuperscript{Autor} (default)
	\item [\docoption{left}] links vom Text -- \textsuperscript{Autor}Text
\end{description}

\chexample{usepackage_authormarkupposition_changes}


\subsubsection{authormarkuptext}

\chinline{usepackage_authormarkuptext_changes}

Die \docoption{authormarkuptext}-Option gibt an, was fÃ¼r die Autor-Identifizierung genutzt wird.
Der default-Wert wird gewÃ¤hlt, wenn die Option nicht gesetzt wird.

Die folgenden Werte fÃ¼r \emph{authormarkuptext} sind definiert:

\begin{description}
	\item [\docoption{id}] Autoren-ID -- Text\textsuperscript{ID} (default)
	\item [\docoption{name}] Autorenname -- Text\textsuperscript{Autorenname}
\end{description}

\chexample{usepackage_authormarkuptext_changes}


\subsubsection{defaultcolor}

\chinline{usepackage_defaultcolor_changes}

Die \docoption{defaultcolor}-Option legt die Standardfarbe fÃ¼r Autoren, insbesondere den anonymen Autor fest.
Sie kÃ¶nnen die Farben des \docpackage{xcolor}-Pakets benutzen.

Die Standardfarbe ist blau (\emph{blue}).

\chexample{usepackage_defaultcolor_changes}


\subsubsection{todonotes}

\chinline{usepackage_todonotes_changes}

Optionen fÃ¼r das \docpackage{todonotes}-Paket kÃ¶nnen als Parameter der \docoption{todonotes}-Option angegeben werden.
Mehrere Optionen oder Angaben mit Sonderzeichen mÃ¼ssen in geschweifte Klammern gesetzt werden.

\chexample{usepackage_todonotes_changes}



\subsubsection{truncate}

\chinline{usepackage_truncate_changes}

Optionen fÃ¼r das \docpackage{truncate}-Paket kÃ¶nnen als Parameter der \docoption{truncate}-Option angegeben werden.
Mehrere Optionen oder Angaben mit Sonderzeichen mÃ¼ssen in geschweifte Klammern gesetzt werden.

\chexample{usepackage_truncate_changes}



\subsubsection{ulem}

\chinline{usepackage_ulem_changes}

Optionen fÃ¼r das \docpackage{ulem}-Paket kÃ¶nnen als Parameter der \docoption{ulem}-Option angegeben werden.
Mehrere Optionen oder Angaben mit Sonderzeichen mÃ¼ssen in geschweifte Klammern gesetzt werden.

\chexample{usepackage_ulem_changes}



\subsubsection{xcolor}

\chinline{usepackage_xcolor_changes}

Optionen fÃ¼r das \docpackage{xcolor}-Paket kÃ¶nnen als Parameter der \docoption{xcolor}-Option angegeben werden.
Mehrere Optionen oder Angaben mit Sonderzeichen mÃ¼ssen in geschweifte Klammern gesetzt werden.

\chexample{usepackage_xcolor_changes}


%^^A ---- change management

\subsection{Ã„nderungsmanagement}
\label{sec:ui:changemanagement}

\localtableofcontents

\chnewcmd{added}

\chinline{added}

Der Befehl \doccommand{added} markiert zugefÃ¼gten Text.
Der neue Text wird in geschweiften Klammern Ã¼bergeben.

Das optionale Argument enthÃ¤lt Key-Value-Paare fÃ¼r die Angabe von Autor-ID sowie eines Kommentars.
Die Autor-ID muss mit einer mit dem \doccommand{definechangesauthor}-Befehl definierten ID Ã¼bereinstimmen.
EnthÃ¤lt der Kommentar Sonderzeichen oder Leerzeichen, ist er in geschweifte Klammern einzuschlieÃŸen.

Wenn ein Kommentar angegeben wurde, wird das direkte Autormarkup am geÃ¤nderten Text unterdrÃ¼ckt, da es im Kommentar erscheint.

\chexample{added}
\chresult{added}


\chnewcmd{deleted}

\chinline{deleted}

Der Befehl \doccommand{deleted} markiert gelÃ¶schten Text.
Der gelÃ¶schte Text wird in geschweiften Klammern Ã¼bergeben.

Optionale Argumente: siehe \doccommand{added} (\autoref{sec:ui:cmd:added}).

\chexample{deleted}
\chresult{deleted}


\chnewcmd{replaced}

\chinline{replaced}

Der Befehl \doccommand{replaced} markiert geÃ¤nderten Text.
Der neue sowie der alte Text werden in dieser Reihenfolge jeweils in geschweiften Klammern Ã¼bergeben.

Optionale Argumente: siehe \doccommand{added} (\autoref{sec:ui:cmd:added}).

Die Ausgabe ersetzten Texts ist ein Kombination von zugefÃ¼gtem und gelÃ¶schten Text, daher beeinflusst deren LayoutÃ¤nderung auch das Layout ersetzen Texts.

\chexample{replaced}
\chresult{replaced}



%^^A -- Highlighting and Comments ------------------------------------------------------
\subsection{Hervorhebungen und Kommentare}
\label{sec:ui:comment}

\localtableofcontents

\chnewcmd{highlight}

\chinline{highlight}

Der Befehl \doccommand{highlight} markiert hervorgehobenen Text.
Der hervorzuhebende Text wird in geschweiften Klammern Ã¼bergeben.

Optionale Argumente: siehe \doccommand{added} (\autoref{sec:ui:cmd:added}).

\chexample{highlight}
\chresult{highlight}


\chnewcmd{comment}

\chinline{comment}

Der Befehl \doccommand{comment} fÃ¼gt dem Dokument einen Kommentar hinzu.
Der Kommentar wird als in geschweiften Klammern Ã¼bergeben.

Der Befehl besitzt nur ein optionales Argument: ein Key-Value-Paar fÃ¼r die Angabe der Autor-ID.
Die Autor-ID muss mit einer mit dem \doccommand{definechangesauthor}-Befehl definierten ID Ã¼bereinstimmen.

Die Kommentare werden durchnumeriert, die Nummer erscheint im Kommentar.

\chexample{comment}
\chresult{comment}






%^^A -- Overview of changes
\subsection{Ã„nderungsÃ¼bersicht}
\label{sec:ui:overview}


\chnewcmd{listofchanges}

\chinline{listofchanges}

Der Befehl \doccommand{listofchanges} gibt eine Liste oder Zusammenfassung der Ã„nderungen aus.
Im ersten \hologo{LaTeX}-Lauf wird eine Hilfsdatei angelegt, deren Daten im zweiten Durchlauf eingebunden werden.
FÃ¼r eine aktuelle Liste der Ã„nderungen sind daher zwei \hologo{LaTeX}-LÃ¤ufe notwendig.

Es kÃ¶nnen drei optionale Argumente angegeben werden:

\begin{description}
	\item[\docoption{style}] Listenstil
	\item[\docoption{title}] individueller Titel
	\item[\docoption{show}] Ã„nderungstypen
\end{description}

\paragraph{style}
Ãœber das Argument \docoption{style} kÃ¶nnen verschiedene Listenstile fÃ¼r die Anzeige ausgewÃ¤hlt werden.
Es sind folgende drei Stile definiert:

\begin{description}
	\item[\docoption{list}] gibt die Ã„nderungsliste wie ein Inhaltsverzeichnis aus (default)
	\item[\docoption{summary}] gibt die Anzahl der Ã„nderungen gruppiert nach Autor aus
	\item[\docoption{compactsummary}] wie \docoption{summary}, jedoch werden Ã„nderungen mit Anzahl 0 nicht ausgegeben
\end{description}

\paragraph{title}
Mit dem Argument \docoption{title} kann ein eigener Titel fÃ¼r die Ã„nderungsliste angegeben werden.
Wenn Sie Sonderzeichen oder Leerzeichen im Titel benutzen wollen, klammern Sie den Titel geschweift ein.

\paragraph{show}
Das Argument \docoption{show} gibt an, welche Ã„nderungstypen in der Ã„nderungsliste ausgegeben werden.
Sie kÃ¶nnen die Typen mit Hilfe des Zeichens \texttt{|} kombinieren.
Wenn Sie \zB alle neuen Texte und alle LÃ¶schungen anzeigen wollen, geben Sie \texttt{show=added|deleted} an.

Die folgenden Werte sind definiert:

\begin{description}
	\item[\docoption{all}] alle Typen (default)
	\item[\docoption{added}] nur neue Texte
	\item[\docoption{deleted}] nur LÃ¶schungen
	\item[\docoption{replaced}] nur Ersetzungen
	\item[\docoption{highlight}] nur Hervorhebungen
	\item[\docoption{comment}] nur Kommentare
\end{description}

\chexample{listofchanges}



%^^A ---- Author management

\subsection{Autorenverwaltung}
\label{sec:ui:authormanagement}

\chnewcmd{definechangesauthor}

\chinline{definechangesauthor}

Der Befehl \doccommand{definechangesauthor} definiert einen neuen Autor/eine neue Autorin fÃ¼r Ã„nderungen.
Es muss eine eindeutige Autor-ID angegeben werden, die keine Sonder- oder Leerzeichen enthalten darf.

Optional kann eine Farbe und ein Name angegeben werden.
Wird keine Farbe angegeben, wird blau genutzt.

Der Name wird in der Ã„nderungsliste sowie im Markup benutzt, im Markup jedoch nur, wenn die entsprechende Option gesetzt ist.

Das Paket definiert einen anonymen Autor vor, der ohne ID genutzt werden kann.

\chexample{definechangesauthor}


%^^A ---- Adaptation of the output
\subsection{Anpassung der Ausgabe}
\label{sec:ui:customizingoutput}

\localtableofcontents

\subsubsection{Werte fÃ¼r die Anpassung in den Makros}

Wenn Sie die Ausgabe anpassen wollen, kÃ¶nnen sie beliebige \hologo{LaTeX}-Befehle sowie spezielle Werte oder Makros des \docpackage{changes}-Pakets benutzen.
Einige Werte sind makrospezifisch, diese sind in den Makros beschrieben.

Die folgenden Werte und Makros kÃ¶nnen Sie in jedem Kommando benutzen:

\begin{itemize}
	\item beliebige \hologo{LaTeX}-Befehle
	\item Autorenfarbe wird in der Farbe "`authorcolor"' bereitgestellt
	\item boolscher Test auf farbigen Text mit "`\doccommand{IfIsColored}"'
\end{itemize}

Ich stelle nicht den vollen Zugriff auf alle Parameter des Markups zur VerfÃ¼gung, um die Makros einfach zu halten.
So ist \zB die Autoren-ID nur fÃ¼r \doccommand{setcommentmarkup} zugreifbar.

Die Ausgabe ersetzten Texts ist ein Kombination von zugefÃ¼gtem und gelÃ¶schten Text.


\chnewcmd{setaddedmarkup}

\chinline{setaddedmarkup}

Der Befehl \doccommand{setaddedmarkup} legt fest, wie neuer Text ausgezeichnet wird.
Ohne andere Definition gilt, dass der Text farbig oder je nach Option \docoption{markup} bzw.\ \docoption{addedmarkup} erscheint.

Werte fÃ¼r die Definition:

\begin{itemize}
	\item neuer Text wird mit "`\#1"' gesetzt
\end{itemize}

\chexample{setaddedmarkup}

Die Ausgabe ersetzten Texts ist ein Kombination von zugefÃ¼gtem und gelÃ¶schten Text, daher beeinflusst deren LayoutÃ¤nderung auch das Layout ersetzen Texts.


\chnewcmd{setdeletedmarkup}

\chinline{setdeletedmarkup}

Der Befehl \doccommand{setdeletedmarkup} legt fest, wie gelÃ¶schter Text ausgezeichnet wird.
Ohne andere Definition gilt, dass der Text durchgestrichen wird oder je nach Option \docoption{markup} bzw.\ \docoption{deletedmarkup} erscheint.

Werte fÃ¼r die Definition:

\begin{itemize}
	\item gelÃ¶schter Text wird mit "`\#1"' gesetzt
\end{itemize}

Die Ausgabe ersetzten Texts ist ein Kombination von zugefÃ¼gtem und gelÃ¶schten Text, daher beeinflusst deren LayoutÃ¤nderung auch das Layout ersetzen Texts.

\chexample{setdeletedmarkup}


\chnewcmd{sethighlightmarkup}

\chinline{sethighlightmarkup}

Der Befehl \doccommand{sethighlightmarkup} legt fest, wie hervorgehobene Texte gesetzt werden.
Ohne andere Definition gilt, dass die Hervorhebung Ã¼ber die Hintergrundfarbe erfolgt oder je nach Option \docoption{markup} bzw.\ \docoption{commentmarkup} erscheint.

Werte fÃ¼r die Definition:

\begin{itemize}
	\item hervorgehobener Text wird mit "`\#1"' gesetzt
\end{itemize}

\chexample{sethighlightmarkup}


\chnewcmd{setcommentmarkup}

\chinline{setcommentmarkup}

Der Befehl \doccommand{setcommentmarkup} legt fest, wie Kommentare gesetzt werden.
Ohne andere Definition gilt, dass Kommentare im Rand oder je nach Option \docoption{markup} bzw.\ \docoption{commentmarkup} erscheint.

Werte fÃ¼r die Definition:

\begin{itemize}
	\item Kommentar wird mit "`\#1"' gesetzt
	\item Autor-ID steht in "`\#2"' bereit
	\item Autor-Ausgabe (ID oder Name) wird mit "`\#3"' gesetzt
	\item Kommentaranzahl steht in "`authorcommentcount"' bereit
	\item boolscher Test auf anonymen Autor mit "`\doccommand{IfIsAnonymous}"'
\end{itemize}

\chexample{setcommentmarkup}


\chnewcmd{setauthormarkup}

\chinline{setauthormarkup}

Der Befehl \doccommand{setauthormarkup} legt fest, wie der Autortext im Text angezeigt wird.
Ohne andere Definition gilt, dass der Autor hochgestellt erscheint.

Werte fÃ¼r die Definition:

\begin{itemize}
	\item Autor-Ausgabe (ID oder Name) wird mit "`\#1"' gesetzt
\end{itemize}

\chexample{setauthormarkup}


\chnewcmd{setauthormarkupposition}

\chinline{setauthormarkupposition}

Der Befehl \doccommand{setauthormarkupposition} legt fest, auf welcher Seite der Autor im Text angezeigt wird.
Ohne andere Definition gilt, dass der Autor rechts von den Ã„nderungen erscheint.

Die folgenden Werte fÃ¼r \emph{authormarkupposition} sind definiert:

\begin{description}
	\item [\docoption{right}] rechts vom Text -- Text\textsuperscript{Autor} (default)
	\item [\docoption{left}] links vom Text -- \textsuperscript{Autor}Text
\end{description}

\chexample{setauthormarkupposition}


\chnewcmd{setauthormarkuptext}

\chinline{setauthormarkuptext}

Der Befehl \doccommand{setauthormarkuptext} legt fest, welche Information des Autors im Text angezeigt wird.
Ohne andere Definition gilt, dass die Autor-ID genutzt wird.

Die folgenden Werte fÃ¼r \emph{authormarkuptext} sind definiert:

\begin{description}
	\item [\docoption{id}] Autoren-ID -- Text\textsuperscript{ID} (default)
	\item [\docoption{name}] Autorenname -- Text\textsuperscript{Autorenname}
\end{description}

\chexample{setauthormarkuptext}


\chnewcmd{setanonymousname}

\chinline{setanonymousname}

Der Befehl \doccommand{setanonymousname} legt den Namen des anonymen Autors fest.
Der Standardname ist das sprachabhÃ¤ngige Ã„quivalent zu "`Anonym"'.

Diese Option ist \zB hilfreich, wenn man die/der einzige Autor:in ist und den Namen bei den Ã„nderungen angezeigt haben will.

\chexample{setanonymousname}



\chnewcmd{settruncatewidth}

\chinline{settruncatewidth}

Der Befehl \doccommand{settruncatewidth} legt die Breite der TextkÃ¼rzung in der Ã„nderungsliste fest.
Die Standardbreite ist \texttt{0.6}\doccommand{textwidth}.

\chexample{settruncatewidth}



\chnewcmd{setsummarywidth}

\chinline{setsummarywidth}

Der Befehl \doccommand{setsummarywidth} legt die Breite der Ã„nderungsliste mit Stil \docoption{summary} bzw.\ \docoption{compactsummary} fest.
Die Standardbreite ist \texttt{0.3}\doccommand{textwidth}.

\chexample{setsummarywidth}



\chnewcmd{setsummarytowidth}

\chinline{setsummarytowidth}

Der Befehl \doccommand{setsummarytowidth} legt die Breite der Ã„nderungsliste mit Stil \docoption{summary} bzw.\ \docoption{compactsummary} anhand der Breite des Ã¼bergebenen Texts fest.

\chexample{setsummarytowidth}



\chnewcmd{setlocextension}

\chinline{setlocextension}

Der Befehl \doccommand{setlocextension} legt die Dateierweiterung der Hilfsdatei fÃ¼r die Liste der Ã„nderungen (loc-Datei\footnote{%
	"`loc"' steht dabei fÃ¼r "`list of changes"'.
}) fest.
Ohne andere Definition gilt das Suffix "`\texttt{loc}"'.

Im angegebenen Beispiel wÃ¼rde fÃ¼r "`\texttt{foo.tex}"' eine Hilfsdatei erzeugt werden, die "`\texttt{foo.listofchanges}"' bzw.\ "`\texttt{foo.lochg}"' statt des Standardnamens "`\texttt{foo.loc}"' hieÃŸe.

\chexample{setlocextension}

\chimportant{Nutzen Sie keine Standard-\hologo{LaTeX}-Dateierweiterungen wie "`toc"' oder "`lof"', da das den normalen \hologo{LaTeX}-Lauf stÃ¶ren wÃ¼rde.}



\chnewcmd{setsocextension}

\chinline{setsocextension}

Der Befehl \doccommand{setsocextension} legt die Dateierweiterung der Hilfsdatei fÃ¼r die Ã„nderungszusammenfassung (soc-Datei\footnote{%
	"`soc"' steht dabei fÃ¼r "`summary of changes"'.
}) fest.
Ohne andere Definition gilt das Suffix "`\texttt{soc}"'.

Im angegebenen Beispiel wÃ¼rde fÃ¼r "`\texttt{foo.tex}"' eine Hilfsdatei erzeugt werden, die "`\texttt{foo.changes}"' bzw.\ "`\texttt{foo.chg}"' statt des Standardnamens "`\texttt{foo.soc}"' hieÃŸe.

\chexample{setsocextension}

\chimportant{Nutzen Sie keine Standard-\hologo{LaTeX}-Dateierweiterungen wie "`toc"' oder "`lof"', da das den normalen \hologo{LaTeX}-Lauf stÃ¶ren wÃ¼rde.}


%^^A ---- packages
\subsection{BenÃ¶tigte Pakete}
\label{sec:ui:packages}

Das \docpackage{changes}-Paket bindet bereits Pakete ein, die fÃ¼r die Funktion des Pakets notwendig sind.
Eine genauere Beschreibung der einzelnen Pakete ist in der Dokumentation der Pakete selbst zu finden.

Die folgenden Pakete sind zwingend notwendig und mÃ¼ssen fÃ¼r die Nutzung des \docpackage{changes}-Pakets installiert sein:
\begin{description}
	\item [etoolbox] stellt verbesserte \doccommand{if}-Abfragen, \emph{bools} oder Listenoperationen zur VerfÃ¼gung
	\item [truncate] KÃ¼rzung von Texten (fÃ¼r die Ã„nderungsliste)
	\item [xkeyval] Eingabe von Optionen mit WerteÃ¼bergabe
	\item [xstring] verbesserte Stringoperationen
\end{description}

Die folgenden Pakete sind manchmal notwendig und mÃ¼ssen installiert sein, wenn sie Ã¼ber die entsprechende Option genutzt werden:
\begin{description}
	\item [todonotes] wird geladen, wenn Kommentare als ToDo-Notizen gesetzt werden (default Markup)
	\item [ulem] wird geladen, wenn Text durchgestrichen, gewellt markiert oder ausge-x-t wird (default Markup)
	\item [xcolor] wird geladen, wenn farbiger Text genutzt wird (default Markup)
\end{description}


%^^A ---- Remove markup from file
\cleardoublepage
\section{Markierungen aus den Dateien entfernen}
\label{sec:remove-markup}

Die Entfernung der Markierungen aus dem Quelltext mÃ¼ssen Sie von Hand vornehmen, dafÃ¼r steht auch ein Script von Yvon Cui zur VerfÃ¼gung.
Das Script liegt im Verzeichnis:

\chinline[, language=bash]{path_script}

Das Script entfernt alle Markierungen, indem die Ã„nderungen angenommen oder abgelehnt werden.
Sie kÃ¶nnen die zu entfernenden Markierungen individuell im interaktiven Modus selektieren bzw.\ selektieren, indem Sie das Skript ohne Optionen starten.

Das Skript benÃ¶tigt \emph{python3}.

Nutzen Sie das Skript wie folgt:

\chinputlisting{, language=bash}{userdoc/script_pymergechanges}

Starten Sie das Skript ohne Optionen und Dateien fÃ¼r eine kurze Hilfe:

\chinputlisting{, language=bash}{userdoc/script_pymergechanges_empty}

Bekannte Probleme:

\begin{itemize}
	\item entfernt nur Markierungen, die in einer Zeile stehen, Markierungen, die mehrere Zeilen umfassen, werden ignoriert
\end{itemize}



%^^A ---- Known problems and solutions
\cleardoublepage
\section{Bekannte Probleme und LÃ¶sungen}
\label{sec:known-problems}

In diesem Kapitel sammle ich die hÃ¤ufigsten Probleme und mir dazu bekannte LÃ¶sungen.
Wenn Ihr Problem hier nicht aufgefÃ¼hrt ist, sehen Sie bitte im Issue-Tracker auf gitlab nach, ob das Problem dort beschrieben ist (es gibt eine Suche):

\url{https://gitlab.com/ekleinod/changes/issues}

Wenn das alles zu nichts fÃ¼hrt, Ã¶ffnen Sie bitte ein neues Issue fÃ¼r das Problem, beschreiben Sie das Problem genau und liefern Sie, wenn mÃ¶glich, eine kleine Beispieldatei mit dem problematischen Verhalten mit.

\subsection{Besondere Inhalte}

Die Ã„nderungsmarkierung von Text funktioniert recht gut, es kÃ¶nnen auch ganze AbsÃ¤tze markiert werden.
Die Markierung ist eingeschrÃ¤nkt oder nicht mÃ¶glich fÃ¼r:

\begin{itemize}
	\item Abbildungen
	\item Tabellen
	\item Ãœberschriften
	\item manche Kommandos
	\item mehrere AbsÃ¤tze (manchmal)
\end{itemize}

Sie kÃ¶nnen versuchen, solchen Text in eine eigene Datei auszulagern, und diese mit \texttt{input} einzubinden.
Manchmal hilft das, oft ist es einen Versuch wert.
Danke an Charly Arenz fÃ¼r diesen Tip.

\subsection{FuÃŸnoten und Randnotizen}

FuÃŸnoten oder Randnotizen werden in bestimmten Umgebungen, \zB Tabellen oder der \emph{tabbing}-Umgebung, nicht korrekt gesetzt.
Vermeiden Sie das Markup, wenn Sie diese Umgebungen benutzen.

\subsection{Das \docpackage{ulem}-Paket}

Ich verwende standardmÃ¤ÃŸig das \docpackage{ulem}-Paket fÃ¼r das Durchstreichen von Text.
Das fÃ¼hrt bei manchen Befehlen und Umgebungen zu Problemen, \zB

\begin{itemize}
	\item im Mathemodus
	\item bei Verwendung des \docpackage{siunitx}-Pakets
	\item bei Nutzung der \doccommand{citet}- oder \doccommand{citep}-Befehle
\end{itemize}

In dem Fall gibt es wenig gute MÃ¶glichkeiten, am besten ist es, das Markup fÃ¼r LÃ¶schungen selbst zu definieren und das \docpackage{ulem}-Paket zu vermeiden.
Siehe

\begin{itemize}
	\item \autoref{sec:ui:options:deletedmarkup}
	\item \autoref{sec:ui:cmd:setdeletedmarkup}
\end{itemize}


\subsection{Kommando bereits definiert -- command already defined}

Einige Pakete benutzen fÃ¼r ihre Kommandos dieselben Namen wie das \docpackage{changes}-Paket, insbesondere \doccommand{comment} und \doccommand{highlight} sind keine originell benannten Kommandos.

In diesem Fall kann \docpackage{changes} seinen Kommandos ein PrÃ¤fix voranstellen, um Namenskollisionen zu vermeiden.
Das wird Ã¼ber die Option \docoption{commandnameprefix} gesteuert, die in \autoref{sec:ui:options:commandnameprefix} beschrieben ist.

Damit das funktioniert, muss das \docpackage{changes}-Paket nach dem Paket geladen werden, das das Kommando auch benutzt.



%^^A ---- Authors
\cleardoublepage
\section{Autorinnen und Autoren}
\label{sec:authors}

Am \docpackage{changes}-Paket haben mehrere Autorinnen und Autoren mitgewirkt.
Viele Probleme wurden in de.comp.text.tex gelÃ¶st oder deren LÃ¶sung durch LÃ¶sungsansÃ¤tzen inspiriert.
Danke.

Die Autorinnen und Autoren sind in alphabetischer Reihenfolge:
\begin{itemize}
	\item Chiaradonna, Silvano
	\item Cui, Yvon
	\item Fischer, Ulrike
	\item Giovannini, Daniele
	\item Kleinod, Ekkart
	\item Le Garrec, Vincent
	\item Mittelbach, Frank
	\item Richardson, Alexander
	\item Voss, Herbert
	\item WÃ¶lfel, Philipp
	\item Wolter, Steve
\end{itemize}



%^^A ---- Versions
\cleardoublepage
\section{Versionen}
\label{sec:versions}

FÃ¼r eine Liste der verfÃ¼gbaren Versionen und deren Ã„nderungen gehen Sie bitte zu

\url{https://gitlab.com/ekleinod/changes/blob/master/changelog.md}

Dort sind auch die bereits implementierten aber noch nicht verÃ¶ffentlichten Ã„nderungen verzeichnet.

Wenn Sie an geplanten, zukÃ¼nftigen Ã„nderungen interessiert sind, finden Sie diese unter

\url{https://gitlab.com/ekleinod/changes/milestones}


%^^A ---- copyright, license
\cleardoublepage
\section{Weitergabe, Copyright, Lizenz}

Copyright 2007-2021 Ekkart Kleinod (\href{mailto:ekleinod@edgesoft.de}{ekleinod@edgesoft.de})

Dieses Paket darf unter der "`\hologo{LaTeX} Project Public License"' Version~1.3 oder jeder spÃ¤teren Version weitergegeben und/oder geÃ¤ndert werden.
Die neueste Version dieser Lizenz steht auf \url{http://www.latex-project.org/lppl.txt} Version~1.3 und spÃ¤tere Versionen sind Teil aller \hologo{LaTeX}-Distributionen ab Version~2005/12/01.

Dieses Paket besitzt den Status "`maintained"' (verwaltet).
Der aktuelle Verwalter dieses Pakets ist Ekkart Kleinod.

Dieses Paket besteht aus den Dateien

\begin{tabbing}
	mm\=\kill
	\&gt;\texttt{source/latex/changes/changes.drv}\\
	\&gt;\texttt{source/latex/changes/changes.dtx}\\
	\&gt;\texttt{source/latex/changes/changes.ins}\\
	\&gt;\texttt{source/latex/changes/examples.dtx}\\
	\&gt;\texttt{source/latex/changes/regression.dtx}\\
	\&gt;\texttt{source/latex/changes/README}\\
	\&gt;\texttt{source/latex/changes/userdoc/*.tex}\\

	\&gt;\texttt{scripts/changes/pyMergeChanges.py}
\end{tabbing}


und den generierten Dateien

\begin{tabbing}
	mm\=\kill
	\&gt;\texttt{doc/latex/changes/changes.english.pdf}\\
	\&gt;\texttt{doc/latex/changes/changes.english.withcode.pdf}\\
	\&gt;\texttt{doc/latex/changes/changes.ngerman.pdf}\\

	\&gt;\texttt{doc/latex/changes/examples/changes.example.*.tex}\\
	\&gt;\texttt{doc/latex/changes/examples/changes.example.*.pdf}\\

	\&gt;\texttt{doc/latex/changes/regression/changes.regression.*.tex}\\
	\&gt;\texttt{doc/latex/changes/regression/changes.regression.*.pdf}\\

	\&gt;\texttt{tex/latex/changes/changes.sty}
\end{tabbing}


%^^A end of user documentation
</pre></body></html>