scrlayer-fancyhdr (5apr21)

git-svn-id: svn://tug.org/texlive/trunk@58746 c570f23f-e606-0410-a88d-b1316a301751
author: Norbert Preining <preining@logic.at> 2021-04-05 01:25:20 +0000
committer: Norbert Preining <preining@logic.at> 2021-04-05 01:25:20 +0000
commit: b819a383cb88874c8b0932ac053c66d921fbf779 (patch)
tree: dcc98711c05f7e7c435f22b759ad58af88ed29dd /Master/texmf-dist/source/latex/scrlayer-fancyhdr/scrlayer-fancyhdr.dtx
parent: 5ce1bb2ea7ef831dba98ff9ab16299685ff63be8 (diff)
1 files changed, 552 insertions, 179 deletions
diff --git a/Master/texmf-dist/source/latex/scrlayer-fancyhdr/scrlayer-fancyhdr.dtx b/Master/texmf-dist/source/latex/scrlayer-fancyhdr/scrlayer-fancyhdr.dtx
index a3f9765f3f5..406b32e1d22 100644
--- a/Master/texmf-dist/source/latex/scrlayer-fancyhdr/scrlayer-fancyhdr.dtx
+++ b/Master/texmf-dist/source/latex/scrlayer-fancyhdr/scrlayer-fancyhdr.dtx
@@ -46,12 +46,12 @@
 %<body>%%% docstrip run: body
 %<*dtx>
 \ifx\ProvidesFile\undefined\def\ProvidesFile#1[#2]{}\fi
-\ProvidesFile{scrlayer-fancyhdr.dtx}[2021-03-17 v0.2
+\ProvidesFile{scrlayer-fancyhdr.dtx}[2021-03-30 v0.2.1
   source of package scrlayer-scrpage]
 %</dtx>
 %<*package>
 %<identify>\NeedsTeXFormat{LaTeX2e}[1995/12/01]
-%<identify>\ProvidesPackage{scrlayer-fancyhdr}[2021-03-17 v0.2
+%<identify>\ProvidesPackage{scrlayer-fancyhdr}[2021-03-30 v0.2.1
 %<identify>  combining fancyhdr with KOMA-Script's scrlayer]
 %</package>
 %<*dtx>
@@ -70,10 +70,14 @@
 \fi
 \endbatchfile
 \documentclass{scrdoc}
+\RedeclareSectionCommand[tocbeforeskip=0pt]{section}
+\RedeclareSectionCommand[tocbeforeskip=.75\baselineskip plus .25\baselineskip]{part}
+\setkomafont{sectionentry}{}
+\KOMAoption{toc}{flat}
 \addtolength{\textwidth}{-1em}
 \addtolength{\marginparwidth}{2em}
 \addtolength{\oddsidemargin}{2em}
-\usepackage[english]{babel}
+\usepackage[main=english,ngerman]{babel}
 \usepackage{csquotes}
 \usepackage{biblatex}
 \usepackage{listings}
@@ -88,8 +92,8 @@
              footers in {\LaTeXe}},
   date    = {2021-01-28},
   edition = {4.0.1},
-  url     = {https://www.ctan.org/pkg/fancydr},
-  urldate = {2021-02-18}
+  url     = {https://www.ctan.org/pkg/fancyhdr},
+  urldate = {2021-03-30}
 }
 
 @Misc{      package:koma-script,
@@ -97,10 +101,10 @@
   author  = {Markus Kohm},
   title   = {{\Package{koma-script}}\,---\,A bundle of versatile classes and
              packages},
-  date    = {2021-03-01},
+  date    = {2021-03-17},
   edition = {3.33},
   url     = {https://www.ctan.org/pkg/koma-script},
-  urldate = {2021-03-01}
+  urldate = {2021-03-30}
 }
 
 @Misc{      package:scrlayer,
@@ -108,23 +112,24 @@
   author  = {Markus Kohm},
   title   = {{\Package{scrlayer}}\,---\,Manage text `layers' within
              {\KOMAScript}},
-  date    = {2021-03-01},
+  date    = {2021-03-17},
   edition = {3.33},
-  url     = {https://www.ctan.org/pkg/koma-script},
-  urldate = {2021-03-01}
+  url     = {https://www.ctan.org/pkg/scrlayer},
+  urldate = {2021-03-30}
 }
 \end{filecontents}
 
 \addbibresource{\jobname.bib}
-\xpretocmd\DescribeMacro{\ifhmode\else\bigskip\noindent\fi}{}{}
-\xpretocmd\DescribeEnv{\ifhmode\else\bigskip\noindent\fi}{}{}
-\xpretocmd\DescribeOption{\ifhmode\else\bigskip\noindent\fi}{}{}
 
 \CodelineIndex
 \RecordChanges
 \GetFileInfo{scrlayer-fancyhdr.dtx}
 \title{The \texttt{scrlayer} interface \texttt{scrlayer-fancyhdr}%
-  \footnote{This is version \fileversion\ of file \texttt{\filename}.}}
+  \footnote{\parbox[t]{.9\linewidth}{\raggedright
+      This is version \fileversion\ of file \texttt{\filename}.\\
+      Dies ist Version \fileversion\ der Datei \texttt{\filename}.}}\\
+  \otherlanguage{ngerman}{Das \texttt{scrlayer}-Interface
+    \texttt{scrlayer-fancyhdr}\footnotemark[1]}}
 \date{\filedate}
 \author{Markus Kohm}
 
@@ -165,7 +170,13 @@
 \providecommand*{\textnote}[2][]{}
 
 \lstnewenvironment{lstcode}{\lstset{language=[LaTeX]TeX}}{}
-\sloppy% YOU SHOULD NOT DO THIS!!!
+
+\renewcaptionname{english}{\partname}{Part}
+\renewcaptionname{english}{\contentsname}{Contents\,/\,Inhalt}%
+\renewcaptionname{english}{\refname}{References\,/\,Literatur}%
+\renewcaptionname{ngerman}{\partname}{Teil}
+\renewcaptionname{ngerman}{\contentsname}{Inhalt\,/\,Contents}
+\renewcaptionname{ngerman}{\refname}{Literatur\,/\,References}%
 
 \begin{document}
 \maketitle
@@ -179,160 +190,181 @@
 % 
 % \changes{v0.0}{2018/09/01}{start of interface}
 % \changes{v0.2}{2021/02/18}{package is no longer part of \KOMAScript}
+% \changes{v0.2.1}{2021/03/30}{improved user manual}
+% \changes{v0.2.1}{2021/03/30}{German user manual}
 %
 % \changes{v0.0}{2018/09/05}{some user documentation}
+% \part{English User Manual}
 % \section{The Purpose of this Package}
+% \label{sec:purpose}
 % This package has been made to give users a chance to combine the features of
-% Piet van Oostrum's \Package{fancyhdr} \autocite{package:fancyhdr} with the
-% features of \Package{scrlayer} \autocite{package:scrlayer}. In other words:
-% It has been made to combine the page layers of \Package{scrlayer} with the
-% page styles of \Package{fancyhdr}.
-%
-% In this combination compatibility with \Package{fancyhdr} is the first aim!
-% Usability and the freedom provided by \Package{scrlayer} is only the second
-% one. Compatibility with other packages or classes of \KOMAScript{}
-% \cite{package:koma-script} is not a primary aim. Perhaps it will become an
-% optional feature in future. Abolishing any real or virtual limitations of
-% \Package{fancyhdr} other than make it possible to use layers is not an aim
-% and will not be an aim in future.
+% Piet van Oostrum's \mbox{\Package{fancyhdr}} \autocite{package:fancyhdr}
+% with the features of \mbox{\Package{scrlayer}}
+% \autocite{package:scrlayer}. In other words: It has been made to combine the
+% page layers of \mbox{\Package{scrlayer}} with the page styles of
+% \mbox{\Package{fancyhdr}}.
+%
+% In this combination compatibility with \mbox{\Package{fancyhdr}} is the
+% first aim!  Usability and the freedom provided by \mbox{\Package{scrlayer}}
+% is only the second one. Compatibility with other packages or classes of
+% \KOMAScript{} \cite{package:koma-script} is not a primary aim. Perhaps it
+% will become an optional feature in future. Abolishing any real or virtual
+% limitations of \mbox{\Package{fancyhdr}} other than make it possible to use
+% layers is not an aim and will not be an aim in future.
 %
 % If you need a better combination of page styles and layers, you should
-% either use the low level interface of \Package{scrlayer} to define your page
-% styles or\,---\,and this is the recommendation of the author\,---\,use
-% \Package{scrlayer-scrpage} instead of \Package{scrlayer-fancyhdr} or
-% \Package{fancyhdr}. If you need more compatibility with other parts of
-% \KOMAScript, i.\,e.\@ with the \KOMAScript{} classes, you should use
-% \Package{scrlayer-scrpage} instead of \Package{scrlayer-fancyhdr} or
-% \Package{fancyhdr}.
+% either use the low level interface of \mbox{\Package{scrlayer}} to define
+% your page styles or\,---\,and this is the recommendation of the
+% author\,---\,use \Package{scrlayer-scrpage} instead of
+% \Package{scrlayer-fancyhdr} or \mbox{\Package{fancyhdr}}. If you need more
+% compatibility with other parts of \KOMAScript, i.\,e.\@ with the
+% \KOMAScript{} classes, you should use \Package{scrlayer-scrpage} instead of
+% \Package{scrlayer-fancyhdr} or \mbox{\Package{fancyhdr}}.
 %
 %
 % \section{How it works}
-% To combine \Package{fancyhdr} and \Package{scrlayer},
+% \label{sec:howitworks}
+%
+% To combine \mbox{\Package{fancyhdr}} and \mbox{\Package{scrlayer}},
 % \Package{scrlayer-scrpage} loads both packages. After loading
-% \Package{fancyhdr} it redefines page style \Pagestyle{@fancy} (up to
-% \Package{fancyhdr} version 3.10) resp. \Pagestyle{f@nch@fancycore} (from
-% \Package{fancyhdr} version 4) to make it a layer page style of
-% \Package{scrlayer} using the newly defined layers \texttt{fancy.head.even},
-% \texttt{fancy.head.odd}, \texttt{fancy.foot.even} and
-% \texttt{fancy.foot.odd}. The \texttt{\dots head\dots} layers are background
-% layers like the page head of \Package{fancyhdr}'s page styles (or other
-% usual page styles). The \texttt{\dots foot\dots} layers are foreground
-% layers like the page footer of \Package{fancyhdr}'s page styles (or other
-% usual page styles). The \texttt{\dots even} layers are restricted to even
-% pages, that means left side pages in two-sided documents. The \texttt{\dots
-% odd} layers are restricted to odd pages, that means right side pages in
-% two-sided documents or all pages in single-sided documents.
+% \mbox{\Package{fancyhdr}} it redefines page style \Pagestyle{@fancy} (up to
+% \mbox{\Package{fancyhdr}} version 3.10) resp. \Pagestyle{f@nch@fancycore}
+% (from \mbox{\Package{fancyhdr}} version 4) to make it a layer page style of
+% \mbox{\Package{scrlayer}} using the newly defined layers
+% \texttt{fancy.head.even}, \texttt{fancy.head.odd}, \texttt{fancy.foot.even}
+% and \texttt{fancy.foot.odd}. The \texttt{\dots head\dots} layers are
+% background layers like the page head of \mbox{\Package{fancyhdr}}'s page
+% styles (or other usual page styles). The \texttt{\dots foot\dots} layers are
+% foreground layers like the page footer of \mbox{\Package{fancyhdr}}'s page
+% styles (or other usual page styles). The \texttt{\dots even} layers are
+% restricted to even pages, that means left side pages in two-sided
+% documents. The \texttt{\dots odd} layers are restricted to odd pages, that
+% means right side pages in two-sided documents or all pages in single-sided
+% documents.
 %
 % \DescribeMacro\ps@@fancy
 % \DescribeMacro\ps@f@nch@fancycore
 % \DescribeMacro\ps@fancyplain
 % \DescribeMacro\ps@plain@fancy
-% Note: Page style \Pagestyle{@fancy} (up to \Package{fancyhdr} version 3.10)
-% resp. \Pagestyle{f@nch@fancycore} (from \Package{fancyhdr} version 4) is an
-% internal basic page style of package \Package{fancyhdr}. It is used for the
-% user page style \Pagestyle{fancy}. The user page style \Pagestyle{fancy} is
-% also used for \Package{fancyhdr}'s deprecated page style
-% \Pagestyle{fancyplain}, that also redefines page style \Pagestyle{plain} to
-% be \Package{fancyhdr}'s internal page style \Pagestyle{plain@fancy}, that
-% also uses \Pagestyle{fancy} but with \Macro{if@fancyplain} set to
-% \Macro{iftrue}. There is also a deprecated command
-% \Macro{fancyplain}\Parameter{plain code}\Parameter{fancy code}, that uses
-% the \meta{plain code} if \Macro{if@fancyplain} is \Macro{iftrue} and
-% \meta{fancy code} if \Macro{if@fancyplain} is \Macro{iffalse}.
-%
-% Note: Page styles defined using \Package{fancyhdr}'s command
+% Up to \mbox{\Package{fancyhdr}} verison 3.10 page style \Pagestyle{@fancy}
+% was an internal page style, users should not select direclty. From version 4
+% page style \Pagestyle{f@nch@fancycore} is used internally by package
+% \mbox{\Package{fancyhdr}}. In both cases, the internal page style is used
+% for the user page style \Pagestyle{fancy}. The user page style
+% \Pagestyle{fancy} is also used for \Package{fancyheadings}'s deprecated page
+% style \Pagestyle{fancyplain}, that also redefines page style
+% \Pagestyle{plain} to be \mbox{\Package{fancyhdr}}'s internal page style
+% \Pagestyle{plain@fancy}, that also uses \Pagestyle{fancy} but with
+% \Macro{if@fancyplain} set to \Macro{iftrue}. There is an additional
+% deprecated command \Macro{fancyplain}\Parameter{plain code}\Parameter{fancy
+% code}, too. The command uses the \meta{plain code} if \Macro{if@fancyplain}
+% is \Macro{iftrue} and \meta{fancy code} if \Macro{if@fancyplain} is
+% \Macro{iffalse}. It can be used inside the definition of the page style
+% elements to distinguish settings of \Pagestyle{fancy} and \Pagestyle{plain}
+% pages.
+%
+% Page styles defined using \mbox{\Package{fancyhdr}}'s command
 % \Macro{fancypagestyle} also always use page style \Pagestyle{fancy} and so
-% the internal basic page style \Pagestyle{@fancy} (up to \Package{fancyhdr}
-% version 3.10) resp. \Pagestyle{f@nch@fancycore} (from \Package{fancyhdr}
-% version 4).
-%
-% As a result of the two notes above, every page style of \Package{fancyhdr}
-% always uses the same internal basic page style \Pagestyle{@fancy} (up to
-% \Package{fancyhdr} version 3.10) resp. \Pagestyle{f@nch@fancycore} (from
-% \Package{fancyhdr} version 4). As a result of redefining page style
-% \Pagestyle{@fancy} (up to \Package{fancyhdr} version 3.10)
-% resp. \Pagestyle{f@nch@fancycore} (from \Package{fancyhdr} version 4) to be
-% a layer page style, users can add layers to or remove layers from all
-% \Package{fancyhdr} page styles by adding layers to or remove layers from
-% page style \Pagestyle{@fancy} (up to \Package{fancyhdr} version 3.10)
-% resp. \Pagestyle{f@nch@fancycore} (from \Package{fancyhdr} version 4). You
-% cannot add layers to or remove layers from \Package{fancyhdr}'s single page
-% styles \Pagestyle{fancy}, \Pagestyle{fancyplain}, \Pagestyle{plain@fancy} or
-% the page styles defined using \Macro{fancypagestyle} directly. So using
-% layers is a all or nothing feature with \Package{scrlayer-scrpage}. However,
-% you can use the second argument of \Macro{fancypagestyle} to add or remove
-% layers whenever one of the \Package{fancyhdr} page styles is activated. So
-% this is a move from the \Package{scrlayer} interface of adding or removing
-% layers to single page styles to the \Package{fancyhdr} interface of defining
+% the internal basic page style \Pagestyle{@fancy} (up to
+% \mbox{\Package{fancyhdr}} version 3.10) resp. \Pagestyle{f@nch@fancycore}
+% (from \mbox{\Package{fancyhdr}} version 4).
+%
+% As a result of the two notes above, every page style of
+% \mbox{\Package{fancyhdr}} always uses the same internal basic page style
+% \Pagestyle{@fancy} (up to \mbox{\Package{fancyhdr}} version 3.10)
+% resp. \Pagestyle{f@nch@fancycore} (from \mbox{\Package{fancyhdr}} version
+% 4). As a result of redefining page style \Pagestyle{@fancy} (up to
+% \mbox{\Package{fancyhdr}} version 3.10) resp. \Pagestyle{f@nch@fancycore}
+% (from \mbox{\Package{fancyhdr}} version 4) to be a layer page style, users
+% can add layers to or remove layers from all \mbox{\Package{fancyhdr}} page
+% styles by adding layers to or remove layers from page style
+% \Pagestyle{@fancy} (up to \mbox{\Package{fancyhdr}} version 3.10)
+% resp. \Pagestyle{f@nch@fancycore} (from \mbox{\Package{fancyhdr}} version
+% 4). You cannot add layers to or remove layers from
+% \mbox{\Package{fancyhdr}}'s single page styles \Pagestyle{fancy},
+% \Pagestyle{fancyplain}, \Pagestyle{plain@fancy} or the page styles defined
+% using \Macro{fancypagestyle} directly. So using layers is a all or nothing
+% feature with \Package{scrlayer-scrpage}. However, you can use the second
+% argument of \Macro{fancypagestyle} to add or remove layers whenever one of
+% the \mbox{\Package{fancyhdr}} page styles is activated. So this is a move
+% from the \mbox{\Package{scrlayer}} interface of adding or removing layers to
+% single page styles to the \mbox{\Package{fancyhdr}} interface of defining
 % modifications of page style \Pagestyle{fancy}.
 %
-% Another such movement from an \Package{scrlayer} user interface to a
-% \Package{fancyhdr} user interface is the decision whether or not automatic
-% running heads are used. \Package{scrlayer} provides the options
-% \Option{automark} and \Option{manualmark} and commands \Macro{automark} and
-% \Macro{manualmark} to do this decision and also to configure commands like
-% \Macro{partmark}, \Macro{chaptermark}, \Macro{sectionmark} etc. With
-% \Package{scrlayer-fancyhdr} also using page style \Pagestyle{@fancy} (up to
-% \Package{fancyhdr} version 3.10) resp. \Pagestyle{f@nch@fancycore} (from
-% \Package{fancyhdr} version 4) does switch to automatic running heads. The
-% first activation of page style \Pagestyle{fancy} still redefines
-% \Macro{chaptermark} and \Macro{sectionmark}, if a class with \Macro{chapter}
-% is used, or \Macro{sectionmark} and \Macro{subsectionmark}, if a class
-% without \Macro{chapter} is used. However, you still can use
-% \Macro{manualmark} and \Macro{automark} after switching to a
-% \Package{fancyhdr} page style to configure the running heads. So this
-% movement is only partial.
+% Another such movement from a \mbox{\Package{scrlayer}} user interface to a
+% \mbox{\Package{fancyhdr}} user interface is the decision whether or not
+% automatic running heads are used. \mbox{\Package{scrlayer}} provides the
+% options \Option{automark} and \Option{manualmark} and commands
+% \Macro{automark} and \Macro{manualmark} to do this decision and also to
+% configure commands like \Macro{partmark}, \Macro{chaptermark},
+% \Macro{sectionmark} etc. With \Package{scrlayer-fancyhdr} already using page
+% style \Pagestyle{@fancy} (up to \mbox{\Package{fancyhdr}} version 3.10)
+% resp. \Pagestyle{f@nch@fancycore} (from \mbox{\Package{fancyhdr}} version 4)
+% does switch to automatic running heads. The first activation of page style
+% \Pagestyle{fancy} still redefines \Macro{chaptermark} and
+% \Macro{sectionmark}, if a class with \Macro{chapter} is used, or
+% \Macro{sectionmark} and \Macro{subsectionmark}, if a class without
+% \Macro{chapter} is used. However, you still can use \Macro{manualmark} and
+% \Macro{automark} after switching to a \mbox{\Package{fancyhdr}} page style
+% to configure the running heads. So this movement is only partial.
 %
 % \DescribeMacro\ps@headings
 % \DescribeMacro\ps@myheadings
 % \DescribeMacro\ps@plain
-% Note: Currently, neither \Package{scrlayer} nor \Package{fancyhdr} nor
-% \Package{scrlayer-fancyhdr} do redefine page styles \Pagestyle{headings} or
-% \Pagestyle{myheadings} by default. And neither \Package{scrlayer} nor
-% \Package{fancyhdr} nor \Package{scrlayer-fancyhdr} do redefine page style
-% \Pagestyle{plain} unless you are activating the deprecated
-% \Package{fancyhdr} page style \Pagestyle{fancyplain}. So if you like to use
-% layers on \Pagestyle{plain} pages, i.\,e. usually the first page of a
-% chapter or part or the page with a title head, you have to either use
-% \Package{fancyhdr}'s deprecated page style \Pagestyle{fancyplain} or
-% redefine page style \Pagestyle{plain} either using \Macro{fancypagestyle} as
-% documented in the \Package{fancyhdr} manual or using
-% \Macro{DeclareNewPageStyleByLayers}, documented in the \KOMAScript{} manual.
-% However from version 4.0 \Package{fancyhdr} provides options
+% Note: Currently, neither \mbox{\Package{scrlayer}} nor
+% \mbox{\Package{fancyhdr}} nor \Package{scrlayer-fancyhdr} do redefine page
+% styles \Pagestyle{headings} or \Pagestyle{myheadings} by default. And
+% neither \mbox{\Package{scrlayer}} nor \mbox{\Package{fancyhdr}} nor
+% \Package{scrlayer-fancyhdr} do redefine page style \Pagestyle{plain} unless
+% you are activating the deprecated \mbox{\Package{fancyhdr}} page style
+% \Pagestyle{fancyplain}. So if you like to use layers on \Pagestyle{plain}
+% pages, i.\,e. usually the first page of a chapter or part or the page with a
+% title head, you have to either use \mbox{\Package{fancyhdr}}'s deprecated
+% page style \Pagestyle{fancyplain} or redefine page style \Pagestyle{plain}
+% either using \Macro{fancypagestyle} as documented in the
+% \mbox{\Package{fancyhdr}} manual or using \Macro{DeclarePageStyleByLayers},
+% documented in the \KOMAScript{} manual.
+% \DescribeOption{myheading}%
+% \DescribeOption{heading}%
+% However from version 4.0 \mbox{\Package{fancyhdr}} provides options
 % \Option{myheadings} and \Option{headings} to redefine the corresponding page
 % style. \Package{scrlayer-fancyhdr} also provides these options and passes
-% them to \Package{fancyhdr}.
+% them to \mbox{\Package{fancyhdr}}.
 %
 % \DescribeMacro\ps@empty
 % \DescribeMacro\ps@@empty
-% Note: Pagestyle \Pagestyle{empty} is somehow special. \Package{scrlayer}
-% redefines it to be a layer page style. And \Package{fancyhdr}'s internal
-% page style \Pagestyle{@empty} is the same like \Pagestyle{empty}. So
-% \Pagestyle{@empty} also uses the layers of \Pagestyle{empty} but you should
-% not try to modify it directly using the interface of
-% \Package{scrlayer}. Moreover, if \Package{fancyhdr} is loaded before
-% \Package{scrlayer-scrpage}, \Package{fancyhdr}'s internal page style
-% \Pagestyle{@empty} is not a copy of \Package{scrlayer}'s layer page style
-% \Pagestyle{empty} but the original standard page style
-% \Pagestyle{empty}. However, with \Package{scrlayer-fancyhdr} package
-% \Package{fancyhdr} does not longer use the internal page style
-% \Pagestyle{@empty}. So you would not need to know this.
+% Note: Pagestyle \Pagestyle{empty} is somehow
+% special. \mbox{\Package{scrlayer}} redefines it to be a layer page
+% style. And \mbox{\Package{fancyhdr}}'s internal page style
+% \Pagestyle{@empty} is the same like \Pagestyle{empty}. So \Pagestyle{@empty}
+% also uses the layers of \Pagestyle{empty} but you should not try to modify
+% it directly using the interface of \mbox{\Package{scrlayer}}. Moreover, if
+% \mbox{\Package{fancyhdr}} is loaded before \Package{scrlayer-fancyhdr},
+% \mbox{\Package{fancyhdr}}'s internal page style \Pagestyle{@empty} is not a
+% copy of \mbox{\Package{scrlayer}}'s layer page style \Pagestyle{empty} but
+% the original standard page style \Pagestyle{empty}. However, with
+% \Package{scrlayer-fancyhdr} package \mbox{\Package{fancyhdr}} does not
+% longer use the internal page style \Pagestyle{@empty}. So you would not need
+% to know this.
 %
 % \section{How to use the Package}
+% \label{sec:howtouse}
 %
 % To use the package you have to load it, e.\,g., using:
 %\begin{verbatim}
 % \usepackage{scrlayer-fancyhdr}
 %\end{verbatim}
-% instead of loading \Package{scrlayer} and \Package{fancyhdr} or before or
-% after loading one of these packages. However it is recommended to replace
-% loading \Package{scrlayer} and \Package{fancyhdr} by loading
-% \Package{scrlayer-fancyhdr} because this avoids option
+% instead of loading \mbox{\Package{scrlayer}} and \mbox{\Package{fancyhdr}}
+% or before or after loading one of these packages. However it is recommended
+% to replace loading \mbox{\Package{scrlayer}} and \mbox{\Package{fancyhdr}}
+% by loading \Package{scrlayer-fancyhdr} because this avoids option
 % clashes. \Package{scrlayer-fancyhdr} provides all options of
-% \Package{scrlayer} and \Package{fancyhdr} and passes them to
-% \Package{scrlayer} resp. \Package{fancyhdr}. Nevertheless
+% \mbox{\Package{scrlayer}} and \mbox{\Package{fancyhdr}} and passes them to
+% \mbox{\Package{scrlayer}} resp. \mbox{\Package{fancyhdr}}. Nevertheless
 % sometimes it may be useful to be able to additionally load
-% \Package{scrlayer} or \Package{fancyhdr}.
+% \mbox{\Package{scrlayer}} or \mbox{\Package{fancyhdr}}. In this case you
+% should first load \mbox{\Package{scrlayer}} next \mbox{\Package{fancyhdr}}
+% and last \Package{scrlayer-fancyhdr}.
 %
 % \DescribeMacro\ps@@fancy
 % \DescribeMacro\ps@f@nch@fancycore
@@ -340,17 +372,18 @@
 % \DescribeMacro\ps@fancyplain
 % \DescribeMacro\ps@plain@fancy
 % \DescribeMacro\fancypagestyle
-% After this you should be able to use the page styles and commands of
-% \Package{fancyhdr} and to add layers to or remove layers from the
-% \Package{fancyhdr}'s internal basic page style \Package{@fancy} (up to
-% \Package{fancyhdr} version 3.10) resp. \Pagestyle{f@nch@fancycore} (from
-% \Package{fancyhdr} version 4). Note, you are not able to add layers to or
-% remove layers from \Package{fancyhdr}'s page styles \Pagestyle{fancy},
+% After loading the package you should be able to use the page styles and
+% commands of \mbox{\Package{fancyhdr}} and to add layers to or remove layers
+% from the \mbox{\Package{fancyhdr}}'s internal basic page style
+% \Package{@fancy} (up to \mbox{\Package{fancyhdr}} version 3.10)
+% resp. \Pagestyle{f@nch@fancycore} (from \mbox{\Package{fancyhdr}} version
+% 4). Note, you are not able to add layers to or remove layers from
+% \mbox{\Package{fancyhdr}}'s page styles \Pagestyle{fancy},
 % \Pagestyle{fancyplain}, \Pagestyle{plain@fancy} or page styles defined by
 % \Macro{fancypagestyle}. However adding layers to or removing layers from
-% \Pagestyle{@fancy} (up to \Package{fancyhdr} version 3.10)
-% resp. \Pagestyle{f@nch@fancycore} (from \Package{fancyhdr} version 4) will
-% always change all these page styles!
+% \Pagestyle{@fancy} (up to \mbox{\Package{fancyhdr}} version 3.10)
+% resp. \Pagestyle{f@nch@fancycore} (from \mbox{\Package{fancyhdr}} version 4)
+% will always change all these page styles!
 %
 % \DescribeMacro\ps@plain
 % \DescribeMacro\ps@headings
@@ -359,16 +392,50 @@
 % Note: Loading \Package{scrlayer-fancyhdr} will not make page style
 % \Pagestyle{plain} nor \Pagestyle{headings} nor \Pagestyle{myheadings} or any
 % other page style but \Pagestyle{empty} to automatically be a layer page
-% style! But if you are using option \Option{headings} or \Option{myheadings}
-% package \Package{fancyhdr} redefines the corresponding page styles to be
-% \Package{fancyhdr} page styles\,---\,and so become layer page styles.
+% style! But if you are using option \Option{headings} or \Option{myheadings},
+% package \mbox{\Package{fancyhdr}} redefines the corresponding page styles to
+% be \mbox{\Package{fancyhdr}} page styles\,---\,and so relate to the same
+% internal layer page style, either \Pagestyle{@fancy} (up to
+% \mbox{\Package{fancyhdr}} version 3.10) or \Pagestyle{@f@nch@fancycore}
+% (from \Package{fancydr} version 4.0).
+%
+%
+% \section{Hint}
+% \label{sec:hint}
+%
+% To become independent from the used version of \mbox{\Package{fancyhdr}} you
+% can use:
+% \begin{verbatim}
+% \IfPackageAtLeastTF{fancyhdr}{2019/03/21}{%
+%   \DeclarePageStyleAlias{@fancy}{f@nch@fancycore}%
+% }{%
+%   \DeclarePageStyleAlias{f@nch@fancycore}{@fancy}%
+% }
+% \end{verbatim}^^A
+% \unskip after loading \Package{scrlayer-fancyhdr} and before adding a layer
+% to the internal layer page style. This code defines page style
+% \Pagestyle{@fancy} to be an alias of \Pagestyle{f@nch@fancycore} if
+% \mbox{\Package{fancyhdr}} from version 4.0 is used or vise versa
+% \Pagestyle{f@nch@fancycore} as an alias of \Pagestyle{@fancy} if
+% \mbox{\Package{fancyhdr}} before version 4.0 is used. So after this code
+% using either
+% \begin{verbatim}
+% \AddLayersToPageStyle{@fancy}{...}
+% \end{verbatim}^^A
+% \unskip or
+% \begin{verbatim}
+% \AddLayersToPageStyle{f@nch@fancycore}{...}
+% \end{verbatim}^^A
+% \unskip would both result in adding the layers to the internal layer page
+% style.
+%
 %
 % \section{Known Issues}
+% \label{sec:issues}
 %
 % Please note, the follow issues are either notes to the package author or
 % notes to the user to avoid them reporting the same issues again and
 % again. Listing these issues does not say they are bugs or features.
-%
 % \begin{itemize}
 % \item
 %   \DescribeMacro\ps@fancy
@@ -379,13 +446,13 @@
 %   You are not able to add layers to the user level page style
 %   \Pagestyle{fancy} or \Pagestyle{fancyplain} or any page style defined by
 %   \Macro{fancypagestyle} but only to the internal page style
-%   \Pagestyle{@fancy} (if you are using \Package{fancyhdr} up to version
-%   3.10) resp. \Pagestyle{f@nch@fancycore} (if you are using
-%   \Package{fancyhdr} from version 4). This is intended as explained in this
-%   manual.
+%   \Pagestyle{@fancy} (if you are using \mbox{\Package{fancyhdr}} up to
+%   version 3.10) resp. \Pagestyle{f@nch@fancycore} (if you are using
+%   \mbox{\Package{fancyhdr}} from version 4). This is intended as explained
+%   in this manual (see also section~\ref{sec:hint}).
 % \item
 %   \DescribeMacro\ps@@empty
-%   Using \Package{fancyhdr}'s internal page style \Pagestyle{@empty}
+%   Using \mbox{\Package{fancyhdr}}'s internal page style \Pagestyle{@empty}
 %   could have strange results. However, there is a simple solution for this:
 %   Don't use the internal \Pagestyle{@empty} but always the user level page
 %   style \Pagestyle{empty}!
@@ -393,10 +460,313 @@
 %   \DescribeMacro\ps@@fancy
 %   \DescribeMacro\ps@f@nch@fancycore
 %   The vertical position of the page header does differ a little bit, if
-%   \Package{scrlayer-fancyhdr} is used instead of \Package{fancyhdr}. This
-%   could be fixed by a modification of the layers \texttt{fancy.head.odd} and
-%   \texttt{fancy.head.even} using \Option{addvoffset}. More tests are needed.
+%   \Package{scrlayer-fancyhdr} is used instead of
+%   \mbox{\Package{fancyhdr}}. This could be fixed by a modification of the
+%   layers \texttt{fancy.head.odd} and \texttt{fancy.head.even} using
+%   \Option{addvoffset}. More tests are needed.
+% \end{itemize}
+% See \url{https://github.com/komascript/scrlayer-fancyhdr/issues} for more
+% issues.
+%
+% \selectlanguage{ngerman}
+% \part{Benutzeranleitung auf Deutsch}
+% \section{Der Sinn dieses Pakets}
+% \label{sec:sinn}
+% Dieses Paket wurde entwickelt, um den Anwendern die Möglichkeit zu geben,
+% die Fähigkeiten von Piet van Oostrums \mbox{\Package{fancyhdr}}
+% \autocite{package:fancyhdr} mit den Fähigkeiten von
+% \mbox{\Package{scrlayer}} \autocite{package:scrlayer} zu kombinieren. In
+% anderen Worten: Es wurde geschaffen, um die Seiten-Ebenen von
+% \mbox{\Package{scrlayer}} mit den Seiten-Stilen von
+% \mbox{\Package{fancyhdr}} zu kombinieren.
+%
+% In dieser Kombination ist Kompatibilität mit \mbox{\Package{fancyhdr}} das
+% oberste Ziel! Verwendbarkeit und die Freiheiten, die von
+% \mbox{\Package{scrlayer}} geboten werden, ist das zweite
+% Ziel. Kompatibilität mit anderen Paketen oder Klassen von \KOMAScript{}
+% \cite{package:koma-script} ist kein primäres Ziel. Vielleicht wird dies in
+% Zukunft eine optionale Fähigkeit werden. Die Aufhebung irgendwelcher realen
+% oder eingebildeter Beschränkungen von \mbox{\Package{fancyhdr}}, die darüber
+% hinaus gehen, die Verwendung von Ebenen zu ermöglichen, ist kein Ziel und
+% wird auch in Zukunft kein Ziel werden.
+%
+% Wenn Sie eine bessere Kombination von Seitenstilen und Ebenen benötigen, so
+% sollten Sie entweder die Low-Level-Schnittstelle von
+% \mbox{\Package{scrlayer}} zur Definition von Seitenstilen oder ---~und das
+% ist die Empfehlung des Autors~--- das Paket \Package{scrlayer-scrpage}
+% anstelle von \Package{scrlayer-fancyhdr} oder \mbox{\Package{fancyhdr}}
+% verwenden. Wenn Sie bessere Kompatibilität mit anderen Teilen von
+% \KOMAScript, beispielsweise mit den \KOMAScript-Klassen. benötigen, sollten
+% Sie \Package{scrlayer-scrpage} anstelle von \Package{scrlayer-fancyhdr} oder
+% \mbox{\Package{fancyhdr}} verwenden.
+%
+% \section{Wie es funktioniert}
+% \label{sec:funktion}
+% Zur Kombination von \mbox{\Package{fancyhdr}} mit \mbox{\Package{scrlayer}}
+% lädt \Package{scrlayer-scrpage} beide Pakete. Nach dem Laden von
+% \mbox{\Package{fancyhdr}} definiert es den Seitenstil \Pagestyle{@fancy}
+% (bis einschließlich \mbox{\Package{fancyhdr}} Version 3.10)
+% bzw. \Pagestyle{f@nch@fancycore} (ab \mbox{\Package{fancyhdr}} Version 4.0)
+% in einen Ebenen-Seitenstil von \mbox{\Package{scrlayer}} um, bestehend aus
+% den neu definierten Ebenen \texttt{fancy.head.even},
+% \texttt{fancy.head.odd}, \texttt{fancy.foot.even} und
+% \texttt{fancy.foot.odd}. Die \texttt{\dots head\dots}-Ebenen sind
+% Hintergrund-Ebenen entsprechend dem Seitenkopf von
+% \mbox{\Package{fancyhdr}}-Seiten\-stilen (oder anderen gebräuchlichen
+% Seitenstilen). Die \texttt{\dots foot\dots}-Ebenen sind Vordergrund-Ebenen
+% entsprechend dem Seitenfuß von
+% \linebreak\mbox{\Package{fancyhdr}}-Seitenstilen (oder anderen
+% gebräuchlichen Seitenstilen). Die \texttt{\dots even}-Ebenen sind auf gerade
+% Seiten, also linke Seiten von doppelseitigen Dokumenten, beschränkt. Die
+% \texttt{\dots odd}-Ebenen sind auf ungerade Seiten, also rechte Seiten bei
+% doppelseitigen Dokumenten oder alle Seiten bei einseitigen Dokumenten,
+% beschränkt.
+%
+% \DescribeMacro\ps@@fancy
+% \DescribeMacro\ps@f@nch@fancycore
+% \DescribeMacro\ps@fancyplain
+% \DescribeMacro\ps@plain@fancy
+% Bis Version 3.10 von \mbox{\Package{fancyhdr}} war Seitenstil
+% \Pagestyle{@fancy} ein interner Seitenstil, den Anwender selbst nicht direkt
+% verwenden sollten. Ab Version 4.0 wird \Pagestyle{f@nch@fancycore} als
+% interner Seitenstil von Paket \mbox{\Package{fancyhdr}} genutzt. In beiden
+% Fällen wird der interne Seitenstil für den Benutzer\-seiten\-stil
+% \Pagestyle{fancy} verwendet. Der Benutzerseitenstil \Pagestyle{fancy} wird
+% ebenfalls für den veralteten Seitenstil \Pagestyle{fancyplain} des Pakets
+% \Package{fancyheadings} verwendet, der zusätzlich den Seitenstil
+% \Pagestyle{plain} in \mbox{\Package{fancyhdr}}s internen Seitenstil
+% \Pagestyle{plain@fancy} ändert, der ebenfalls \Pagestyle{fancy} verwendet,
+% wobei allerdings \Macro{if@fancyplain} auf \Macro{iftrue} gesetzt ist. Es
+% gibt eine weitere überholte Anweisung
+% \Macro{fancyplain}\Parameter{plain-Code}\Parameter{fancy-Code}. Diese
+% Anweisung verwendet \meta{plain-Code}, wenn \Macro{if@fancyplain}
+% \Macro{iftrue} ist, aber \meta{fancy-Code}, wenn \Macro{if@fancyplain}
+% \Macro{iffalse} ist. Sie kann innerhalb der Definition der
+% Seitenstilelemente verwendet werden um zwischen den Einstellung für
+% \Pagestyle{fancy} und \Pagestyle{plain} zu unterscheiden.
+%
+% Seitenstile, die mit der \mbox{\Package{fancyhdr}}-Anweisung
+% \Macro{fancypagestyle} definiert wurden, verwenden ebenfalls immer den
+% Seitenstil \Pagestyle{fancy} und damit den internen grundlegenden Seitenstil
+% \Pagestyle{@fancy} (bis einschließlich \mbox{\Package{fancyhdr}} Version
+% 3.10) bzw. \Pagestyle{f@nch@fancycore} (ab \mbox{\Package{fancyhdr}} Version
+% 4).
+%
+% Als Ergebnis der beiden obigen Anmerkungen, verwenden alle Seitenstile von
+% \mbox{\Package{fancyhdr}} immer denselben internen grundlegenden Seitenstil
+% \Pagestyle{@fancy} (bis einschließlich \mbox{\Package{fancyhdr}} Version
+% 3.10) bzw. \Pagestyle{f@nch@fancycore} (ab \mbox{\Package{fancyhdr}} Version
+% 4). Als Ergebnis daraus resultiert aus der Umdefinierung des Seitenstils
+% \Pagestyle{@fancy} (bis einschließlich \mbox{\Package{fancyhdr}} Version
+% 3.10) bzw. \Pagestyle{f@nch@fancycore} (ab \mbox{\Package{fancyhdr}} Version
+% 4) in einen Ebenen-Seitenstil, dass Anwender Ebenen zu allen Seitenstilen
+% von \mbox{\Package{fancyhdr}} hinzufügen oder daraus löschen können, indem
+% sie Ebenen zu \Pagestyle{@fancy} (bis einschließlich
+% \mbox{\Package{fancyhdr}} Version 3.10) bzw. \Pagestyle{f@nch@fancycore} (ab
+% \mbox{\Package{fancyhdr}} Version 4) hinzufügen oder daraus löschen. Sie
+% können keine Ebenen unmittelbar zu einzelnen Seitenstilen von
+% \mbox{\Package{fancyhdr}} wie \Pagestyle{fancy}, \Pagestyle{fancyplain},
+% \Pagestyle{plain@fancy} oder anderen mit \Macro{fancypagestyle} definierten
+% Seitenstilen hinzufügen oder daraus löschen. Aber natürlich können Sie das
+% zweite Argument von \Macro{fancypagestyle} nutzen, um Ebenen zum Zeitpunkt
+% der Aktivierung eines \mbox{\Package{fancyhdr}}-Seitenstils hinzuzufügen
+% oder zu entfernen. Dies stellt eine Verschiebung dar weg von der
+% \mbox{\Package{scrlayer}}-Schnittstelle zum Hinzufügen oder Entfernen von
+% Ebenen hin zur \mbox{\Package{fancyhdr}}-Schnittstelle zur Definition von
+% Änderungen des Seitenstils \Pagestyle{fancy}.
+%
+% Ein weitere solche Verschiebung von der Anwenderschnittstelle von
+% \mbox{\Package{scrlayer}} zur Anwenderschnittstelle von
+% \mbox{\Package{fancyhdr}} ist die Entscheidung, ob automatische, lebende
+% Kolumnentitel verwendet werden sollen oder nicht. \mbox{\Package{scrlayer}}
+% bietet dafür die Optionen \Option{automark} und \Option{manualmark} und die
+% Anweisungen \Macro{automark} und \Macro{manualmark}. Diese konfigurieren
+% gleichzeitig Anweisungen wie \Macro{partmark}, \Macro{chaptermark},
+% \Macro{sectionmark} etc. Mit \Package{scrlayer-fancyhdr} wird bereits durch
+% Verwendung von Seitenstil \Pagestyle{@fancy} (bis einschließlich
+% \mbox{\Package{fancyhdr}} Version 3.10) bzw. \Pagestyle{f@nch@fancycore} (ab
+% \mbox{\Package{fancyhdr}} Version 4) auf automatische, lebende Kolumnentitel
+% umgeschaltet. Die erste Aktivierung von \Pagestyle{fancy} definiert auch
+% weiterhin \Macro{chaptermark} und \Macro{sectionmark}, wenn eine Klasse mit
+% \Macro{chapter} verwendet wird, oder \Macro{sectionmark} und
+% \Macro{subsectionmark}, wenn eine Klasse ohne \Macro{chapter} verwendet
+% wird. Dennoch können Sie weiterhin \Macro{manualmark} und \Macro{automark}
+% nach der Umschaltung zu einem \mbox{\Package{fancyhdr}}-Seitenstil
+% verwenden, um die lebenden Kolumnentitel zu konfigurieren. Diese
+% Verschiebung ist also nur partiell.
+%
+% \DescribeMacro\ps@headings
+% \DescribeMacro\ps@myheadings
+% \DescribeMacro\ps@plain
+% Hinweis: Derzeit definieren weder \mbox{\Package{scrlayer}} noch
+% \mbox{\Package{fancyhdr}} noch \Package{scrlayer-fancyhdr} die Seitenstile
+% \Pagestyle{headings} oder \Pagestyle{myheadings} in der Voreinstellung
+% um. Und weder \mbox{\Package{scrlayer}} noch \mbox{\Package{fancyhdr}} oder
+% \Package{scrlayer-fancyhdr} definieren den Seitenstil \Pagestyle{plain} um,
+% solange nicht der veraltete \mbox{\Package{fancyhdr}}-Seitenstil
+% \Pagestyle{fancyplain} aktiviert wird. Wenn Sie also einen Ebeneseitenstil
+% für \Pagestyle{plain}-Seiten wünschen, insbesondere für die erste Seite
+% eines Kapitels oder Teils oder die Seiten mit dem Titelkopf, so müssen Sie
+% entweder den veralteten \mbox{\Package{fancyhdr}}-Seitenstil
+% \Pagestyle{fancyplain} verwenden oder den Seitenstil \Pagestyle{plain}
+% entweder per \Macro{fancypagestyle} umdefinieren, wie dies in der
+% \mbox{\Package{fancyhdr}}-Anleitung beschrieben ist, oder per
+% \Macro{DeclarePageStyleByLayers}, wie dies in der \KOMAScript-Anleitung
+% dokumentiert ist.
+% \DescribeOption{myheading}%
+% \DescribeOption{headings}%
+% Darüber hinaus bietet \mbox{\Package{fancyhdr}} ab Version 4.0 die Optionen
+% \Option{myheadings} und \Option{headings}, um die entsprechenden Seitenstile
+% umzudefinieren. \Package{scrlayer-fancyhdr} bietet diese Optionen ebenfalls
+% und leitet sie an \mbox{\Package{fancyhdr}} weiter.
+%
+% \DescribeMacro\ps@empty
+% \DescribeMacro\ps@@empty
+% Hinweis: Der Seitenstil \Pagestyle{empty} ist etwas
+% speziell. \mbox{\Package{scrlayer}} definiert dieses in einen
+% Ebenen-Seitenstil um. Und \mbox{\Package{fancyhdr}}s interner Seitenstil
+% \Pagestyle{@empty} ist ebenfalls identisch mit \Pagestyle{empty}. Daher
+% verwendet auch \Pagestyle{@empty} die Ebenen von \Pagestyle{empty}, aber Sie
+% sollten nicht versuchen, diese direkt mit der Schnittstelle von
+% \mbox{\Package{scrlayer}} zu verändern. Mehr noch, wenn
+% \mbox{\Package{fancyhdr}} vor \Package{scrlayer-fancyhdr} geladen wird, ist
+% der interne Seitenstil \Pagestyle{@empty} von \mbox{\Package{fancyhdr}}
+% nicht länger eine Kopie des Ebenen-Seitenstils \Pagestyle{empty} von
+% \mbox{\Package{scrlayer}}, sondern weiterhin des Standard-Seitenstils
+% \Pagestyle{empty}. Allerdings verwendet \mbox{\Package{fancyhdr}} mit
+% \Package{scrlayer-fancyhdr} selbst den internen Seitenstil
+% \Pagestyle{@empty} gar nicht mehr. Daher brauchen Sie das eigentlich auch
+% nicht zu wissen.
+%
+% \section{Wie man das Paket verwendet}
+% \label{sec:verwendung}
+%
+% Um das Paket zu verwenden, muss man es laden, beispielsweise per:
+%\begin{verbatim}
+% \usepackage{scrlayer-fancyhdr}
+%\end{verbatim}
+% an Stelle von \mbox{\Package{scrlayer}} oder \mbox{\Package{fancyhdr}} oder
+% vor dem Laden eines dieser Pakete. Empfohlen wird das komplette Ersetzen von
+% \mbox{\Package{scrlayer}} und \mbox{\Package{fancyhdr}} durch das Laden von
+% \Package{scrlayer-fancyhdr}, weil dadurch Optionskonflikte
+% (engl. \emph{option clash}) vermieden wird. \Package{scrlayer-fancyhdr}
+% stellt alle Optionen von \mbox{\Package{scrlayer}} und
+% \mbox{\Package{fancyhdr}} bereit und leitet diese an
+% \mbox{\Package{scrlayer}} bzw. \mbox{\Package{fancyhdr}}
+% weiter. Nichtsdestotrotz kann es in seltenen Fällen nützlich sein, dass man
+% das Paket auch zusätzlich nach \mbox{\Package{scrlayer}} und
+% \mbox{\Package{fancyhdr}} laden kann. In diesem Fall sollte
+% \mbox{\Package{scrlayer}} vor \mbox{\Package{fancyhdr}} und zuletzt
+% \Package{scrlayer-fancyhdr} geladen werden.
+%
+% \DescribeMacro\ps@@fancy
+% \DescribeMacro\ps@f@nch@fancycore
+% \DescribeMacro\ps@fancy
+% \DescribeMacro\ps@fancyplain
+% \DescribeMacro\ps@plain@fancy
+% \DescribeMacro\fancypagestyle
+% Nach dem Laden des Pakets sollten Sie in der Lage sein, die Seitenstile und
+% Befehle von \mbox{\Package{fancyhdr}} zu verwenden und Ebenen zum internen
+% \mbox{\Package{fancyhdr}}-Seitenstil \Package{@fancy} (bis einschließlich
+% \mbox{\Package{fancyhdr}} Version 3.10) bzw. \Pagestyle{f@nch@fancycore} (ab
+% \mbox{\Package{fancyhdr}} Version 4) hinzuzufügen oder davon zu
+% entfernen. Hinweis: Es ist Ihnen nicht möglich, Ebenen zu den
+% \mbox{\Package{fancyhdr}}-Seitenstilen \Pagestyle{fancy},
+% \Pagestyle{fancyplain}, \Pagestyle{plain@fancy} oder jedem anderen mit
+% \Macro{fancypagestyle} definierten Seitenstil hinzuzufügen. Jedoch wird das
+% Hinzufügen oder Entfernen von Ebenen zu bzw. von \Package{@fancy} (bis
+% einschließlich \mbox{\Package{fancyhdr}} Version 3.10)
+% bzw. \Pagestyle{f@nch@fancycore} (ab \mbox{\Package{fancyhdr}} Version 4)
+% immer alle diese Seitenstile mit ändern!
+%
+% \DescribeMacro\ps@plain
+% \DescribeMacro\ps@headings
+% \DescribeMacro\ps@myheadings
+% \DescribeMacro\ps@empty
+% Hinweis: Das Laden von Paket \Package{scrlayer-fancyhdr} wird weder den
+% Seitenstil \Pagestyle{plain} noch \Pagestyle{headings} noch
+% \Pagestyle{myheadings} noch irgend einen anderen Seitenstil außer
+% \Pagestyle{empty} automatisch in einen Ebenen-Seitenstil umwandeln! Wenn Sie
+% aber Option \Option{headings} oder \Option{myheadings} angeben, definiert
+% \mbox{\Package{fancyhdr}} die entsprechenden Seitenstile in
+% \mbox{\Package{fancyhdr}}-Seitenstil um --~somit hängen diese dann von
+% demselben internen Seitenstil, entweder \Package{@fancy} (bis einschließlich
+% \mbox{\Package{fancyhdr}} Version 3.10) oder \Pagestyle{f@nch@fancycore} (ab
+% \mbox{\Package{fancyhdr}} Version 4), ab.
+%
+%
+%
+% \section{Tipp}
+% \label{sec:tipp}
+%
+% Um unabhängig von der verendeten Version von \mbox{\Package{fancyhdr}} zu
+% werden, kann man:
+% \begin{verbatim}
+% \IfPackageAtLeastTF{fancyhdr}{2019/03/21}{%
+%   \DeclarePageStyleAlias{@fancy}{f@nch@fancycore}%
+% }{%
+%   \DeclarePageStyleAlias{f@nch@fancycore}{@fancy}%
+% }
+% \end{verbatim}^^A
+% \unskip nach dem Laden von \Package{scrlayer-fancyhdr} verwendenm, bevor man
+% irgendwelche Ebenen zu dem internen Seitenstil hinzufügt oder davon
+% entfernt. Diese Codezeilen definieren bei Verwendung von
+% \mbox{\Package{fancyhdr}} aber Version 4.0 Seitenstil \Pagestyle{@fancy} als
+% Alias für Seitenstil \Pagestyle{f@nch@fancycore} und umgekehrt für
+% \mbox{\Package{fancyhdr}} bis einschließlich Version 3.10
+% \Pagestyle{f@ch@fancycore} als Alias für Seitenstil \Package{@fancy}. Damit
+% führt dann sowohl:
+% \begin{verbatim}
+% \AddLayersToPageStyle{@fancy}{...}
+% \end{verbatim}^^A
+% \unskip als auch
+% \begin{verbatim}
+% \AddLayersToPageStyle{f@nch@fancycore}{...}
+% \end{verbatim}^^A
+% \unskip dazu, dass die Ebenen zum internen Ebenen-Seitenstil hinzugefügt
+% werden.
+%
+%
+%
+% \section{Bekannte Probleme}
+% \label{sec:probleme}
+%
+% Bitte beachten Sie, dass die folgenden Hinweise entweder Notizen für den
+% Paketautor oder Hinweise für die Anwender darstellen und verhindern sollen,
+% dass dieselben Probleme immer wieder gemeldet werden. Die Auflistung sagt
+% nichts darüber aus, ob es sich dabei um Fehler oder Eigenschaften handelt:
+% \begin{itemize}
+% \item
+%   \DescribeMacro\ps@fancy
+%   \DescribeMacro\ps@f@nch@fancycore
+%   \DescribeMacro\ps@fancyplain
+%   \DescribeMacro\fancypagestyle
+%   \DescribeMacro\ps@@fancy
+%   Sie können keine Ebenen zu den Seitenstilen auf Benutzerebene
+%   \Pagestyle{fancy} oder \Pagestyle{fancyplain} oder irgendwelchen anderen
+%   Seitenstilen, die mit \Macro{fancypagestyle} definiert wurden,
+%   hinzufügen. Dies ist nur für den internen Seitenstil \Package{@fancy} (bis
+%   einschließlich \mbox{\Package{fancyhdr}} Version 3.10)
+%   bzw. \Pagestyle{f@nch@fancycore} (ab \mbox{\Package{fancyhdr}} Version 4)
+%   möglich (see auch Abschnitt~\ref{sec:tipp}).
+% \item 
+%   \DescribeMacro\ps@@empty
+%   Die Verwendung des internen \mbox{\Package{fancyhdr}}-Seitenstils
+%   \Pagestyle{@empty} kann zu unerwarteten Ergebnissen führen. Es gibt jedoch
+%   eine einfache Lösung für dieses Problem: Verwenden Sie nicht den internen
+%   Seitenstile \Package{@empty}, sondern immer den Seitenstile
+%   \Package{empty} der Benutzerebene.
+% \item
+%   \DescribeMacro\ps@@fancy
+%   \DescribeMacro\ps@f@nch@fancycore
+%   Die vertikale Position des Seitenkopfes weicht ein wenig ab, wenn
+%   \Package{scrlayer-fancyhdr} an Stelle von \mbox{\Package{fancyhdr}}
+%   verwendet wird. Dies kann durch leichte Modifikation der Ebenen
+%   \texttt{fancy.head.odd} und \texttt{fancy.head.even} mit Hilfe von
+%   \Option{addvoffset} behoben werden. Weitere Tests sind hier erforderlich.
 % \end{itemize}
+% Siehe \url{https://github.com/komascript/scrlayer-fancyhdr/issues} für
+% weitere bekannte Probleme.
 %
 %\iffalse
 %</dtx>
@@ -404,23 +774,26 @@
 %
 % \StopEventually{}
 %
-% \section{Implementation of \Package{scrlayer-fancyhdr}}
+% \selectlanguage{english}
+% \part{Implementation of \Package{scrlayer-fancyhdr}}
 % \label{sec:scrlayer-fancyhdr}
 %
+% \sloppy^^A Good paragraph breaking is not the purpose of implementation
+%        ^^A documentation.
 % \iffalse
 %<*package>
 % \fi
 %
 % This section if for developers only.
 %
-% We need \Package{scrlayer} at least version 2021/02/15,
+% We need \mbox{\Package{scrlayer}} at least version 2021/02/15,
 %    \begin{macrocode}
 %<*init>
 \RequirePackage{scrlayer}[2021/02/15]
 %</init>
 %    \end{macrocode}
 % Because before \cs{scrlayer@do@inherited@options} would not be defined. And
-% we need it, to inherit all options of \Package{scrlayer}.
+% we need it, to inherit all options of \mbox{\Package{scrlayer}}.
 %    \begin{macrocode}
 %<*options>
 \scrlayer@do@inherited@options{\scrlayer@inherit@option}
@@ -436,23 +809,23 @@
 %    \end{macrocode}
 %
 % Note: The main problem of this interface is, that it tries to implement the
-% user interface of package \Package{fancyhdr} by Piet van Oostrum, that is
-% completely different from \Package{scrlayer} and not really compatible with
-% \Package{scrlayer}, using \Package{scrlayer}. This means, that
+% user interface of package \mbox{\Package{fancyhdr}} by Piet van Oostrum, that is
+% completely different from \mbox{\Package{scrlayer}} and not really compatible with
+% \mbox{\Package{scrlayer}}, using \mbox{\Package{scrlayer}}. This means, that
 % \Package{scrlayer-fancyhdr} never can be a drop-in replacement of
-% \Package{fancyhdr}. Nevertheless it can help to let \Package{scrlayer} and
-% \Package{fancyhdr} coexist. To do so
+% \mbox{\Package{fancyhdr}}. Nevertheless it can help to let \mbox{\Package{scrlayer}} and
+% \mbox{\Package{fancyhdr}} coexist. To do so
 % \begin{itemize}
-% \item the lowest level of \Package{fancyhdr} should not be the page style
+% \item the lowest level of \mbox{\Package{fancyhdr}} should not be the page style
 % but a layer
-% \item the page styles of \Package{fancyhdr} should be layer page styles
-% \item init code of the page styles of \Package{fancyhdr} should use the
+% \item the page styles of \mbox{\Package{fancyhdr}} should be layer page styles
+% \item init code of the page styles of \mbox{\Package{fancyhdr}} should use the
 % layer page init code
 % \end{itemize}
 % Currently it is unsure whether it would be best to do a new implementation
-% or to load original \Package{fancyhdr} and to only modify some things. First
+% or to load original \mbox{\Package{fancyhdr}} and to only modify some things. First
 % I'll try the second method. Currently we explicitly provide the options of
-% \Package{fancyhdr}.
+% \mbox{\Package{fancyhdr}}.
 %    \begin{macrocode}
 %<*options>
 \DeclareOption{nocheck}{\PassOptionsToPackage{nocheck}{fancyhdr}}
@@ -498,31 +871,31 @@
 ]{fancy.foot.even}
 %    \end{macrocode}
 % \begin{macro}{\ps@f@nch@fancycore}
-% \changes{0.1.3558}{2021/02/15}{support for \Package{fancyhdr} 4}
+% \changes{0.1.3558}{2021/02/15}{support for \mbox{\Package{fancyhdr}} 4}
 % \begin{macro}{\ps@@fancy}
 % \begin{macro}{\@mkboth}
 % And have to create a layer page style from this new layers, but we do not
 % redefine page style \Pagestyle{fancy} but the low level page style
-% \Pagestyle{@fancy} (up to \Package{fancyhdr} version 3.10)
-% resp. \Pagestyle{f@nch@fancycore} (from \Package{fancyhdr} version 4.0).
+% \Pagestyle{@fancy} (up to \mbox{\Package{fancyhdr}} version 3.10)
+% resp. \Pagestyle{f@nch@fancycore} (from \mbox{\Package{fancyhdr}} version 4.0).
 %
-% \Package{fancyhdr} does some initialization at the very first call
-% of \cs{pagestyle{fancy}}. To do so \Package{fancyhdr} first uses a different
+% \mbox{\Package{fancyhdr}} does some initialization at the very first call
+% of \cs{pagestyle{fancy}}. To do so \mbox{\Package{fancyhdr}} first uses a different
 % page style definition, that does the initialization and redefines the page
 % style afterwards. This is still active with \Package{scrlayer-fancyhdr}.
-% Additionally, \Package{fancyhdr} redefines \cs{@mkboth} at every selection
+% Additionally, \mbox{\Package{fancyhdr}} redefines \cs{@mkboth} at every selection
 % of the internal page style \Pagestyle{@fancy}
 % resp. \Pagestyle{f@nch@fancycore}. This can be adapted using the
 % \Option{onselect} feature of the new layer page style \Pagestyle{@fancy}
 % resp. \Pagestyle{f@nch@fancycore}. In my opinion, the
 % |\let\@mkboth\markboth| used by page style \Pagestyle{headings} of, e.\,g.,
 % the standard classes or the \KOMAScript{} classes would be best
-% here. However, \Package{fancyhdr} uses the uncommon
+% here. However, \mbox{\Package{fancyhdr}} uses the uncommon
 % |\def\@mkboth{\protect\markboth}|, which would fail if a class or package
 % tests \cs{@mkboth} using |\ifx\@mkboth\markboth|. However, \KOMAScript's
 % \cs{IfActiveMkBoth} (see the \Package{scrbase} chapter in the \KOMAScript{}
-% manual) does also recognize the \Package{fancyhdr} definition and copying
-% this is more compatible with \Package{fancyhdr}.
+% manual) does also recognize the \mbox{\Package{fancyhdr}} definition and copying
+% this is more compatible with \mbox{\Package{fancyhdr}}.
 %    \begin{macrocode}
 \@ifpackagelater{fancyhdr}{2019/03/21}{%
   \DeclarePageStyleByLayers[
@@ -546,9 +919,9 @@
 % supported by \Package{scrlayer-fancyhdr}. Also currently the font features
 % of the \KOMAScript{} classes are not supported by
 % \Package{scrlayer-fancyhdr}. However you are now able to combine other
-% features of \Package{scrlayer} with features of \Package{fancyhdr} and you
-% can, e.g., use \Package{scrlayer-notecolumn} with
-% \Package{scrlayer-fancyhdr}.
+% features of \mbox{\Package{scrlayer}} with features of
+% \mbox{\Package{fancyhdr}} and you can, e.g., use
+% \Package{scrlayer-notecolumn} with \Package{scrlayer-fancyhdr}.
 % \end{macro}%^^A \@mkboth
 % \end{macro}%^^A \ps@@fancy
 % \end{macro}%^^A \ps@f@nch@fancycore
author	Norbert Preining <preining@logic.at>	2021-04-05 01:25:20 +0000
committer	Norbert Preining <preining@logic.at>	2021-04-05 01:25:20 +0000
commit	b819a383cb88874c8b0932ac053c66d921fbf779 (patch)
tree	dcc98711c05f7e7c435f22b759ad58af88ed29dd /Master/texmf-dist/source/latex/scrlayer-fancyhdr/scrlayer-fancyhdr.dtx
parent	5ce1bb2ea7ef831dba98ff9ab16299685ff63be8 (diff)