summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/koma-script/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2009-07-20 18:10:03 +0000
committerKarl Berry <karl@freefriends.org>2009-07-20 18:10:03 +0000
commitc085420206defb618b877e4e046024830c6ef8e1 (patch)
tree4871a44a4250285bfd69467785548085cf5ab21e /Master/texmf-dist/source/latex/koma-script/doc
parentd0d80da633ecb4209bb8355828026d5cf5419ea7 (diff)
koma-script update (8jul09)
git-svn-id: svn://tug.org/texlive/trunk@14345 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/source/latex/koma-script/doc')
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2.tex120
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/english/tocbasic.tex4
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/guide.bib9
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2-experts.tex247
-rw-r--r--Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2.tex78
5 files changed, 345 insertions, 113 deletions
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2.tex
index f53c5112241..03c4c01e181 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/scrlttr2.tex
@@ -45,7 +45,7 @@
%
% ============================================================================
-\ProvidesFile{scrlttr2.tex}[2009/01/01 KOMA-Script guide (chapter: scrlttr2)]
+\ProvidesFile{scrlttr2.tex}[2009/06/12 KOMA-Script guide (chapter: scrlttr2)]
\translator{Harald Bongartz\and Georg Grandke\and Raimund Kohl\and Jens-Uwe
Morawski\and Stephan Hennig\and Gernot Hassenpflug\and Markus Kohm}
@@ -909,15 +909,15 @@ can contain internal commands available to package writers. For
(see \autoref{sec:scrlttr2.pseudoLength}).
There are already some \File{lco} files included in the {\KOMAScript}
-distribution. The \File{DIN.lco}, \File{DINmtext.lco},
-\File{SNleft.lco}, and \File{SN.lco} files serve to adjust
-{\KOMAScript} to different layout standards. They are well suited as
-templates for your own parameter sets. The \File{KOMAold.lco} file, on
-the other hand, serves to improve compatibility with the old letter
-class \Class{scrlettr}. Since it contains internal commands not open
-to package writers, you should not use this as a template for your own
-\File{lco} files. You can find a list of predefined \File{lco} files
-in \autoref{tab:lcoFiles}, \autopageref{tab:lcoFiles}.
+distribution. The \File{DIN.lco}, \File{DINmtext.lco}, \File{SNleft.lco},
+\File{SN.lco}, and \File{NF.lco}\ChangedAt{v3.04}{\Class{scrlttr2}} files
+serve to adjust {\KOMAScript} to different layout standards. They are well
+suited as templates for your own parameter sets. The \File{KOMAold.lco} file,
+on the other hand, serves to improve compatibility with the old letter class
+\Class{scrlettr}. Since it contains internal commands not open to package
+writers, you should not use this as a template for your own \File{lco}
+files. You can find a list of predefined \File{lco} files in
+\autoref{tab:lcoFiles}, \autopageref{tab:lcoFiles}.
\begin{Explain}
If you have defined a parameter set for a letter standard not yet
@@ -1051,66 +1051,70 @@ value. Additionally, also reduce \PLength{toaddrwidth} accordingly.
\Endhead%
\standardfoot%
\oentry{DIN}{%
- parameter set for letters on A4-size paper, complying with German
- standard DIN~676; suitable for window envelopes in the sizes C4,
- C5, C6, and C6/5 (C6 long).}%
- \oentry{DINmtext}{%
- parameter set for letters on A4-size paper, complying with
- DIN~676, but using an alternate layout with more text on the first
- page; only suitable for window envelopes in the sizes C6 and C6/5
+ parameter set for letters on A4-size paper, complying with German standard
+ DIN~676; suitable for window envelopes in the sizes C4, C5, C6, and C6/5
(C6 long).}%
+ \oentry{DINmtext}{%
+ parameter set for letters on A4-size paper, complying with DIN~676, but
+ using an alternate layout with more text on the first page; only suitable
+ for window envelopes in the sizes C6 and C6/5 (C6 long).}%
\oentry{KOMAold}{%
- parameter set for letters on A4-size paper using a layout close to
- the now obsolete \Class{scrlettr} letter class; suitable for
- window envelopes in the sizes C4, C5, C6, and C6/5 (C6 long); some
- additional commands to improve compatibility with obsolete
- \Class{scrlettr} commands are defined; \Class{scrlttr2} may behave
- slightly different when used with this \File{lco} file than with
- the other \File{lco} files.}%
+ parameter set for letters on A4-size paper using a layout close to the now
+ obsolete \Class{scrlettr} letter class; suitable for window envelopes in
+ the sizes C4, C5, C6, and C6/5 (C6 long); some additional commands to
+ improve compatibility with obsolete \Class{scrlettr} commands are defined;
+ \Class{scrlttr2} may behave slightly different when used with this
+ \File{lco} file than with the other \File{lco} files.}%
+ \oentry{NF}{%
+ parameter set for French letters, according to NF~Z~11-001; suitable for
+ window envelopes of type DL (110\Unit{mm} to 220\Unit{mm}) with a window
+ of about 20\Unit{mm} from right and bottom with width 45\Unit{mm} and
+ height 100\Unit{mm}; this file was originally developed by Jean-Marie
+ Pacquet, who provides an extended version and additional information on
+ \cite{www:NF.lco}.}%
\oentry{NipponEL}{%
- parameter set for Japanese letters in A4 format; suitable for
- Japanese window envelopes of types Chou or You 3 or 4, in which
- the windows is approximately 90\Unit{mm} wide, 45\Unit{mm} high,
- and positioned 22\Unit{mm} from the left and 12\Unit{mm} from the
- top edge (see \autoref{cha:japanlco}).}%
+ parameter set for Japanese letters in A4 format; suitable for Japanese
+ window envelopes of types Chou or You 3 or 4, in which the windows is
+ approximately 90\Unit{mm} wide, 45\Unit{mm} high, and positioned
+ 22\Unit{mm} from the left and 12\Unit{mm} from the top edge (see
+ \autoref{cha:japanlco}).}%
\oentry{NipponEH}{%
- parameter set for Japanese letters in A4 format; suitable for
- Japanese window envelopes of types Chou or You 3 or 4, in which
- the windows is approximately 90\Unit{mm} wide, 55\Unit{mm} high,
- and positioned 22\Unit{mm} from the left and 12\Unit{mm} from the
- top edge (see \autoref{cha:japanlco}).}%
+ parameter set for Japanese letters in A4 format; suitable for Japanese
+ window envelopes of types Chou or You 3 or 4, in which the windows is
+ approximately 90\Unit{mm} wide, 55\Unit{mm} high, and positioned
+ 22\Unit{mm} from the left and 12\Unit{mm} from the top edge (see
+ \autoref{cha:japanlco}).}%
\oentry{NipponLL}{%
- parameter set for Japanese letters in A4 format; suitable for
- Japanese window envelopes of types Chou or You 3 or 4, in which
- the windows is approximately 90\Unit{mm} wide, 45\Unit{mm} high,
- and positioned 25\Unit{mm} from the left and 12\Unit{mm} from the
- top edge (see \autoref{cha:japanlco}).}%
+ parameter set for Japanese letters in A4 format; suitable for Japanese
+ window envelopes of types Chou or You 3 or 4, in which the windows is
+ approximately 90\Unit{mm} wide, 45\Unit{mm} high, and positioned
+ 25\Unit{mm} from the left and 12\Unit{mm} from the top edge (see
+ \autoref{cha:japanlco}).}%
\oentry{NipponLH}{%
- parameter set for Japanese letters in A4 format; suitable for
- Japanese window envelopes of types Chou or You 3 or 4, in which
- the windows is approximately 90\Unit{mm} wide, 55\Unit{mm} high,
- and positioned 25\Unit{mm} from the left and 12\Unit{mm} from the
- top edge (see \autoref{cha:japanlco}).}%
+ parameter set for Japanese letters in A4 format; suitable for Japanese
+ window envelopes of types Chou or You 3 or 4, in which the windows is
+ approximately 90\Unit{mm} wide, 55\Unit{mm} high, and positioned
+ 25\Unit{mm} from the left and 12\Unit{mm} from the top edge (see
+ \autoref{cha:japanlco}).}%
\oentry{NipponRL}{%
- parameter set for Japanese letters in A4 format; suitable for
- Japanese window envelopes of types Chou or You 3 or 4, in which
- the windows is approximately 90\Unit{mm} wide, 45\Unit{mm} high,
- and positioned 25\Unit{mm} from the left and 24\Unit{mm} from the
- top edge (see \autoref{cha:japanlco}).}%
- \oentry{KakuLL}{%
- parameter set for Japanese letters in A4 format; suitable for
- Japanese window envelopes of type Kaku A4, in which the windows is
+ parameter set for Japanese letters in A4 format; suitable for Japanese
+ window envelopes of types Chou or You 3 or 4, in which the windows is
approximately 90\Unit{mm} wide, 45\Unit{mm} high, and positioned
25\Unit{mm} from the left and 24\Unit{mm} from the top edge (see
\autoref{cha:japanlco}).}%
+ \oentry{KakuLL}{%
+ parameter set for Japanese letters in A4 format; suitable for Japanese
+ window envelopes of type Kaku A4, in which the windows is approximately
+ 90\Unit{mm} wide, 45\Unit{mm} high, and positioned 25\Unit{mm} from the
+ left and 24\Unit{mm} from the top edge (see \autoref{cha:japanlco}).}%
\oentry{SN}{%
- parameter set for Swiss letters with address field on the right
- side, according to SN~010\,130; suitable for Swiss window
- envelopes in the sizes C4, C5, C6, and C6/5 (C6 long).}%
+ parameter set for Swiss letters with address field on the right side,
+ according to SN~010\,130; suitable for Swiss window envelopes in the sizes
+ C4, C5, C6, and C6/5 (C6 long).}%
\oentry{SNleft}{%
- parameter set for Swiss letters with address field on the left
- side; suitable for Swiss window envelopes with window on the left
- side in the sizes C4, C5, C6, and C6/5 (C6 long).}%
+ parameter set for Swiss letters with address field on the left side;
+ suitable for Swiss window envelopes with window on the left side in the
+ sizes C4, C5, C6, and C6/5 (C6 long).}%
\end{desctable}
\begin{Explain}
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/english/tocbasic.tex b/Master/texmf-dist/source/latex/koma-script/doc/english/tocbasic.tex
index 4b45a2c316f..2c876dfd2c1 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/english/tocbasic.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/english/tocbasic.tex
@@ -38,9 +38,9 @@
%% standard classes created by The LaTeX3 Project 1994-1996.
%%
%%% From File: tocbasic.dtx
-\def\tocbasicversion{2009/01/20 v3.02a}
+\def\tocbasicversion{2009/06/08 v3.03b}
\ProvidesFile{tocbasic.tex}
- [\tocbasicversion
+ [\tocbasicversion\space KOMA-Script package
(manual)%
]
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/guide.bib b/Master/texmf-dist/source/latex/koma-script/doc/guide.bib
index 10761b93606..c1cb00521f5 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/guide.bib
+++ b/Master/texmf-dist/source/latex/koma-script/doc/guide.bib
@@ -133,6 +133,15 @@
address = {Berlin}
}
+@Misc{ www:NF.lco,
+ language = {english},
+ author = {Jean-Marie Pacquet},
+ title = {{KomaLetter2}; {E}xample by {J}ean-{M}arie {P}acquet ({F}rench style)},
+ institution = {wiki.lyx.org},
+ howpublished = {Wiki},
+ url = {http://wiki.lyx.org/Examples/KomaLetter2#toc6}
+}
+
@Misc{ www:blaettery,
language = {ngerman},
author = {Jürgen F. Schopp},
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2-experts.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2-experts.tex
index 216d50925cc..f80b4d62b17 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2-experts.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2-experts.tex
@@ -45,7 +45,7 @@
%
% ============================================================================
-\ProvidesFile{scrlttr2-experts.tex}[2009/03/04 KOMA-Script guide (chapter: scrlttr2 for experts)]
+\ProvidesFile{scrlttr2-experts.tex}[2009/07/07 KOMA-Script guide (chapter: scrlttr2 for experts)]
\chapter{Zusätzliche Informationen zur
Briefklasse \Class{scrlttr2}}
@@ -565,7 +565,8 @@ Die Pseudolänge \PLength{firstheadwidth} gibt die Breite des Briefkopfes
an. Der Wert wird in den vordefinierten \File{lco}-Dateien unterschiedlich
gesetzt. Während er normalerweise von der Papierbreite und dem horizontalen
Abstand der Empfängeradresse vom linken Papierrand abhängt, entspricht er bei
-\Option{KOMAold} der Breite des Satzspiegels.%
+\Option{KOMAold} der Breite des Satzspiegels und ist bei \Option{NF} fest auf
+170\Unit{mm} eingestellt.%
\EndIndex{PLength}{firstheadwidth}%
@@ -581,7 +582,7 @@ erwähnt wurde, kann in den vordefinierten Briefköpfen eine Linie im oder unter
dem Absender gesetzt werden. Hat die Pseudolänge \PLength{fromrulewidth} die
Länge 0, so wird dabei die Länge dieser Linie automatisch bestimmt. Dies ist
die Voreinstellung bei den vordefinierten \File{lco}-Dateien. Der Wert kann
-mit \Macro{\@setplength} (siehe
+mit \Macro{@setplength} (siehe
\autopageref{desc:scrlttr2-experts.cmd.@setplength}) in eigenen
\File{lco}-Dateien aber auch abweichend gesetzt werden. Die voreingestellte
Dicke\ChangedAt{v2.97c}{\Class{scrlttr2}}, \PLength{fromrulethickness}, der
@@ -615,11 +616,11 @@ Fensterbriefumschlags vom oberen und vom linken Rand des Papiers an. Sie
werden in den vordefinierten \File{lco}-Dateien unterschiedlich eingestellt.
Für \PLength{toaddrhpos} gilt außerdem eine Besonderheit. Ist der Wert
negativ, so ist sein Betrag der Abstand des Anschriftfeldes vom rechten Rand
-des Papiers. Sie finden dies beispielsweise bei \Option{SN}. Am kleinsten ist
-der Wert \PLength{toaddrvpos} bei \Option{DINmtext}. Hier kann es schnell
-passieren, dass der Briefkopf in das Anschriftfenster ragt. Ob das
-Anschriftfenster überhaupt gesetzt wird, hängt von der Option
-\Option{addrfield} ab (siehe \autoref{sec:scrlttr2.firstpage},
+des Papiers. Sie finden dies beispielsweise bei \Option{SN} oder
+\Option{NF}. Am kleinsten ist der Wert \PLength{toaddrvpos} bei
+\Option{DINmtext}. Hier kann es schnell passieren, dass der Briefkopf in das
+Anschriftfenster ragt. Ob das Anschriftfenster überhaupt gesetzt wird, hängt
+von der Option \Option{addrfield} ab (siehe \autoref{sec:scrlttr2.firstpage},
\autopageref{desc:scrlttr2.option.addrfield}).%
\EndIndex{PLength}{toaddrhpos}%
\EndIndex{PLength}{toaddrvpos}%
@@ -1014,13 +1015,13 @@ verringert werden.
Bei einer Kompatibilitätseinstellung\ChangedAt{v2.9t}{\Class{scrlttr2}} bis
Version~2.9t (siehe \Option{version} in
\autoref{sec:scrlttr2.compatibilityOptions},
-\autopageref{desc:scrlttr2.option.version}) wird außer bei \Option{KOMAold} in
-allen vordefinierten \File{lco}-Dateien (siehe \autoref{sec:scrlttr2.lcoFile})
-der Fuß abhängig vom Satzspiegel gesetzt. Damit hat dann auch
-\Option{enlargefirstpage} keine Wirkung. Ab Version 2.9u bekommt der Fuß eine
-Position am unteren Ende des Papiers. Damit ist dann die Höhe des Satzspiegels
-des Briefbogens eventuell auch von der Option \Option{enlargefirstpage}
-abhängig.
+\autopageref{desc:scrlttr2.option.version}) wird außer bei \Option{KOMAold}
+und \Option{NF} in allen vordefinierten \File{lco}-Dateien (siehe
+\autoref{sec:scrlttr2.lcoFile}) der Fuß abhängig vom Satzspiegel gesetzt.
+Damit hat dann auch \Option{enlargefirstpage} keine Wirkung. Ab Version 2.9u
+bekommt der Fuß eine Position am unteren Ende des Papiers. Damit ist dann die
+Höhe des Satzspiegels des Briefbogens eventuell auch von der Option
+\Option{enlargefirstpage} abhängig.
Sollte der Briefbogenfuß mittels Option
\Option{firstfoot}\IndexOption{firstfoot}\ChangedAt{v2.97e}{\Class{scrlttr2}}
@@ -1168,26 +1169,33 @@ funktionieren.
Obwohl jedes von \Package{typearea} einstellbare Format verwendbar ist, kann
es bei der Ausgabe der ersten Briefseite mit manchen Formaten zu unerwünschten
Ergebnissen kommen. Das liegt aber nicht am Konzept der Klasse, sondern daran,
-dass derzeit nur Parametersätze für ISO A4 existieren. Leider gibt es keine
-allgemein gültigen Regeln, um die Position von Anschriftfeldern und Ähnlichem
-für beliebige Papierformate zu berechnen. Es ist jedoch möglich, auch für
-andere Papierformate Parametersätze zu erstellen.%
+dass derzeit hauptsächlich Parametersätze für ISO A4 existieren. Leider gibt
+es keine allgemein gültigen Regeln, um die Position von Anschriftfeldern und
+Ähnlichem für beliebige Papierformate zu berechnen. Es ist jedoch möglich,
+auch für andere Papierformate Parametersätze zu erstellen.%
\EndIndex{}{Papierformat>Beschraenkungen=Beschränkungen}%
+\subsection{Überwachung des Papierformats}
+\label{sec:scrlttr2-experts.papersize}
+
+Derzeit existieren Parametersätze und \File{lco}-Dateien für A4-Papier und
+letter-Papier. Die Klasse \Class{scrlttr2} versteht aber theoretisch sehr viel
+mehr Papierformate. Daher ist es notwendig zu überwachen, ob die korrekte
+Papiergröße eingestellt ist.
+
\begin{Declaration}
\Macro{LetterOptionNeedsPapersize}%
\Parameter{Optionsname}\Parameter{Papiergröße}
\end{Declaration}
\BeginIndex{Cmd}{LetterOptionNeedsPapersize}%
-Derzeit existieren nur Parametersätze und \File{lco}-Dateien für
-A4-Papier. Damit man bei Verwendung einer anderen
-\PName{Papiergröße}\Index{Papierformat} zumindest gewarnt wird, ist in
-jeder mit \KOMAScript{} ausgelieferten \File{lco}-Datei eine Anweisung
-\Macro{LetterOptionNeedsPapersize} zu finden. Als erstes Argument wird
-dabei der Name der \File{lco}-Datei ohne die Endung »\File{.lco}«
-übergeben. Als zweites Argument wird die Papiergröße übergeben, für
-die diese \File{lco}-Datei gedacht ist.
+Damit man bei Verwendung einer in der \File{lco}-Datei nicht
+vorgesehenen \PName{Papiergröße}\Index{Papierformat} zumindest gewarnt wird,
+sind in den mit \KOMAScript{} ausgelieferten \File{lco}-Dateien Anweisungen
+\Macro{LetterOptionNeedsPapersize} zu finden. Als erstes Argument wird dabei
+der Name der \File{lco}-Datei ohne die Endung »\File{.lco}« übergeben. Als
+zweites Argument wird die Papiergröße übergeben, für die diese
+\File{lco}-Datei gedacht ist.
Werden nacheinander mehrere \File{lco}-Dateien geladen, so kann jede dieser
\File{lco}-Dateien eine Anweisung \Macro{LetterOptionNeedsPapersize}
@@ -1227,6 +1235,191 @@ und auch das Beispiel überspringen.
\end{Example}
%
\EndIndex{Cmd}{LetterOptionNeedsPapersize}%
+
+\subsection{Positionen sichtbar machen}
+\label{sec:scrlttr2-experts.visualize}
+\BeginIndex{Option}{visualize}
+
+Wenn man selbst \File{lco}-Dateien entwickelt, beispielsweise umd die
+Positionen von verschiedenen Feldern des Briefbogens an eigene Wünsche oder
+Notwendigkeiten anzupassen, ist es hilfreich, wenn zumindest einige Elemente
+unmittelbar sichtbar gemacht werden können. Zu diesem Zweck existiert die
+\File{lco}-Datei
+\File{visualize.lco}\ChangedAt{v3.04}{\Class{scrlttr2}}. Diese kann wie jede
+\File{lco}-Datei geladen werden. Allerdings ist das Laden dieser \emph{Letter
+ Class Option} auf die Dokumentpräambel beschränkt und seine Auswirkungen
+können nicht wieder rückgängig gemacht werden. Die \File{lco}-Datei selbst
+bedient sich der Pakete \Package{eso-pic}\IndexPackage{eso-pic} und
+\Package{graphicx}\IndexPackage{graphicx}, die nicht zu \KOMAScript{} gehören.
+
+Es wird darauf hingewiesen, dass \Option{visualize} bisher nur in einer
+Beta-Version existiert. Das bedeutet insbesondere, dass es keinen Support
+dafür gibt und sich noch alles ändern kann. Da die Datei aber ohnehin nicht
+für Produktionssysteme genutzt werden sollte, sondern in erste Linie der
+Entwicklung eigener Parametersätze dient, sollte das die Verwendbarkeit nicht
+verhindern.
+
+\begin{Declaration}
+ \Macro{showfields}\Parameter{Feldliste}
+\end{Declaration}
+\BeginIndex{Cmd}{showfields}%
+Mit dieser Anweisung kann die Visualisierung von Feldern des Briefbogens
+aktiviert werden. Das Argument \PName{Feldliste} ist dabei eine durch Komma
+separierte Liste der Feldern, die visualisiert werden sollen. Folgende Felder
+werden derzeit unterstützt:
+\begin{description}
+\item[test] -- ein Testfeld der Größe 10\Unit{cm} auf 15\Unit{cm}, das jeweils
+ 1\Unit{cm} vom oberen und linken Papierrand entfernt ist. Dieses Testfeld
+ existiert zu Debuggingzwecken. Es dient als Vergleichsmaß für den Fall, dass
+ im Dokumenterstellungsprozess die Maße verfälscht werden.
+\item[head] -- der Kopfbereich des Briefbogens. Es handelt sich hier um ein nach
+ unten offenes Feld.
+\item[foot] -- der Fußbereich des Briefbogens. Es handelt sich hier um ein nach
+ unten offenes Feld.
+\item[address] -- das Anschriftfenster.
+\item[location] -- das Feld der Absenderergänzung.
+\item[refline] -- die Geschäftszeile. Es handelt sich hier um ein nach unten
+ offenes Feld.
+\end{description}%
+\BeginIndex{FontElement}{field}%
+Mit Hilfe der Anweisungen \Macro{setkomafont} und \Macro{addtokomafont} (siehe
+\autoref{sec:scrlttr2.textmarkup},
+\autopageref{desc:scrlttr2.cmd.setkomafont}) für das
+Element \FontElement{field} kann die Farbe der Visualisierung geändert
+werden. Voreingestellt ist \Macro{normalcolor}.%
+\EndIndex{FontElement}{field}%
+%
+\EndIndex{Cmd}{showfields}
+
+\begin{Declaration}
+ \Macro{setshowstyle}\Parameter{Visualsisierungsstil}\\
+ \Macro{edgesize}
+\end{Declaration}
+\BeginIndex{Cmd}{setshowstyle}%
+\BeginIndex{Cmd}{edgesize}
+In der Voreinstellung werden die einzelnen Felder durch Umgrenzungslinien
+markiert. Dies entspricht dem \PName{Visualisierungsstil} \PValue{frame}. Nach
+unten offene Felder werden dabei nicht komplett umrahmt, sondern unten offen
+mit kleinen Pfeilen nach unten dargestellt. Als Alternative hierzu steht auch
+der \PName{Visualisierungsstil} \PValue{rule} zur Verfügung. Dabei wird das
+Feld farbig hinterlegt. Hierbei kann nicht zwischen geschlossenen und nach
+unten offenen Feldern unterschieden werden. Stattdessen werden nach unten
+offene Felder mit einer Mindesthöhe dargestellt. Der dritte verfügbare
+\PName{Visualisierungsstil} ist \PValue{edge}. Dabei werden die Ecken der
+Felder markiert. Bei nach unten offenen Feldern entfallen dabei die unteren
+Eckmarkierungen. Die Größe der Eckmarkierungen ist im Makro \Macro{edgesize}
+abgelegt und mit 1\Unit{ex} voreingestellt.
+\EndIndex{Cmd}{edgesize}
+\EndIndex{Cmd}{setshowstyle}
+
+\begin{Declaration}
+ \Macro{showenvelope}(\PName{Breite},\PName{Höhe})%
+ (\PName{HOffset},\PName{VOffset})\OParameter{Zusatz}\\
+ \Macro{showISOenvelope}\Parameter{Format}\OParameter{Zusatz}\\
+ \Macro{showUScommercial}\Parameter{Format}\OParameter{Zusatz}\\
+ \Macro{showUScheck}\OParameter{Zusatz}\\
+ \Macro{unitfactor}
+\end{Declaration}
+\BeginIndex{Cmd}{showenvelope}%
+\BeginIndex{Cmd}{showISOenvelope}%
+\BeginIndex{Cmd}{showUScommercial}%
+\BeginIndex{Cmd}{showUScheck}%
+\BeginIndex{Cmd}{unitfactor}%
+Diese Anweisungen dienen dazu eine Seite mit einer Zeichnung eines Umschlags
+auszugeben. Der Umschlag wird dabei immer um 90° gedreht auf einer eigenen
+Seite im Maßstab~1:1 ausgegeben. Das Anschriftfenster wird automatisch aus den
+aktuellen Daten für die Anschriftposition auf dem Briefbogen,
+\PLength{toaddrvpos}, \PLength{toaddrheight}, \PLength{toaddrwidth} und
+\PLength{toaddrhpos}, erzeugt. Hierfür ist es notwendig zu wissen, um welchen
+Wert der gefaltete Briefbogen auf jeder Seite kleiner als die
+\PName{Breite} und \PName{Höhe} des Briefbogens ist. Sind diese beiden Werte,
+\PName{HOffset} und \PName{VOffset}, bei \Macro{showenvelope} nicht angegeben,
+so wird versucht, sie aus den Faltmarken und der Papiergröße selbst zu
+berechnen.
+
+Die übrigen Anweisungen basieren auf \Macro{showenvelope}. Mit
+\Macro{showISOenvelope} kann ein ISO-Umschlag im \PName{Format} C4, C5, C5/6,
+DL (auch bekannt als C5/6) oder C6 erzeugt werden. Mit
+\Macro{showUScommercial} wird hingegen ein US-Commercial-Umschlag im
+\PName{Format} 9 oder 10 ausgegeben. \Macro{showUScheck} schließlich ist für
+Umschläge im US-Check-Format zuständig.
+
+\BeginIndex{FontElement}{letter}%
+Innerhalb des Umschlags wird die Lage des Briefbogens gestrichtelt
+angedeutet. Die dabei verwendete Farbe kann mit Hilfe der Anweisungen
+\Macro{setkomafont} und \Macro{addtokomafont} (siehe
+\autoref{sec:scrlttr2.textmarkup},
+\autopageref{desc:scrlttr2.cmd.setkomafont}) für das Element
+\FontElement{letter} verändert werden. Voreingstellt ist \Macro{normalcolor}.%
+\EndIndex{FontElement}{letter}
+
+\BeginIndex{FontElement}{measure}%
+Die Umschlagzeichnung wird automatisch bemaßt. Die Farbe der Bemaßung und die
+Größe deren Beschriftung kann mit Hilfe der Anweisungen \Macro{setkomafont}
+und \Macro{addtokomafont} (siehe \autoref{sec:scrlttr2.textmarkup},
+\autopageref{desc:scrlttr2.cmd.setkomafont}) für das Element
+\FontElement{measure} verändert werden. Voreingstellt ist hier
+\Macro{normalcolor}. Die Bemaßung erfolgt in Vielfachen von
+\Length{unitlength} mit einer maximalen Genauigkeit von
+$1/\Macro{unitfactor}$, wobei die Genauigkeit der \TeX-Arithmetik die
+tatsächliche Grenze darstellt. Voreingestellt ist 1. Eine Umdefinierung ist
+mit \Macro{renewcommand} möglich.%
+\EndIndex{FontElement}{measure}
+
+\begin{Example}
+ Es wird ein Beispielbrief im Format ISO~A4 erzeugt. Die unterstützten Felder
+ sollen zwecks Überprüfung ihrer Position mit gelben Rahmenlinien markiert
+ werden. Desweiteren soll die Position des Fensters in einem Umschlag der
+ Größe~DL mit Hilfe einer Zeichnung überprüft werden. Die Maßlinien in dieser
+ Zeichnung sollen rot und die Maßzahlen in kleinerer Schrift ausgegeben
+ werden, wobei die Maßzahlen in cm mit einer Genauigkeit von 1\Unit{mm}
+ ausgegeben werden sollen. Der gestrichelte Briefbogen im Umschlag soll
+ hingegen grün eingefärbt werden.
+ \begin{lstcode}
+\documentclass[visualize]{scrlttr2}
+\usepackage{xcolor}
+\setkomafont{field}{\color{yellow}}
+\setkomafont{measure}{\color{red}\small}
+\setkomafont{letter}{\color{green}}
+\showfields{head,address,location,refline,foot}
+\usepackage[ngerman]{babel}
+\usepackage{lipsum}
+\begin{document}
+\setkomavar{fromname}{Peter Musterfrau}
+\setkomavar{fromaddress}{Hinter dem Tal 2\\
+ 54321 Musterheim}
+\begin{letter}{%
+ Petra Mustermann\\
+ Vor dem Berg 1\\
+ 12345 Musterhausen%
+ }
+\opening{Hallo,}
+\lipsum[1]
+\closing{Bis dann}
+\end{letter}
+\setlength{\unitlength}{1cm}
+\renewcommand*{\unitfactor}{10}
+\showISOenvelope{DL}
+\end{document}
+ \end{lstcode}
+ Auf der ersten Seite findet sich nun der Briefbogen, auf der zweiten Seite
+ wird die Zeichnung des Umschlags ausgegeben.
+\end{Example}
+
+Bezüglich der Bemaßung ist zu beachten, dass ungünstige Kombinationen von
+\Length{unitlength} und \Macro{unitfactor} sehr schnell einen \TeX-Fehler der
+Art \emph{arthmetic overflow} provozieren. Ebenso kann es geschehen, dass
+ausgegebene Maßzahlen geringfügig vom tatsächlichen Wert abweichen. Beides
+sind keine Fehler von \Option{visualize}, sondern lediglich
+Implementierungsgrenzen.
+%
+\EndIndex{Cmd}{unitfactor}%
+\EndIndex{Cmd}{showUScheck}
+\EndIndex{Cmd}{showUScommercial}
+\EndIndex{Cmd}{showISOenvelope}
+\EndIndex{Cmd}{showenvelope}
+%
+\EndIndex{Option}{visualize}%
%
\EndIndex{File}{lco}%
diff --git a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2.tex b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2.tex
index 348f42e0aeb..662a5a5d2d2 100644
--- a/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2.tex
+++ b/Master/texmf-dist/source/latex/koma-script/doc/ngerman/scrlttr2.tex
@@ -45,7 +45,7 @@
%
% ============================================================================
-\ProvidesFile{scrlttr2.tex}[2009/03/16 KOMA-Script guide (chapter: scrlttr2)]
+\ProvidesFile{scrlttr2.tex}[2009/06/12 KOMA-Script guide (chapter: scrlttr2)]
\chapter{Die neue Briefklasse \Class{scrlttr2}}
\labelbase{scrlttr2}
@@ -2578,16 +2578,17 @@ verwendet werden, die für Paketautoren freigegeben sind. Bei
\autoref{sec:scrlttr2-experts.pseudoLengths}).
\KOMAScript{} liegen bereits einige \File{lco}-Dateien bei. Die Dateien
-\File{DIN.lco}, \File{DINmtext.lco}, \File{SNleft.lco} und \File{SN.lco}
-dienen dazu, \Class{scrlttr2} an verschiedene Normen\Index{Norm}
-anzupassen. Sie können von angehenden Experten sehr gut als Vorlage für eigene
-Parametersätze verwendet werden. Die Datei \File{KOMAold.lco} dient hingegen
-dazu, die Kompatibilität zu \Class{scrlettr}, der alten Briefklasse, zu
-verbessern. Da hierbei auch auf Anweisungen zurückgegriffen wird, die nicht
-für Paketautoren freigegeben sind, sollte man sie nicht als Vorlage für eigene
-\File{lco}-Dateien verwenden. Eine Liste aller vordefinierten
-\File{lco}-Dateien ist in \autoref{tab:lcoFiles}, \autopageref{tab:lcoFiles}
-zu finden.
+\File{DIN.lco}, \File{DINmtext.lco}, \File{SNleft.lco}, \File{SN.lco},
+\File{NF.lco}\ChangedAt{v3.04}{\Class{scrlttr2}}, \File{UScommercial9} und
+\File{UScommercial9DW} dienen dazu, \Class{scrlttr2} an verschiedene
+Normen\Index{Norm} anzupassen. Sie können von angehenden Experten sehr gut als
+Vorlage für eigene Parametersätze verwendet werden. Die Datei
+\File{KOMAold.lco} dient hingegen dazu, die Kompatibilität zu
+\Class{scrlettr}, der alten Briefklasse, zu verbessern. Da hierbei auch auf
+Anweisungen zurückgegriffen wird, die nicht für Paketautoren freigegeben sind,
+sollte man sie nicht als Vorlage für eigene \File{lco}-Dateien verwenden. Eine
+Liste aller vordefinierten \File{lco}-Dateien ist in \autoref{tab:lcoFiles},
+\autopageref{tab:lcoFiles} zu finden.
Wenn Sie einen Parametersatz für eine Briefnorm, die bisher nicht von
\KOMAScript{} unterstützt wird, erstellt haben, so sind Sie ausdrücklich
@@ -2712,8 +2713,7 @@ kleineren Wert gesetzt wird. Verringern Sie dann außerdem
\standardfoot%
\oentry{DIN}{%
Parametersatz für Briefe im Format A4 nach DIN~676; geeignet für
- Fensterbriefumschläge in den Formaten C4, C5, C6 und C6/5 (C6 lang)%
- }%
+ Fensterbriefumschläge in den Formaten C4, C5, C6 und C6/5 (C6 lang)}%
\oentry{DINmtext}{%
Parametersatz für Briefe im Format A4 nach DIN~676, wobei die Alternative
für mehr Text auf der ersten Briefseite verwendet wird; nur geeignet für
@@ -2727,48 +2727,54 @@ kleineren Wert gesetzt wird. Verringern Sie dann außerdem
definiert; \Class{scrlttr2} verhält sich mit dieser \File{lco}-Datei
möglicherweise nicht genau wie bei Verwendung der übrigen
\File{lco}-Dateien}%
+ \oentry{NF}{%
+ Parametersatz für französische Briefe nach NF~Z~11-001; geeignet für
+ Fensterbriefumschläge im Format DL (110\Unit{mm} auf 220\Unit{mm}) mit
+ einem Fenster von 45\Unit{mm} Breite und 100\Unit{mm} Höhe ca. jeweils
+ 20\Unit{mm} entfernt vom rechten unteren Rand; diese Datei wurde
+ ursprünglich von Jean-Marie Pacquet entwickelt, der auf \cite{www:NF.lco}
+ neben einer Erweiterung auch eine LyX-Einbindung bereit stellt.}%
\oentry{NipponEL}{%
Parametersatz für japanische Briefe im Format A4; geeignet für japanische
Fensterbriefumschläge der Typen Chou oder You 3 oder 4, bei denen das
- Fenster in etwa 90\Unit{mm} breit, 45\Unit{mm} hoch, 22\Unit{mm}
- vom linken und 12\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch
+ Fenster in etwa 90\Unit{mm} breit, 45\Unit{mm} hoch, 22\Unit{mm} vom
+ linken und 12\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch
\iffree{den Anhang der englischen
\KOMAScript-Anleitung}{\autoref{cha:japanlco}})}%
\oentry{NipponEH}{%
Parametersatz für japanische Briefe im Format A4; geeignet für japanische
Fensterbriefumschläge der Typen Chou oder You 3 oder 4, bei denen das
- Fenster in etwa 90\Unit{mm} breit, 55\Unit{mm} hoch, 22\Unit{mm}
- vom linken und 12\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch
+ Fenster in etwa 90\Unit{mm} breit, 55\Unit{mm} hoch, 22\Unit{mm} vom
+ linken und 12\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch
\iffree{den Anhang der englischen
\KOMAScript-Anleitung}{\autoref{cha:japanlco}})}%
\oentry{NipponLL}{%
Parametersatz für japanische Briefe im Format A4; geeignet für japanische
Fensterbriefumschläge der Typen Chou oder You 3 oder 4, bei denen das
- Fenster in etwa 90\Unit{mm} breit, 45\Unit{mm} hoch, 25\Unit{mm}
- vom linken und 12\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch
+ Fenster in etwa 90\Unit{mm} breit, 45\Unit{mm} hoch, 25\Unit{mm} vom
+ linken und 12\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch
\iffree{den Anhang der englischen
\KOMAScript-Anleitung}{\autoref{cha:japanlco}})}%
\oentry{NipponLH}{%
Parametersatz für japanische Briefe im Format A4; geeignet für japanische
Fensterbriefumschläge der Typen Chou oder You 3 oder 4, bei denen das
- Fenster in etwa 90\Unit{mm} breit, 55\Unit{mm} hoch, 25\Unit{mm}
- vom linken und 12\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch
+ Fenster in etwa 90\Unit{mm} breit, 55\Unit{mm} hoch, 25\Unit{mm} vom
+ linken und 12\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch
\iffree{den Anhang der englischen
\KOMAScript-Anleitung}{\autoref{cha:japanlco}})}%
\oentry{NipponRL}{%
Parametersatz für japanische Briefe im Format A4; geeignet für japanische
Fensterbriefumschläge der Typen Chou oder You 3 oder 4, bei denen das
- Fenster in etwa 90\Unit{mm} breit, 45\Unit{mm} hoch, 22\Unit{mm}
- vom rechten und 28\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch
+ Fenster in etwa 90\Unit{mm} breit, 45\Unit{mm} hoch, 22\Unit{mm} vom
+ rechten und 28\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch
\iffree{den Anhang der englischen
\KOMAScript-Anleitung}{\autoref{cha:japanlco}})}%
\oentry{KakuLL}{%
Parametersatz für japanische Briefe im Format A4; geeignet für japanische
Fensterbriefumschläge des Typs Kaku A4, bei denen das Fenster in etwa
90\Unit{mm} breit, 45\Unit{mm} hoch, 25\Unit{mm} vom linken und
- 24\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch
- \iffree{den Anhang der englischen
- \KOMAScript-Anleitung}{\autoref{cha:japanlco}})}%
+ 24\Unit{mm} vom oberen Rand entfernt ist (siehe dazu auch \iffree{den
+ Anhang der englischen \KOMAScript-Anleitung}{\autoref{cha:japanlco}})}%
\oentry{SN}{%
Parametersatz für Schweizer Briefe nach SN~010\,130 mit Anschrift rechts;
geeignet für Schweizer Fensterbriefumschläge in den Formaten C4, C5, C6
@@ -2777,6 +2783,26 @@ kleineren Wert gesetzt wird. Verringern Sie dann außerdem
Parametersatz für Schweizer Briefe mit Anschrift links; geeignet für
Schweizer Fensterbriefumschläge mit dem Fenster links in den Formaten C4,
C5, C6 und C6/5 (C6 lang)}%
+ \oentry{UScommercial9}{%
+ Parametersatz für US-amerikanische Briefe im Format letter;
+ geeignet für US-amerikanische Fensterbriefumschläge der Größe
+ \emph{commercial~No.\,9} mit einem
+ Anschriftfenster der Breite 4\,1/2Unit{in} und Höhe 1\,1/8\Unit{in} an
+ einer Position 7/8\Unit{in} von links und 1/2\Unit{in} von unten ohne
+ Rücksendeadresse im Fenster; bei Faltung zunächst an der Mittelmarke und
+ dann an der oberen Faltmarke kann auch Papier im Format legal verwendet
+ werden, führt dann jedoch zu einer Papiergrößen-Warnung}%
+ \oentry{UScommercial9DW}{%
+ Parametersatz für US-amerikanische Briefe im Format letter;
+ geeignet für US-amerikanische Fensterbriefumschläge der Größe
+ \emph{commercial~No.\,9} mit einem
+ Anschriftfenster der Breite 3\,5/8Unit{in} und Höhe 1\,1/8\Unit{in} an
+ einer Position 3/4\Unit{in} von links und 1/2\Unit{in} von unten mit
+ einem Absenderfenster der Breite 3\,1/2\Unit{in} und Höhe 7/8\Unit{in} an
+ einer Position 5/16\Unit{in} von links und 2\,1/2\Unit{in} von unten,
+ jedoch ohne Rücksendeadresse im Fenster; bei Faltung zunächst an der
+ Mittelmarke und dann an der oberen Faltmarke kann auch Papier im Format
+ legal verwendet werden, führt dann jedoch zu einer Papiergrößen-Warnung}%
\end{desctable}
Die \File{lco}-Datei \File{DIN} wird übrigens immer als erste