% ======================================================================
% common-lists.tex
% Copyright (c) Markus Kohm, 2001-2017
%
% This file is part of the LaTeX2e KOMA-Script bundle.
%
% This work may be distributed and/or modified under the conditions of
% the LaTeX Project Public License, version 1.3c of the license.
% The latest version of this license is in
%   http://www.latex-project.org/lppl.txt
% and version 1.3c or later is part of all distributions of LaTeX 
% version 2005/12/01 or later and of this work.
%
% This work has the LPPL maintenance status "author-maintained".
%
% The Current Maintainer and author of this work is Markus Kohm.
%
% This work consists of all files listed in manifest.txt.
% ----------------------------------------------------------------------
% common-lists.tex
% Copyright (c) Markus Kohm, 2001-2017
%
% Dieses Werk darf nach den Bedingungen der LaTeX Project Public Lizenz,
% Version 1.3c, verteilt und/oder veraendert werden.
% Die neuste Version dieser Lizenz ist
%   http://www.latex-project.org/lppl.txt
% und Version 1.3c ist Teil aller Verteilungen von LaTeX
% Version 2005/12/01 oder spaeter und dieses Werks.
%
% Dieses Werk hat den LPPL-Verwaltungs-Status "author-maintained"
% (allein durch den Autor verwaltet).
%
% Der Aktuelle Verwalter und Autor dieses Werkes ist Markus Kohm.
% 
% Dieses Werk besteht aus den in manifest.txt aufgefuehrten Dateien.
% ======================================================================
%
% Paragraphs that are common for several chapters of the KOMA-Script guide
% Maintained by Markus Kohm
%
% ----------------------------------------------------------------------
%
% Absaetze, die mehreren Kapiteln der KOMA-Script-Anleitung gemeinsam sind
% Verwaltet von Markus Kohm
%
% ======================================================================

\KOMAProvidesFile{common-lists.tex}
                 [$Date: 2017-01-30 20:46:35 +0100 (Mon, 30 Jan 2017) $
                  KOMA-Script guide (common paragraphs)]
\translator{Gernot Hassenpflug\and Markus Kohm\and Krickette Murabayashi}

% Date of the translated German file: 2017-01-02

\section{Lists}
\seclabel{lists}%
\BeginIndexGroup
\BeginIndex{}{lists}%

\IfThisCommonFirstRun{}{%
  All of what is described in \autoref{sec:\ThisCommonFirstLabelBase.lists} is
  generally applicable. So if you have alread read and understood
  \autoref{sec:\ThisCommonFirstLabelBase.lists} you can switch to
  \autoref{sec:\ThisCommonLabelBase.lists.next},
  \autopageref{sec:\ThisCommonLabelBase.lists.next}.%
  \IfThisCommonLabelBase{scrextend}{ %
    However, \Package{scrextend} does support only the environments
    \DescRef{\ThisCommonLabelBase.env.labeling},
    \DescRef{\ThisCommonLabelBase.env.addmargin} and
    \DescRef{\ThisCommonLabelBase.env.addmargin*}. All the other list
    environments may be supported and controlled by the used class.%
  }{}%
}

Both {\LaTeX} and the standard classes offer different environments for
lists. Though slightly changed or extended all these list are of course
offered in {\KOMAScript} as well. In general, all lists\,---\,even of different
kind\,---\,can be nested up to four levels. From a typographical view,
anything more would make no sense, as more than three levels can no longer be
easily perceived. The recommended\textnote{Hint!} procedure in such a case is
to split the large list into several smaller ones.

\IfThisCommonFirstRun{}{%
  Because lists are standard elements of \LaTeX{} this section abandons on
  examples. Nevertheless, you may find examples either in
  \autoref{sec:\ThisCommonFirstLabelBase.lists} from
  \autopageref{sec:\ThisCommonFirstLabelBase.lists} or in almost every
  introduction to \LaTeX.%
}

\IfThisCommonLabelBase{scrextend}{\iffalse}{\csname iftrue\endcsname}
  \begin{Declaration}
    \begin{Environment}{itemize}\labelsuffix[itemize]
      \begin{Body}
        \Macro{item} \dots
        \BodyDots
      \end{Body}
    \end{Environment}
    \Macro{labelitemi}%
    \Macro{labelitemii}%
    \Macro{labelitemiii}%
    \Macro{labelitemiv}
  \end{Declaration}%
  The simplest form of a list is an \Environment{itemize} list.
  \iffalse % Umbruckoptimierungstext
    The users of a certain disliked word processing package often refer to
    this form of a list as \emph{bulletpoints}.  Presumably, these users
    are unable to envisage that, depending on the level, a different
    symbol from a large dot could be used to introduce each
    point. %
  \fi%
  Depending on the level, {\KOMAScript} uses the following marks:
  ``{\labelitemi}'', ``{\labelitemii}'', ``{\labelitemiii}'' and
  ``{\labelitemiv}''. The definition of these symbols is specified in
  the macros \Macro{labelitemi}, \Macro{labelitemii},
  \Macro{labelitemiii} and \Macro{labelitemiv}, all of which can be
  redefined using \Macro{renewcommand}. Every item is introduced with
  \Macro{item}.%
  \IfThisCommonFirstRun{\iftrue}{\csname iffalse\endcsname}
    \begin{Example}
      \phantomsection\xmpllabel{env.itemize}%
      You have a simple list which is nested in several levels. You write
      for example:
\begin{lstcode}
  \minisec{Vehicles}
  \begin{itemize}
    \item aeroplanes
    \begin{itemize}
      \item biplane
      \item jets
      \item transport planes
      \begin{itemize}
        \item single-engined
        \begin{itemize}
          \item jet-driven
          \item propeller-driven
        \end{itemize}
        \item multi-engined
      \end{itemize}
      \item helicopters
    \end{itemize}
    \item automobiles
    \begin{itemize}
      \item racing cars
      \item private cars
      \item lorries
    \end{itemize}
    \item bicycles
  \end{itemize}
\end{lstcode}
      As output you get:
      \begin{ShowOutput}[\baselineskip]
        \minisec{Vehicles}
        \begin{itemize}
        \item aeroplanes
          \begin{itemize}
          \item biplanes
          \item jets
          \item transport planes
            \begin{itemize}
            \item single-engined
              \begin{itemize}
              \item jet-driven
              \item propeller-driven
              \end{itemize}
            \item multi-engined
            \end{itemize}
          \item helicopters
          \end{itemize}
% Falls fuer die Umbruchoptimierung erforderlich, kann die Liste
% beispielsweise so erweitert werden:
%    \item motorcycles
%    \begin{itemize}
%      \item historically accurate
%      \item futuristic, not real
%    \end{itemize}
        \item automobiles
          \begin{itemize}
          \item racing cars
          \item private cars
          \item lorries
          \end{itemize}
        \item bicycles
        \end{itemize}
      \end{ShowOutput}
    \end{Example}
  \fi
  % 
  \EndIndexGroup


  \begin{Declaration}
    \begin{Environment}{enumerate}\labelsuffix[enumerate]
      \begin{Body}
        \Macro{item} \dots
        \BodyDots
      \end{Body}
    \end{Environment}
    \Macro{theenumi}%
    \Macro{theenumii}%
    \Macro{theenumiii}%
    \Macro{theenumiv}%
    \Macro{labelenumi}%
    \Macro{labelenumii}%
    \Macro{labelenumiii}%
    \Macro{labelenumiv}
  \end{Declaration}%
  Another form of a list often used is a numbered list which is already
  implemented by the {\LaTeX} kernel. Depending on the level, the
  numbering\Index{numbering} uses the following characters: Arabic numbers,
  small letters, small roman numerals, and capital letters. The kind of
  numbering is defined with the macros \Macro{theenumi} down to
  \Macro{theenumiv}. The output format is determined by the macros
  \Macro{labelenumi} to \Macro{labelenumiv}. While the small letter of the
  second level is followed by a round parenthesis, the values of all other
  levels are followed by a dot. Every item is introduced with \Macro{item}.%
  \IfThisCommonFirstRun{\iftrue}{\csname iffalse\endcsname}
    \begin{Example}
      \phantomsection\xmpllabel{env.enumerate}%
      Replacing every occurrence of an
      \DescRef{\ThisCommonLabelBase.env.itemize} environment with an
      \Environment{enumerate} environment in the example above we
      get the following result:
      \begin{ShowOutput}[\baselineskip]
        \minisec{Vehicles}
        \begin{enumerate}
        \item aeroplanes
          \begin{enumerate}
          \item biplanes
          \item jets
          \item transport planes
            \begin{enumerate}
            \item single-engined
              \begin{enumerate}
              \item jet-driven\label{xmp:maincls.jets}
              \item propeller-driven
              \end{enumerate}
            \item multi-engined
            \end{enumerate}
          \item helicopters
          \end{enumerate}
          % Wie oben:
          % \item motorcycles
          %   \begin{enumerate}
          %   \item historically accurate
          %   \item futuristic, not real
          %   \end{enumerate}
        \item automobiles
          \begin{enumerate}
          \item racing cars
          \item private cars
          \item lorries
          \end{enumerate}
        \item bicycles
        \end{enumerate}
      \end{ShowOutput}
      Using \Macro{label} within a list you can set labels which are
      referenced with \Macro{ref}. In the example above, a label was set
      after the jet-driven, single-engined transport planes with
      \Macro{label}\PParameter{xmp:jets}. The \Macro{ref} value is then
      \ref{xmp:maincls.jets}.
    \end{Example}
  \fi%
  % 
  \EndIndexGroup


  \begin{Declaration}
    \begin{Environment}{description}\labelsuffix[description]
      \begin{Body}
        \Macro{item}\OParameter{keyword} \dots
        \BodyDots
      \end{Body}
    \end{Environment}
  \end{Declaration}%
  A further list form is the description list. Its main use is the description
  of several items. The item itself is an optional parameter in
  \Macro{item}. %
  \BeginIndex{FontElement}{descriptionlabel}%
  \LabelFontElement{descriptionlabel}%
  The font\Index{font>style}\ChangedAt{v2.8p}{%
    \Class{scrbook}\and \Class{scrreprt}\and \Class{scrartcl}}%
  which is responsible for emphasizing the item can be changed with the
  commands \DescRef{\ThisCommonLabelBase.cmd.setkomafont} and
  \DescRef{\ThisCommonLabelBase.cmd.addtokomafont} (see
  \autoref{sec:\ThisCommonLabelBase.textmarkup},
  \DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}) for the element
  \FontElement{descriptionlabel} (see
  \autoref{tab:\ThisCommonLabelBase.fontelements},
  \autopageref{tab:\ThisCommonLabelBase.fontelements}). Default setting is
  \Macro{sffamily}\linebreak[1]\Macro{bfseries}.%
  \IfThisCommonFirstRun{\iftrue}{\csname iffalse\endcsname}
    \begin{Example}
      \phantomsection\xmpllabel{env.description}%
      Instead of items in sans serif and bold, you want them printed in the
      standard font in bold. Using
\begin{lstcode}
  \setkomafont{descriptionlabel}{\normalfont\bfseries}
\end{lstcode}
      you redefine the font accordingly.

      An example for a description list is the output of the page styles
      listed in \autoref{sec:maincls.pagestyle}. The heavily
      abbreviated source could be:
\begin{lstcode}
  \begin{description}
  \item[empty] is the page style without any header or footer.
    \item[plain] is the page style without headings.
    \item[headings] is the page style with running headings.
    \item[myheadings] is the page style for manual headings.
  \end{description}
\end{lstcode}
      This abbreviated version gives:
      \begin{ShowOutput}
        \begin{description}
        \item[empty] is the page style without any header or footer.
        \item[plain] is the page style without headings.
        \item[headings] is the page style with running headings.
        \item[myheadings] is the page style for manual headings.
        \end{description}
      \end{ShowOutput}
    \end{Example}
  \fi%
  % 
  \EndIndexGroup%
\fi

\begin{Declaration}
  \begin{Environment}{labeling}
                     \OParameter{delimiter}\Parameter{widest pattern}
    \labelsuffix[labeling]
    \begin{Body}
      \Macro{item}\OParameter{keyword}\dots
      \BodyDots
    \end{Body}
  \end{Environment}
\end{Declaration}%
An additional form of a description list is only available in the
{\KOMAScript} classes%
\IfThisCommonLabelBase{scrextend}{ and the package \Package{scrextend}}{}: the
\Environment{labeling} environment. Unlike the %
\IfThisCommonLabelBase{scrextend}{%
  \DescRef{\ThisCommonFirstLabelBase.env.description}%
}{%
  \DescRef{\ThisCommonLabelBase.env.description}%
} environment, you can provide a
pattern whose length determines the indentation of all items. Furthermore, you
can put an optional \PName{delimiter} between the item and its description.
\BeginIndex{FontElement}{labelinglabel}\LabelFontElement{labelinglabel}%
\BeginIndex{FontElement}{labelingseparator}%
\LabelFontElement{labelingseparator}%
The font\Index{font>style}%
\IfThisCommonLabelBase{maincls}{%
  \ChangedAt{v3.02}{\Class{scrbook}\and \Class{scrreprt}\and
    \Class{scrartcl}}%
}{%
  \IfThisCommonLabelBase{scrlttr2}{%
    \ChangedAt{v3.02}{\Class{scrlttr2}}%
  }{%
    \IfThisCommonLabelBase{scrextend}{%
      \ChangedAt{v3.02}{\Package{scrextend}}%
    }{\InternalCommonFileUsageError}%
  }%
}%
which is responsible for emphasizing the item and the separator can be changed
with the commands \DescRef{\ThisCommonLabelBase.cmd.setkomafont} and
\DescRef{\ThisCommonLabelBase.cmd.addtokomafont} (see
\autoref{sec:\ThisCommonLabelBase.textmarkup},
\DescPageRef{\ThisCommonLabelBase.cmd.setkomafont}) for the element
\FontElement{labelinglabel} and \FontElement{labelingseparator} (see
\autoref{tab:\ThisCommonLabelBase.fontelements},
\autopageref{tab:\ThisCommonLabelBase.fontelements}).
\IfThisCommonFirstRun{\iftrue}{\par\csname iffalse\endcsname}
  \begin{Example}
    \phantomsection\xmpllabel{env.labeling}%
    \IfThisCommonLabelBase{scrextend}{%
      A small example of a list like this may be written:%
    }{%
      Slightly changing the example from the
      \DescRef{\ThisCommonLabelBase.env.description} environment, we could
      write:%
    }%
\begin{lstcode}
  \setkomafont{labelinglabel}{\ttfamily}
  \setkomafont{labelingseparator}{\normalfont}
  \begin{labeling}[~--]{myheadings}
    \item[empty]
      Page style without header and footer
    \item[plain]
      Page style for chapter beginnings without headings
    \item[headings]
      Page style for running headings
    \item[myheadings]
      Page style for manual headings
  \end{labeling}
\end{lstcode}
    As the result we get:
    \begin{ShowOutput}
      \setkomafont{labelinglabel}{\ttfamily}
      \setkomafont{labelingseparator}{\normalfont}
      \begin{labeling}[~--]{myheadings}
      \item[empty]
        Page style without header and footer
      \item[plain]
        Page style for chapter beginnings without headings
      \item[headings]
        Page style for running headings
      \item[myheadings]
        Page style for manual headings
      \end{labeling}
    \end{ShowOutput}
    As can be seen in this example, a font changing command may be set
    in the usual way. But if you do not want the font of the separator to
    be changed in the same way as the font of the label, you have to set
    the font of the separator as well.
  \end{Example}
\fi%
Originally, this environment was implemented for things like ``Precondition,
Assertion, Proof'', or ``Given, Required, Solution'' that are often used in
lecture hand-outs.  By now this environment has found many different
applications. For example, the environment for examples in this guide was
defined with the \Environment{labeling} environment.%
%
\EndIndexGroup


\IfThisCommonLabelBase{scrextend}{\iffalse}{\csname iftrue\endcsname}
  \begin{Declaration}
    \begin{Environment}{verse}\end{Environment}
  \end{Declaration}%
  Usually the \Environment{verse} environment is not perceived as a list
  environment because you do not work with \Macro{item} commands. Instead,
  fixed line breaks are used within the \Environment{flushleft}
  environment. Yet internally in both the standard classes as well as
  {\KOMAScript} it is indeed a list environment.

  In general, the \Environment{verse} environment is used for
  poems\Index{poems}.  Lines are indented both left and right. Individual
  lines of verse are ended by a fixed line break \verb|\\|. Verses are set as
  paragraphs, separated by an empty line. Often also
  \Macro{medskip}\IndexCmd{medskip} or \Macro{bigskip}\IndexCmd{bigskip} is
  used instead. To avoid a page break at the end of a line of verse you could,
  as usual, insert \verb|\\*| instead of \verb|\\|.
  \IfThisCommonFirstRun{\iftrue}{\csname iffalse\endcsname}
    \begin{Example}
      \phantomsection\xmpllabel{env.verse}%
\iffalse
      As an example, the first lines of ``Little Red Riding Hood and the
      Wolf'' by Roald Dahl:
\begin{lstcode}
  \begin{verse}
    As soon as Wolf began to feel\\*
    that he would like a decent meal,\\*
    He went and knocked on Grandma's door.\\*
    When Grandma opened it, she saw\\*
    The sharp white teeth, the horrid grin,\\*
    And Wolfie said, `May I come in?'
  \end{verse}
\end{lstcode}
      The result is as follows:
      \begin{ShowOutput}
        \begin{verse}
          As soon as Wolf began to feel\\*
          That he would like a decent meal,\\*
          He went and knocked on Grandma's door.\\*
          When Grandma opened it, she saw\\*
          The sharp white teeth, the horrid grin,\\*
          And Wolfie said, `May I come in?'
        \end{verse}
      \end{ShowOutput}
\else
      As an example, the sonnet of Emma Lazarus from the pedestal of Liberty
      Enlightening the World\footnote{The lines from Roald Dahl's poem
        ``Little Red Riding Hood and the Wolf'', that has been used in former
        releases, has been replaced, because in these times several
        politicians all over the world really seem to need ``The New
        Colossus'' as urgent reminder.}:
\begin{lstcode}
  \begin{verse}
    Not like the brazen giant of Greek fame\\*
    With conquering limbs astride from land to land\\*
    Here at our sea-washed, sunset gates shall stand\\*
    A mighty woman with a torch, whose flame\\*
    Is the imprisoned lightning, and her name\\*
    Mother of Exiles. From her beacon-hand\\*
    Glows world-wide welcome; her mild eyes command\\*
    The air-bridged harbor that twin cities frame.\\*
    ``Keep, ancient lands, your storied pomp!'' cries she\\*
    With silent lips. ``Give me your tired, your poor,\\*
    Your huddled masses yearning to breathe free,\\*
    The wretched refuse of your teeming shore.\\*
    Send these, the homeless, tempest-tossed to me:\\*
    I lift my lamp beside the golden door.''
  \end{verse}
\end{lstcode}
      The result is as follows:
      \begin{ShowOutput}
        \begin{verse}
          Not like the brazen giant of Greek fame\\*
          With conquering limbs astride from land to land\\*
          Here at our sea-washed, sunset gates shall stand\\*
          A mighty woman with a torch, whose flame\\*
          Is the imprisoned lightning, and her name\\*
          Mother of Exiles. From her beacon-hand\\*
          Glows world-wide welcome; her mild eyes command\\*
          The air-bridged harbor that twin cities frame.\\*
          ``Keep, ancient lands, your storied pomp!'' cries she\\*
          With silent lips. ``Give me your tired, your poor,\\*
          Your huddled masses yearning to breathe free,\\*
          The wretched refuse of your teeming shore.\\*
          Send these, the homeless, tempest-tossed to me:\\*
          I lift my lamp beside the golden door.''
        \end{verse}
      \end{ShowOutput}
\fi
      However, if you have very long lines of verse, for instance:
\begin{lstcode}
  \begin{verse}
    Both the philosopher and the house-owner
    have always something to repair.\\
    \bigskip
    Don't trust a man, my son, who tells you
    that he has never lied.
  \end{verse}
\end{lstcode}
      where a line break occurs within a line of verse:
      \begin{ShowOutput}
        \begin{verse}
          Both the philosopher and the house-owner
          have always something to repair.\\
          \bigskip
          Don't trust a man, my son, who tells you
          that he has never lied.
        \end{verse}
      \end{ShowOutput}
      there \verb|\\*| can not prevent a page break occurring within a verse
      at such a line break. To prevent such a page break, a
      \Macro{nopagebreak}\IndexCmd{nopagebreak} would have to be inserted
      somewhere in the first line:
\begin{lstcode}
  \begin{verse}
    Both the philosopher and the house-owner\nopagebreak
    have always something to repair.\\
    \bigskip
    Don't trust a man, my son, who tells you\nopagebreak
    that he has never lied.
  \end{verse}
\end{lstcode}

      In the above example, \Macro{bigskip} was used to separate the lines of
      verse.
    \end{Example}
  \fi % \ifCommonmaincls
  % 
  \EndIndexGroup

  \begin{Declaration}
    \begin{Environment}{quote}\end{Environment}
    \begin{Environment}{quotation}\end{Environment}
  \end{Declaration}%
  These two environments are also list environments and can be found both in
  the standard and the {\KOMAScript} classes. Both environments use justified
  text which is indented both on the left and right side.  Usually they are
  used to separate long citations\Index{citations} from the main text. The
  difference between these two lies in the manner in which paragraphs are
  typeset. While \Environment{quote} paragraphs are highlighted by vertical
  space, in \Environment{quotation} paragraphs the first line is
  indented. This is also true for the first line of a \Environment{quotation}
  environment. To prevent indentation you have to insert a \Macro{noindent}
  command\IndexCmd{noindent} before the text.
  \IfThisCommonFirstRun{\iftrue}{\csname iffalse\endcsname}
    \begin{Example}
      \phantomsection\xmpllabel{env.quote}%
      You want to highlight a short anecdote. You write the following
      \Environment{quotation} environment for this:% 
\begin{lstcode}
  A small example for a short anecdote:
  \begin{quotation}
    The old year was turning brown; the West Wind was
    calling;
        
    Tom caught the beechen leaf in the forest falling.
    ``I've caught the happy day blown me by the breezes!
    Why wait till morrow-year? I'll take it when me pleases.
    This I'll mend my boat and journey as it chances
    west down the withy-stream, following my fancies!''
    
    Little Bird sat on twig. ``Whillo, Tom! I heed you.
    I've a guess, I've a guess where your fancies lead you.
    Shall I go, shall I go, bring him word to meet you?''
  \end{quotation}
\end{lstcode}
      The result is:
      \begin{ShowOutput}
        A small example for a short anecdote:
        \begin{quotation}
          The old year was turning brown; the West Wind was
          calling;
    
          Tom caught the beechen leaf in the forest falling.
          ``I've caught the happy day blown me by the breezes!
          Why wait till morrow-year? I'll take it when me pleases.
          This I'll mend my boat and journey as it chances
          west down the withy-stream, following my fancies!''
    
          Little Bird sat on twig. ``Whillo, Tom! I heed you.
          I've a guess, I've a guess where your fancies lead you.
          Shall I go, shall I go, bring him word to meet you?''
        \end{quotation}
      \end{ShowOutput}
      % 
      Using a \Environment{quote} environment instead you get:
      % 
      \begin{ShowOutput}
        A small example for a short anecdote:
        \begin{quote}\setlength{\parskip}{4pt plus 2pt minus 2pt}
          The old year was turning brown; the West Wind was
          calling;

          Tom caught the beechen leaf in the forest falling.
          ``I've caught the happy day blown me by the breezes!
          Why wait till morrow-year? I'll take it when me pleases.
          This I'll mend my boat and journey as it chances
          west down the withy-stream, following my fancies!''
          
          Little Bird sat on twig. ``Whillo, Tom! I heed you.
          I've a guess, I've a guess where your fancies lead you.
          Shall I go, shall I go, bring him word to meet you?''
        \end{quote}
      \end{ShowOutput}
      % 
    \end{Example}
  \fi
  % 
  \EndIndexGroup
\fi

\begin{Declaration}
  \begin{Environment}{addmargin}
                     \OParameter{left indentation}\Parameter{indentation}
  \end{Environment}
  \begin{Environment}{addmargin*}
                     \OParameter{inner indentation}\Parameter{indentation}
  \end{Environment}
\end{Declaration}
Similar to %
\IfThisCommonLabelBase{scrextend}{%
  \DescRef{\ThisCommonFirstLabelBase.env.quote} and
  \DescRef{\ThisCommonFirstLabelBase.env.quotation} which are available at the
  standard classes and also the \KOMAScript{} classes%
}{%
  \DescRef{\ThisCommonLabelBase.env.quote} and
  \DescRef{\ThisCommonLabelBase.env.quotation}%
} %
the \Environment{addmargin} environment changes the margin\Index{margin}.  In
contrast to the first two environments, with \Environment{addmargin} the user
can set the width of the indentation. Besides this, this environment does not
change the indentation of the first line nor the vertical spacing between
paragraphs.

If only the obligatory argument \PName{indentation} is given, both the
left and right margin are expanded by this value. If the optional
argument \PName{left indentation} is given as well, then at the left
margin the value \PName{left indentation} is used instead of
\PName{indentation}.

The starred \Environment{addmargin*} only differs from the normal
version in a two-sided layout. Furthermore, the difference only occurs
if the optional argument \PName{inner indentation} is used. In this
case this value \PName{inner indentation} is added to the normal inner
indentation. For right-hand pages this is the left margin, for
left-hand pages the right margin. Then the value of
\PName{indentation} determines the width of the opposite margin.

Both versions of this environment take also negative values for all
parameters. This has the effect of expanding the environment into the
margin.
\IfThisCommonFirstRun{\iftrue}{\csname iffalse\endcsname}
  \begin{Example}
    \phantomsection\xmpllabel{env.addmargin}%
\begin{lstcode}
  \newenvironment{SourceCodeFrame}{%
    \begin{addmargin*}[1em]{-1em}%
      \begin{minipage}{\linewidth}%
        \rule{\linewidth}{2pt}%
  }{%
      \rule[.25\baselineskip]{\linewidth}{2pt}%
      \end{minipage}%
    \end{addmargin*}%
  }
\end{lstcode}
    If you now put your source code in such an environment it will show
    up as:
    \begin{ShowOutput}
      \newenvironment{SourceCodeFrame}{%
        \begin{addmargin*}[1em]{-1em}%
          \begin{minipage}{\linewidth}%
            \rule{\linewidth}{2pt}%
          }{%
            \rule[.25\baselineskip]{\linewidth}{2pt}%
          \end{minipage}%
        \end{addmargin*}%
      }
      You define yourself the following environment:
      \begin{SourceCodeFrame}
\begin{lstcode}
\newenvironment{\SourceCodeFrame}{%
  \begin{addmargin*}[1em]{-1em}%
    \begin{minipage}{\linewidth}%
      \rule{\linewidth}{2pt}%
}{%
    \rule[.25\baselineskip]{\linewidth}{2pt}%
    \end{minipage}%
  \end{addmargin*}%
}
\end{lstcode}
      \end{SourceCodeFrame}
      This may be feasible or not. In any case it shows the usage of this
      environment.
    \end{ShowOutput}
    The optional argument of the \Environment{addmargin*} environment
    makes sure that the inner margin is extended by 1\Unit{em}. In turn
    the outer margin is decreased by 1\Unit{em}. The result is a shift
    by 1\Unit{em} to the outside.  Instead of \PValue{1em} you can of
    course use a length, for example, \PValue{2\Macro{parindent}}.
  \end{Example}
\fi%

Whether a page is going to be on the left or right side of the book can not be
determined for certain in the first {\LaTeX} run.  For details please refer to
the explanation of the commands
\DescRef{\ThisCommonLabelBase.cmd.ifthispageodd}
(\autoref{sec:\ThisCommonLabelBase.oddOrEven},
\DescPageRef{\ThisCommonLabelBase.cmd.ifthispageodd}) and
\iffree{\Macro{ifthispagewasodd}}{%
  \DescRef{\ThisCommonLabelBase.cmd.ifthispagewasodd}}
(\autoref{sec:maincls-experts.addInfos},
\DescPageRef{maincls-experts.cmd.ifthispageodd}).

\begin{Explain}
  There may be several questions about coexistence of lists and
  paragraphs. Because of this additional information may be found at the
  description of option \Option{parskip} in
  \autoref{sec:maincls-experts.addInfos},
  \DescPageRef{maincls-experts.option.parskip}. Also at the expert part,
  in \autoref{sec:maincls-experts.addInfos},
  \DescPageRef{maincls-experts.env.addmargin*}, you may find additional
  information about page breaks inside of \Environment{addmargin*}.%
\end{Explain}%
%
\EndIndexGroup
%
\EndIndexGroup

%%% Local Variables:
%%% mode: latex
%%% coding: us-ascii
%%% TeX-master: "../guide"
%%% End:
