diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc/english/common-1.tex')
-rw-r--r-- | Master/texmf-dist/source/latex/koma-script/doc/english/common-1.tex | 197 |
1 files changed, 102 insertions, 95 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/common-1.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/common-1.tex index 550cafe8918..3dbcdad259b 100644 --- a/Master/texmf-dist/source/latex/koma-script/doc/english/common-1.tex +++ b/Master/texmf-dist/source/latex/koma-script/doc/english/common-1.tex @@ -40,13 +40,15 @@ % % ---------------------------------------------------------------------- % -% Absätze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind +% Absaetze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind % Verwaltet von Markus Kohm % % ====================================================================== -\ProvidesFile{common-1.tex}[2009/01/04 KOMA-Script guide (common paragraphs)] -\translator{Gernot Hassenpflug} +\ProvidesFile{common-1.tex}[2012/04/08 KOMA-Script guide (common paragraphs)] +\translator{Markus Kohm\and Krickette Murabayashi} + +% Date of the translated German file: 2011/09/20 \makeatletter \@ifundefined{ifCommonmaincls}{\newif\ifCommonmaincls}{}% @@ -56,115 +58,120 @@ \makeatother -\section{Kompatibilität zu früheren Versionen von \KOMAScript} +\section{Compatibility with Earlier Versions of \KOMAScript} \label{sec:\csname label@base\endcsname.compatibilityOptions} -\ifshortversion\IgnoreThisfalse\IfNotCommon{maincls}{\IgnoreThistrue}\fi% -\ifIgnoreThis% -Es gilt sinngemäß, was in \autoref{sec:maincls.compatibilityOptions} -geschrieben wurde. \IfCommon{scrlttr2}{Allerdings existiert diese Möglichkeit - bei \Class{scrlttr2} bereits seit Version~2.9t}. -\else -\BeginIndex{}{Kompatibilität} - -\IfCommon{maincls}{Wer seine Dokumente im Quellcode archiviert, legt in der - Regel allergrößten Wert darauf, dass bei zukünftigen \LaTeX{}-Läufen immer - wieder exakt dasselbe Ergebnis erzielt wird. In einigen Fällen ist es aber - so, dass Verbesserungen und Korrekturen an der Klasse zu Änderungen im - Verhalten, inbesondere beim Umbruch, führen.}% -\IfCommon{scrextend}{Wer seine Dokumente im Quellcode archiviert, legt in der - Regel allergrößten Wert darauf, dass bei zukünftigen \LaTeX{}-Läufen immer - wieder exakt dasselbe Ergebnis erzielt wird. In einigen Fällen ist es aber - so, dass Verbesserungen und Korrekturen an der Klasse zu Änderungen im - Verhalten, inbesondere beim Umbruch, führen.}% -\IfCommon{scrlttr2}{In einigen Fällen ist es so, dass Verbesserungen und - Korrekturen an der Klasse zu Änderungen im Verhalten, inbesondere beim - Umbruch, führen. Dies ist jedoch nicht immer erwünscht.}% +\ifshortversion\IgnoreThisfalse\IfNotCommon{typearea}{\IgnoreThistrue}\fi% +\ifIgnoreThis %+++++++++++++++++++++++++++++++++++++++++++++ nicht typearea + + +It applies, mutatis mutandis, what is written in +\autoref{sec:typearea.compatibilityOptions}\IfCommon{scrlttr2}{. However, this + feature exists at \Class{scrlttr2} since version~2.9t}. +\else %------------------------------------------------------- nur typearea - +\BeginIndex{}{Compatibility} +\IfCommon{typearea}{Those who achieve their documents in source code set utmost + value to the fact that future \LaTeX{} runs will yield exactly the same + result. Nevertheless, in some cases improvement and bug corrections of + packages will result in changes of the behaviour and make-up. But sometimes + this is not wanted.}% +\IfCommon{maincls}{Those who achieve their documents in source code set utmost + value to the fact that future \LaTeX{} runs will yield exactly the same + result. However, sometimes improvement and bug corrections of classes will result + in changes of the behaviour and make-up. But sometimes this is not wanted.}% +\IfCommon{scrextend}{Those who achieve their documents in source code set + utmost value to the fact that future \LaTeX{} runs will yield exactly + the same result. In some cases improvement and bug corrections of packages + will result in changes of the behaviour and make-up. But sometimes this is + not wanted.}% +\IfCommon{scrlttr2}{In some cases improvement and bug corrections of classes + will result in changes of the behaviour and make-up. But sometimes this is + not wanted.}% \begin{Declaration} - \KOption{version}\PName{Wert}\\ - \OptionValue{version}{first}\\ - \OptionValue{version}{last} + \KOption{version}\PName{value}\\ + \XOptionValue{version}{first}\\ + \XOptionValue{version}{last} \end{Declaration} \BeginIndex{Option}{version}% -\BeginIndex{Option}{version~=\PName{Wert}}% -\BeginIndex{Option}{version~=last}% -\BeginIndex{Option}{version~=first}% -\IfCommon{maincls}{\ChangedAt{v2.96a}{\Class{scrbook}\and \Class{scrreprt}\and - \Class{scrartcl}}Seit Version~2.96a besteht bei \KOMAScript\ }% -\IfCommon{scrlttr2}{\ChangedAt{v2.9t}{Seit \Class{scrlttr2}} Version~2.9t - besteht bei \Class{scrlttr2} }% -\IfCommon{scrextend}{Bei \Package{scrextend} besteht }% -die Wahl, ob eine Quelldatei soweit irgend möglich auch zukünftig bei einem -\LaTeX{}-Lauf zu exakt demselben Ergebnis führen soll oder ob jeweils -entsprechend der Anpassungen der neusten Version der Klasse zu setzen ist. Zu -welcher Version Kompatibilität herzustellen ist, wird dabei über die Option -\Option{version} festgelegt. Voreingestellt ist Version~2.9t. Dasselbe -Ergebnis kann mit -% Umbruchkorrektur: Unterlängenproblem in listings! -\begin{lstcode}[belowskip=\dp\strutbox] - version=first -\end{lstcode} -oder -\begin{lstcode}[belowskip=\dp\strutbox] - version=2.9 -\end{lstcode} -oder -\begin{lstcode}[belowskip=\dp\strutbox] - version=2.9t -\end{lstcode} -erreicht werden. Bei Angabe einer unbekannten Version als \PName{Wert} wird -eine Warnung ausgegeben und sicherheitshalber \Option{version=}\PValue{first} -angenommen. Mit -\begin{lstcode}[belowskip=\dp\strutbox] - version=last -\end{lstcode} -kann die jeweils neuste Version ausgewählt werden. In diesem Fall wird also -auf zukünftige Kompatibilität verzichtet. Wird die Option ohne Wertangabe -verwendet, so wird ebenfalls \PValue{last} angenommen. - -Die Frage der Kompatibilität betrifft in erster Linie Fragen des Umbruchs. Neue -Möglichkeiten, die sich nicht auf den Umbruch auswirken, sind auch dann -verfügbar, wenn man per Option die Kompatibilität zu einer älteren Version -ausgewählt hat. Die Option hat keine Auswirkungen auf Umbruchänderungen, die -bei Verwendung einer neueren Version durch Beseitigung eindeutiger Fehler -entstehen. Wer auch im Fehlerfall unbedingte Umbruchkompatibilität benötigt, -sollte stattdessen mit dem Dokument auch die verwendete \KOMAScript-Version -archivieren. +\BeginIndex{Option}{version~=\PName{value}}% +\BeginIndex{Option}{version~=\PValue{last}}% +\BeginIndex{Option}{version~=\PValue{first}}% +\IfNotCommon{scrextend}{Since }% +\ChangedAt{v2.96a}{\Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}% +\ChangedAt{v2.9t}{\Class{scrlttr2}}% +\ChangedAt{v3.01b}{\Package{typearea}}% +\IfCommon{typearea}{\ifshortversion % + version~2.96a of \KOMAScript, for \Class{scrlttr2} since + version~2.9t, and for \Package{typearea} since version~3.01b, % + \else% + version~3.01b of \Package{typearea} % + \fi% +}% +\IfCommon{maincls}{version~2.96a of \KOMAScript{} }% +\IfCommon{scrlttr2}{version~2.9t of \Class{scrlttr2} }% +\IfCommon{scrextend}{At \Package{scrextend} }% +it's your choice if your source code should result in the same make-up at +future \LaTeX{} runs or if you like to participate in all improvements of new +releases\IfCommon{maincls}{ of the class}\IfCommon{scrlttr2}{ of the + class}. You may select the compatible version of \KOMAScript{} with option +\Option{version}. Compatibility to the lowest supported \KOMAScript{} +release may be achieved by +\OptionValue{version}{first}\important{\OptionValue{version}{first}} or +\OptionValue{version}{2.9} or \OptionValue{version}{2.9t}. Setting +\PName{value} to an unknown release number will result in a warning message and +selects \OptionValue{version}{first} for safety. + +With \OptionValue{version}{last} the most recent version will be selected at +every \LaTeX{} run. Be warned, though, that using \OptionValue{version}{last} +poses possibilities of compatibility issues for future \LaTeX{} runs. Option +\Option{version} without any \PName{value} means the +same. \ChangedAt{v3.01a}{\Class{scrbook}\and \Class{scrreprt}\and + \Class{scrartcl}\and \Class{scrlttr2}\and \Package{scrextend}}This is the +default behaviour as long as you don't use any deprecated options. + +If\textnote{Attention!} you use a deprecated option of \KOMAScript~2, +\KOMAScript~3 will switch to \OptionValue{version}{first} automatically. This +will also result in a warning message that explains how to prevent this +switching. Alternatively you may select another adjustment using option +\Option{version} with the wanted compatibility after the deprecated option. + +Compatibility is primarily make-up compatibility. New features not related to +the mark-up will be available even if you switch compatibility to a version +before first implementation of the feature. Option \Option{version} doesn't +influence make-up changes that are motivated by bug fixes. If you need bug +compatibility you should physically save the used \KOMAScript{} version +together with your document. \IfCommon{scrlttr2}{\begin{Example} - Die Beispielbriefe dieses Kapitels sollen alle Möglichkeiten nutzen, die in - der neusten Version von \KOMAScript{} zur Verfügung stehen. Dazu muss beim - Laden der Klasse die Kompatibilität entsprechend gesetzt werden:% + The letter examples of this chapter should use and show all the features + of the recent \KOMAScript{} release. To achieve this, we set the + corresponding compatibility:% \lstinputcode[xleftmargin=1em,lastline=1]{letter-0.tex}% - \iftrue% Umbruchkorrektur - Hier wurde einfach mit dem symbolischen Wert \PValue{last} die neuste - Version gewählt.% - \else% - Um nicht bei jeder neuen Version eine neue Versionsnummer angeben zu - müssen, wurde hier die Möglichkeit des symbolischen Wertes \PValue{last} - gewählt.% - \fi + In this case the symbolic value \PValue{last} has been used to select the + latest version.% \end{Example}} -Es ist zu beachten, dass die Option \Option{version} nach dem Laden % -\IfCommon{maincls}{der Klasse }% -\IfCommon{scrlttr2}{der Klasse }% -\IfCommon{scrextend}{des Pakets \Package{scrextend} }% -nicht mehr verändert werden kann.% -% -\EndIndex{Option}{version~=\PName{Wert}}% -\EndIndex{Option}{version~=first}% -\EndIndex{Option}{version~=last}% +Please note\textnote{Attention!} that you can't change option \Option{version} +anymore after loading the % +\IfCommon{maincls}{class}% +\IfCommon{scrlttr2}{class}% +\IfCommon{typearea}{package \Package{typearea}}% +\IfCommon{scrextend}{package \Package{scrextend}}% +. Therefore, the usage of option \Option{version} within the argument of +\Macro{KOMAoptions} or \Macro{KOMAoption} is not recommended and will cause an +error.% +\EndIndex{Option}{version~=\PName{value}}% +\EndIndex{Option}{version~=\PValue{first}}% +\EndIndex{Option}{version~=\PValue{last}}% \EndIndex{Option}{version}% % -\EndIndex{}{Kompatibilität} +\EndIndex{}{Compatibility} -\fi % IgnoreThis +\fi % *************************************************** Ende nur typearea * %%% Local Variables: %%% mode: latex -%%% coding: iso-latin-1 +%%% coding: us-ascii %%% TeX-master: "../guide" %%% End: |