From 19e58651e433cf99a092d2b7ce2689d7e573677f Mon Sep 17 00:00:00 2001
From: LLdaniel <daniel.adlkofer2@freenet.de>
Date: Sat, 4 May 2024 13:30:49 +0200
Subject: [PATCH] manually copied the current version user guide form master

---
 manual/moderncv_userguide.tex | 1372 ++++++++++++++++++++-------------
 1 file changed, 823 insertions(+), 549 deletions(-)

diff --git a/manual/moderncv_userguide.tex b/manual/moderncv_userguide.tex
index 68f9d96..46076ae 100644
--- a/manual/moderncv_userguide.tex
+++ b/manual/moderncv_userguide.tex
@@ -1,702 +1,976 @@
-%% moderncv_userguide.tex (compiled with pdfLaTeX)
-%% Copyright 2007 Cristina Sambo
+%% moderncv_userguide.tex as shipped with 2022/02/21 v2.3.1 modern curriculum vitae and letter document class (moderncv)
+%% 2021 David Seus, cryptointerest@posteo.de
 %
 % This work may be distributed and/or modified under the
 % conditions of the LaTeX Project Public License version 1.3c,
 % available at http://www.latex-project.org/lppl/.
 
-\documentclass[a4paper,11pt]{article}
+\documentclass[a4paper, 11pt]{article}
 
-\title{\bfseries Moderncv -- v. 0.6}
-\author{Package by Xavier Danaux \\ \begin{small}Documentation by Cristina Sambo \end{small}}
-\date{}
+\title{%
+  \texttt{moderncv} User Guide\\
+  {\small Package v2.3.1}%
+}
+% Cristina Sambo,
+\author{%
+  Package by Xavier Danaux\\
+  {\small Documentation by David Seus}%
+}
+\date{\today}
 
-%language and encoding options
+% Language and encoding options
 \usepackage[english]{babel}
-\usepackage[T1]{fontenc}
-\usepackage[latin1]{inputenc}
+\usepackage{ifxetex, ifluatex}
+\newif\ifxetexorluatex
+\ifxetex
+  \xetexorluatextrue
+\else
+  \ifluatex
+    \xetexorluatextrue
+  \else
+    \xetexorluatexfalse
+  \fi
+\fi
 
-%font options
+% PDFLaTeX or LUALaTeX/XeLaTeX
+\ifxetexorluatex
+  % \usepackage{luatextra}
+  % \usepackage{lualatex-math}
+  \usepackage{shellesc}   % Fix a bug for lualatex shellescape
+  % \usepackage{unicode-math}
+  % \setmathfont{xits-math.otf}
+\else
+  \usepackage[utf8]{inputenx}   % Uncomment if using pdflatex, comment if using lualatex
+\fi
+\PassOptionsToPackage{T1}{fontenc}  % T2A for Cyrillic
+\usepackage[T1]{fontenc}
+
+% Font options
 \usepackage{txfonts}
 \usepackage{marvosym}
 \usepackage{pifont}
 
-%margins, spacing and page layout
-\usepackage[pdftex,colorlinks=true]{hyperref} %(hyperref must be loaded before geometry)
-\usepackage[pdftex]{geometry}
+% Margins, spacing and page layout
+\usepackage[pdftex, colorlinks=true]{hyperref}  % hyperref must be loaded before geometry
+\usepackage[pdftex, marginparwidth=50pt]{geometry}
 \geometry{top=2.5cm, bottom=3cm}
-\setlength{\parindent}{0pt} %(to soppress indentation when starting a new paragraph)
-\frenchspacing %(to soppress additional space after a full stop)
+\usepackage{parskip}  % Replace paragraph indentation with vertical spacing
+\frenchspacing  % Suppress additional space after a full stop
+\renewcommand{\arraystretch}{1.1}
 
-%packages
-\usepackage[pdftex]{graphicx}
-\usepackage[pdftex]{xcolor}
-\usepackage[labelfont=sl,font=small,width=0.9\textwidth]{caption}
+% Packages
+\usepackage{graphicx}
+\usepackage{xcolor}
+\usepackage[labelfont=sl, font=small, width=0.9\textwidth]{caption}
 \usepackage{marvosym}
 \usepackage{latexsym}
+\usepackage{url}
+\usepackage{scrhack}  % Fix warnings when using KOMA with listings package
+\usepackage{xspace}   % Fix spacing after macros
+\usepackage{mparhack}   % Fix marginpar
+\usepackage{microtype}
+\usepackage{multicol}   % Multicolumn text for long lists
 
-%pdfLaTeX options
-\pdfpagewidth=\paperwidth
-\pdfpageheight=\paperheight
-\pdfimageresolution=150
-\pdfinfo{
-	/Title		(Moderncv -- v. 0.6)
-	/Author		(Cristina Sambo)
-	/Subject		(Moderncv package user's guide)
-	/Keywords	(curriculum vitae, LaTeX)
+% Code listings
+\usepackage{listings}
+% \lstset{emph={trueIndex, root}, emphstyle=\color{BlueViolet}}% \underbar}   % Special keywords
+\lstset{%
+  language=[LaTeX]Tex, % C++,
+  morekeywords={PassOptionsToPackage, selectlanguage},
+  keywordstyle=\color{cvblue}, % \bfseries,
+  basicstyle=\small\ttfamily,
+  % identifierstyle=\color{NavyBlue},
+  commentstyle=\color{gray}\ttfamily,
+  stringstyle=\rmfamily,
+  numbers=none, % left,
+  numberstyle=\scriptsize, % \tiny
+  stepnumber=5,
+  numbersep=8pt,
+  showstringspaces=false,
+  breaklines=true,
+  % frameround=ftff,
+  % frame=single,
+  belowcaptionskip=0.75\baselineskip,
+  % frame=L,
+  emph={
+    cvitem, cventry, cvdoubleentry, cvdoubleitem, cvlistitem, cvlistdoubleitem, cvcolumns, moderncvstyle, moderncvcolor,
+    cvskill, cvskilllegend, cvskillplainlegend, cvskillhead, cvskillentry, nopagenumbers,
+    name, born, address, email, link, social, phone, homepage, extrainfo, photo, quote, section, subsection, setlength, NewDocumentCommand, definecolor, colorlet, cvitemwithcomment
+  },
+  emphstyle={\color{cvblue}},
+  emph={[2]
+    familydefault, sfdefault, rmdefault, inputenc, moderncv, document, bibliographyitemlabel,
+    addresssymbol, mobilephonesymbol, fixedphonesymbol, faxphonesymbol, emailsymbol, homepagesymbol, linkedinsocialsymbol,
+    xingsocialsymbol, twittersocialsymbol, githubsocialsymbol, gitlabsocialsymbol,
+    stackoverflowsocialsymbol, bitbucketsocialsymbol, skypesocialsymbol, orcidsocialsymbol, researchgatesocialsymbol, arxivsocialsymbol, inspiresocialsymbol,
+    researcheridsocialsymbol, telegramsocialsymbol, whatsappsocialsymbol, signalsocialsymbol, matrixsocialsymbol, googlescholarsocialsymbol, cvstretchability, bornsymbol
+  },
+  emphstyle={[2]\color{cvblue!60!cvgrey}\bfseries},
+  literate={{é}{{\'e}}1},
 }
 
-%my commands
-\definecolor{bluecv}{rgb}{0.25,0.5,0.75}
-\definecolor{greencv}{rgb}{0.55,0.85,0.35}
-\definecolor{redcv}{rgb}{1.00,0.30,0.30}
-\definecolor{orangecv}{rgb}{1,0.65,0.20}
-\definecolor{greycv}{rgb}{0.75,0.75,0.75}
+% Hyperlinks
+\usepackage{hyperref}
+\hypersetup{
+  unicode=true,
+  % draft,  % Draft mode for printing (see below)
+  colorlinks=true, linktocpage=true, pdfstartpage=3, pdfstartview=FitV,
+  % colorlinks=false, linktocpage=false, pdfstartpage=3, pdfstartview=FitV, pdfborder={0 0 0},  % Black links (e.g., for printing)
+  breaklinks=true, pageanchor=true,
+  pdfpagemode=UseNone,
+  % pdfpagemode=UseOutlines,
+  plainpages=false, bookmarksnumbered, bookmarksopen=true, bookmarksopenlevel=1,
+  hypertexnames=true, pdfhighlight=/O, % nesting=true, frenchlinks,
+  urlcolor=cvblue, linkcolor=cvblue, citecolor=cvblue, % pagecolor=RoyalBlue,
+  % urlcolor=Black, linkcolor=Black, citecolor=Black, % pagecolor=Black,
+  % pdfborder={0 0 1},  % Width of PDF link border 0 0 1, 0 0 0 = colorlinks
+  % linkbordercolor=gray!15,
+  % citebordercolor=green!15,
+}
 
-%==================
+% Colors
+\definecolor{cvblue}{rgb}{0.22, 0.45, 0.70}
+\definecolor{cvgreen}{rgb}{0.35, 0.70, 0.30}
+\definecolor{cvred}{rgb}{0.95, 0.20, 0.20}
+\definecolor{cvorange}{rgb}{0.95, 0.55, 0.15}
+\definecolor{cvgrey}{rgb}{0.75, 0.75, 0.75}
+\definecolor{cvburgundy}{rgb}{0.596078, 0, 0}   % burgundy: 139/255 (0.545098) or 152/255 (0.596078)
+\definecolor{cvgrey}{rgb}{0.55, 0.55, 0.55}
+\definecolor{cvpurple}{rgb}{0.50, 0.33, 0.80}
+
+% Macros
+\newcommand{\todo}[1]{\marginpar{\raggedright \textcolor{red}{[\textbf{TODO:} #1]}}}
+\newcommand{\todox}[1]{\textcolor{red}{[\textbf{TODO:} #1]}}
+\newcommand{\note}{\paragraph{Note.}}
+\newcommand{\code}[1]{\lstinline!#1!}
+\newcommand{\moderncv}{\code{moderncv}}
+\newcommand{\Moderncv}{\moderncv~}
+\newcommand{\github}{GitHub}
+\newcommand{\Github}{\github~}
+\newcommand{\ctan}{CTAN}
+\newcommand{\Ctan}{\ctan~}
+\newcommand{\cvtemplate}{\code{template.tex}}
+\newcommand{\Cvtemplate}{\cvtemplate~}
+\newcommand{\Latex}{\LaTeX~}
+\newcommand{\biblatex}{BibLaTeX}
+\newcommand{\Biblatex}{\biblatex~}
+\newcommand{\cvdoccolorbox}[1]{{\color{#1}\rule{4ex}{2ex}}}
+\newcommand{\moderncvGithub}{\url{https://github.com/moderncv/moderncv}}
+\newcommand{\moderncvCtan}{\url{https://ctan.org/pkg/moderncv}}
+
+
+
+
+
+% ==================
 % DOCUMENT BEGINNING
-%==================
+% ==================
 \begin{document}
 \maketitle
-
 \begin{abstract}
-\noindent \texttt{Moderncv}, as its author says in the readme file, provides a documentclass for typesetting modern curriculum vitaes in various styles. It is fairly customizable, allowing you to define your own style by changing the colors, the fonts, \dots\ and provides two default styles: classic and casual.
+  \noindent
+  The \Moderncv package provides a document class for typesetting modern curriculum vit\ae{} and cover letters in various styles.
+  Five predefined styles are available, each of which can be adjusted through various options for headings, footers and colors.
+  It is fairly customizable, allowing the user to adjust the look and feel of each style to their liking.
+  Several macros allow the user to add content to the CV and format it in a consistent way.
+  A letter of motivation consistent with the style is part of the template as well.
 \end{abstract}
+\tableofcontents
 
-\section{Introduction}
-When I saw for the first time this class I was amazing: ``Here it is what I need'', I thought. Using the very clear examples, was easy to make my first curriculum. 
-Indeed the class is very simple to use, in this documentation I will only put together all the things to help users to have all on hand.
 
-\smallskip
-\texttt{Moderncv} requires the following packages: \texttt{ifthen}, \texttt{ifpdf}, \texttt{color}, \texttt{lmodern}, \texttt{marvosym}, \texttt{url}, \texttt{hyperref}, \texttt{longtable}, \texttt{graphicx}, \texttt{fancyhdr}, usually all just included in the \LaTeX\ distributions.
 
-\section{In the preamble}
+\section{Getting started}
+\subsection{How to read this manual}
+This manual is organized as follows.
+The current section explains on how to get started with the \Moderncv package, i.e. how to install required packages.
+% \emph{Note that it is assumed that you know how to install \Latex packages in case some are missing.}
+Section \ref{section:moderncvTemplate} explains how to work with the \Moderncv template file step by step.
+Section \ref{section:customization} details the customizations that the user can make: the different styles, their options, colors and tips and tricks.
+Section \ref{section:implementationDetails} details the packages that \Moderncv uses, known problems and possible solutions to those problems.
 
-At the very beginning of your preamble (that is the part before \verb|\begin{document}|) insert:
+\subsection{Installation instructions}
+If the \Moderncv package does not ship with your \Latex distribution or if the installed version is too old, grab the \Moderncv code from \Ctan or \github:
 
-\begin{verbatim}
-\documentclass[<options>]{moderncv}
-\end{verbatim} 
+\begin{tabular}{l}
+  \moderncvCtan \\% [.5ex]
+  \moderncvGithub
+\end{tabular}
 
-where the options are:
+\note Depending on your \Latex distribution, you may have to install some additional packages.
+Section \ref{section:implementationDetails:requiredPackages} lists all the packages that \Moderncv requires to be installed on your system.
 
-\begin{description}
- \item[paper size options:] \texttt{a4paper}, \texttt{a5paper}, \texttt{b5paper}, \texttt{letterpaper}, \texttt{legalpaper}, \texttt{ex\-ec\-u\-tive\-pa\-per}, \texttt{landscape}
- \item[font size options:] \texttt{10pt}, \texttt{11pt}, \texttt{12pt}
- \item[font option:] \texttt{nolmodern}, for people without the latin modern fonts
- \item[color option:] \texttt{nocolor}, to have all in black and white
- \item[draft/final options:] \texttt{draft}, \texttt{final}
-\end{description}
 
-The default options are: \texttt{a4paper}, \texttt{11pt}, \texttt{color}, \texttt{final}. 
 
-After the documentclass specification, choose the theme for your curriculum vit\ae:
+\section{The \texttt{moderncv} template step by step}
+This section is a quick reference to the \Moderncv package and should contain enough information to typeset a first working CV.
+\label{section:moderncvTemplate}
+The easiest way to get started with \Moderncv is to use the template that comes with the package.
+If \Moderncv is part of your \Latex distribution, search for the folder \Moderncv on your system, which should contain all the files for the package.
+In this folder, there should be a file called \cvtemplate.
+If you downloaded the package from \Github or \ctan, look for \Cvtemplate in the folder of the newly downloaded (and possibly extracted) package.
 
-\begin{verbatim}
-\moderncvtheme[<options>]{casual}
-\end{verbatim} 
+\note If you downloaded \Moderncv from \Github or \Ctan and moved \Cvtemplate to another folder, make sure to adjust the \code{TEXINPUTS} variable to find the newly downloaded package.
+Otherwise, either the package version provided by your \Latex distribution gets used or \Latex throws an error if there is no other version installed.
 
-which is the default theme, or
+Test your setup by compiling \Cvtemplate and looking at the result.
 
-\begin{verbatim}
-\moderncvtheme[<options>]{classic}
-\end{verbatim} 
+\note The \Moderncv package should compile with \code{pdflatex}, \code{lualatex} and \code{xelatex}.
+However, not all icons are available when using \code{pdflatex}, so using either \code{lualatex} or \code{xelatex} \emph{is highly recommended.}
 
-where the theme options are:
+\subsection{Basic setup}
+A document using the \Moderncv document class is set up like any other document class.
+We will go through the template step by step.
 
-\begin{description}
- \item[color options:] you can choose between five color: 
-	\begin{itemize}
-	 \item[\texttt{blue}] {\color{bluecv}\rule{1cm}{2ex}} (default color)
-	 \item[\texttt{green}] {\color{greencv}\rule{1cm}{2ex}}
-	 \item[\texttt{red}] {\color{redcv}\rule{1cm}{2ex}}
-	 \item[\texttt{orange}] {\color{orangecv}\rule{1cm}{2ex}}
-	 \item[\texttt{grey}] {\color{greycv}\rule{1cm}{2ex}}
-	\end{itemize}
- \item[roman option:] \texttt{roman}, for {\fontsize{11}{12} \usefont{T1}{lmr}{m}{n}\selectfont roman} fonts, instead of \fontsize{11}{12} \usefont{T1}{lmss}{m}{n}\selectfont sans serif fonts.
-\end{description}
+\subsubsection*{Configuring document class options}
+The \Moderncv document class is loaded as per usual, by
+\begin{lstlisting}
+  \documentclass[<options>]{moderncv}
+\end{lstlisting}
+where at most one value for each option can be passed to the document class:
 
-Then you have to specify the character encoding (utf8, latin1, and so on):
+\begin{tabular}{r@{\hspace{2ex}}p{0.55\textwidth}}
+  \textbf{\code{paper}:}       & \code{a4paper} (default), \code{a5paper}, \code{b5paper}, \code{letterpaper},
+  \code{legalpaper}, \code{executivepaper}, \code{landscape} \\
+  \textbf{\code{font family}:} & \code{sans}, \code{roman} \\
+  \textbf{\code{font size}:}   & \code{10pt}, \code{11pt} (default), \code{12pt} \\
+  \textbf{\code{draft/final}:} & \code{draft}, \code{final} (default)
+\end{tabular}
 
-\begin{verbatim}
-\usepackage[<your encoding>]{inputenc}
-\end{verbatim} 
+\subsubsection*{Choosing a \texttt{moderncv} style and color}
+Choose a \Moderncv style and color by adjusting the commands
+\begin{lstlisting}
+  \moderncvstyle{<style>}
+  \moderncvcolor{<color>}
+\end{lstlisting}
+As explained in \cvtemplate, the possible values are
 
-and you can adjust the page geometry:
+\begin{tabular}{r@{\hspace{2ex}}p{0.65\textwidth}}
+  \textbf{\code{style}:} & \code{casual} (default), \code{classic}, \code{banking}, \code{oldstyle},
+  \code{fancy} \\
+  \textbf{\code{color}:} & \code{black} \cvdoccolorbox{black}, \code{blue} \cvdoccolorbox{cvblue} (default), \code{burgundy} \cvdoccolorbox{cvburgundy}, \code{green} \cvdoccolorbox{cvgreen}, \code{grey} \cvdoccolorbox{cvgrey}, \code{orange} \cvdoccolorbox{cvorange}, \code{purple} \cvdoccolorbox{cvpurple}, \code{red} \cvdoccolorbox{cvred}
+\end{tabular}
 
-\begin{verbatim}
-\usepackage[<options>]{geometry}
-\recomputelengths
-\end{verbatim} 
+\note Some of the styles take additional options to fine-tune their appearance.
+To keep this overview short, these options will be described in section \ref{section:customization:stylesAndOptions}.
 
-where \verb|\recomputelengths| is required when changes are made to page layout lengths.
+\subsubsection*{Font family and page numbering}
+The default font family is set by the line \code{\\renewcommand\{\\familydefault\}\{\\sfdefault\}} in \cvtemplate.
+Use \code{\\sfdefault} for the default sans-serif font, \code{\\rmdefault} for the default roman font, and likewise for any \TeX{} font name.
+The general syntax is
+\begin{lstlisting}
+  \renewcommand{\familydefault}{<fontfamily>}
+  % \nopagenumbers{}
+\end{lstlisting}
+Uncommenting \code{\%\\nopagenumbers\{\}} suppresses automatic page numbering for CVs longer than one page.
 
-Now we can get into the part most related to our curriculum vit\ae: our personal data. They will be inserted in the header of the first page, in the classic theme, or in the footer of every page, in the case of casual theme.
+\subsubsection*{Adjusting input encoding}
+If you are not using \code{xelatex} or \code{lualatex}, which both use \code{utf8} encoding by default, uncomment the \code{\\usepackage[utf8]\{inputenc\}} import and change the encoding as needed.
 
+\subsubsection{Language-specific setup}
+The \code{babel} package can be loaded in the preamble of your CV.
+
+\note \Moderncv doesn't work with \code{babel} in Spanish (see this \href{https://github.com/moderncv/moderncv/issues/103}{GitHub issue}).
+
+For CJK users, uncomment the \code{\\usepackage\{CJKutf8\}} import.
+
+\subsection{Personal data}
+Edit the personal data section to reflect your personal information.
+This data will appear in the header of the first page of the CV and/or in the footer of every page, as well as on the cover letter.
+Most of the commands are optional, so try out what you like and see what you need.
+
+\paragraph{\code{\\name}}
+A command for your name. Takes the given name and surname as arguments.
+\begin{lstlisting}
+  \name{<given name>}{<surname>}
+\end{lstlisting}
+
+\paragraph{\code{\\title}}
+A command for a document title. Could be used for a generic CV title, job title, etc.
+\begin{lstlisting}
+  \title{<title>}
+\end{lstlisting}
+
+\paragraph{\code{\\born}}
+A command for a birth date.
+\begin{lstlisting}
+  \born{<birth date>}
+\end{lstlisting}
+
+\paragraph{\code{\\address}}
+A command for a three-lined street address.
+\begin{lstlisting}
+  \address{<street address>}{<city and postcode>}{<country>}
+\end{lstlisting}
+
+\paragraph{\code{\\phone}}
+A command for a phone number. Takes the phone type as an optional argument.
+\begin{lstlisting}
+  \phone[<type>]{<phone number>}
+\end{lstlisting}
+The allowed values for \code{<type>} are \code{fax}, \code{fixed} and \code{mobile}.
+
+\paragraph{\code{\\email}}
+A command for an email address.
+\begin{lstlisting}
+  \email{<email address>}
+\end{lstlisting}
+
+\paragraph{\code{\\homepage}}
+A command for a personal website.
+\begin{lstlisting}
+  \homepage{<web address>}
+\end{lstlisting}
+
+\paragraph{\code{\\social}}
+A command for a social media account.
+Takes the platform as an optional argument.
+\begin{lstlisting}
+  \social[<platform>]{<username or handle>}
+\end{lstlisting}
+The following values are supported for \code{<platform>}:
 \begin{itemize}
-\item \verb|\firstname{John}|
-\item \verb|\familyname{Doe}|
-\item \verb|\title{Resum\'e title}|: optional
-\item \verb|\address{street and number}{postcode city}|: optional 
-\item \verb|\mobile{mobile}|: optional
-\item \verb|\phone{phone}|: optional
-\item \verb|\fax{fax}|: optional
-\item \verb|\email{email}|: optional
-\item \verb|\extrainfo{additional information}|: optional; here you can put, for example, the address of your website
-\item \verb|\photo[64pt]{picture}|: optional; \texttt{64pt} is the height the picture, you can set here the size you prefer; \texttt{picture} is the name of the picture file
-\item \verb|\quote{Some quote}|: optional
-\end{itemize} 
-
-Finally you can suppress automatic page numbering for CVs longer than one page:
-
-\begin{verbatim}
-\nopagenumbers{}
-\end{verbatim} 
-
-\subsection{Examples}
-
-In practice, you will type:
-
-\begin{verbatim}
-\documentclass[11pt,a4paper]{moderncv}
-
-% moderncv themes
-\moderncvtheme[green]{casual}
-
-% character encoding
-\usepackage[utf8]{inputenc}
-
-% adjust the page margins
-\usepackage[scale=0.8]{geometry}
-\recomputelengths
-
-% personal data 
-\firstname{John}
-\familyname{Doe}
-\title{Design enthusiast}
-\address{12 somestreet}{3456 somecity}
-\mobile{+123 456 7890}
-\phone{+12 (3)456 78 90}
-\fax{+12 (3)456 78 90}
-\email{jdoe@design.org}
-\extrainfo{\weblink{www.ctan.org}}
-\photo[64pt]{jdoe_picture}
-\quote{Any intelligent fool can make things bigger, more complex, 
-and more violent. It takes a touch of genius -- and a lot of courage -- to 
-move in the opposite direction.}
-
-\begin{document}
-\maketitle
-
-... <what you'll see in the next section>
-
-\end{document}
-\end{verbatim}
-
-to obtain a casual moderncv in green, as shown in figure \ref{fig:casual}, and you will substitute the line describing the theme with:
-
-\begin{verbatim}
-% moderncv themes
-\moderncvtheme[blue]{classic}
-\end{verbatim}
-
-to obtain a classic moderncv in blue, as shown in figure \ref{fig:classic}.
-
-
-\begin{figure}[p]
- \centering
- \fbox{\includegraphics[angle=90,width=\textwidth]{cv_casual.pdf}}
- \caption{An example of casual moderncv in green.}
- \label{fig:casual}
-\end{figure}
-
-\begin{figure}[p]
- \centering
- \fbox{\includegraphics[angle=90,width=\textwidth]{cv_classic.pdf}}
- \caption{An example of classic moderncv in blue.}
- \label{fig:classic}
-\end{figure}
-
-\section{Customize sections}
-
-Now we are ready to edit the part between \verb|\begin{document}| and \verb|\end{document}|.
-
-As you can seen in figure \ref{fig:casual} e \ref{fig:classic}, you can divide your CV into sections, each of them describing what you are, what you know and what you have done in your life. Every section is divide into items chosen from different flavours. More in details:
-
-\subsection{Section}
-
-The command to open a new section is: 
-
-\begin{verbatim}
-\section{<title>}
-\end{verbatim}
-
-and every section can be divided into subsections:
-
-\begin{verbatim}
-\subsection{<title>}
-\end{verbatim}
-
-If necessary, there is a command to close the section: 
-
-\begin{verbatim}
-\closesection{}
-\end{verbatim}
-
-and even one to create an empty section:
-
-\begin{verbatim}
-\emptysection{}
-\end{verbatim}
-
-An example of their usage can be the next one:
-
-\begin{verbatim}
-\section{Section with your own content}\closesection
-Your content here, inside the normal \LaTeX{} environment. 
-You can use any regular \LaTeX{} command, display mathematics
-\[e =m\,c^2,\]
-put some table or figure, \dots
-
-\emptysection{}
-\cvitem{Now}{Back to moderncv layout, without making a new section :-)}
-\end{verbatim}
-
-whose results is shown in figure \ref{fig:ex_sec}.
-
-\begin{figure}[!ht]
- \centering
- \fbox{\includegraphics[width=0.9\textwidth]{ex_sec}}
- \caption{Example of usage of section commands.}
- \label{fig:ex_sec}
-\end{figure}
-
-\subsection{Items}
-
-Inside sections, you can choose between different kind of items depending on the purpose:
-
-\begin{itemize}
- \item in the sections describing your education or your job experiences, you can use:
- \begin{verbatim}
-\cventry{years}{degree/job title}{institution/employer}
-{localization}{optional: grade/...}
-{optional: comment/job description}
-  \end{verbatim} 
-\vspace{-20pt}  
-where the last three arguments can be left empty
- \item inside `language' cvsection environment, you can type every entry with:
- \begin{verbatim}
-\cvlanguage{name}{level}{comment}
- \end{verbatim}
- \item inside `computer skills' cvsection environment, you can type every entry with:
- \begin{verbatim}
-\cvcomputer{category}{programs}{category}{programs}
- \end{verbatim}
- \item to typeset lines with a hint on the left:
- \begin{verbatim}
-\cvline{leftmark}{text}
- \end{verbatim}
- \item to typeset entry with a description on the left, but in two columns inside a cvsection:
- \begin{verbatim}
-\cvdoubleitem{subtitle}{text}{subtitle}{text}
- \end{verbatim}
- \item to typeset lists on one column inside a cvsection:
- \begin{verbatim}
-\cvlistitem{point1}
- \end{verbatim}
- \item to typeset lists on two columns inside a cvsection:
- \begin{verbatim}
-\cvlistdoubleitem{point1}{point2}
- \end{verbatim}
- \item to add a section listing all your publications stored in a BibTeX file:
- \begin{verbatim}
-\nocite{*}
-\bibliographystyle{plain}
-\bibliography{BibTeX_file}
- \end{verbatim}
-\vspace{-20pt}
- where the name of the section title can be changed by redefining the \texttt{refname} with  \verb|\renewcommand{\refname}{<new_name>}|
+  \begin{multicols}{4}
+    \item \code{arxiv}
+    \item \code{battlenet}
+    \item \code{bitbucket}
+    \item \code{codeberg}
+    \item \code{discord}
+    \item \code{github}
+    \item \code{gitlab}
+    \item \code{googlescholar}
+    \item \code{inspire}
+    \item \code{instagram}
+    \item \code{linkedin}
+    \item \code{mastodon}
+    \item \code{matrix}
+    \item \code{orcid}
+    \item \code{playstation}
+    \item \code{researcherid}
+    \item \code{researchgate}
+    \item \code{signal}
+    \item \code{skype}
+    \item \code{soundcloud}
+    \item \code{stackoverflow}
+    \item \code{steam}
+    \item \code{telegram}
+    \item \code{tiktok}
+    \item \code{twitch}
+    \item \code{twitter}
+    \item \code{whatsapp}
+    \item \code{xbox}
+    \item \code{xing}
+    \item \code{youtube}
+  \end{multicols}
 \end{itemize}
 
-\subsubsection*{Example}
+\paragraph{\code{\\extrainfo}}
+A command for any extra information.
+\begin{lstlisting}
+  \extrainfo{<extra information>}
+\end{lstlisting}
 
-Let's put all together and see in figure \ref{fig:sections} what is the result:
+\paragraph{\code{\\photo}}
+A command for a photo.
+Takes the image file name as a required argument.
+Takes the height of the photo and the thickness of the photo frame as optional arguments.
+\begin{lstlisting}
+  \photo[<photo height>][<frame thickness>]{<photo file name>}
+\end{lstlisting}
 
-\begin{verbatim}
-... preamble ...
-\begin{document}
-\section{Education}
-\cventry{year--year}{Degree}{Institution}{City}{\textit{Grade}}{Description}
-\cventry{year--year}{Degree}{Institution}{City}{\textit{Grade}}{Description}
-% 
-\section{Master thesis}
-\cvline{title}{\emph{Title}}
-\cvline{supervisors}{Supervisors}
-\cvline{description}{\small Short thesis abstract}
-% 
-\section{Experience}
-\subsection{Vocational}
-\cventry{year--year}{Job title}{Employer}{City}{}{Description}
-\cventry{year--year}{Job title}{Employer}{City}{}{Description}
-\subsection{Miscellaneous}
-\cventry{year--year}{Job title}{Employer}{City}{}%
-  {Description line 1\newline{}Description line 2}
-% 
-\section{Languages}
-\cvlanguage{language 1}{Skill level}{Comment}
-\cvlanguage{language 2}{Skill level}{Comment}
-% 
-\section{Computer skills}
-\cvcomputer{category 1}{XXX, YYY, ZZZ}{category 3}{XXX, YYY, ZZZ}
-\cvcomputer{category 2}{XXX, YYY, ZZZ}{category 4}{XXX, YYY, ZZZ}
-% 
-\section{Interests}
-\cvline{hobby 1}{\small Description}
-\cvline{hobby 2}{\small Description}
-\cvline{hobby 3}{\small Description}
-% 
-\closesection{}
-\pagebreak
-%
-\section{Extra}
-\cvlistitem{Item 1}
-\cvlistitem{Item 2}
-\cvlistitem{Item 3}
-%
-\section{Extra 2}
-\cvlistdoubleitem{Item 1}{Item 4}
-\cvlistdoubleitem{Item 2}{Item 5}
-\cvlistdoubleitem{Item 3}{}
-%
-% Publications from a BibTeX file
-\nocite{*}
-\bibliographystyle{plain}
-\bibliography{publications}  % 'publications' is the name of a BibTeX file 
-%
-\end{document}
-\end{verbatim} 
+\paragraph{\code{\\quote}}
+A command for a quote.
+\begin{lstlisting}
+  \quote{<quote>}
+\end{lstlisting}
 
-\begin{figure}[!ht]
- \centering
- \fbox{\includegraphics[angle=90,width=\textwidth]{test_cvsection2.pdf}}\\
- \fbox{\includegraphics[angle=90,width=\textwidth]{test_cvsection1.pdf}} 
-\caption{Example of usage of items inside cvsections.}
- \label{fig:sections}
-\end{figure}
+\todox{explain adding pictures}
 
-\section{More customizations}
+\todox{Add note about how to handle long names and long URLs. Is this handled correctly?}
 
-You have some useful commands to personalize your CV further.
+\paragraph{Bibliography.}
+In case BibTeX is used, the bibliography settings are adjusted in the lines
+\begin{lstlisting}
+  % to show numerical labels in the bibliography (default is to show no labels)
+  % \renewcommand*{\bibliographyitemlabel}{[\arabic{enumiv}]}
+  % \renewcommand{\refname}{Articles}
 
-\subsection*{Modifying the symbols}
-You can modify the symbols used for the personal data (phone number, the email, \ldots) redefining \texttt{phonesymbol}, \texttt{emailsymbol}, \texttt{addresssymbol}, \texttt{mobilesymbol}, \texttt{faxsymbol}.
+  % bibliography with mutiple entries
+  % \usepackage{multibib}
+  % \newcites{book, misc}{{Books}, {Others}}
+\end{lstlisting}
+By default, no labels are shown for bibliography entries.
+Uncommenting the line \code{\%\\renewcommand*\{\\bibliographyitemlabel\}\{[\\arabic\{enumiv\}]\}}
+allows one to fine-tune the labels.
+Uncommenting the line \code{\%\\renewcommand\{\\refname\}\{Articles\}} allows one to redefine the bibliography heading string ``Publications'' that is shown by default.
+Finally, adjustments using the \code{multibib} package can be done in the last two lines shown here.
 
-For example: if you want to use the dingbat fonts, load the \texttt{pifont} package in the preamble, then substitute the default symbol \Telefon\ with the dingbat symbol \ding{38}\ by:
-\begin{verbatim}
-\renewcommand{\phonesymbol}{\ding{38}}
-\end{verbatim} 
+\note \Biblatex is currently not supported.
 
-You can change the symbol for lists in two way:
+\subsection{Modifying CV content}
+\subsubsection{Structuring the CV}
+As with any other document style, the CV can be structured into sections and subsections using \code{\\section} and \code{\\subsection}.
+
+The \Moderncv package provides some macros to add content to your CV.
+The easiest way to understand their intended use is to look at how they're used in the template.
+Nonetheless, we list the macros here along with a short description of their intended use.
+
+\subsubsection{General macros}
+
+\paragraph{\code{\\cvitem}}
+A flexible command for a single CV entry.
+Takes the descriptor and body text as required arguments.
+Can be used to list job experiences and similar.
+\begin{lstlisting}
+  \cvitem{<descriptor>}{<body>}
+\end{lstlisting}
+
+\paragraph{\code{\\cvdoubleitem}}
+A two-column variation of \code{\\cvitem}.
+Takes four required arguments: the descriptor and body text of the first column and the descriptor and body text of the second column.
+Can be used to enter skills, such as computer skills or language skills, in a two-column fashion.
+\begin{lstlisting}
+  \cvdoubleitem{<descriptor 1>}{<body 1>}{<descriptor 2>}{<body 2>}
+\end{lstlisting}
+
+\paragraph{\code{\\cvitemwithcomment}}
+A variation of \code{\\cvitem} with an additional argument for a comment.
+Can be used to enter skills such as computer skills or language skills.
+\begin{lstlisting}
+  \cvitemwithcomment{<descriptor>}{<skill level>}{<comment>}
+\end{lstlisting}
+
+\paragraph{\code{\\cventry}}
+A command for entering an education or job experience.
+Takes six required arguments: date(s), degree/job title, educational institution/employer, city, academic grade and description.
+While arguments 3 to 6 aren't optional, they can be left empty.
+If line breaks in argument 6 aren't done properly, a minipage can be used.
+Alternatively, \code{\\newline\{\}} can be used to break lines in argument 6.
+\begin{lstlisting}
+  \cventry{<year--year>}{<degree/job title>}{<institution/employer>}
+      {<city>}{<grade>}{<description>}
+\end{lstlisting}
+
+\paragraph{\code{\\cvlistitem}}
+A command for a single bullet-list item.
+Very long lines get broken.
+\begin{lstlisting}
+  \cvlistitem{<item>}
+\end{lstlisting}
+
+\paragraph{\code{\\cvlistdoubleitem}}
+A two-column variation of \code{\\cvlistitem}.
+\begin{lstlisting}
+  \cvlistdoubleitem{<item 1>}{item 2>}
+\end{lstlisting}
+
+\paragraph{\code{\\cvcolumns}}
+An environment typesetting multicolumn \code{\\cvitem}s.
+This can be combined with the \code{itemize} environment.
+\begin{lstlisting}
+  \begin{cvcolumns}
+    \cvcolumn{<category 1>}{<content>}
+    \cvcolumn{<category 2>}{<content>}
+    \cvcolumn[<width>]{<content>}
+  \end{cvcolumns}
+\end{lstlisting}
+\code{<width>} is a number between 0 and 1 controling the width of the column.
+
+\subsubsection{Skill matrix macros}
+The skill matrix is a table for displaying skills such as computer skills or project management skills graphically.
+The skill matrix table consists of several elements:
 \begin{itemize}
- \item redefining the command \texttt{listitemsymbol}: \verb|\renewcommand{\listitemsymbol}{-}|
- \item adding a specification for the label in \texttt{cvlistitem} and \texttt{cvlistdoubleitem}
+  \item the graphical representation of the skill on a scale from 0 to 5,
+  \item the legend to explain the meaning of the scale,
+  \item a header line to explain the meaning of the table columns and
+  \item the actual skill entries.
 \end{itemize}
 
-For example: the  following code produces the result shown in figure \ref{fig:ex_items}.
+\paragraph{\code{\\cvskill}}
+A command for the graphical representation of a single skill.
+The required argument must be a number from 0 to 5.
+\begin{lstlisting}
+  \cvskill{<0-5>}
+\end{lstlisting}
+This command can be used outside of the skill matrix, too.
 
-\begin{verbatim}
-\closesection{}                   % needed to renewcommands
-\renewcommand{\listitemsymbol}{-} % change the symbol for lists
+\paragraph{\code{\\cvskilllegend}}
+A command for a legend for the skill matrix.
+Takes six optional arguments: post-padding width and the descriptions for the five skill levels.
+\begin{lstlisting}
+  \cvskilllegend
+  \cvskilllegend*[<post-padding>][<level 1>][<level 2>][<level 3>]
+      [<level 4>][<level 5>]{<descriptor>}
+\end{lstlisting}
+The command with no arguments inserts the legend in its standard form: without a descriptor or any lines.
+An optional asterisk toggles the inclusion of a dashed line.
+\code{<post-padding>} must be a valid length like \code{1em} or \code{1ex}.
 
-\section{Extra 1}
-\cvlistitem{Item 1}
-\cvlistitem{Item 2}
-\cvlistitem[+]{Item 3}            % optional other symbol
+The most general form of this command can be used to translate the legend descriptions into other languages or to add a name descriptor:
+\begin{lstlisting}
+  % Example: German translation
+  \cvskilllegend[0.2em][Grundkenntnisse]
+      [Grundkenntnisse und eigene Erfahrung in Projekten]
+      [Umfangreiche Erfahrung in Projekten]
+      [Vertiefte Expertenkenntnisse][Experte/Guru]{Legende}
+\end{lstlisting}
 
-\section{Extra 2}
-\cvlistdoubleitem[\Neutral]{Item 1}{Item 4}
-\cvlistdoubleitem[\Neutral]{Item 2}{Item 5}
-\cvlistdoubleitem[\Neutral]{Item 3}{}
-\end{verbatim} 
+\paragraph{\code{\\cvskillplainlegend}}
+A variation of \code{\\cvskilllegend} with the first three skill levels in the first column.
+\begin{lstlisting}
+  \cvskillplainlegend
+  \cvskillplainlegend*[<post-padding>][<level 1>][<level 2>]
+      [<level 3>][<level 4>][<level 5>]{<descriptor>}
+\end{lstlisting}
 
-\begin{figure}[!hbt]
- \centering
- \fbox{\includegraphics[width=.8\textwidth]{ex_items.png}}
- \caption{Example of customization of the list labels.}
- \label{fig:ex_items}
-\end{figure}
+\paragraph{\code{\\cvskillhead}}
+A command for a header line for the skill matrix.
+Takes five optional arguments: post-padding width, level, skill label, years of experience and a comment.
+\begin{lstlisting}
+  \cvskillhead[<post-padding>][<level>][<skill>][<years of experience>][<comment>]
+\end{lstlisting}
+\code{<post-padding>} must be a valid length like \code{1em} or \code{1ex}.
 
-\subsection*{Adjusting lenghts}
-The different lengths used by moderncv are customizable by
-\begin{verbatim}
-\setlength{<length>}{<new_dimensions>}
-\end{verbatim}
-where \texttt{<length>} are \texttt{quote\-width}, \texttt{sep\-a\-ra\-tor\-col\-umn\-width}, \texttt{main\-col\-umn\-width}, \texttt{doub\-le\-i\-tem\-main\-col\-umn\-width}, \texttt{list\-i\-tem\-sym\-bol\-width}, \texttt{list\-doub\-le\-i\-tem\-main\-col\-umn\-width}, 
+\paragraph{\code{\\cvskillentry}}
+A command for an entry in the skill matrix.
+Takes five required arguments: skill category, skill level (0 to 5), skill name, years of experience and a comment.
+Takes a single optional argument for the post-padding width.
+\begin{lstlisting}
+  \cvskillentry*[<post-padding>]{<skill category>}{<0-5>}
+      {<skill name>}{<years of experience>}{<comment>}
+\end{lstlisting}
+An optional asterisk toggles the inclusion of a dashed line.
+\code{<post-padding>} must be a valid length like \code{1em} or \code{1ex}.
 
-In particular, the first column, can be set to any width. You can do that in two way:
-\begin{itemize}
- \item using \verb|\sethintscolumnlength{<length>}|, where  \texttt{<length>} is the desired length in a unit LaTeX understands
- \item using \verb|\sethintscolumntowidth{<string>}|, where \texttt{<string>} is a string of the desired length (usually, the longest string that has to appear in the column)
-\end{itemize}
+How to make length adjustments to the skill matrix will be explained in section \ref{section:length:skillmatrix}.
 
-\subsection*{Additional commands}
-There are commands to manage hypertextual links:
-\begin{itemize}
- \item[-] \verb|\weblink[optional text]{link}|
- \item[-] \verb|\httplink[optional text]{link}|
- \item[-] \verb|\emaillink[optional text]{link}|
-\end{itemize}
+\subsection{Letter of motivation}
+
+\todo{add short explanation of motivation letter.}
+To add a subject to the letter of motivation or to close with your signature, see sections \ref{section:add:subject} and \ref{section:add:signature}, respectively.
 
-There is a \verb|\today| command, useful for example if you need to add the date the CV was produced.
 
-\subsection*{Putting things at the end of CV}
-Sometimes there is the need to add some lines at the end of the CV. For example, in Italy is necessary to add the permission to treat the personal data contained in the r\'esum\'e. You can do that dropping out of the layout of \texttt{moderncv} and pushing the lines at the end by the command \verb|\vfill|:
-\begin{verbatim}
-\emptysection{}\closesection
-\vfill
-\begin{center} 
-\textit{\small Ai sensi del D. Lgs. 196/2003 ...}
-\end{center}
-\end{verbatim}
 
 \section{Customization}
 \label{section:customization}
 \subsection{Styles and their options}
 \label{section:customization:stylesAndOptions}
-Each style allows fine tuning through passing options to the \Code{\\moderncvstyle} command. The general syntax
+Each style allows fine-tuning via options passed into the \code{\\moderncvstyle} command:
 \begin{lstlisting}
-  \moderncvstyle[<option1>,<option2>,...]{<style>}
+  \moderncvstyle[<option 1>, <option 2>, ...]{<style>}
 \end{lstlisting}
-for passing options follows the usual \LaTeX\ scheme.
-Each style defines their own options and not all options are available for each style. 
-Below is a list of all options available along with a short description. 
+Each style defines its own options, and not all options are available for each style.
+Below is a list of all the options available for each style:
 
-\paragraph{\texttt{casual}.} This style allows the following options which \emph{only} affect footer and head style:\medskip
+\paragraph{\code{casual}}
+This style allows the following options which \emph{only} affect header and footer styles:
 
-\begingroup
-\renewcommand{\arraystretch}{1.1}
 \begin{tabular}{r@{\hspace{2ex}}p{0.72\textwidth}}
- {\bfseries \code{head alignment}:}  & values: \Code{left}, \Code{right} (default). This option allows to influence the alignment of the title and the picture if one is included.  \\
- {\bfseries \texttt{name}:} & values: \Code{alternate}. Displays the name in all lowercase letters. Differentiation of the name is done by color (disabled by default). This feature is discouraged for  longer names.\\
- {\bfseries \code{data in head}:} & values: \Code{details}, \Code{nodetails} (default). Show personal data in the header (\code{details}) or in the footer (\code{nodetails} (default)). \\
- {\bfseries \code{symbols:}}   & values: \Code{symbols} (default), \code{nosymbols}. These options let you chose between the inclusion of icons for the personal data or text based abbreviations. 
-\end{tabular}\medskip
-\endgroup
+  \textbf{\code{head alignment}} & values: \code{left}, \code{right} (default).
+  Aligns the title and the picture if one is included. \\
+  \textbf{\code{name}}           & values: \code{alternate}.
+  Displays the name in all lowercase.
+  Differentiation of the name is done by color (disabled by default).
+  This feature is discouraged for longer names. \\
+  \textbf{\code{data in head}}   & values: \code{details}, \code{nodetails} (default).
+  Toggles between the header and footer as the location of personal data on the page. \\
+  \textbf{\code{symbols}}        & values: \code{symbols} (default), \code{nosymbols}.
+  Toggles between inclusion of icons or text-based abbreviations for personal data.
+\end{tabular}
 
-\paragraph{\texttt{classic}.} This style allows the following options which \emph{only} affect footer and head style:\medskip
+\paragraph{\code{classic}}
+This style allows the following options which \emph{only} affect header and footer styles:
 
-\begingroup
-\renewcommand{\arraystretch}{1.1}
 \begin{tabular}{r@{\hspace{2ex}}p{0.75\textwidth}}
- {\bfseries \code{alignment}:}  & values: \Code{left} (default), \code{right}. The option toggles the alignment of the address block and the picture.  \\
- {\bfseries \code{data in head}:} & values: \Code{details}, \Code{nodetails} (default). Show personal data in the header (\code{details}) or in the footer (\code{nodetails} (default)). \\
- {\bfseries \code{symbols:}}   & values: \Code{symbols} (default), \code{nosymbols}. These options let you chose between the inclusion of icons for the personal data or text based abbreviations. 
-\end{tabular}\medskip
-\endgroup
+  \textbf{\code{alignment}}    & values: \code{left} (default), \code{right}.
+  Aligns the address block and the picture. \\
+  \textbf{\code{data in head}} & values: \code{details}, \code{nodetails} (default).
+  Toggles between the header and footer as the location of personal data on the page. \\
+  \textbf{\code{symbols}}      & values: \code{symbols} (default), \code{nosymbols}.
+  Toggles between inclusion of icons or text-based abbreviations for personal data.
+\end{tabular}
 
-\paragraph{\texttt{banking}.} This style allows the following options:\medskip
+\paragraph{\code{banking}}
+This style allows the following options:
 
-\begingroup
-\renewcommand{\arraystretch}{1.1}
 \begin{tabular}{r@{\hspace{2ex}}p{0.68\textwidth}}
-  {\bfseries \code{alignment (body)}:}  & values: \Code{left} (default), \Code{center}, \code{right}. This option allows to influence the alignment of the entries in the style.   \\
-  %
-  {\bfseries \code{rule style}:}  & values: \Code{fullrules}, \Code{shortrules}, \Code{mixedrules} (default), \code{norules}. This option allows to adjust the rules used in the style.   \\
-  {\bfseries \code{data in head}:} & values: \Code{details}, \Code{nodetails} (default). Show personal data in the header (\code{details}) or in the footer (\code{nodetails} (default)). \\
- {\bfseries \code{symbols:}}   & values: \Code{symbols} (default), \code{nosymbols}. These options let you chose between the inclusion of icons for the personal data or text based abbreviations. 
-\end{tabular}\medskip
-\endgroup
+  \textbf{\code{alignment (body)}} & values: \code{left} (default), \code{center}, \code{right}.
+  Aligns the entries in the style. \\
+  \textbf{\code{rule style}}       & values: \code{fullrules}, \code{shortrules}, \code{mixedrules} (default), \code{norules}.
+  Adjusts the rules used in the style. \\
+  \textbf{\code{data in head}}     & values: \code{details}, \code{nodetails} (default).
+  Toggles between the header and footer as the location of personal data on the page. \\
+  \textbf{\code{symbols}}          & values: \code{symbols} (default), \code{nosymbols}.
+  Toggles between inclusion of icons or text-based abbreviations for personal data.
+\end{tabular}
 
-\paragraph{\texttt{oldstyle}.} This style allows the following options:\medskip
+\paragraph{\code{oldstyle}}
+This style allows the following options:
 
-\begingroup
-\renewcommand{\arraystretch}{1.1}
 \begin{tabular}{r@{\hspace{2ex}}p{0.73\textwidth}}
-  {\bfseries \code{data in head}:} & values: \Code{details}, \Code{nodetails} (default). Show personal data in the header (\code{details}) or in the footer (\code{nodetails} (default)). \\
- {\bfseries \code{symbols:}}   & values: \Code{symbols} (default), \code{nosymbols}. These options let you chose between the inclusion of icons for the personal data or text based abbreviations. 
-\end{tabular}\medskip
-\endgroup
+  \textbf{\code{data in head}} & values: \code{details}, \code{nodetails} (default).
+  Toggles between the header and footer as the location of personal data on the page. \\
+  \textbf{\code{symbols}}      & values: \code{symbols} (default), \code{nosymbols}.
+  Toggles between inclusion of icons or text-based abbreviations for personal data.
+\end{tabular}
 
-\paragraph{\texttt{fancy}.} This style allows the following options:\medskip
+\paragraph{\code{fancy}}
+This style allows the following options:
 
-\begingroup
-\renewcommand{\arraystretch}{1.1}
 \begin{tabular}{r@{\hspace{2ex}}p{0.73\textwidth}}
-  {\bfseries \code{data in head}:} & values: \Code{details}, \Code{nodetails} (default). Show personal data in the header (\code{details}) or in the footer (\code{nodetails} (default)). \\
- {\bfseries \code{symbols:}}   & values: \Code{symbols} (default), \code{nosymbols}. These options let you chose between the inclusion of icons for the personal data or text based abbreviations. 
-\end{tabular}\medskip
-\endgroup
+  \textbf{\code{data in head}} & values: \code{details}, \code{nodetails} (default).
+  Toggles between the header and footer as the location of personal data on the page. \\
+  \textbf{\code{symbols}}      & values: \code{symbols} (default), \code{nosymbols}.
+  Toggles between inclusion of icons or text-based abbreviations for personal data.
+\end{tabular}
 
-
-\paragraph{Note.} From each option category only one of the possibilities listed can be passed at a time, e.g.:  
+\note Only one option from each option category can be passed in at a time, e.g.
 \begin{lstlisting}
-  \moderncvstyle[left,nosymbols]{casual}
+  \moderncvstyle[left, nosymbols]{casual}
 \end{lstlisting}
 
 
-\subsection{Colors}
-The colors of each style can be readjusted. 
-\todox{explain the three basic colors}
+\subsection{Adjusting colors}
+The colors of each style can be adjusted.
 
-\paragraph{casual}
+\note The color theme must be loaded \emph{before} \code{\\moderncvstyle}, i.e.
 \begin{lstlisting}
- %-------------------------------------------------------------------------------
-%               Colors
-%-------------------------------------------------------------------------------
-% head and footer
-\colorlet{lastnamecolor}{color1}
-\colorlet{namecolor}{lastnamecolor}
-\colorlet{headrulecolor}{color1}
-\colorlet{firstnamecolor}{lastnamecolor!50}
-\colorlet{titlecolor}{color2}
-\colorlet{addresscolor}{color2}
-\colorlet{quotecolor}{color1}
-\colorlet{pictureframecolor}{color1}
-% body
-\colorlet{bodyrulecolor}{color1}
-\colorlet{sectioncolor}{color1}
-\colorlet{subsectioncolor}{color1}
-\colorlet{hintstylecolor}{color0}
-% letter
-\colorlet{letterclosingcolor}{color2}
-% skillmatrix
-\colorlet{skillmatrixfullcolor}{color1}
-\colorlet{skillmatrixemptycolor}{color2!30}
-
+  \moderncvcolor{blue}
+  \moderncvstyle{casual}
 \end{lstlisting}
 
+\paragraph{Base colors.}
+Each style defines three main colors: \code{color0}, \code{color1} and \code{color2}.
+\code{color0} is black and the main text color.
+\code{color1} is the main theme color, like blue, green, etc.
+\code{color2} is a some form of grey used for the user data, etc.
+These colors can be redefined by using either \code{\\definecolor} or \code{\\colorlet}:
+\begin{lstlisting}
+  \definecolor{color1}{rgb}{0.55, 0.55, 0.55}   % dark grey
+  \colorlet{color1}{black}
+\end{lstlisting}
+Any mechanism for naming and defining colors used by the \code{xcolor} package can be used to redefine the colors of a \Moderncv style.
+
+\paragraph{Fine tuning.}
+If an even finer control over the color scheme of the style is desired, the following color settings are used internally for the \code{casual} style and can be redefined:
+\begin{lstlisting}
+  % Head and footer
+  \colorlet{lastnamecolor}{color1}
+  \colorlet{namecolor}{lastnamecolor}
+  \colorlet{headrulecolor}{color1}
+  \colorlet{firstnamecolor}{lastnamecolor!50}
+  \colorlet{titlecolor}{color2}
+  \colorlet{addresscolor}{color2}
+  \colorlet{quotecolor}{color1}
+  \colorlet{pictureframecolor}{color1}
+  % Body
+  \colorlet{bodyrulecolor}{color1}
+  \colorlet{sectioncolor}{color1}
+  \colorlet{subsectioncolor}{color1}
+  \colorlet{hintstylecolor}{color0}
+  % Letter
+  \colorlet{letterclosingcolor}{color2}
+  % Skill matrix
+  \colorlet{skillmatrixfullcolor}{color1}
+  \colorlet{skillmatrixemptycolor}{color2!30}
+\end{lstlisting}
 
 
 \subsection{Modifying symbols and icons}
 \subsubsection{Icons}
-As we have seen in section \ref{section:customization:stylesAndOptions}, the use of icons can be 
-influenced by the \code{symbols} and \Code{nosymbols} options that can be passed to the \Code{\\moderncvstyle} command. \medskip
+As stated in section \ref{section:customization:stylesAndOptions}, the use of icons is toggled by the \code{symbols} option that can be passed to \code{\\moderncvstyle}.
 
-The icons used in the display of the personal data (phone numbers, email, fax, social accounts, etc.) can be customized by redefining the internal commands representing the symbols.
+The icons used in the display of the personal data (phone numbers, email, fax, social media accounts, etc.) can be customized by redefining the internal commands for the symbols:
 \begin{lstlisting}
   \renewcommand*{<\symbolcommand>}{{\small<\symbol>}~}
-\end{lstlisting} 
-Using \code{\\small} is optional, but by default all icons are rendered using the small 
-versions of the symbols used. \emph{The above command is what should be used if one merely whishes to 
-  replace an icon/symbol leaving the size consistent with the default icons}.
+\end{lstlisting}
+Using \code{\\small} is optional, but the default behavior is to render all icons using \code{\\small}.
+Use \code{\\small} if one merely wishes to replace an icon/symbol while keeping the size consistent with the default icons/symbols.
 The tilde ensures proper spacing after the symbols and is recommended as well.
 
-Currently \moderncv supports the following commands as \code{<\\symbolcommand>}:
+Currently \Moderncv supports the following commands as \code{<\\symbolcommand>}:
 \begin{itemize}
-  \item \lstinline!\addresssymbol!
-  \item \lstinline!\mobilephonesymbol!
-  \item \lstinline!\fixedphonesymbol!
-  \item \lstinline!\faxphonesymbol!
-  \item \lstinline!\emailsymbol!
-  \item \lstinline!\homepagesymbol!
-  \item \lstinline!\linkedinsocialsymbol!
-  \item \lstinline!\xingsocialsymbol!
-  \item \lstinline!\twittersocialsymbol!
-  \item \lstinline!\githubsocialsymbol!
-  \item \lstinline!\gitlabsocialsymbol!
-  \item \lstinline!\stackoverflowsocialsymbol!
-  \item \lstinline!\bitbucketsocialsymbol!
-  \item \lstinline!\skypesocialsymbol!
-  \item \lstinline!\orcidsocialsymbol!
-  \item \lstinline!\researchgatesocialsymbol!
-  \item \lstinline!\researcheridsocialsymbol!
-  \item \lstinline!\telegramsocialsymbol!
-  \item \lstinline!\googlescholarsocialsymbol!
+  \begin{multicols}{2}
+    \item \code{\\addresssymbol}
+    \item \code{\\mobilephonesymbol}
+    \item \code{\\fixedphonesymbol}
+    \item \code{\\faxphonesymbol}
+    \item \code{\\emailsymbol}
+    \item \code{\\homepagesymbol}
+    \item \code{\\linkedinsocialsymbol}
+    \item \code{\\xingsocialsymbol}
+    \item \code{\\twittersocialsymbol}
+    \item \code{\\githubsocialsymbol}
+    \item \code{\\gitlabsocialsymbol}
+    \item \code{\\stackoverflowsocialsymbol}
+    \item \code{\\googlescholarsocialsymbol}
+    \item \code{\\telegramsocialsymbol}
+    \item \code{\\whatsappsocialsymbol}
+    \item \code{\\signalsocialsymbol}
+    \item \code{\\matrixsocialsymbol}
+    \item \code{\\orcidsocialsymbol}
+    \item \code{\\researchgatesocialsymbol}
+    \item \code{\\researcheridsocialsymbol}
+    \item \code{\\bitbucketsocialsymbol}
+    \item \code{\\skypesocialsymbol}
+    \item \code{\\bornsymbol}
+    \item \code{\\arxivsocialsymbol}
+    \item \code{\\inspiresocialsymbol}
+  \end{multicols}
 \end{itemize}
-The possible options for \Code{<\\symbol>} depend on the package that is used. 
-By default the \Code{marvosym} package is loaded if \Code{pdflatex} is used and the packages 
-\code{academicons} and \Code{fontawesome5} are loaded if \Code{lualatex} or \Code{xelatex} are 
-employed. The documentation including full lists of all available symbols and icons can be found 
-in the respective package documentations \medskip
+The possible options for \code{<\\symbol>} depend on the package that is used.
+By default, the \code{marvosym} package is loaded if \code{pdflatex} is used, and the \code{academicons} and \code{fontawesome5} packages are loaded if either \code{lualatex} or \code{xelatex} is used.
+Full lists of all available symbols and icons can be found in the documentation of each respective package:
 
 \begin{tabular}{l}
-  \url{https://ctan.org/pkg/marvosym}\\[1ex]
-  \url{https://ctan.org/pkg/fontawesome5}\\[1ex]
+  \url{https://ctan.org/pkg/marvosym} \\[1ex]
+  \url{https://ctan.org/pkg/fontawesome5} \\[1ex]
   \url{https://ctan.org/pkg/academicons}
 \end{tabular}
 
 \paragraph{Example.}
-If one wanted to use the dingbat fonts to substitute fixed phone symbol one would load the \Code{pifont} package in the preamble, then substitute the default symbol \Code{\\fixedphonesymbol} with the dingbat symbol \ding{38}\ by:
+If one wanted to use the dingbat fonts to replace the default phone symbol, one should load the \code{pifont} package in the preamble and then substitute the default symbol with the dingbat symbol \ding{38}\ with
 \begin{lstlisting}
   \renewcommand*{\fixedphonesymbol}{\ding{38}~}
-\end{lstlisting} 
+\end{lstlisting}
 
 \subsubsection{Listing labels}
-The labels used in \Code{itemize} environments or the \Moderncv macros \code{cvlistitem} and \Code{cvlistdoubleitem} can be affected in two different ways:
+The labels used in \code{itemize} environments, \code{cvlistitem} and \code{cvlistdoubleitem} can be changed in two different ways:
 
 \begin{itemize}
- \item By redefining the internal commands \code{\\labelitemi}, \code{\\labelitemii} as well as
-  \code{\\labelitemiii} and \code{\\labelitemiv}, e.g. 
+  \item Redefining \code{\\labelitemi}, \code{\\labelitemii}, \code{\\labelitemiii} and \code{\\labelitemiv} changes the labels for \code{itemize} environments as well as for \code{cvlistitem} and \code{cvlistdoubleitem}, e.g.
   \begin{lstlisting}
-  \renewcommand{\labelitemi}{-}.
+  \renewcommand{\labelitemi}{-}
   \end{lstlisting}
-  This will affect both, the \Code{itemize} environments as well as the macros \Code{cvlistitem} and \Code{cvlistdoubleitem}.
-  \item If one only whishes to change the labels of the macros \Code{cvlistitem} and \Code{cvlistdoubleitem}, one needs to redefine the \code{\\listitemsymbol}, e.g.
-\begin{lstlisting}
-  \renewcommand{\listitemsymbol}{-}.
+  \item Redefining \code{\\listitemsymbol} changes the labels for \code{cvlistitem} and \code{cvlistdoubleitem} but \emph{not} for \code{itemize} environments, e.g.
+  \begin{lstlisting}
+  \renewcommand{\listitemsymbol}{-}
 \end{lstlisting}
-This will leave the definitions of \Code{itemize} environments untouched.
 \end{itemize}
 
+\subsection{Adjusting lengths}
+\todo{Add more adjustable lengths}
+Some lengths in \Moderncv can be adjusted.
+
+The hints column can be adjusted by setting \code{\\hintscolumnwidth}:
+\begin{lstlisting}
+  \setlength{\hintscolumnwidth}{3cm}
+\end{lstlisting}
+
+For the \code{classic} style, the amount of horizontal space for the name can be adjusted by setting \code{\\makecvheadnamewidth} to avoid breaks:
+\begin{lstlisting}
+  \setlength{\makecvheadnamewidth}{10cm}
+\end{lstlisting}
+One should be careful though, as the length is normally calculated to avoid any overlap with the personal information.
+This should be used at one's own typographical risk.
+
+% The different lengths used by moderncv are customizable by
+% \begin{lstlisting}
+% \setlength{<length>}{<new_dimensions>}
+% \end{lstlisting}
+% where \code{<length>} are \code{quotewidth}, \code{separatorcolumnwidth}, \code{maincolumnwidth}, \code{doubleitemmaincolumnwidth}, \code{listitemsymbolwidth}, \code{listdoubleitemmaincolumnwidth},
+
+
+\subsubsection{Lengths in the skill matrix}
+\label{section:length:skillmatrix}
+Both the width of the skill matrix legend and the width of the skill matrix columns can be adjusted.
+
+The width of the skill matrix legend can be adjusted as follows:
+\begin{lstlisting}
+  \setcvskilllegendcolumns[<width>][<factor>]
+  % Examples:
+  \setcvskilllegendcolumns[][0.45]
+  \setcvskilllegendcolumns[\widthof{``Legend''}][0.45]
+  \setcvskilllegendcolumns[0ex][0.46] % useful for the banking style
+\end{lstlisting}
+\code{<width>} should be a length smaller than \code{\\textwidth}, and \code{<factor>} must be between 0 and 1.
+
+The width of the skill matrix columns can be adjusted as follows:
+\begin{lstlisting}
+  \setcvskillcolumns[<width>][<factor>][<exp_width>]
+  % Examples:
+  \setcvskillcolumns[5em][][]   % adjust first column, same as \setcvskillcolumns[5em]
+  \setcvskillcolumns[][0.45][]  % adjust third (skill) column, same as \setcvskillcolumns[][0.45]
+  \setcvskillcolumns[][][\widthof{``Year''}]  % adjust fourth (years of experience) column
+  \setcvskillcolumns[][0.45][\widthof{``Year''}]
+  \setcvskillcolumns[\widthof{``Language''}][0.48][]
+  \setcvskillcolumns[\widthof{``Language''}]
+\end{lstlisting}
+\code{<width>} and \code{<exp_width>} should be lengths smaller than \code{\\textwidth}, and \code{<factor>} must be between 0 and 1.
+
+\subsection{Page breaks and orphaned section headers}
+If \Latex breaks pages just after \code{\\section} or \code{\\subsection} commands, try adjusting the stretchability of the page with \code{\\cvsectionstretchability} or \code{\\cvsubsectionstretchability}:
+\begin{lstlisting}
+  \setlength{\cvsectionstretchability}{\baselineskip}
+  \setlength{\cvsubsectionstretchability}{100pt}
+\end{lstlisting}
+These two lengths tell \Latex how much extra length it needs after \code{\\section} and \code{\\subsection} commands.
+By default, \Moderncv sets both lengths to \code{0.9\\baselineskip}.
+
+This should solve orphaned \code{\\section} and \code{\\subsection} commands that are used alone for most users.
+However, \Latex does not check for content.
+For example, writing
+\begin{lstlisting}
+  \section{blub}
+  \subsection{blubblub}
+\end{lstlisting}
+one after the other may cause \Latex to place the section and subsection headers on separate pages.
+Since \Latex considers the subsection header to not be orphaned, it may place the section header at the bottom of a page if there is enough space to do so while placing the subsection header on the next page.
+One solution is to increase \code{\\cvsectionstretchability} to force the break of the section header.
+However, this changes the behaviour for all \code{\\section} commands in your CV and might cause unnecessary page breaks.
+It is therefore recommended to force the page break manually with a \code{\\newpage} in this case.
+
+\paragraph{Experts only:}
+Internally, \Moderncv uses a custom \code{\\needspace} command:
+\begin{lstlisting}
+  \NewDocumentCommand\@cvneedspace{m}{%
+    \begingroup
+      \setlength{\dimen@}{#1}%
+      \vskip\z@\@plus\dimen@
+      \penalty \withinstretchpenalty\vskip\z@\@plus -\dimen@
+      \vskip\dimen@
+      \penalty \poststretchpenalty%
+      \vskip -\dimen@
+      \vskip\z@skip % hide the previous |\vskip| from |\addvspace|
+    \endgroup
+  }
+\end{lstlisting}
+Thus, instead of setting \code{\\cvsectionstretchability} and/or \code{\\cvsubsectionstretchability}, page break behavior can be adjusted by redefining the following internal penalties:
+\begin{lstlisting}
+ \renewcommand{\withinstretchpenalty}{<-100...9999>}
+ \renewcommand{\poststretchpenalty}{<-100...9999>}.
+\end{lstlisting}
+By default, \Moderncv sets \code{\\withinstretchpenalty} to 0 and \code{\\poststretchpenalty} to 9999.
+The higher the penalties are, the less likely a page break will occur.
+A good explanation of \code{\\needspace} can be found at \url{https://tex.stackexchange.com/questions/348994/understanding-needspace}.
+
+
 \subsection{Tips and Tricks}
-\subsubsection{Legal disclaimer at the end of CV}
-Some countries (e.g. Italy) require to add the permission to treat the personal data contained in the CV. This can be achieved by the command \code{\\vfill}. At the end of the last entry to your 
-CV, add the following:%
-\footnote{Example provided by Cristina Sambo} %
+\subsubsection{Including a scanned signature in the letter of motivation}
+\label{section:add:signature}
+To add a scanned signature to your letter of motivation, add the following to your preamble:
+%%%% redefinition of makeletterclosing without printing Name and last name but inserting
+%%%% a signature png instead.
+\begin{lstlisting}
+  \makeatletter
+  \renewcommand*{\makeletterclosing}{
+    \@closing\\[3em]%
+    \includegraphics[height=1.5cm, width=5.5cm]{<signature.png>}
+    % \textbf{\@firstname~\@lastname}%
+    \ifthenelse{\isundefined{\@enclosure}}{}{%
+      \\%
+      \vfill%
+      \textcolor{color2}{\textit{\enclname: \@enclosure}}%
+    }%
+  }
+  \makeatother
+\end{lstlisting}
+
+\subsubsection{Including a subject in the letter of motivation}
+\label{section:add:subject}
+To add a subject to your letter of motivation, add the following to your preamble:
+\begin{lstlisting}
+  \makeatletter
+  \renewcommand*{\makeletterhead}{%
+    \recomputeletterlengths   % in case we are switching from letter to resume, or vice versa
+    % recipient block
+    \begin{minipage}[t]{0.5\textwidth}
+      \raggedright\addressfont%
+      \textbf{\textup{\@recipientname}}\\%
+      \@recipientaddress%
+    \end{minipage}
+    % date
+    \hfill  % US style
+    % \\[1em] % UK style
+    \@date\\[4em]   % US informal style: "January 1, 1900"; UK formal style: "01/01/1900"
+    % opening
+    \raggedright%
+    \textbf{\subject}\\[2em]
+    \@opening\\[1.5em]%
+    % ensure no extra spacing after \makelettertitle due to a possible blank line
+    % \ignorespacesafterend   % not working
+    \hspace{0pt}\par\vspace{-\baselineskip}\vspace{-\parskip}
+  }
+  \makeatother
+\end{lstlisting}
+Then a subject can be added to the letter of motivation with
+\begin{lstlisting}
+  \subject{<subject_text>}
+\end{lstlisting}
+
+\subsubsection{Legal disclaimer at the end of the CV}
+Some countries (e.g. Italy) require you to add a legal disclaimer authorizing the use of the personal data in your CV.
+To add such a disclaimer, add the following to the bottom of your CV:%
+\footnote{Example provided by Cristina Sambo}%
 \begin{lstlisting}
   \vfill
-  \begin{center} 
-  \textit{\small Ai sensi del D. Lgs. 196/2003 ...}
+  \begin{center}
+    \textit{\small Ai sensi del D. Lgs. 196/2003 ...}
   \end{center}
 \end{lstlisting}
 
+
+
 \section{Implementation details}
 \label{section:implementationDetails}
 
 \subsection{Creating your own styles}
-\todox{Add explanation on how to create styles and and how to recombine headers, footers, bodies etc.}
+\todox{Explain how to create styles and and how to recombine headers, footers, bodies etc.}
 
 \subsection{Required packages}
 \label{section:implementationDetails:requiredPackages}
-In addition to the packages that \Moderncv itself provides the following packages are loaded internally:
-
+In addition to the packages that \Moderncv provides, the following packages are loaded internally:
 \begin{itemize}
-  \item\code{etoolbox}, 
-  \item\code{ifthen}, 
-  \item\code{xcolor}, 
-  \item\code{ifxetex,ifluatex}, 
-  \item\code{fontenc}, 
-  \item\code{url}, 
-  \item\code{hyperref}, 
-  \item\code{graphicx}, 
-  \item\code{fancyhdr}, 
-  \item\code{tweaklist}, 
-  \item\code{calc}, 
-  \item\code{xparse}, 
-  \item\code{microtype}, 
-  \item\code{expl3}, 
-  \item\code{tikz}, 
-  \item\code{changepage}, 
-  \item\code{fontawesome5}, 
-  \item\code{academicons}, 
-  \item\code{tgpagella}, %
-  \item\code{ebgaramond}, %
-  \item\code{kurier}, 
-  \item\code{multirow},
-  \item\code{arydshln}. %
+  \begin{multicols}{3}
+    \item \code{etoolbox}
+    \item \code{ifthen}
+    \item \code{xcolor}
+    \item \code{ifxetex} or \code{ifluatex}
+    \item \code{fontenc}
+    \item \code{url}
+    \item \code{hyperref}
+    \item \code{graphicx}
+    \item \code{fancyhdr}
+    \item \code{tweaklist}%
+    \footnote{The \code{tweaklist} package has been altered for the development of \Moderncv and ships with \moderncv.}
+    \item \code{calc}
+    \item \code{xparse}
+    \item \code{microtype}
+    \item \code{expl3}
+    \item \code{tikz}
+    \item \code{changepage}
+    \item \code{fontawesome5}
+    \item \code{academicons}
+    \item \code{tgpagella}
+    \item \code{ebgaramond}
+    \item \code{kurier}
+    \item \code{multirow}
+    \item \code{arydshln}
+  \end{multicols}
 \end{itemize}
 
-Note that the \Code{tweaklist} package has been altered for the development of \Moderncv and ships 
-with \moderncv.
-
-Most of the packages should be included in the \LaTeX\ distribution of your choice.
+Most of these packages should be included in your \Latex distribution of choice.
 
 \subsection{Known conflicts with other packages}
 \begin{enumerate}
-  \item The \Moderncv packages is incompatible with biber.
+  \item \Moderncv is incompatible with \code{biber}.
+  \item \Moderncv is incompatible with \biblatex.
+  \item \Moderncv is incompatible with \code{babel} in Spanish
 \end{enumerate}
 
 \subsection{Known bugs}
-\input{known_bugs}
+\begin{enumerate}
+  \item Skill matrices don't break automatically in \texttt{fancy} style.
+  \item Long names break the \texttt{oldstyle} style and possibly other styles (needs testing).
+  \item Long URLs in \texttt{classic} style can make the name break line.
+  Fixed width for the address part must be implemented.
+  \item When using the \texttt{fancy} style, undesired space is added between the bibliography head and the first entry, as well as after the last entry.
+  \item Footnotes generate errors, but the output seems correct when running with \code{-interaction=nonstopmode}.
+  \item When using CJK, the last \code{\\clearpage} required for the \code{fancyhdr} package to work properly kills the ``lastpage'' counter, and therefore also the page numbering.
+  \item \Moderncv produces the error ``\code{lonely \\item--perhaps a missing list environment}'' when used with the \code{bibentry} package, though the output is actually correct.
+  Among other things, this causes compilation by LyX to stop.
+  \item The space after a \code{\\cventry} gets eaten up when the last argument contains a nested \code{itemize} environment.
+  An ugly hack and incomplete solution was implemented by including a \code{\\strut} in every item label, but this doesn't solve the problem for multi-line items.
+  Ideally, the \code{\\strut} should end the item, but there seems to be no way to do this.
+\end{enumerate}
 
 \end{document}