diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex')
-rw-r--r-- | Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex | 75 |
1 files changed, 39 insertions, 36 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex index 247aaf6f023..325431cf595 100644 --- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex +++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex @@ -48,13 +48,13 @@ % ============================================================================ \KOMAProvidesFile{scrbookreportarticle-experts.tex} - [$Date: 2019-10-09 16:34:25 +0200 (Wed, 09 Oct 2019) $ + [$Date: 2019-12-06 11:54:25 +0100 (Fri, 06 Dec 2019) $ KOMA-Script guide (chapter: scrbook, scrreprt, scrartcl for experts)] \translator{Gernot Hassenpflug\and Markus Kohm\and Karl Hagen} -% Date of the translated German file: 2019-10-09 +% Date of the translated German file: 2019-12-06 \chapter[{Additional Information about the Main Classes and \Package{scrextend}}]{Additional Information about the Main Classes @@ -134,6 +134,36 @@ on \autopageref{sec:tocbasic.tocstyle}). Other are implemented directly in the classes. \begin{Declaration} + \Macro{raggedchapterentry} +\end{Declaration} +In\ChangedAt{v3.21}{\Class{scrbook}\and \Class{scrreprt}} earlier versions of +\KOMAScript{}, it was possible to define the \Macro{raggedchapterentry} macro +as \Macro{raggedright} to print chapter entries in the table of contents +left-aligned instead of fully justified. Officially, this feature has not +existed in \KOMAScript{} since version~3.21. + +In fact, the \PValue{raggedentrytext} attribute for the \PValue{tocline} +TOC-entry style of the \Package{tocbasic}\IndexPackage{tocbasic} package is +implemented by setting the \Macro{ragged\PName{entry level}entry} macro to +either \Macro{relax} or \Macro{raggedright}. This attribute is evaluated by +checking whether the corresponding macro is defined as \Macro{raggedright}. If +so, the text is printed left-aligned. With any other definition, no ragged +margins are used. + +Since it was previously documented that \Macro{raggedchapterentry} should not +be defined as anything other than \Macro{raggedright}, this behaviour is +compatible with the documented behaviour of earlier versions. As noted in +earlier releases, other definitions of \Macro{raggedchapterentry}\,---\,and +now also of \Macro{raggedsectionentry} and similar macros for other entry +levels\,---\,may lead to unexpected results. + +You should select the desired justification for the all table-of-contents +entries using the \PValue{raggedentrytext} attribute of \PValue{tocline} +rather than attempting to set the attribute for specific entry levels.% +\EndIndexGroup + + +\begin{Declaration} \Macro{addtocentrydefault}\Parameter{level}\Parameter{number}% \Parameter{heading} \end{Declaration} @@ -174,8 +204,8 @@ Package authors and authors of wrapper classes can redefine this command to alter the entries. For example\textnote{Example}, you could use \begin{lstcode} \renewcommand{\addtocentrydefault}[3]{% - \ifstr{#3}{}{% - \ifstr{#2}{}{% + \Ifstr{#3}{}{% + \Ifstr{#2}{}{% \addcontentsline{toc}{#1}{#3}% }{% \addcontentsline{toc}{#1}{\protect\numberline{#2}#3}% @@ -183,7 +213,7 @@ alter the entries. For example\textnote{Example}, you could use }% }% \end{lstcode} -to\IndexCmd{ifstr} omit entries with an empty \PName{heading}. In practice, +to\IndexCmd{Ifstr} omit entries with an empty \PName{heading}. In practice, such a change is not necessary because the \KOMAScript{} classes already use another method to suppress empty entries. See the description of the sectioning commands in \autoref{sec:maincls.structure}, starting on @@ -214,36 +244,6 @@ these commands simply pass their own \PName{level} and arguments directly to \EndIndexGroup -\begin{Declaration} - \Macro{raggedchapterentry} -\end{Declaration} -In\ChangedAt{v3.21}{\Class{scrbook}\and \Class{scrreprt}} earlier versions of -\KOMAScript{}, it was possible to define the \Macro{raggedchapterentry} macro -as \Macro{raggedright} to print chapter entries in the table of contents -left-aligned instead of fully justified. Officially, this feature has not -existed in \KOMAScript{} since version~3.21. - -In fact, the \PValue{raggedentrytext} attribute for the \PValue{tocline} -TOC-entry style of the \Package{tocbasic}\IndexPackage{tocbasic} package is -implemented by setting the \Macro{ragged\PName{entry level}entry} macro to -either \Macro{relax} or \Macro{raggedright}. This attribute is evaluated by -checking whether the corresponding macro is defined as \Macro{raggedright}. If -so, the text is printed left-aligned. With any other definition, no ragged -margins are used. - -Since it was previously documented that \Macro{raggedchapterentry} should not -be defined as anything other than \Macro{raggedright}, this behaviour is -compatible with the documented behaviour of earlier versions. As noted in -earlier releases, other definitions of \Macro{raggedchapterentry}\,---\,and -now also of \Macro{raggedsectionentry} and similar macros for other entry -levels\,---\,may lead to unexpected results. - -You should select the desired justification for the all table-of-contents -entries using the \PValue{raggedentrytext} attribute of \PValue{tocline} -rather than attempting to set the attribute for specific entry levels.% -\EndIndexGroup - - \section{Font Settings} \seclabel{fonts} @@ -251,6 +251,9 @@ rather than attempting to set the attribute for specific entry levels.% sizes, but they also let you define, manipulate, and apply elements with their own font settings. +% Note: Instead of +% \LoadNonFree{scrbookreportarticle-experts}{5} +% here is the content of that file: \begin{Declaration} \Macro{@fontsizefilebase}% \Macro{changefontsizes}\Parameter{font size} @@ -1534,7 +1537,7 @@ breaks inside heading. \KOMAScript{} itself only changes \makeatletter \renewcommand{\sectionlinesformat}[4]{% \@tempswafalse - \ifstr{#1}{section}{% + \Ifstr{#1}{section}{% \hspace*{#2}% \colorbox{yellow}{% \parbox{\dimexpr\linewidth-2\fboxrule-2\fboxsep-#2}{% |