summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/koma-script/doc/english/scrbookreportarticle-experts.tex
diff options
context:
space:
mode:
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.tex247
1 files changed, 164 insertions, 83 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 c01bbdada5d..17734f58c26 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: 2018-03-30 11:57:25 +0200 (Fri, 30 Mar 2018) $
+ [$Date: 2018-10-14 20:31:51 +0200 (Sun, 14 Oct 2018) $
KOMA-Script guide (chapter: scrbook, scrreprt, scrartcl for
experts)]
\translator{Gernot Hassenpflug\and Markus Kohm\and Karl Hagen}
-% Date of the translated German file: 2018-02-13
+% Date of the translated German file: 2018-10-14
\chapter[{Additional Information about the Main Classes and
\Package{scrextend}}]{Additional Information about the Main Classes
@@ -516,69 +516,75 @@ its font settings using \DescRef{maincls.cmd.setkomafont} or
\toprule
\PName{key} & \PName{value} & Description \\
\midrule%
- \PValue{counterwithin} & \PName{counter name} & The value of the
- counter of the heading should depend on \PName{counter name}. Whenever
- \Macro{stepcounter} or \Macro{refstepcounter} increases the value of
- \PName{counter name}, the value of the counter of this heading is
- reset to 0. In addition, \Macro{the\PName{counter name}} is prefixed
- with a dot when this counter is output.\\
+ \PValue{counterwithin}
+ & \PName{counter name}
+ & The value of the counter of the heading should depend on \PName{counter
+ name}. Whenever \Macro{stepcounter} or \Macro{refstepcounter} increases
+ the value of \PName{counter name}, the value of the counter of this
+ heading is reset to 0. In addition, \Macro{the\PName{counter name}} is
+ prefixed with a dot when this counter is output.\\
\ChangedAt{v3.19}{\Class{scrbook}\and \Class{scrreprt}\and
- \Class{scrartl}}%
- \PValue{counterwithout} & \PName{counter name} & Cancels a prior
- \PValue{counterwithin} setting. Therefore it makes sense only if you
- redefine an existing sectioning command.\\
- \PValue{expandtopt} & \PName{switch}& If the switch is on, all subsequent
- values for lengths will be completely expanded, evaluated, and stored as
- \texttt{pt} values when they are defined. This means lengths no longer
- depend on the current font size. If the switch is off, all subsequent
- values for lengths will be tentatively expanded and evaluated but stored
- for full evaluation at application time. You can use any values from
- \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}. The
- default is \PValue{false}.\\
- \PValue{level} & \PName{integer} & The numerical value of the sectioning level
- (see the \DescRef{maincls.counter.secnumdepth} counter,
- \autoref{sec:maincls.structure},
- \DescPageRef{maincls.counter.secnumdepth});
- the value should be unique and is mandatory for new levels.\\
- \PValue{style} & \PName{name} & Defines the style of the
- heading.\\
- \ChangedAt[2016/03]{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
- \PValue{tocstyle} & \PName{name} & Defines the style of the entries in
- the table of contents. You can use every previously defined TOC-entry style
- (see \autoref{sec:tocbasic.tocstyle}). An empty \PName{name} prevents a
- new definition of the TOC-entry
- command \Macro{l@\dots}.\\
- \ChangedAt[2016/03]{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and
+ \PValue{counterwithout}
+ & \PName{counter name}
+ & Cancels a prior \PValue{counterwithin} setting. Therefore it makes sense
+ only if you redefine an existing sectioning command.\\
+ \PValue{expandtopt}
+ & \PName{switch}
+ & If the switch is on, all subsequent values for lengths will be
+ completely expanded, evaluated, and stored as \texttt{pt} values when
+ they are defined. This means lengths no longer depend on the current
+ font size. If the switch is off, all subsequent values for lengths will
+ be tentatively expanded and evaluated but stored for full evaluation at
+ application time. You can use any values from
+ \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch}.
+ The default is \PValue{false}.\\
+ \PValue{level}
+ & \PName{integer}
+ & The numerical value of the sectioning level (see the
+ \DescRef{maincls.counter.secnumdepth} counter,
+ \autoref{sec:maincls.structure},
+ \DescPageRef{maincls.counter.secnumdepth}); the value should be unique
+ and is mandatory for new levels.\\
+ \PValue{style}
+ & \PName{name}
+ & Defines the style of the heading.\\
+ \ChangedAt{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and
\Class{scrartcl}}%
- \PValue{toc\PName{option}} & \PName{value} & Additional options depending
- on the TOC-entry style selected with \Option{tocstyle}. See
- \autoref{sec:tocbasic.tocstyle}, \autopageref{sec:tocbasic.tocstyle} for
- additional information about TOC-entry styles. You can find the attributes
- that can be used as \PName{option}s for the predefined TOC-entry styles of
- the \Package{tocbasic} package in
- \autoref{tab:tocbasic.tocstyle.attributes},
- \autopageref{tab:tocbasic.tocstyle.attributes}.\\
- % \PValue{tocindent} & \PName{length} & Total indentation from the left
- % margin of the entry in the table of
- % contents corresponding to this
- % heading, if and only if such an
- % entry will be made (see
- % \DescRef{maincls.counter.tocdepth} (siehe
- % \autoref{sec:maincls.toc},
- % \DescPageRef{maincls.counter.tocdepth}).\\
- % \PValue{toclevel} & \PName{integer} &
- % A number denoting the depth of the
- % entry in the table of contents
- % corresponding to this heading, if
- % this should differ from
- % \PValue{level} (see
- % \DescRef{maincls.counter.tocdepth} in
- % \autoref{sec:maincls.toc},
- % \DescPageRef{maincls.counter.tocdepth}). \\
- % \PValue{tocnumwidth} & \PName{length} &
- % Width of the box for the number of
- % the entry in the table of contents.\\
+ \PValue{tocstyle}
+ & \PName{name}
+ & Defines the style of the entries in the table of contents. You can use
+ every previously defined TOC-entry style (see
+ \autoref{sec:tocbasic.tocstyle}). An empty \PName{name} prevents a new
+ definition of the TOC-entry command \Macro{l@\dots}.\\
+ \ChangedAt{v3.20}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}%
+ \PValue{toc\PName{option}}
+ & \PName{value}
+ & Additional options depending on the TOC-entry style selected with
+ \Option{tocstyle}. See \autoref{sec:tocbasic.tocstyle},
+ \autopageref{sec:tocbasic.tocstyle} for additional information about
+ TOC-entry styles. You can find the attributes that can be used as
+ \PName{option}s for the predefined TOC-entry styles of the
+ \Package{tocbasic} package in
+ \autoref{tab:tocbasic.tocstyle.attributes},
+ \autopageref{tab:tocbasic.tocstyle.attributes}.\\
+ % \PValue{tocindent}
+ % & \PName{length}
+ % & Total indentation from the left margin of the entry in the table of
+ % contents corresponding to this heading, if and only if such an
+ % entry will be made (see \DescRef{maincls.counter.tocdepth},
+ % \autoref{sec:maincls.toc}, \DescPageRef{maincls.counter.tocdepth}).\\
+ % \PValue{toclevel}
+ % & \PName{integer}
+ % & A number denoting the depth of the entry in the table of contents
+ % corresponding to this heading, if this should differ from
+ % \PValue{level} (see \DescRef{maincls.counter.tocdepth},
+ % \autoref{sec:maincls.toc}, \DescPageRef{maincls.counter.tocdepth}). \\
+ % \PValue{tocnumwidth}
+ % & \PName{length}
+ % & Width of the box for the number of the entry in the table of
+ % contents.\\
\bottomrule
\end{tabularx}
\end{table}
@@ -593,20 +599,55 @@ its font settings using \DescRef{maincls.cmd.setkomafont} or
\toprule
\PName{key} & \PName{value} & Description \\
\midrule
- \PValue{afterskip} & \PName{length} & A negative value activates a run-in
- heading. The absolute value is the horizontal space after the heading. A
- positive value is the vertical skip below the heading.\\
- \PValue{beforeskip} & \PName{length} & The amount indicates the vertical
- skip before the heading. If the value is negative, a positive distance
- is still inserted, but in this case the paragraph indent of the text
- following the heading is suppressed.\\
- \PValue{font} & \PName{font commands} & The font settings that should be
- used for the heading in addition to
+% TODO: New translation by Markus Kohm (please fix)
+ \PValue{afterindent}%
+ \ChangedAt{v3.26}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}%
+ & \PName{switch}
+ & The \PName{switch} defines whether or not to allow the indent of the
+ paragraph following a free-standing heading (see \PValue{runin}). With
+ the default \PValue{bysign} the sign of \PValue{beforeskip} defines the
+ behaviour. If the value of \PValue{beforeskip} is negative, the
+ paragraph indent of the text following the heading is suppressed. You
+ can use any values from \autoref{tab:truefalseswitch},
+ \autopageref{tab:truefalseswitch} to explicitly allow or suppress that
+ paragraph indent.\\
+ \PValue{afterskip}
+ & \PName{length}
+ & In case of a run-in heading, the absolute value is the horizontal space
+ after the heading. In case of a free-standing heading, the value of the
+ vertical skip below the heading. With \OptionValue{runin}{bysign}, a
+ positive value activates a free-standing heading and a negative value or
+ zero activates a run-in heading.\\
+ \PValue{beforeskip}
+ & \PName{length}
+ & The vertical skip before the heading. With
+ \OptionValue{afterindent}{bysign}, if the value is negative, a positive
+ distance\,---\,the amount of \PName{length}\,---\,is still inserted, but
+ in this case the paragraph indent of the text following the heading is
+ suppressed.\\
+% End of new translation
+ \PValue{font}
+ & \PName{font commands}
+ & The font settings that should be used for the heading in addition to
\DescRef{maincls.fontelement.disposition}. You can use all settings that
are allowed for \DescRef{maincls.cmd.setkomafont} and
\DescRef{maincls.cmd.addtokomafont} for the element of the heading.\\
- \PValue{indent} & \PName{length} & The indentation of heading from the
- left margin.\\
+ \PValue{indent}
+ & \PName{length}
+ & The indentation of heading from the left margin.\\
+% TODO: New translation by Markus Kohm (please fix)!
+ \PValue{runin}
+ \ChangedAt{v3.26}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}%
+ & \PName{switch}
+ & Defines whether to use a run-in heading or a free-standing heading. With
+ the default \PValue{bysign} the sign of \PValue{afterskip} defines the
+ behaviour. In this case, a positive value of \PValue{afterskip}
+ deactivates a run-in heading. You can use any values from
+ \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} to
+ explicitly activate or deactivate a run-in heading.\\
+% End of new translation
\bottomrule
\end{tabularx}
\end{table}
@@ -621,14 +662,31 @@ its font settings using \DescRef{maincls.cmd.setkomafont} or
\toprule
\PName{key} & \PName{value} & Description \\
\midrule
- \PValue{afterskip} & \PName{length} & The value is the vertical skip below
- the heading.\\
- \PValue{beforeskip} & \PName{length} & The value of the vertical skip
- before the heading. If the value is negative, then the positive distance
- is nevertheless inserted, and the paragraph indent of the text following
- the heading is suppressed. There will also be no indentation even for
- positive values if the \DescRef{maincls.option.version} class option is
- set to a value less than 3.22.\\
+% TODO: New translation by Markus Kohm (please fix)
+ \PValue{afterindent}%
+ \ChangedAt{v3.26}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}%
+ & \PName{switch}
+ & The \PName{switch} defines whether or not to allow the indent of the
+ paragraph following a heading. With the default \PValue{bysign} the sign
+ of \PValue{beforeskip} defines the behaviour. If the value of
+ \PValue{beforeskip} is negative, the paragraph indent of the text
+ following the heading is suppressed. You can use any values from
+ \autoref{tab:truefalseswitch}, \autopageref{tab:truefalseswitch} to
+ explicitly allow or suppress that paragraph indent.\\
+ \PValue{afterskip}%
+ \ChangedAt{v3.26}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}%
+ & \PName{length}
+ & The vertical skip below the heading.\\
+ \PValue{beforeskip}
+ & \PName{length}
+ & The vertical skip before the heading. With
+ \OptionValue{afterindent}{bysign}, if the value is negative, a positive
+ distance\,---\,the amount of \PName{length}\,---\,is still inserted, but
+ in this case the paragraph indent of the text following the heading is
+ suppressed.\\
+% End of new translation
\PValue{font} & \PName{font commands} & The font setting to use for the
heading in addition to \DescRef{maincls.fontelement.disposition}. You
can use all settings, that are allowed for
@@ -660,10 +718,33 @@ its font settings using \DescRef{maincls.cmd.setkomafont} or
\toprule
\PName{key} & \PName{value} & Description \\
\midrule
+% TODO: New translation by Markus Kohm (please fix)
+ \PValue{afterindent}%
+ \ChangedAt{v3.26}{\Class{scrbook}\and \Class{scrreprt}\and
+ \Class{scrartcl}}%
+ & \PName{switch}
+ & The \PName{switch} defines whether or not to allow the indent of the
+ paragraph following a heading. With
+ value \PValue{bysign} the sign of \PValue{beforeskip} defines the
+ behaviour. If the value of \PValue{beforeskip} is negative, the
+ paragraph indent of the text following the heading is suppressed. You
+ can use any values from \autoref{tab:truefalseswitch},
+ \autopageref{tab:truefalseswitch} to explicitly allow or suppress that
+ paragraph indent. For compatibility, the default of \Class{scrartcl} is
+ \PValue{false} and the default of \Class{scrbook} and \Class{scrreprt}
+ is \PValue{true}.\\
+% End of new translation
\PValue{afterskip} & \PName{length} & The value is the vertical skip below
the heading.\\
- \PValue{beforeskip} & \PName{length}& The value is the vertical skip above
- the heading.\\
+% TODO: New translation by Markus Kohm (please fix)
+ \PValue{beforeskip}
+ & \PName{length}
+ & The vertical skip before the heading. With
+ \OptionValue{afterindent}{bysign}, if the value is negative, a positive
+ distance\,---\,the amount of \PName{length}\,---\,is still inserted, but
+ in this case the paragraph indent of the text following the heading is
+ suppressed.\\
+% End of new translation
\PValue{font} & \PName{font commands} & The font setting to use for the
heading in addition to \DescRef{maincls.fontelement.disposition}. You
can use all settings that are allowed for