summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/koma-script/source-doc/english/scrlayer-notecolumn.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/koma-script/source-doc/english/scrlayer-notecolumn.tex')
-rw-r--r--macros/latex/contrib/koma-script/source-doc/english/scrlayer-notecolumn.tex31
1 files changed, 26 insertions, 5 deletions
diff --git a/macros/latex/contrib/koma-script/source-doc/english/scrlayer-notecolumn.tex b/macros/latex/contrib/koma-script/source-doc/english/scrlayer-notecolumn.tex
index 47cc29a8aa..20651e4003 100644
--- a/macros/latex/contrib/koma-script/source-doc/english/scrlayer-notecolumn.tex
+++ b/macros/latex/contrib/koma-script/source-doc/english/scrlayer-notecolumn.tex
@@ -1,6 +1,6 @@
% ======================================================================
% scrlayer-notecolumn.tex
-% Copyright (c) Markus Kohm, 2013-2018
+% Copyright (c) Markus Kohm, 2013-2019
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
@@ -18,7 +18,7 @@
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% scrlayer-notecolumn.tex
-% Copyright (c) Markus Kohm, 2013-2018
+% Copyright (c) Markus Kohm, 2013-2019
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
@@ -51,7 +51,7 @@
\translator{Markus Kohm\and Arndt Schubert\and Karl Hagen}
-% Date of the translated German file: 2018-02-05
+% Date of the translated German file: 2019-10-09
\chapter{Note Columns with \Package{scrlayer-notecolumn}}
\labelbase{scrlayer-notecolumn}
@@ -482,7 +482,29 @@ commands mentioned in the example above does not occur with the starred
variant\important{\Macro{makenote*}}. It uses \Macro{detokenize} to prevent
the expansion of commands. But this also means that you should not use
commands in the \PName{note} that change their definition within the
-document.%
+document.
+
+Unfortunately, both commands have two other known
+limitations\textnote{Attention!}. The first issue is related to colours using
+\Package{color}\IndexPackage{color} or \Package{xcolor}\IndexPackage{xcolor}
+within the note columns. To make such colour changes possible each note column
+requires its own colour management using so-called \emph{colour stacks}.
+Because the package was designed only as a \emph{proof of concept} and because
+\XeTeX{} does not support multiple colour stacks, \XeTeX{} colour switching is
+restricted to the attributes of the font element
+\FontElement{notecolumn.\PName{note column name}}, a limitation which
+eliminates the time and effort required to implement custom colour management.
+
+The second issue is of a more conceptual nature. The content of the auxiliary
+file that contains the note-column information is read while processing the
+page header. This has consequences in particular if the read occurs while
+an environment like \Environment{verbatim} is active. In this case, the
+\Macro{catcode} settings of this environment would be active while reading the
+auxiliary file. This will inevitably lead to errors in processing and output.
+To attenuate this risk, the \Macro{catcodes} of the characters from
+\Macro{dospecials}\IndexCmd{dospecials} are stored during
+\Macro{begin}\PParameter{document} and explicitly restored when reading from
+the auxiliary file.%
\EndIndexGroup
@@ -696,7 +718,6 @@ changed from blue to grey.}
%%% Local Variables:
%%% mode: latex
%%% mode: flyspell
-%%% coding: iso-latin-1
%%% ispell-local-dictionary: "en_GB"
%%% TeX-master: "../guide"
%%% End: