path: root/Master/texmf-dist/source/latex/limap/limap.dtx

%%^^A%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%\iffalse
%% Purpose:
%%      A package for typesetting Information Maps.
%%
%% Documentation:
%%      The documentation  can be generated  from  the  original  file
%%      limap.dtx with the doc class/package. LaTeX the file limap.tex
%%      to get the full documentation in pdf format.
%%
%% Author: Gerd Neugebauer
%%         Im Lerchelsb\"ohl 5
%%         64521 Gro\ss-Gerau (Germany)
%% Mail:   gene@gerd-neugebauer.de
%%
%% Copyright (C) 1999-2017 Gerd Neugebauer
%%
%% limap.dtx may be  distributed under the terms of  the LaTeX Project
%% Public License version  1.3c, as described in lppl.txt.
%%
%% This class is still under development and  may be replaced with a
%% new version which provides an enhanced functionality.
%%
%\fi
%^^A%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% \title{\texttt{limap}: A \LaTeX\ Package and Class for Typesetting Information Maps} 
% \author{Gerd Neugebauer\\\normalsize
%	  Net: \texttt{\href{mailto:gene@gerd-neugebauer.de}{gene@gerd-neugebauer.de}}}
% \hypersetup{
%  pdftitle    = {limap},
%  pdfsubject  = {A LaTeX Package for Typesetting Information Maps},
%  pdfauthor   = {Gerd Neugebauer},
% }
%
% \date{This file documents \filename\ version \fileversion\ as of
% \filedate.\\ Documentation date: \docdate}
%
% \maketitle
%
%^^A%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% \changes{1.0}{2000/03/01}{First public release.}
% \changes{2.0}{2016/04/16}{Fix in |MapTableofContents|: Trailing percent made unnecessary}
% \changes{2.0}{2016/04/16}{Extensions integrated into the package.
%                           Documentation improved.}
% \changes{2.0}{2016/04/14}{Renamed |MapTOCemph| to |MapTOCheadfont|.}
% \changes{2.0}{2016/04/15}{Renamed |MapTitleSize| to |MapTitleFont|.}
% \changes{2.0}{2016/04/16}{Renamed |MapTitlefraction| to |MapTitleFraction|.}
% \changes{2.0}{2016/04/16}{Environment |MapTabular| added}
% \changes{2.0}{2016/04/16}{Renamed |MapTextfraction| to |MapTextFraction|.}
% \changes{2.0}{2016/04/16}{Parameter |MapBlockLabelFont| introduced.}
% \changes{2.0}{2016/04/16}{Parameter |MapBlockLabelFont| introduced.}
% \changes{2.0}{2016/04/17}{Renamed |MapTitleContinuedSize| to |MapTitleContinuedFont|.} 
% \changes{2.0}{2016/05/22}{TOC Re-engineered to allow
%        interaction with hyperref.}
% \changes{2.0}{2016/05/22}{Option |nolines| added.}
% \changes{2.1}{2016/05/24}{|WideBlock| fixed and samples added.}
% \changes{2.1}{2016/05/26}{|MapTabularFraction| added.}
%^^A%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
% \DoNotIndex{\ ,\",\',\.,\[,\\,\],\^,\`,\~,\@,\@author,\@auxout}
% \DoNotIndex{\@currentlabel,\@currenvir,\@date}
% \DoNotIndex{\@dottedtocline,\@gobble,\@gobbletwo,\@highpenalty}
% \DoNotIndex{\@ifnextchar,\@ifstar,\@ifundefined}
% \DoNotIndex{\@namedef,\@nameuse,\@pnumwidth,\@startsection,\@starttoc}
% \DoNotIndex{\@tempdima,\@title,\@thefnmark,\@undefined}
% \DoNotIndex{\@ixpt,\@vpt,\@vipt,\@viipt,\@viiipt}
% \DoNotIndex{\@xpt,\@xipt,\@xiipt,\@xivpt,\@xvii,\@xxpt,\@xxvpt}
% \DoNotIndex{\AA,\AE,\CodelineIndex,\CurrentOption}
% \DoNotIndex{\DescribeEnv,\DescribeMacro,\DeclareOption,\DeleteShortVerb,\DocInput}
% \DoNotIndex{\EnableCrossrefs,\H,\InputIfFileExists}
% \DoNotIndex{\L,\LARGE,\LaTeX,\Large}
% \DoNotIndex{\LoadClass,\NeedsTeXFormat,\O,\OE,\OptionNotUsed}
% \DoNotIndex{\PackageError,\PackageWarning,\PassOptionsToClass}
% \DoNotIndex{\ProcessOptions,\ProvidesClass,\PrintDescribeEnv,\PrintDescribeMacro}
% \DoNotIndex{\PrintChanges,\PrintIndex}
% \DoNotIndex{\ProvidesPackage,\R,\RecordChanges,\RequirePackage,\TeX}
% \DoNotIndex{\SpecialEnvIndex,\SpecialUsageIndex}
% \DoNotIndex{\aa,\addcontentsline,\addpenalty,\addtolength,\advance}
% \DoNotIndex{\addvspace,\ae,\ast,\arabic}
% \DoNotIndex{\b,\baselineskip,\begin,\begingroup,\bfseries,\bgroup}
% \DoNotIndex{\bigskip,\bottomrule,\box,\bullet}
% \DoNotIndex{\c,\cal,\catcode,\centering,\chapter,\chardef,\circ}
% \DoNotIndex{\cfoot,\clearpage,\closein,\closeout}
% \DoNotIndex{\clubpenalty,\color,\csname}
% \DoNotIndex{\d,\def,\dimen,\diamond,\divide,\documentclass,\dots,\dp}
% \DoNotIndex{\definecolor}
% \DoNotIndex{\edef,\egroup,\else,\em,\emph,\empty,\end,\endcsname}
% \DoNotIndex{\endgroup,\endinput,\endlist}
% \DoNotIndex{\expandafter,\fbox,\fi,\footnotesize,\footskip,\framebox}
% \DoNotIndex{\frenchspacing,\futurelet,\gdef,\global,\gobble}
% \DoNotIndex{\hangafter,\hangindent,\hbox,\headheight,\headsep,\hfil}
% \DoNotIndex{\hfill,\hrule,\hskip,\hspace,\hss,\ht,\huge,\hypersetup}
% \DoNotIndex{\ifcat,\ifeof}
% \DoNotIndex{\ifdim,\ifnum,\iftrue,\ifx,\ignorespaces,\immediate,\index}
% \DoNotIndex{\input,\it}
% \DoNotIndex{\itemindent,\itemsep,\jobname,\kern,\l,\labelsep,\labelwidth}
% \DoNotIndex{\large,\leavevmode,\leftmark,\leftskip,\let,\lhead,\list}
% \DoNotIndex{\llap,\long,\lower}
% \DoNotIndex{\makeatletter,\makeatother}
% \DoNotIndex{\m@th,\makebox,\magstep,\makeindex,\markboth,\mbox,\medskip}
% \DoNotIndex{\marginpar,\midrule,\multicolumn}
% \DoNotIndex{\newblock,\newcommand,\newcount,\newenvironment,\newfont}
% \DoNotIndex{\newif,\newlength,\newline,\newpage,\newread,\newwrite}
% \DoNotIndex{\nobreak,\noindent,\normalsize,\null}
% \DoNotIndex{\o,\oddsidemargin,\oe,\openin,\openout,\or}
% \DoNotIndex{\pagestyle,\par,\paragraph,\parbox}
% \DoNotIndex{\parfillskip,\parindent,\parsep,\parskip,\part,\partopsep}
% \DoNotIndex{\penalty,\providecommand,\quad}
% \DoNotIndex{\raggedbottom,\raggedright,\raise,\raisebox,\refstepcounter}
% \DoNotIndex{\relax,\renewcommand,\renewenvironment,\rhead}
% \DoNotIndex{\rightskip,\rm,\rule}
% \DoNotIndex{\sbox,\sc,\section,\setcounter,\setlength,\settowidth}
% \DoNotIndex{\sf,\sfcode,\sl}
% \DoNotIndex{\sloppy,\small,\space,\ss,\string}
% \DoNotIndex{\setsansfont,\setmonofont,\setmainfont}
% \DoNotIndex{\subparagraph,\subsubparagraph}
% \DoNotIndex{\subsection,\subsubsection,\symbol}
% \DoNotIndex{\t,\tenex,\textheight,\textit,\textsf,\textstyle,\textwidth}
% \DoNotIndex{\textrm,\the,\thepage,\thispagestyle,\textregistered}
% \DoNotIndex{\topmargin,\toprule,\topsep,\tt,\typeout}
% \DoNotIndex{\u,\unitlength,\usecounter,\usepackage,\usetikzlibrary}
% \DoNotIndex{\v,\varepsilon,\vbox}
% \DoNotIndex{\vfill,\vsize,\voffset,\vskip,\vspace,\vss}
% \DoNotIndex{\wd,\widowpenalty,\write,\xdef,\z@,\(,\)}
%
%^^A%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%    \CheckSum{813}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%%  \CharacterTable
%%  {Upper-case    \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
%%   Lower-case    \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
%%   Digits        \0\1\2\3\4\5\6\7\8\9
%%   Exclamation   \!     Double quote  \"     Hash (number) \#
%%   Dollar        \$     Percent       \%     Ampersand     \&
%%   Acute accent  \'     Left paren    \(     Right paren   \)
%%   Asterisk      \*     Plus          \+     Comma         \,
%%   Minus         \-     Point         \.     Solidus       \/
%%   Colon         \:     Semicolon     \;     Less than     \<
%%   Equals        \=     Greater than  \>     Question mark \?
%%   Commercial at \@     Left bracket  \[     Backslash     \\
%%   Right bracket \]     Circumflex    \^     Underscore    \_
%%   Grave accent  \`     Left brace    \{     Vertical bar  \|
%%   Right brace   \}     Tilde         \~}
%%
%^^A%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%
%    \begin{Abstract}
%      The Information Mapping\R method provides a methodology for
%      structuring and presenting information. It claims to be useful
%      for readers who are more concerned about finding the right
%      information than reading the document as a whole. Thus short,
%      highly structured, and context free pieces of information are
%      used.
%
%      \texttt{limap} provides a \LaTeX{} package and a \LaTeX{}
%      class. The package contains definitions to typeset maps and
%      blocks according to the Information Mapping\R method. The class
%      provides all definitions to typeset a whole document.
%    \end{Abstract}
%
%    \newpage
%    \begin{Map}{}
%      \vspace*{-6ex}%
%      \Block{Copyright}%
%      Copyright \textcopyright\ 1999–2016
%      \href{http://www.gerd-neugebauer.de}{Gerd Neugebauer}
%
%      \Block{Licenses}%
%      The source files of |limap| and the derived files
%      \begin{itemize}\itemsep=0pt
%      \item |limap.dtx|
%      \item |limap.ins|
%      \item |README.md|
%      \item |Makefile|
%      \item |limap.sty|
%      \item |limap.cls|
%      \item |limap.pdf|
%      \end{itemize}
%      may be distributed under the terms of the \LaTeX\ Project
%      Public License version 1.3c, as described in the file
%      |lppl.txt|.
%
%      The documentation can be used under the
%      \href{http://creativecommons.org/licenses/by-sa/4.0/}{Creative
%      Commons Attributation-Share Alike 4.0 License} (CC BY-SA 4.0).
%
%      The files in the |samples| directory are distributed unter
%      \href{http://creativecommons/zero/1.0}{Creative Commons CC0 
%      1.0 Universal}.
%
%      \Block{Net}%
%      The sources of |limap| are hosted on Sourceforge as part of the
%      project \texttt{gene-tex-lib}. The sources can be found under
%      the URL
%      \url{https://sourceforge.net/p/gene-tex-lib/svn/HEAD/tree/limap/}.
%      
%      A bundled distribution can be obtained via CTAN under the
%      package URL
%      \url{https://www.ctan.org/pkg/limap} or from the package's home
%      page under \url{http://www.gerd-neugebauer.de/sowftware/TeX/limap}.
%
%      \Block{Contact}%
%      The author can be contacted under the following coordinates:
%
%      \begin{minipage}{.6\linewidth}\parindent=2em
%        Gerd Neugebauer	\medskip\par
%        Im Lerchelsb\"ohl 5	\par
%        64521 Gro\ss-Gerau	\par
%        Germany		\medskip\par
%        \href{mailto:gene@gerd-neugebauer.de}{gene@gerd-neugebauer.de}
%      \end{minipage}
%    \end{Map}
%    \newpage
%    \tableofcontents
%    \newpage
%    
%    
%    \begin{Map}{Motivation}
%    
%      \Block{Methodology}%
%      The information mapping\R method provides a methodology to
%      structure information in a special way. The aim is to help a
%      reader who uses the document to search for relevant information
%      instead of consuming it from start to end. The information
%      mapping method also claims to raise the productivity of
%      writers.
%
%      \Block{No tutorial}%
%      This document does not include an introduction to the
%      information mapping method itself. The reader is referred to
%      other documents. Maybe an accompanying document will be
%      distributed along with this package.
%
%      Unfortunately the methodology – or the name – is protected by
%      a trademark. Thus the teaching of the methodology is restricted
%      to licensed institutions.
%
%      \Block{Principles}%
%      \begin{center}
%        \begin{tikzpicture}[mindmap,concept color=blue!16]\bfseries\scriptsize
%          \node [concept,ball color=blue!8] {Information Mapping\R}
%            child[grow=150,concept color=blue!20!black] {%
%            node[concept,ball color=blue!20!black] {\color{white}Principles}
%            child[grow=30,concept color=blue!48] {%
%            node[concept,ball color=blue!48] {Chunking}}
%            child[grow=80,concept color=blue!48] {%
%            node[concept,ball color=blue!48] {Relevance}}
%            child[grow=130,concept color=blue!48] {%
%            node[concept,ball color=blue!48] {Labelling}}
%            child[grow=180,concept color=blue!48] {%
%            node[concept,ball color=blue!48] {Consistency}}
%            child[grow=230,concept color=blue!48] {%
%            node[concept,ball color=blue!48] {Accessible details}}
%            child[grow=280,concept color=blue!48] {%
%            node[concept,ball color=blue!48] {Integrated graphics}}
%          };
%        \end{tikzpicture}
%      \end{center}
%
%      \Block{Information Type}%
%      
%      \begin{center}
%        \begin{tikzpicture}[mindmap,concept color=blue!48]\bfseries\scriptsize
%          \node [concept,ball color=blue!8] {Information Mapping\R}
%            child[grow=-30,concept color=blue!20!black] {%
%            node[concept,ball color=blue!20!black] {\color{white}Infor-mation Type}
%            child[grow=100,concept color=blue!48] {%
%            node[concept,ball color=blue!48] {Procedure}}
%            child[grow=50,concept color=blue!48] {%
%            node[concept,ball color=blue!48] {Process}}
%            child[grow=0,concept color=blue!48] {%
%            node[concept,ball color=blue!48] {Principle}}
%            child[grow=-50,concept color=blue!48] {%
%            node[concept,ball color=blue!48] {Concept}}
%            child[grow=-110,concept color=blue!48] {%
%            node[concept,ball color=blue!48] {Structure}}
%            child[grow=-160,concept color=blue!48] {%
%            node[concept,ball color=blue!48] {Fact}}
%          };
%        \end{tikzpicture}
%      \end{center}
%
%      \Block{Problems of restructuring}%
%      You as \LaTeX\ user may have encountered the problem when
%      restructuring a document: The sections know exactly the level
%      they belong to. If you introduce a new section and put another
%      section into it you have to change all sectioning commands to
%      reflect the new level of the section and their subsections.
%    
%      The macros of |limap| abstract away the level of the document
%      structuring. Any structuring unit is a “Block”. It may contain
%      text or other blocks. Such blocks are the replacement or the
%      sectioning commands. When you restructure your document you
%      simply shift the block and anything it contains to the new
%      place and you are done.
%    
%      The same mechanism can help you to include the same material in
%      several documents – at different sectioning levels!
%
%      \Block{Structure and constituents}%
%      The general approach focuses very much on the structure of
%      the document. The following diagram illustrates the terminology
%      used within this documentation.
%
%      \begin{center}\small
%        \tikzstyle{class}=[rectangle,
%                           text centered,
%                           minimum width=6em,
%                           minimum height=3em,
%                           draw=black!60!red,
%                           drop shadow,
%                           top color=yellow!92!red!10!white,
%                           bottom color=yellow!92!red!40!white]
%        \tikzstyle{arrow}=[draw=black!60!red, thick]
%        \begin{tikzpicture}
%          \path (3.75,6) node(doc) [class]{\bfseries Document}
%                (3.75,4) node(map) [class]{\bfseries Map}
%                (3.75,2) node(block) [class]{\bfseries Block}
%                (0,0) node(text) [class]{\bfseries Text}
%                (2.5,0) node(table) [class]{\bfseries Table}
%                (5,0) node(image) [class]{\bfseries Image}
%                (7.5,0) node(figure) [class]{\bfseries Diagram};
%          \draw[arrow,very thick,->] (doc) -- (map);
%          \node[left] at ($(doc)!.6!(map)$) {\scriptsize 1..*};
%          \draw[arrow,very thick,->] (map) -- (block);
%          \node[left] at ($(map)!.6!(block)$) {\scriptsize 1..9};
%          \draw[arrow,very thick,->] (map) -- +(1.5,0) -- +(1.5,1) -- +(.75,1) -- (map);
%          \draw (4.75,4.75) node {\scriptsize 0..*};
%          \draw[arrow,very thick,->] (block) -- (text);
%          \node[left] at ($(block)!.6!(text)$) {\scriptsize 0..*};
%          \draw[arrow,very thick,->] (block) -- (table);
%          \node[left] at ($(block)!.6!(table)$) {\scriptsize 0..1};
%          \draw[arrow,very thick,->] (block) -- (image);
%          \node[right] at ($(block)!.6!(image)$) {\scriptsize 0..1};
%          \draw[arrow,very thick,->] (block) -- (figure);
%          \node[right] at ($(block)!.6!(figure)$) {\scriptsize 0..1};
%        \end{tikzpicture}
%      \end{center}
%
%      \Block{Class or package}%
%      To support the information mapping\R method several \LaTeX{}
%      macros and environments are provided which allow you to enter a
%      logical description of the relevant concepts. Those macros are
%      provided in the package and class file. It is up to you to
%      choose one of them.
%    
%      \Block{Interoperabilty with other classes and packages}%
%      The main part of the user interface is inherited from \LaTeX.
%      The major differences are the sectioning commands which are
%      made obsolete in parts by the information mapping\R method.
%      Thus most packages can be used to typeset contents of a block.
%    \end{Map}
%
%    \begin{Map}{Getting Started}
%    
%      \Block{Introduction}%
%      If you are starting to use |limap| you should be vaguely
%      familiar with the underlying methodology. This documentation
%      does not provide an introduction.
%    
%      When you start using this class or package you should say
%      “Good bye” to the classical document structuring macros in
%      the \LaTeX\ standard classes.
%
%      \Block{Class or package}%
%      First of all you should decide whether to use the |limap| class
%      or the |limap| package. The class is meant for a complete document.
%      The package allows to combine |limap| with arbitrary other
%      document classes.
%
%      \Block{Contents}%
%      In the maps contained herein you will find an introduction on
%      the use of the |limap| macros and environments. They are
%      accompanied by illustrating sample code.
%      \MapTableOfContents
%
%      \begin{Map}{Using the Document Class}
%
%        \Block{Using the document class}%
%        This package provides both a class file as well as a package.
%        The package contains the definitions of maps, blocks, and
%        others. They can be used together with any base class. This
%        is illustrated in the following preamble:
%    \begin{verbatim}
%  \documentclass{book}
%  \usepackage{limap}
%  \begin{document}     \end{verbatim}
%
%        \Block{Suppressing the block lines}%
%        This class option |nolines| can be used to suppress the line
%        above and below block. This  is illustrated in the following
%        preamble:
%    \begin{verbatim}
%  \documentclass[nolines]{limap}
%  \begin{document}     \end{verbatim}
%
%        \Block{Other options}%
%        Any option not processed by |limap.cls| is passed to the
%        underlying document class used. Thus it is possible to
%        customize the underlying class any further.
%
%        \Block{Several types of options}%
%         In the maps contained herein you will find the supported
%         options for the document class |limap|.
%        \MapTableOfContents
%
%      \begin{Map}{Document Class Options for Language Selection}
%
%        \Block{Introduction}%
%        The document class |limap| inserts some words. Thus it has to
%        know the language it is supposed to use. Thus the language
%        has to be specified as one document class option.
%    \begin{verbatim}
%  \documentclass[german]{limap}
%  \begin{document}     \end{verbatim}
%
%        \Block{Supported languages}%
%        First, we describe the settings influencing the language
%        specific settings. They do not make provisions to use the
%        appropriate hyphenation patterns. They just arrange things
%        such that the internally used texts are displayed in the
%        chosen language.
%
%        \begin{MapTabular}{@{\tt }lp{.75\linewidth}}\toprule
%          \rm Option & Description\\\midrule
%          austrian   & Activate the language specific text
%                       fragments for the Austrian language (in fact
%                       German with one minor modification).\\
%          english    & Activate the language specific text fragments
%                       for the English language.\\
%          french     & Activate the language specific text fragments
%                       for the French language.\\
%          german     & Activate the language specific text fragments
%                       for the German language.\\
%          USenglish  & Activate the language specific text
%                       fragments for the American
%                       English.\\\bottomrule 
%        \end{MapTabular}
%    
%        \Block{Default language}%
%        The default language is |english|. It is used if no language
%        is set.
%    
%        \Block{Beware of hyphenation}%
%        Note that the hyphenation patterns are not loaded
%        automatically. You have to load the hyphenation patterns,
%        for instance with the
%        \href{https://www.ctan.org/pkg/babel}{babel} package.
%
%        This behavior has been chosen to allow you to select the
%        language package of your choice. Also you can pass in
%        additional options to this package more easily.
%      \end{Map}
%
%      \begin{Map}{Document Class Options for Variant Selection}
%
%        \Block{Introduction}%
%        The document class |limap| is based on another document
%        class. Thus you can use the well-known macros and
%        environments defined there and take advantage of the
%        extensions provided by |limap|.
%
%    \begin{verbatim}
%  \documentclass{limap}
%  \begin{document}     \end{verbatim}
%        \Block{Variants}%
%        The class has two additional options to determine the base
%        class to be used. The first option is the variant. It can take
%        the following values:
%    
%        \begin{MapTabular}{@{\tt }ll}\toprule
%          \rm Option & Description\\\midrule
%          base & Use the base set of classes. This is the default.\\
%          koma & Use the set of classes from
%                 \href{https://www.ctan.org/pkg/koma-script}{koma-script}.\\\bottomrule
%        \end{MapTabular}
%
%        \Block{Default variant}%
%        If no document class option is used then |base| is the
%        default variant.
%      \end{Map}
%
%      \begin{Map}{Document Class Options for Base Class Selection}
%
%        \Block{Introduction}%
%        The document class |limap| follows the logic introduced in
%        the \LaTeX\ standard document classes. The type of the base
%        document class can be given as argument to the |limap| class.
%
%    \begin{verbatim}
%  \documentclass[book]{limap}
%  \begin{document}     \end{verbatim}
%    
%
%        \Block{Class type}%
%        The second option is the class type. It determines which kind of
%        document to typeset. It can take the following values:
%
%        \begin{MapTabular}{@{\tt }ll}\toprule
%          \rm Option & Description\\\midrule
%          book       & Typeset a book type document.\\
%          report     & Typeset a report type document.\\
%          article    & Typeset an article type document.\\
%          letter     & Typeset a letter type document.\\\bottomrule
%        \end{MapTabular}
%      
%        \Block{Mapping of variant and type}%
%        The following table shows which base classes are loaded according
%        to the given values:
%    
%        \begin{MapTabular}{@{\tt }lcc}\toprule
%          \rm Type /variant  & \emph{base}	& \emph{koma}	\\\midrule
%          book		      & book		& scrbook	\\
%          report	      & report  	& scrreprt	\\
%          article	      & article 	& scrartcl	\\
%          letter	      & letter  	& scrlettr	\\\bottomrule
%        \end{MapTabular}
%
%        \Block{Default type}%
%        The default type is |report|. It is used if no type is set.
%      \end{Map}
%      \end{Map}
%
%      \begin{Map}{Using the Package}
%        \Block{Introduction}%
%        The package |limap| can be used together with most document
%        classes. An exception are classes for slides like the
%        \href{https://www.ctan.org/pkg/beamer}{beamer} class.
%
%        As usual it is declared in the document preamble.
%    
%    \begin{verbatim}
%  \documentclass{report}
%  \usepackage{limap}
%  \begin{document}    \end{verbatim}
%        \Block{Content}%
%        The following additional information is available.
%        \MapTableOfContents
%
%      \begin{Map}{Package Options for Language Selection}
%
%        \Block{Introduction}%
%        The package |limap| inserts some words. Thus it has to
%        know the language it is supposed to use. Thus the language
%        has to be specified as package option.
%    \begin{verbatim}
%  \usepackage[german]{limap}
%  \begin{document}     \end{verbatim}
%
%        \Block{Inheritance of document class options}%
%        Alternatively the language selecting option can be specified
%        as document class option. Thus several packages can share the
%        same setting.
%    \begin{verbatim}
%  \documentclass[german]{scrbook}
%  \documentclass{limap}
%  \begin{document}     \end{verbatim}
%
%        \Block{Supported languages}%
%        Here we describe the settings influencing the language
%        specific settings. They do not make provisions to use the
%        appropriate hyphenation patterns. They just arrange things
%        such that the internally used texts are displayed in the
%        chosen language.
%
%        \begin{MapTabular}{@{\tt }lp{.75\linewidth}}\toprule
%          \rm Option & Description\\\midrule
%          austrian   & Activate the language specific text
%                       fragments for the Austrian language (in fact
%                       German with one minor modification).\\
%          english    & Activate the language specific text fragments
%                       for the English language.\\
%          french     & Activate the language specific text fragments
%                       for the French language.\\
%          german     & Activate the language specific text fragments
%                       for the German language.\\
%          USenglish  & Activate the language specific text
%                       fragments for the American English.\\\bottomrule
%        \end{MapTabular}
%    
%        \Block{Default language}%
%        The default language is |english|. It is used if no language
%        is set.
%    
%        \Block{Beware of hyphenation}%
%        Note that the hyphenation patterns are not loaded
%        automatically. You have to load the hyphenation patterns,
%        for instance with the
%        \href{https://www.ctan.org/pkg/babel}{babel} package.
%
%        This behavior has been chosen to allow you to select the
%        language package of your choice. Also you can pass in
%        additional options to this package more easily.
%      \end{Map}
%    \end{Map}
%    \end{Map}
%    
%    \begin{Map}{The Block}\label{map:block}
%    
%      \Block{Meaning}%
%      A “block” is the essential building units of the |limap|
%      package. You can think of it as paragraph with a title.
%    
%      \Block{Appearance}%
%      The blocks are usually typeset with the block label on the left
%      side and the contents to its right. They are surrounded by
%      white-space and a thin line above and below.
%    
%      \DescribeMacro{\Block}
%      The macro |\Block| can be used to typeset an block. It
%      takes one argument which is the block label.
%
%      This is a shorthand for denoting a block. The end mark can be
%      omitted if you use the macro instead of the environment.
%      Nevertheless this is depreciated.
%
%      \Block{Example}%
%      The following sample illustrates how to enter a block.
%    \begin{verbatim}
%  \Block{Block Label}
%  And now comes the block text. It can consist of one or more 
%  classical paragraphs, or tables, or pictures, or something
%  else.     \end{verbatim}
%    
%      \Block{Just in a map}%
%      Note that the macro |\Block| can be used inside a map only. If
%      you try to use it outside the scope of a map you will get an
%      error.
%
%      \Block{More on blocks}%
%      Several more aspects of blocks are covered in the following
%      maps.
%      \MapTableOfContents
%
%    \begin{Map}{Configuring Blocks}
%
%      \DescribeMacro{\MapBlockLabelFont}
%        The macro |\MapBlockLabelFont| determines the font changing
%        command to be used for typesetting the block label. The
%        default is empty.
%
%      \Block{Colored block labels}%
%      The macro |\MapBlockLabelFont| can for instance be used to achieve
%      colored block labels. For this purpose we can include the package
%      |xcolor| in the preamble and select for instance a named color
%      for the rule.
%      This is illustrated in the following example.
%    \begin{verbatim}
%  \usepackage[svgnames]{xcolor}
%  \renewcommand\MapBlockLabelFont{\color{Navy}}     \end{verbatim}
%      \DescribeMacro{\MapParskip}
%      The macro |\MapParskip| determines the vertical distance of the
%      text from the separating rules. The default is \MapParskip.
%    \begin{verbatim}
%  \renewcommand\MapParskip{.25ex}     \end{verbatim}
%
%      \DescribeMacro{\MapTitleFraction}
%      The macro |\MapTitleFraction| determines the part of the page
%      width devoted to the block label area. It is a fraction in the
%      range from 0 to 1. The default value of |\MapTitleFraction| is
%      0\MapTitleFraction.
%    \begin{verbatim}
%  \renewcommand\MapTitleFraction{.25}     \end{verbatim}
%
%      \DescribeMacro{\MapTextFraction}
%      This macro determines the part of the page width devoted to the
%      text area. It is a fraction in the range from 0 to 1. The
%      default value of |\MapTextFraction| is 0\MapTextFraction.
%
%      |\MapTitleFraction| and |\MapTextFraction| should add up to
%      something less or equal to 1. Otherwise you will get some
%      “overfull hbox” messages.
%    \begin{verbatim}
%  \renewcommand\MapTextFraction{.8}     \end{verbatim}
%      \vspace*{-\MapParskip}
%    \end{Map}
%
%    \begin{Map}{Configuring the Rules of Blocks}
%    
%      \Block{Motivation}%
%      Blocks are usually surrounded by horizontal rules. The
%      appearance of these rules can be influenced by some macros.
%
%      \DescribeMacro{\MapRuleWidth} The macro |\MapRuleWidth|
%      determines the width of the rules drawn between blocks. It is
%      defined as a macro containig a length. The default is
%      \MapRuleWidth.
%
%    \begin{verbatim}
%  \setlength\MapRuleWidth{1mm}     \end{verbatim}
%
%      \Block{Suppress visible rules}%
%      For some people the rules are distracting since they emphasize
%      the structure too much. In such situations the rule width might
%      be reduced. In the extreme case it can even be set to 0pt to
%      suppress the lines at all as in the following example:
%      
%    \begin{verbatim}
%  \renewcommand\MapRuleWidth{0pt}     \end{verbatim}
%
%      \DescribeMacro{\MapRuleStart}
%      The macro |\MapRuleStart| is inserted before rules around
%      blocks. It can be used to inject some code before the rule is
%      typeset.  Initially it is empty.
%
%      \Block{Colored rules}%
%      The macro |\MapRuleStart| can for instance be used to achieve
%      colored rules. For this purpose we can include the package
%      |xcolor| in the preamble and select a named color for the rule.
%      This is illustrated in the following example.
%    \begin{verbatim}
%  \usepackage[svgnames]{xcolor}
%  \renewcommand\MapRuleStart{\color{Silver}}     \end{verbatim}
%	\vspace*{-3ex}
%    \end{Map}
%    
%    \begin{Map}{A Wide Block}
%    
%      \Block{Motivation}%
%      Sometimes it is necessary to extend the content of a block to
%      the whole width of the page. This can be the case for
%      illustrations or large tables.
%
%      \DescribeMacro{\WideBlock}
%      The macro |\WideBlock| can be used to typeset a piece of
%      information on the whole page width. It is normally used after an
%      initiating block containing the title of the whole construction.
%      
%      The macro |\WideBlock| takes one argument which contains the
%      material to span the whole page width.
%
%      \Block{Example}%
%      The following sample illustrates how to enter a wide block.
%    \begin{verbatim}
%  \Block{Block Label}
%  And now comes the block text.
%  \WideBlock{\includegraphics{images/overview.svg}}     \end{verbatim}
%
%      \Block{Block Label}
%      And now comes the wide block produced with the help of
%      Ti\textit{kZ} and its decoration with random steps.
%
%      \vspace*{-\MapParskip}
%      \WideBlock{\centering
%      \begin{tikzpicture}
%        \node [draw=black!50!white,
%               ball color=yellow!85!red!12!white,draw,thick,
%               minimum height=20mm, minimum width=147mm,
%               decorate, decoration={random steps,
%               segment length=5pt,amplitude=4pt}]
%              {\it A very, very, very, very, very, very, very, very, very, very, very, very, very
%               wide block content};
%      \end{tikzpicture}}\\
%      \vspace*{-\MapParskip}
%    \end{Map}
%    \end{Map}
%
%    \begin{Map}{The Map}\label{map:map}
%    
%      \Block{Structuring documents}%
%      The maps are the structuring units of the |limap| package. Maps
%      may recursively contain maps and other material. The other
%      material is usually named a block. This recursive structure is
%      illustrated in the following figure.
%    
%      \newcount\picX
%      \newcount\picY
%      \newcount\picW
%      \picX=0
%      \picY=0
%      \picW=20
%      \long\def\picMap(#1)#2{%
%        \put(\the\picX,\the\picY){\framebox(\the\picW,#1)[tl]{Map}}
%        \begingroup\advance\picW-2
%        \advance\picY1  \advance\picX1
%        #2
%        \endgroup
%        \advance\picY#1 \advance\picY2
%      }%
%      \def\picBlock{%
%        \put(\the\picX,\the\picY){\makebox(\the\picW,3)[tl]{\tiny Block}}
%        \put(\the\picX,\the\picY){\line(1,0){\the\picW}}
%        \begingroup \advance\picX6
%        \advance\picY1
%        \advance\picW-6
%        \multiput(\the\picX,\the\picY)(0,.5){5}{\line(1,0){\the\picW}}
%        \endgroup
%        \advance\picY4
%        \put(\the\picX,\the\picY){\line(1,0){\the\picW}}
%      }%
%      \begin{center}\unitlength=1mm
%        \begin{picture}(20,72)\sf\scriptsize
%          \picMap(71){
%          \picMap(21){
%            \picMap(16){
%              \picBlock
%              \picBlock
%              \picBlock
%            }
%          }
%          \picMap(16){
%            \picBlock
%            \picBlock
%            \picBlock
%          }
%          \picMap(16){
%            \picBlock
%            \picBlock
%            \picBlock
%          }
%          \picBlock
%          \picBlock
%        }
%        \end{picture}
%      \end{center}
%    
%      \DescribeEnv{Map}
%      The environment |Map| can be used to typeset a map. It
%      takes a single argument which contains the map title. The map
%      title is typeset above the map and is repeated on each
%      continuation page.
%
%      \Block{Example}%
%    
%    \begin{verbatim}
%  \begin{Map}{Map Title}
%    \Block{Block Label}
%     And now comes the block text. It can  consist of
%    one or more classical paragraphs, or tables, or 
%    pictures, or something else.
%  \end{Map}    \end{verbatim}
%
%      \Block{To at most 12~cascaded Maps}
%      There is a technical restriction in the current implementation
%      of Maps. This restriction does not allow more than 12 cascaded
%      Maps, i.e. Maps in Maps \ldots in Maps.
%
%      According to the good old 7$\pm$2 rule a full populated
%      document of this level would contain 282\,429\,536\,481 Maps. I
%      think it should take some time until this limit is reached.
%    
%      \Block{More on maps}%
%      Some more aspects are covered in the following pages.
%      \MapTableOfContents
%
%    \begin{Map}{Referencing Maps}
%    
%      \Block{Referencing maps}%
%      Maps can be referenced in the usual \LaTeX\ way. For this
%      purpose you place a macro invocation of |\label| right behind
%      the beginning of the |Map|.
%
%      Then you can add references somewhere in the document with
%      |\ref| and |\pageref|. For backward references two \LaTeX\ runs
%      are required.
%
%      \Block{Example}%
%    \begin{verbatim}
%  \begin{Map}{Map Title}\label{my.label}
%    \Block{Block Label}
%    As said on page~\pageref{my.label}...    \end{verbatim}
%      \Block{Caveat emptor}%
%      |limap| automatically labels any map with a label of the form
%      \texttt{Map|@|}\textsl{n} where \textsl{n} is a
%      sequence number. Thus avoid to use such labels yourself.
%    \end{Map}
%
%    \begin{Map}{Configuring Maps}
%      
%      \DescribeMacro{\MapFont}
%      The macro |\MapFont| determines the font changing command to be
%      used when starting a new map. 
%    \begin{verbatim}
%  \renewcommand\MapFont{\tt}    \end{verbatim}
%
%      \DescribeMacro{\MapTitleFont}
%      The macro |\MapTitleFont| determines the font changing command to
%      be used when typesetting the title of a map. The default is |\Large|.
%    \begin{verbatim}
%  \renewcommand\MapTitleFont{\huge\bfseries}    \end{verbatim}
%    
%      \DescribeMacro{\MapContinued}
%      The macro |\MapContinued| contains the text appearing at the end
%      of map which are continued on the next page. It is initiated
%      when the class or package is loaded. It can overwritten
%      afterwards – for instance in the preamble.
%    \begin{verbatim}
%  \renewcommand\MapContinued{}    \end{verbatim}
%
%      \DescribeMacro{\MapContinuing}
%      The macro |\MapContinuing| contains the text appearing at the
%      beginning of map which are continued from the previous page. It
%      is typeset after the map title. It is initiated
%      when the class or package is loaded. It can overwritten
%      afterwards – for instance in the preamble.
%    \begin{verbatim}
%  \renewcommand\MapContinuing{}    \end{verbatim}
%
%      \DescribeMacro{\MapTitleContinuedFont}
%      This macro determines the font changing command to be used for
%      typesetting the additional text after titles on followup pages of
%      multi-page maps.
%
%      The default value is |\small|.
%    \begin{verbatim}
%  \renewcommand\MapTitleContinuedFont{\normalsize}    \end{verbatim}
%
%      \DescribeMacro{\MapNewpage}
%      The macro |\MapNewpage| is expanded whenever a new page is
%      required between maps. Thus it can be used to suppress the
%      newpages by |\let|ing it to |\relax|. Note that this is not in
%      the spirit of the Information Mapping\R method.
%
%      \DescribeMacro{\MapTOC} 
%      The macro |\MapTOC| is expanded to generate the entry in the
%      table of contents. It can be redefined to allow another
%      behavior.
%    \end{Map}
%    \end{Map}
%    
%    \begin{Map}{The Table of Contents}
%    
%      \Block{Everything is local}%
%      The concept of the underlying methodology is that everything
%      should be addressed relative to the current location. We see
%      this when dealing with maps (see page~\pageref{map:map}). The
%      same principle is applied to the table of contents.
%
%      \Block{Direct children are included}%
%      The table of contents includes all maps contained in the map in
%      which it appears. This means the immediate children of the map
%      are shown.
%
%      \Block{Block context required}%
%      The table of contents is typeset inside a block (see
%      page~\pageref{map:block}).
%
%      \DescribeMacro{\MapTableOfContents}
%      The macro |\MapTableOfContents| can be used to typeset the table
%      of contents for a map. This table of contents includes all
%      sub-maps of the map it is contained in – not recursively but
%      only one level deeper.
%
%      The macro |\MapTableOfContents| does not take any argument.
%
%      \Block{Example}%
%    \begin{verbatim}
%  \Block{Contents}
%  And some wise words about the table of contents.
%  \MapTableOfContents    \end{verbatim}
%    
%      \DescribeMacro{\MapTableOfContentsStyle}
%      The macro |\MapTableOfContentsStyle| can be used to determine
%      the style of the |\MapTableOfContents| The default style is an
%      open layout utilizing the package
%      \href{https://www.ctan.org/pkg/booktabs}{booktabs}.
%
%      The macro |\MapTableOfContentsStyle| takes one argument. This
%      argument may have one of the following values:
%
%      \begin{MapTabular}{ll}\toprule
%        Argument & Meaning \\\midrule
%        open     & an open style for the TOC\\\hline
%        boxed    & a boxed style for the TOC\\\bottomrule
%      \end{MapTabular}%
%      \vspace*{-5ex}
%    \begin{Map}{Blocks in the Table of Contents}
%    
%      \Block{Motivation}%
%      Sometimes it can be desirable to add the blocks to the global
%      table of contents. Here we will see how this can be achieved.
%
%      \DescribeMacro{\MapBlockStartHook}
%      The macro |\MapBlockStartHook| is expanded at the beginning of
%      each block it if is defined. It takes a single argument which
%      is the title of the block.
%
%      \DescribeMacro{\MapBlockTOC}
%      The macro |\MapBlockTOC| is a macro which adds one line to the
%      table of contents. It takes one argument which is the text to
%      be added. 
%
%      \Block{Example}%
%      Put the following code in the preamble to get the blocks into
%      the table of contents.
%    \begin{verbatim}
%  \let\MapBlockStartHook\MapBlockTOC    \end{verbatim}
%    
%      %\vspace*{-5ex}
%    \end{Map}
%    \end{Map}
%    \begin{Map}{Tables}
%
%      \Block{Introduction}%
%      Tables play an important role as part of maps. Usually they are
%      included into a block and preceded by some useful introduction.
%
%      \Block{Combination with booktabs}%
%      The document class |limap| and the package |limap|
%      automatically include the package
%      \href{https://www.ctan.org/pkg/booktabs}{booktabs}. This
%      package contains some support for typesetting proper tables.
%      You should have a look at the documentation of |booktabs| and
%      follow the recommendations given there.
%
%      |booktabs| is automatically loaded by |limap| upon start-up.
%
%      \DescribeEnv{MapTabular}
%      The environment |MapTabular| provides a convenient way to
%      include a table into a block. It produces a |tabular*|
%      environment and sets the width to the width of the text column
%      of the block.
%
%      \Block{Example}%
%    \begin{verbatim}
%  \Block{Table block}
%  Sheding some insight on the following table.
%
%  \begin{MapTabular}{lll}\toprule
%    a & b & \\\midrule
%    x & y & Z\\\hline
%    X & Y & Z\\\bottomrule
%  \end{MapTabular}    \end{verbatim}
%      \DescribeMacro{\MapTabularFraction}
%      The tabular is always centered in the text column of the block. The
%      macro |\MapTabularFraction| contains a factor for the line
%      width occupied by the tabular. This value is used to determine
%      the width of the tabular. The default value for the macro
%      |\MapTabularFraction| is 0\MapTabularFraction.
%    \begin{verbatim}
%  \renewcommand\MapTabularFraction{.7}    \end{verbatim}
%      \vspace*{-4ex}
%    \end{Map}
%    
%    \begin{Map}{Configuration}
%
%      \Block{Introduction}%
%      |limap| is designed with a set of extension points. Those are
%      mainly definition which can be overwritten to achieve a certain
%      effect.
%
%      \Block{Configuration in the preamble}%
%      Any configuration change performed in the preamble of a
%      document is global. It lasts until oberwritten within the
%      document. 
%
%      \Block{Configuration in the document}%
%      The configuration parameters can be overwritten in the document
%      just before they are needed. This is not recommended since it
%      makes it harder to achieve consistency.
%
%      \Block{External configuration}%
%      The confiration can be externalised. For this purpose a special
%      file |limap.cfg| is loaded with the class or package in case it
%      exists. This file can contain configuration options for
%      |limap|. Thus it is possible to share the same appearance
%      among different documents.
%
%      \Block{Contents}%
%      The following maps contain the various aspects of the
%      configuration of |limap|.
%      \MapTableOfContents
%
%    \begin{Map}{The Configuration File limap.cfg}
%
%      \Block{Default configuration file}%
%      When the class or package is loaded as a last action a
%      configuration file is loaded if it can be found. The name of
%      the configuration file is \texttt{limap.cfg}. This file can
%      contain re-definitions of the several macros to adjust the
%      behavior of |limap| on a per directory, per user or per
%      installation base.
%
%      \Block{Note}%
%      Some settings are activated before the configuration file is
%      loaded. Thus some settings may not have any effect at all.
%    \end{Map}
%    
%    \begin{Map}{Changing or Adding Language Specific Settings}
%
%      \Block{Overview}%
%      Several strings are used automatically by the current class or
%      package. Default values for several languages are hardwired in
%      the implementation. Nevertheless it is possible to change those
%      language specific settings.
%
%      If you create settings for a new language it is highly
%      recommended to contact the author to integrate them into the
%      default distribution.
%
%      The following macros can be redefined in the preamble after the
%      package or class has been loaded to reset the language specific
%      text.
%
%      \DescribeMacro{\MapTOCname}
%      The macro |\MapTOCname| contains the text of the heading in table
%      of contents of maps for the column of map titles. It is initiated
%      when the class or package is loaded. It can overwritten
%      afterwards – for instance in the preamble.
%      \begin{verbatim}
%  \renewcommand\MapTOCname{Issue}    \end{verbatim}
%
%      \DescribeMacro{\MapTOCpage}
%      The macro |\MapTOCpage| contains the text of the heading in table
%      of contents of maps for the column of page numbers. It is initiated
%      when the class or package is loaded. It can overwritten
%      afterwards – for instance in the preamble.
%      \begin{verbatim}
%  \renewcommand\MapTOCname{Reference}    \end{verbatim}
%
%      \Block{Providing a new language}%
%      If you want to provide a new language \textit{lang} you can
%      define the macro |\LIMAP@SelectLanguage@|\textit{lang} which
%      redefines the macros given above. This definition has to be
%      present before the package is loaded.
%
%      Note that the macro name contains the @ character. Thus the
%      definition should be made in a package of its own.
%    \end{Map}
%    \end{Map}
%    
%
%^^A%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%    \StopEventually{}
%    \newpage
%    \if@undefined\environment
%    \newenvironment{environment}[1]{}{}
%    \fi
%    
%    \begin{Map}{The Implementation}
%      \Block{Overview}%
%      This part of the document describes the implementation. Usually
%      it is not meant for the casual user. Nevertheless it might be
%      fruitful for those searching for inspiration or for tricks when
%      using this class or package.
%
%      \Block{Contents}%
%      \MapTableOfContents
%
%    \begin{Map}{The Version Information}
%
%      \Block{Purpose}%
%      The version information is included for printing it on the
%      documentation and at start-up when the class or package is
%      loaded. It has to preceed the documentation driver to properly
%      include this information into the printed manual.
%    
%      \Block{}%
%      \begin{macro}{\filename}
%        |\filename| is the name of the dtx file containing this class
%        and package.
%    \begin{macrocode}
\def\filename{limap.dtx}
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\fileversion}
%        |\fileversion| is the version number of the |dtx| file. It is
%        used as a version number for the class and package.
%    \begin{macrocode}
\def\fileversion{2.2}
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\filedate}
%        |\filedate| is the change date of the |dtx| file. It is used
%        as a version date and documentation date.
%    \begin{macrocode}
\def\filedate{2016/05/29}
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\docversion}
%        |\docversion| is the version number of the documentation. It
%        is identical to the version number of the |dtx| file.
%    \begin{macrocode}
\let\docversion=\fileversion
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\docdate}
%        |\docdate| is the change date of the documentation. It is
%        identical to the change date of the |dtx| file.
%    \begin{macrocode}
\let\docdate=\filedate
%    \end{macrocode}
%      \end{macro}
%    \end{Map}
%
%    \begin{Map}{The Documentation Driver}
%      \Block{Purpose}%
%      The documentation driver is necessary to provide a self
%      documenting |dtx| file. With this construction the dtx file can
%      be run through \LaTeX\ to produce the documentation.
%
%      The driver section contains a complete \LaTeX\ document which
%      loads the |dtx| file. The special class |ltxdoc| is used and
%      some arrangements are made for this purpose.
%
%      \Block{Driver code}%
%      The driver code is not exported by the installer.
%
%    \begin{macrocode}
%<*driver>
\documentclass[a4paper]{ltxdoc}
\RequirePackage{textcomp}
\usepackage{limap}
\let\LimapFilename\filename
\let\LimapFileversion\fileversion
\let\LimapFiledate\filedate
\let\LimapDocdate\docdate
%    \end{macrocode}
%      \Block{Page Layout}%
%    \begin{macrocode}
\oddsidemargin=10pt
\evensidemargin=10pt
\textwidth=430pt
\textheight=650pt
\voffset=-12mm
%    \end{macrocode}
%      \Block{Headings}%
%    \begin{macrocode}
\usepackage{fancyhdr}
\addtolength{\headheight}{2ex}%
\pagestyle{fancy}%
\cfoot{}
\rhead{\small\sf\thepage}
\lhead{\textit{\footnotesize limap} – Package and Class}
%    \end{macrocode}
%      \Block{Links and such}%
%    \begin{macrocode}
\usepackage{hyperref}
%    \end{macrocode}
%      \Block{Fonts}%
%    \begin{macrocode}
\usepackage{fontspec}
\setmainfont{TeX Gyre Heros}
\setsansfont{TeX Gyre Heros}%[Scale=MatchLowercase]
\setmonofont{Inconsolata}%[Scale=MatchLowercase]
%    \end{macrocode}
%      \Block{Coloring}%
%    \begin{macrocode}
\usepackage[svgnames]{xcolor}
\renewcommand\MapTitleFont{\Large\bfseries\color{Navy}}
\renewcommand\MapBlockLabelFont{\bfseries\color{Navy}}
\definecolor{linkColor}{rgb}{.66,.2,.2}
\hypersetup{colorlinks, 
            citecolor=linkColor,
            filecolor=linkColor,
            linkcolor=linkColor,
            urlcolor=linkColor}
\renewcommand\MapRuleStart{\color{Navy}}
\renewcommand\MapRuleWidth{1pt}
%    \end{macrocode}
%      \Block{Graphics}%
%    \begin{macrocode}
\usepackage{tikz}
\usetikzlibrary{decorations.pathmorphing}
\usetikzlibrary{shadows}
\usetikzlibrary{mindmap}
\usetikzlibrary{calc}
%    \end{macrocode}
%      \Block{Saving version}%
%    \begin{macrocode}
\let\filename\LimapFilename
\let\fileversion\LimapFileversion
\let\filedate\LimapFiledate
\let\docdate\LimapDocdate
%    \end{macrocode}
%      \Block{Adapting doc.sty}%
%    \begin{macrocode}
\def\theCodelineNo{\color{DarkGreen}\rmfamily\scriptsize\arabic{CodelineNo}}%
\makeatletter
\renewcommand\DescribeMacro{\catcode`\\=12\Describe@@Macro}
\def\Describe@@Macro#1{\Block{\PrintDescribeMacro{#1}}%
  \SpecialUsageIndex{#1}\@esphack\ignorespaces}
\renewcommand\DescribeEnv{\catcode`\\=12\Describe@@Env}
\def\Describe@@Env#1{\Block{\PrintDescribeEnv{#1}}%
  \SpecialEnvIndex{#1}\@esphack\ignorespaces}
\makeatother
\let\maketitle\MakeTitle
%    \end{macrocode}
%      \Block{Some additions}%
%    \begin{macrocode}
\newcommand\R{\(^{\textrm{\footnotesize\textregistered}}\) }
\let\marginpar\Block
\InputIfFileExists{limap.dcf}{}{}
\RecordChanges
\EnableCrossrefs
\CodelineIndex
%    \end{macrocode}
%      \Block{The content}%
%      Now everything is prepared. Let the show begin\ldots
%    \begin{macrocode}
\begin{document}
\DeleteShortVerb{|}
\DocInput{\filename}
%\newpage
%\PrintChanges
\newpage
\setcounter{IndexColumns}{2}
\PrintIndex
\end{document}
%</driver>
%    \end{macrocode}
%    \end{Map}
%    
%
%    \begin{Map}{The \TeX\ Code}
%
%      \Block{Overview}%
%      The rest of the document describes the implementation. Usually
%      it is not meant for the casual user. Nevertheless it might be
%      fruitful for those searching for inspiration or for tricks when
%      using this class or package.
%
%      \Block{Contents}%
%      \MapTableOfContents
%
%    \begin{Map}{The Package and Class Declarations}
%
%      \Block{Preliminaries}%
%      First of all we request a descent version of \LaTeX\ to be
%      used. I don't think it does have to be too new.
%
%    \begin{macrocode}
\NeedsTeXFormat{LaTeX2e}
%    \end{macrocode}
%
%      \Block{Package identification}%
%      When the package is generated, the package identification is
%      included.
%    \begin{macrocode}
%<*package>
\ProvidesPackage{limap}[\filedate\space Gerd Neugebauer]
%</package>
%    \end{macrocode}
%
%      \Block{Class identification}%
%      When the class is generated, the class identification is
%      included. 
%    \begin{macrocode}
%<*class>
\ProvidesClass{limap}[\filedate\space Gerd Neugebauer]
%</class>
%    \end{macrocode}
%    \end{Map}
%
%    \begin{Map}{Language Specific Macros}
%
%      \Block{Introduction}%
%      This section contains internal macros used to implement the
%      functionality. New languages can be easily be added. For this
%      purpose only a new macro has to be defined and a package/class
%      option for the convenience of the user.
%
%      Consider you want to add a new language “latin” then you have
%      to provide the command |\LIMAP@SelectLanguage@latin|. This
%      macro should simply redefine the macros containing strings of
%      the language specific texts. Examples for other languages are
%      provided in this section.
%
%      To enable the language settings for “latin” the macro
%      |\LIMAP@Language| has to be defined to contain the value
%      “latin”. Usually this is accomplished by providing a
%      convenient option to the package or class.
%
%      \Block{}%
%      \begin{macro}{\defineLimapLanguage}
%        Provide the definitions for a language. The different texts
%        to be used are stored in a macro which defines the target
%        macros when expanded.
%    \begin{macrocode}
\def\defineLimapLanguage#1#2#3#4#5{%
  \expandafter\def\csname LIMAP@SelectLanguage@#1\endcsname{%
    \def\MapContinued{#2}%
    \def\MapContinuing{#3}%
    \def\MapTOCname{#4}%
    \def\MapTOCpage{#5}%
  }%
}
%    \end{macrocode}
%      \end{macro}
%
%      \Block{Definitions for the language “austrian“}%
%    \begin{macrocode}
\defineLimapLanguage{austrian}%
  { Fortsetzung}{Fortsetzung\dots}%
  {Titel}{Seite}
%    \end{macrocode}
%
%      \Block{Definitions for the language “german“}%
%    \begin{macrocode}
\defineLimapLanguage{german}%
  { Fortsetzung}{Fortsetzung\dots}%
  {Titel}{Seite}
%    \end{macrocode}
%
%      \Block{Definitions for the language “english“}%
%    \begin{macrocode}
\defineLimapLanguage{english}%
  { Continued}{Continuing\dots}%
  {Title}{Page}
%    \end{macrocode}
%
%      \Block{Definitions for the language “USenglish“}%
%    \begin{macrocode}
\defineLimapLanguage{USenglish}%
  { Continued}{Continuing\dots}%
  {Title}{Page}
%    \end{macrocode}
%
%      \Block{Definitions for the language “french“}%
%    \begin{macrocode}
\defineLimapLanguage{french}%
  { continuation}{continuation\dots}%
  {Intitulé}{Page}
%    \end{macrocode}
%
%      \Block{}%
%      \begin{macro}{\LIMAP@Language}
%        The macro |\LIMAP@Language| determines the language to be
%        used for several small text fragments to be inserted at
%        certain places. It is redefined by package/class options and
%        evaluated at the end to activate the selected settings.
%    \begin{macrocode}
\providecommand\LIMAP@Language{english}
%    \end{macrocode}
%      \end{macro}
%    
%      \Block{}%
%    \begin{macrocode}
\DeclareOption{austrian}{\renewcommand\LIMAP@Language{austrian}}
\DeclareOption{german}{\renewcommand\LIMAP@Language{german}}
\DeclareOption{french}{\renewcommand\LIMAP@Language{french}}
\DeclareOption{english}{\renewcommand\LIMAP@Language{english}}
\DeclareOption{USenglish}{\renewcommand\LIMAP@Language{USenglish}}
%    \end{macrocode}
%
%      \Block{}%
%      \begin{macro}{\ifLIMAP@strict}
%        The boolean |\ifLIMAP@strict| determines if the lower
%        sectioning macros should be disabled in the class.
%    \begin{macrocode}
\newif\ifLIMAP@strict \LIMAP@stricttrue
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%    \begin{macrocode}
\DeclareOption{nonstrict}{\LIMAP@strictfalse}
%    \end{macrocode}
%    
%      \Block{}%
%    \begin{macrocode}
\DeclareOption{nolines}{\def\MapRuleWidth{0pt}\ignorespaces}
%    \end{macrocode}
%    
%    \begin{Map}{Determining the Appropriate Base Class}
%
%      \Block{}%
%    \begin{macrocode}
%<*class>
%    \end{macrocode}
%
%      \begin{macro}{\LIMAP@ClassType}
%        The macro |\LIMAP@ClassType| determines the type of the class
%        to be used. Usually it can take the values |book|, |report|,
%        |article|, and |letter| (for completeness). This macro is
%        redefined when the options of the class are evaluated.
%        Finally this macro helps to select the appropriate base
%        class.
%    \begin{macrocode}
\providecommand\LIMAP@ClassType{report}
%    \end{macrocode}
%      \end{macro}
%    
%      \Block{}%
%    \begin{macrocode}
\DeclareOption{book}{\renewcommand\LIMAP@ClassType{book}}
\DeclareOption{report}{\renewcommand\LIMAP@ClassType{report}}
\DeclareOption{article}{\renewcommand\LIMAP@ClassType{article}}
\DeclareOption{letter}{\renewcommand\LIMAP@ClassType{letter}}
%    \end{macrocode}
%    
%      \Block{}%
%      \begin{macro}{\LIMAP@Variant}
%        The macro |\LIMAP@Variant| determines the variant of the
%        class to be used. Usually it can take the values |base| and
%        |koma|. This macro is redefined when the options of the class
%        are evaluated. Finally this macro helps to select the
%        appropriate base class.
%    \begin{macrocode}
\providecommand\LIMAP@Variant{base}
%    \end{macrocode}
%      \end{macro}
%    
%      \Block{Options for selecting the variant}%
%    \begin{macrocode}
\DeclareOption{koma}{\renewcommand\LIMAP@Variant{koma}}
\DeclareOption{base}{\renewcommand\LIMAP@Variant{base}}
%    \end{macrocode}
%
%      \Block{Mapping to document class}%
%      Define a mapping between the variant and class type to the class
%      name to be used.
%    \begin{macrocode}
\newcommand\LIMAP@Class@base@article{article}
\newcommand\LIMAP@Class@base@report{report}
\newcommand\LIMAP@Class@base@book{book}
\newcommand\LIMAP@Class@base@letter{letter}
\newcommand\LIMAP@Class@koma@article{scrartcl}
\newcommand\LIMAP@Class@koma@report{scrreprt}
\newcommand\LIMAP@Class@koma@book{scrbook}
\newcommand\LIMAP@Class@koma@letter{scrlettr}
%</class>
%    \end{macrocode}
%
%      \Block{Pass on the unknown options}%
%    \begin{macrocode}
%<*class>
\DeclareOption*{\PassOptionsToClass{\CurrentOption}{%
    \csname LIMAP@Class@\LIMAP@Variant @\LIMAP@ClassType\endcsname}%
  }
%</class>
%    \end{macrocode}
%
%      Thus the class specific options are completed.
%    
%      Now we can process all options. 
%    \begin{macrocode}
\ProcessOptions
%    \end{macrocode}
%
%      \Block{}%
%    \begin{macrocode}
%<*class>
%    \end{macrocode}
%    The requested class is loaded and the options remaining are
%    processed. 
%    \begin{macrocode}
\LoadClass{\csname
  LIMAP@Class@\LIMAP@Variant @\LIMAP@ClassType\endcsname}
%</class>
%    \end{macrocode}
%    \end{Map}
%
%    \begin{Map}{Loading Required Packages}
%
%      \Block{longtable for breakable tables}%
%      The package
%      \href{https://www.ctan.org/pkg/longtable}{longtable} is used
%      internally to implement a part of the required functionality.
%      Thus we need to ensure that it is loaded.
%    \begin{macrocode}
\RequirePackage{longtable}
%    \end{macrocode}
%      \Block{etoolbox}%
%    \begin{macrocode}
\RequirePackage{etoolbox}
%    \end{macrocode}
%
%      \Block{booktabs for nice tables}%
%      The package \href{https://www.ctan.org/pkg/booktabs}{booktabs}
%      is used internally to implement a part of the required
%      functionality. Thus we need to ensure that it is loaded.
%    \begin{macrocode}
\RequirePackage{booktabs}
%    \end{macrocode}
%    
%      \Block{fancyhdr for head and foot lines}%
%    
%    \begin{macrocode}
%<*class>
\RequirePackage{fancyhdr}
\addtolength{\headheight}{2ex}%
\pagestyle{fancy}%
\cfoot{}
\rhead{\small\thepage}
\lhead{\textit{\footnotesize\@title}}
\def\@title{}
%</class>
%    \end{macrocode}
%
%      \Block{No vertical adjustment of pages}%
%      Since the blocks are not supposed to line up at the end of the
%      page we declare |\raggedbottom|.
%    \begin{macrocode}
\raggedbottom
%    \end{macrocode}
%    \end{Map}
%    \end{Map}
%
%    \begin{Map}{Layout Parameters}
%
%      \Block{Overview}%
%      The layout can be influenced by a large number of parameters.
%      Thus the design decisions have been made transparent (to a
%      certain degree at least). These options are not meant to be
%      changed except when a new layout is being designed and
%      implemented.
%
%      \Block{}%
%      \begin{macro}{\MapRuleWidth}
%        The macro |\MapRuleWidth| determines the width of the rules
%        drawn between blocks.
%    \begin{macrocode}
\providecommand\MapRuleWidth{.25pt}
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\MapRuleStart}
%        The macro |\MapRuleStart| is inserted before the rules
%        drawn between blocks.
%    \begin{macrocode}
\newcommand\MapRuleStart{}
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\MapContinued}
%        This macro determines the text to be used in the title of
%        continued maps. This macro is reset when the language
%        specific initializations are performed.
%    \begin{macrocode}
\newcommand\MapContinued{}
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\MapContinuing}
%        The macro |\MapContinuing| determines the text to be used at
%        the bottom of the map which is continued. This macro is reset
%        when the language specific initializations are performed.
%    \begin{macrocode}
\newcommand\MapContinuing{}
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\MapContinuingFormat}
%        This macro determines the format of the bottom line on
%        continued maps. I.e. it includes the text as well as font
%        changing commands. The text is passed to this command as
%        argument 1.
%    \begin{macrocode}
\newcommand\MapContinuingFormat[1]{\textit{\footnotesize #1}}
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\MapContinuedFormat}
%        This macro determines the format of the bottom line on
%        continued maps. I.e. it includes the text passed to it as
%        argument 1 as well as font changing commands.
%    \begin{macrocode}
\newcommand\MapContinuedFormat[1]{, {\MapTitleContinuedFont #1}}
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\MapFont}
%        The macro |\MapFont| determines the font changing command to
%        be used when starting a new map.
%    \begin{macrocode}
\let\MapFont\textsf
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\MapTitleFont}
%        The macro |\MapTitleFont| determines the size changing
%        command to be used when typesetting the title of a map.
%    \begin{macrocode}
\let\MapTitleFont\Large
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\MapTitleContinuedFont}
%        This macro determines the font changing command to be used
%        for typesetting the additional text after titles on followup
%        pages of multipage maps.
%    \begin{macrocode}
\let\MapTitleContinuedFont\small
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\MapBlockLabelFont}
%        This macro determines the font changing command to be used
%        for typesetting the block label.
%    \begin{macrocode}
\def\MapBlockLabelFont{}
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\MapParskip}
%        The macro |\MapParskip| determines the distance of the text
%        from the separating rules.
%    \begin{macrocode}
\newcommand\MapParskip{2ex}
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\MapTitleFraction}
%        The macro |\MapTitleFraction| determines the part of the page
%        width devoted to the title area. It is a fraction in the
%        range from 0 to 1.
%    \begin{macrocode}
\newcommand\MapTitleFraction{.2}
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\MapTextFraction}
%        This macro determines the part of the page width devoted to
%        the text area. It is a fraction in the range from 0 to 1.
%        |\MapTitleFraction| and |\MapTextFraction| should add up to
%        something less or equal to 1. Otherwise you will get some
%        “overfull hbox” messages.
%    \begin{macrocode}
\newcommand\MapTextFraction{.75}
%    \end{macrocode}
%    \end{macro}
%    \end{Map}
%
%    \begin{Map}{Adaptable Macros}
%
%      \Block{Overview}%
%
%      \begin{macro}{\MapNewpage}
%        The macro |\MapNewpage| is expanded whenever a new page is
%        required between maps. Thus it can be used to suppress the
%        newpages by |\let|ing it to |\relax|.
%    \begin{macrocode}
\let\MapNewpage\newpage
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\MapTOC}
%        The macro |\MapTOC| is expanded to generate the entry in the
%        table of contents. It can be redefined to allow another
%        behavior.
%    \begin{macrocode}
\newcommand\MapTOC[1]{%
  \refstepcounter{\@nameuse{Map@TOC@name\the\Map@level}}%
  \addcontentsline{toc}{\@nameuse{Map@TOC@name\the\Map@level}}{#1}%
}
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\MapBlockTOC}
%        The macro |\MapBlockTOC| can be used to add an entry for a
%        block to the table of contents.
%        \changes{2.2}{2017/07/20}{new}
%    \begin{macrocode}
\newcommand\MapBlockTOC[1]{%
  \begingroup\count0=\Map@level \advance\count0 1%
    \addcontentsline{toc}{\@nameuse{Map@TOC@name\the\count0}}{#1}%
  \endgroup
}
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\MapTOCname}
%        The macro |\MapTOCname| contains the heading for the section
%        title in contents blocks. This macro is reset when the
%        language specific initializations are performed.
%    \begin{macrocode}
\newcommand\MapTOCname{}
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\MapTOCpage}
%        The macro |\MapTOCpage| contains the heading for the page
%        number in contents blocks. This macro is reset when the
%        language specific initializations are performed.
%    \begin{macrocode}
\newcommand\MapTOCpage{}
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\MapTOCheadfont}
%        The macro |\MapTOCheadfont| contains the font switching
%        command for typesetting the head line of map table of
%        contents.
%    \begin{macrocode}
\newcommand\MapTOCheadfont{\scriptsize\emph}
%    \end{macrocode}
%      \end{macro}
%    \end{Map}
%
%    \begin{Map}{Internal Macros, Lengths, and Counters}
%
%      \Block{}%
%      This section contains internal macros used to implement the
%      functionality.
%
%      \Block{}%
%      \begin{macro}{\Map@length}
%        The length register |\Map@length| is allocated to store the
%        width of the space between the columns of a block.
%    \begin{macrocode}
\newlength{\Map@length}
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\Map@level}
%        The macro |\Map@level| determines the level of inclusion of
%        maps. It is used to determine the appearance in the table of
%        contents.
%    \begin{macrocode}
\newcount\Map@level
\Map@level=0
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\Map@blockcount}
%        The macro |\Map@blockcount| is used to count the blocks per
%        map to issue a package warning if required.
%    \begin{macrocode}
\newcount\Map@blockcount
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\LT@final@warn}
%        The macro |\LT@final@warn| is defined in |longtable|. It is
%        redefined to show |limap| are originator.
%    \begin{macrocode}
\def\LT@final@warn{%
  \AtEndDocument{%
    \PackageWarning{limap}%
    {Table \@width s have changed. Rerun LaTeX.\@gobbletwo}}%
  \global\let\LT@final@warn\relax}
%    \end{macrocode}
%      \end{macro}
%    \end{Map}
%
%    \begin{Map}{Typesetting a Map}
%
%      \Block{}%
%      \begin{environment}{Map}
%        The environment |Map|determines the appearance of a map. It is
%        implemented as a |longtable| environment which takes care for
%        the page breaks and inserts material at the end of the page
%        and the beginning of the new page upon page break.
%      \end{environment}
%    \begin{macrocode}
\def\Map#1{%
%    \end{macrocode}
%        First the messages of |longtable| are modified to show this
%        package name instead.
%    \begin{macrocode}
  \def\LT@err{\PackageError{limap}}%
  \def\LT@warn{\PackageWarning{limap}}%
%    \end{macrocode}
%      \Block{}%
%        The map local macro |\Block| is
%        activated. The counter for blocks is reset.
%    \begin{macrocode}
  \let\Block\Map@Block
  \let\endBlock\Map@endBlock
  \Map@blockcount=0
%    \end{macrocode}
%      \Block{}%
%      The number of the map in the internal counting is set by
%      incrementing the old value.
%    \begin{macrocode}
  \global\advance\Map@no1
%    \end{macrocode}
%      \Block{}%
%    
%    \begin{macrocode}
  \ifx\Map@UP\empty\else
    \immediate\write\@auxout
      {\string\expandafter\string\xdef\string\csname\space
        Map@parts@\Map@UP\string\endcsname{\string\csname\space 
          Map@parts@\Map@UP\string\endcsname\the\Map@no:}}%
  \fi
%    \end{macrocode}
%      \Block{}%
%    
%    \begin{macrocode}
  \edef\Map@UP{\the\Map@no}%
  \ifnum\Map@level>0
    \xdef\Map@@up{\Map@UP}% Just to save the value across blocks.
    \endgroup
    \Map@end
    \begingroup
    \edef\Map@UP{\Map@@up}%
    \def\@currenvir{Map}%
  \fi
  \edef\Map@this{\the\Map@no}%
%    \end{macrocode}
%      \Block{}%
%      The entries for future use of sub-maps are written to the |aux| file.
%    \begin{macrocode}
  \immediate\write\@auxout
    {\string\global\string\@namedef{Map@parts@\the\Map@no}{}}%
%    \end{macrocode}
%      \Block{}%
%    
%    \begin{macrocode}
  \global\advance\Map@level1
  \def\Map@TITLE{#1}%
  \Map@start
  }
%    \end{macrocode}
%      \Block{}%
%
%    \begin{macrocode}
\def\endMap{%
  \Map@end
  \global\advance\Map@level-1
  \ignorespaces
}
%    \end{macrocode}
%
%      \Block{}%
%      \begin{macro}{\ifMap@open@}
%        The conditional |\ifMap@open@| is used to record the opening
%        and closing of the |longtable| environment, since can not be
%        used inside itself. Thus it can be closed before a new
%        instance is opened.
%    \begin{macrocode}
\newif\ifMap@open@
\Map@open@false
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\Map@TOC@name}
%        The macros |\Map@TOC@name|\dots provide a mapping between a
%        number and a sectioning unit. This mapping is used when the
%        entry in the table of contents is generated.
%    \begin{macrocode}
\@namedef{Map@TOC@name0}{chapter}
\@namedef{Map@TOC@name1}{section}
\@namedef{Map@TOC@name2}{subsection}
\@namedef{Map@TOC@name3}{subsubsection}
\@namedef{Map@TOC@name4}{paragraph}
\@namedef{Map@TOC@name5}{subparagraph}
\@namedef{Map@TOC@name6}{subsubparagraph}
\@namedef{Map@TOC@name7}{subsubparagraph}
\@namedef{Map@TOC@name8}{subsubparagraph}
\@namedef{Map@TOC@name9}{subsubparagraph}
\@namedef{Map@TOC@name10}{subsubparagraph}
\@namedef{Map@TOC@name11}{subsubparagraph}
\@namedef{Map@TOC@name12}{subsubparagraph}
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\Map@start}
%        The macro |\Map@start| is used to initiate the use of a map.
%        It takes no arguments. The map title is passed in via the
%        macro |\Map@TITLE|.
%
%        It uses the |longtable| environment to perform the page
%        breaking and marking of continued pages.
%    \begin{macrocode}
\newcommand\Map@start{%
  \advance\Map@counter1
  \setlength{\Map@length}{\textwidth}%
  \addtolength{\Map@length}{-\MapTitleFraction\textwidth}%
  \addtolength{\Map@length}{-\MapTextFraction\textwidth}%
  \ifx\Map@TITLE\empty\else
    \MapTOC{\Map@TITLE}%
  \fi
  \longtable
    {@{}p{\MapTitleFraction\textwidth}@{\hspace{\Map@length}}
        p{\MapTextFraction\textwidth}@{}}%
      \multicolumn{2}{@{}p{\textwidth}@{}}{%
        \MapFont{\MapTitleFont\rule{0pt}{3ex}%
          \Map@TITLE}}
    \endfirsthead
      \multicolumn{2}{@{}p{\textwidth}@{}}{%
        \MapFont{\MapTitleFont\rule{0pt}{3ex}%
          \Map@TITLE\MapContinuedFormat{\MapContinued}}}%
    \endhead
    \\
      &\MapRuleStart
       \rule{\MapTextFraction\textwidth}{\MapRuleWidth}\newline
       \mbox{}\hfill
       \raisebox{3pt}{\MapContinuingFormat{\MapContinuing}}
    \endfoot
      &\MapRuleStart
       \rule{\MapTextFraction\textwidth}{\MapRuleWidth}%
       \vspace{\MapParskip}
    \endlastfoot
    \xdef\@currentlabel{\Map@TITLE}%
    \label{Map@\the\Map@no}%
    \global\Map@open@true
}
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\Map@end}
%        The macro |\Map@end| is expanded when the end of the end of
%        the |longtable| environment might be needed. The boolean
%        |\ifMap@open@| determines whether such an environment is
%        really open.
%    \begin{macrocode}
\newcommand\Map@end{%
  \ifMap@open@\vspace*{1.5ex}
    \global\Map@open@false
    \endlongtable
    \MapNewpage
  \fi
  \iftrue
   \ifnum\Map@blockcount>9
    \PackageWarning{limap}%
    {*** The current map contains too much blocks:
         \the\Map@blockcount}%
   \else\ifnum\Map@blockcount>7
    \PackageWarning{limap}%
    {--- The current map contains \the\Map@blockcount blocks.}%
   \fi\fi
  \fi
}
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\Map@UP}
%        The macro |\Map@UP| contains the number of the parent map or
%        the empty string.
%    \begin{macrocode}
\newcommand\Map@UP{}
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\Map@no}
%        The counter |\Map@no| contains the sequence number for all
%        maps. This value is used internally to reference single maps.
%    \begin{macrocode}
\newcount\Map@no
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\Map@counter}
%        The counter |\Map@counter| contains the number of a map in
%        the context of the containing map .
%    \begin{macrocode}
\newcount\Map@counter
\Map@counter=0
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\Map@parts@}
%        The macro |\Map@parts@| is used to store the parts of the
%        top-level maps. This is the initialization of a feature
%        otherwise used in the aux file.
%    \begin{macrocode}
\@namedef{Map@parts@}{}
%    \end{macrocode}
%    \end{macro}
%    \end{Map}
%
%    \begin{Map}{Typesetting a Block}
%
%      \Block{}%
%      Blocks are the basic building unit of maps. Here the Block is
%      defined in all it's beauty.
%
%      \begin{environment}{Map@Block}
%        This macro is used to typeset a block inside a Map. To avoid
%        abuse outside of a map it is activated within a Map only.
%        \changes{2.2}{2017/07/20}{|MapBlockStartHook| added.}
%    \begin{macrocode}
\newenvironment{Map@Block}[1]{\par
  \vspace*{-\parskip}\vspace*{-1ex}%
  \\\null\par
  \vspace*{\MapParskip}%
  \raggedright\hspace{0pt}\MapFont{\MapBlockLabelFont{#1}}%
  \gdef\@currentlabel{#1}%
  &\parskip=\MapParskip
  {\MapRuleStart
    \rule{\MapTextFraction\textwidth}{\MapRuleWidth}}\par
    \ifx\@undefined\MapBlockStartHook\else
      \MapBlockStartHook{#1}%
    \fi
%    \end{macrocode}
%
%      The final action is empty. Thus the block can be used as a simple
%      macro as well. 
%    \begin{macrocode}
}{%
}
%    \end{macrocode}
%      \end{environment}
%
%      \Block{}%
%      \begin{macro}{\Block}
%        The macro |\Block| issues an error when used outside of a Map
%        environment.
%    \begin{macrocode}
\newcommand\Block[1]{\PackageWarning{limap}{The sectioning command 
      `Block' has been encountered outside the scope of a Map
      environment.}}
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\WideBlock}
%        The macro |\WideBlock| takes one argument which is added to
%        the current block where the whole width of the table is used.
%    \begin{macrocode}
\newcommand\WideBlock{\\\multicolumn2{@{}l@{}}}
%    \end{macrocode}
%      \end{macro}
%    \end{Map}
%
%    \begin{Map}{Typesetting a Table of Contents}
%
%
%      \Block{}%
%    \begin{macrocode}
\newif\if@Map@toc@sep@
%    \end{macrocode}
%
%      \Block{}%
%      \begin{macro}{\MapTableOfContents@open}
%        The macro |\MapTableOfContents@open| produces the table of
%        contents for the current map. It produces a tabular
%        containing the titles and pages of all maps directly
%        contained in the current map. It utilizes a tabular
%        environment and booktabs.
%    \begin{macrocode}
\def\MapTableOfContents@open{%
  \centering
  \begin{tabular}{p{.6\textwidth}r}\toprule
    \MapTOCheadfont{\MapTOCname}&
    \MapTOCheadfont{\MapTOCpage}\\\midrule
    \ifcsdef{Map@parts@\the\Map@no}{
      \edef\Map@tmp@{\csname Map@parts@\the\Map@no\endcsname:}%
      \expandafter\Map@toc@loop\Map@tmp@
      \\\bottomrule
    }{}
  \end{tabular}
}
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\MapTableOfContents@boxed}
%        The macro |MapTableOfContents@boxed| produces the table of
%        contents for the current map. It produces a tabular
%        containing the titles and pages of all maps directly
%        contained in the current map. It utilizes a tabular
%        environment and booktabs.
%    \begin{macrocode}
\def\MapTableOfContents@boxed{%
  \centering
  \begin{tabular}{|p{.6\textwidth}|r|}\hline
    \MapTOCheadfont{\MapTOCname}&
    \MapTOCheadfont{\MapTOCpage}\\\hline
    \ifcsdef{Map@parts@\the\Map@no}{
      \edef\Map@tmp@{\csname Map@parts@\the\Map@no\endcsname:}%
      \expandafter\Map@toc@loop\Map@tmp@
      \\\hline
    }{}
  \end{tabular}
}
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\MapTableOfContentsStyle}
%        The macro |MapTableOfContentsStyle| determines the style of
%        the TOCs. It can take the values |open| or |boxed|.
%    \begin{macrocode}
\newcommand\MapTableOfContentsStyle{open}
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\MapTableOfContents}
%        The macro |MapTableOfContents| produces the table of
%        contents for the current map. It produces a tabular
%        containing the titles and pages of all maps directly
%        contained in the current map.
%    \begin{macrocode}
\newcommand\MapTableOfContents{\par
  \global\@Map@toc@sep@false
  \csname MapTableOfContents@\MapTableOfContentsStyle\endcsname
  \vspace*{-1.5\parskip}\par\ignorespaces
}
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{macro}{\Map@toc@loop}
%        The macro |\Map@toc@loop| is a recursive solution to loop
%        through all elements of a list of children. The argment is
%        expected to be a colon separated list of numbers. The end is
%        marked by two colons in row.
%
%        Each number is a reference to a map. The respective line in
%        the toc table is produced.
%    \begin{macrocode}
\def\Map@toc@loop#1:{%
  \def\Map@tmp@{#1}%
  \ifx\Map@tmp@\empty
    \global\let\Map@next@=\relax
  \else
    \if@Map@toc@sep@
    \gdef\Map@next@{\\
    \ref{Map@#1}&\pageref{Map@#1}%
    \Map@toc@loop}%
    \else
    \gdef\Map@next@{%
    \ref{Map@#1}&\pageref{Map@#1}%
    \Map@toc@loop}%
    \global\@Map@toc@sep@true
    \fi
  \fi
  \Map@next@
}
%    \end{macrocode}
%    \end{macro}
%    \end{Map}
%
%    \begin{Map}{Typesetting a Table}
%
%      \Block{}%
%      \begin{macro}{\MapTabularFraction}
%        The macro |\MapTabularFraction| contains a factor for the line
%        width. This is used to determine the width of the table. The
%        tabular is centered in the text column.
%    \begin{macrocode}
\newcommand\MapTabularFraction{.95}
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{environment}{MapTabular}
%        The environment |MapTabular| produces the |tabular| environment
%        with the width of the text column.
%    \begin{macrocode}
\newenvironment{MapTabular}{%
  \begin{center}
    \begin{tabular*}{\MapTabularFraction\linewidth}%
}{%
    \end{tabular*}
  \end{center}\ignorespaces
}
%    \end{macrocode}
%    \end{environment}
%    \end{Map}
%
%    \begin{Map}{Typesetting the Title Page}
%
%      \Block{}%
%      \begin{macro}{\MakeTitle}
%        The macro |\MakeTitle| can be used as a replacement for the
%        |\maketitle| macro.
%    \begin{macrocode}
\newcommand\MakeTitle{\thispagestyle{empty}
  \rule{0pt}{.25\textheight}\par
  \mbox{}\hfill
  \begin{minipage}{\MapTextFraction\textwidth}
    \raggedright
    \rule{\textwidth}{2pt}\par
    \vspace*{2.5\MapParskip}%
    \sf{\huge \@title\par}%
    \vspace*{2.5\MapParskip}%
    \rule{\textwidth}{2pt}\par
    \vspace*{2.5\MapParskip}%
    \MapFont{\large \@author}	\par
    \vspace*{2.5\MapParskip}%
    \MapFont{\footnotesize \@date}
    \vspace*{\MapParskip}%
  \end{minipage}%
  \vspace*{-22ex}%
  \par
}
%    \end{macrocode}
%      \end{macro}
%
%      \Block{}%
%      \begin{environment}{Abstract}
%        This macro is used to typeset the abstract.
%    \begin{macrocode}
\newenvironment{Abstract}{\vfill
  \par
  \mbox{}\hfill
  \begin{minipage}{\MapTextFraction\textwidth}\parskip=1ex
    \rule{\textwidth}{1pt}\medskip\par
%    \end{macrocode}
%
%    \begin{macrocode}
}{\par\rule{\textwidth}{1pt}
  \end{minipage}%
  \par
}
%    \end{macrocode}
%      \end{environment}
%
%      \Block{Use maketitle and abstract}%
%      The new |\maketitle| macro is activated for the class.
%
%    \begin{macrocode}
%<*class>
\let\maketitle\MakeTitle
\let\abstract\Abstract
\let\endabstract\endAbstract
%</class>
%    \end{macrocode}
%    \end{Map}
%
%    \begin{Map}{Final Actions}
%
%      \Block{Local configuration}%
%      Load the configuration file at the end if it can be found.
%    \begin{macrocode}
\InputIfFileExists{limap.cfg}{}{}
%    \end{macrocode}
%
%      \Block{}%
%      Finally we have to activate the proper settings for the chosen
%      language.
%    \begin{macrocode}
\csname LIMAP@SelectLanguage@\LIMAP@Language\endcsname
%    \end{macrocode}
%
%    \begin{macrocode}
\ifLIMAP@strict
  \def\chapter{\PackageWarning{limap}{The sectioning command 
      `chapter' is not available.}}
%  \def\section{\PackageWarning{limap}{The sectioning command 
%      `section' is not available.}}
  \def\subsection{\PackageWarning{limap}{The sectioning command
      `subsection' is not available.}}
  \def\subsubsection{\PackageWarning{limap}{The sectioning command
      `subsubsection' is not available.}}
  \def\paragraph{\PackageWarning{limap}{The sectioning command
      `paragraph' is not available.}}
  \def\subparagraph{\PackageWarning{limap}{The sectioning command
      `subparagraph' is not available.}}
  \def\subsubparagraph{\PackageWarning{limap}{The sectioning command
      `subsubparagraph' is not available.}}
\fi
%    \end{macrocode}
%
%      \Block{Finale}%
%      That's all for this time.
%    \end{Map}
%    \end{Map}
%    \end{Map}
%
%    \Finale
%
\endinput
%
% Local Variables: 
% mode: latex
% TeX-master: "limap.dtx"
% End: