luatodonotes (8aug14)

git-svn-id: svn://tug.org/texlive/trunk@34908 c570f23f-e606-0410-a88d-b1316a301751

2 files changed, 1888 insertions, 0 deletions

diff --git a/Master/texmf-dist/source/lualatex/luatodonotes/luatodonotes.dtx b/Master/texmf-dist/source/lualatex/luatodonotes/luatodonotes.dtx
new file mode 100644
index 00000000000..3188307f4c5
--- /dev/null
+++ b/Master/texmf-dist/source/lualatex/luatodonotes/luatodonotes.dtx
@@ -0,0 +1,1823 @@
+% \iffalse meta-comment
+%
+% Copyright (C) 2014 by Fabian Lipp <fabian.lipp@gmx.de>
+% based on the todonotes package
+%   by Henrik Skov Midtiby <henrikmidtiby@gmail.com>
+% -------------------------------------------------------
+% 
+% This file may be distributed and/or modified under the
+% conditions of the LaTeX Project Public License, either version 1.2
+% of this license or (at your option) any later version.
+% The latest version of this license is in:
+%
+%    http://www.latex-project.org/lppl.txt
+%
+% and version 1.2 or later is part of all distributions of LaTeX 
+% version 1999/12/01 or later.
+%
+% \fi
+%
+% \iffalse
+%<*driver>
+\ProvidesFile{luatodonotes.dtx}
+%</driver>
+%<package>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
+%<package>\ProvidesPackage{luatodonotes}
+%<*package>
+    [2014/08/07 v0.1 luatodonotes source and documentation.]
+%</package>
+%
+%<*driver>
+\documentclass{ltxdoc}
+\usepackage{wrapfig}
+\usepackage[colorlinks, linkcolor=black, urlcolor=blue]{hyperref}
+\usepackage[colorinlistoftodos, shadow]{luatodonotes}[2014/06/08]
+\usepackage{fontspec}
+\usepackage{amsmath}
+\usepackage{setspace}
+\usepackage{soul}
+\setcounter{tocdepth}{2}
+\EnableCrossrefs         
+\CodelineIndex
+\RecordChanges
+\begin{document}
+  \DocInput{luatodonotes.dtx}
+%\iffalse
+%  \PrintChanges
+%  \PrintIndex
+%\fi
+\end{document}
+%</driver>
+% \fi
+%
+% \CheckSum{841}
+%
+% \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         \~}
+%
+%
+% \changes{0.1}{2014/08/07}{The first version of the package}
+% \GetFileInfo{luatodonotes.dtx}   
+%
+% \DoNotIndex{\newcommand,\newenvironment}
+%
+% \iffalse
+% A macro for marking things todo before the next relase
+% (typically update of documentation).
+% \fi
+% \newcommand{\donow}[1]{\todo[color=blue]{#1}}
+% 
+%
+% \title{The \textsf{luatodonotes} package\thanks{This document
+%   corresponds to \textsf{luatodonotes}~\fileversion, dated \filedate.}}
+% \author{Fabian Lipp\thanks{This documentation and the whole package is based
+% on version 1.0.2 of the todonotes package by Henrik Skov Midtiby.} \\
+% \texttt{fabian.lipp@gmx.de}}
+%
+% \maketitle
+%
+% \begin{abstract}
+% The |luatodonotes| package allows you to insert to--do items in your
+% document. At any point in the document a list of all the inserted
+% to--do items can be listed with the |\listoftodos| command.
+%
+% It is an extended version of the |todonotes| package and uses more advanced
+% algorithms to place the to--do notes notes on the page.
+% For this algorithms it depends on Lua\TeX.
+% \end{abstract}
+%
+% \tableofcontents
+%
+% \newpage
+% \section{Introduction}
+%
+% The |luatodonotes| package makes three commands available to the
+% user: |\todo[]{}|, |\missingfigure{}| and |\listoftodos|.
+% |\todo[]{}| and |\missingfigure{}| makes it possible to insert
+% notes in your document about things that has to be done later
+% (todonotes \ldots).
+% This package is based on version 1.0.2 of
+% |todonotes|\footnote{\url{http://www.ctan.org/pkg/todonotes}} by Henrik Skov
+% Midtiby.
+%
+% The positions of the notes on the page is determined using algorithms
+% implemented in Lua, so you have to process your documents using Lua\LaTeX.
+% The package can be used as a drop-in replacement for the original
+% |todonotes| package, you
+% only need to modify |\usepackage{todonotes}| to |\usepackage{luatodonotes}|.
+% Note that |todonotes| and |luatodonotes| must not be loaded inside the same
+% document.
+% 
+% Some alternatives for the luatodonotes package are:
+% \begin{itemize}
+% \item \href{http://www.ctan.org/tex-archive/macros/latex/contrib/easy-todo}{easy-todo}\\
+% Depends on |color|, |tocloft| and |ifthen|, small feature set.
+% \item \href{http://www.ctan.org/pkg/fixmetodonotes}{fixmetodonotes}\\
+% Depends on |graphicx|, |color|, |transparent|, |watermark|, |fix-cm|, |ulem| and |tocloft|, small feature set.
+% \item \href{http://www.ctan.org/tex-archive/macros/latex/contrib/todo}{todo}\\
+% Depends on |amssymb|, medium feature set.
+% \item \href{http://www.ctan.org/tex-archive/macros/latex/contrib/fixme}{fixme}\\
+% Large package with a lot of features.
+% \item \href{http://www.ctan.org/pkg/todonotes}{todonotes}
+% \end{itemize}
+%
+% Compared to the classical todonotes this package has more advanced algorithms
+% and more configuration options to control the position of the notes on the
+% page.
+% Additionally, we are able to place notes at almost every position on the
+% page, e.\,g., in floating environments or in footnotes.
+% As a disadvantage luatodonotes requires Lua\LaTeX for document processing, so
+% a standard |pdflatex| won't work.
+% Depending on the chosen layout for the to--do notes the runtime can be much
+% higher than with todonotes.
+% Labels placed by luatodonotes can conflict with text placed with
+% |\marginpar|.
+%
+% The main reason for considering other packages is that the todonotes 
+% package is quire large and relies heavily on tikz.
+% This can slow down compilation of large documents significantly.
+% The mentioned alternatives have a different feature set and does not 
+% rely on tikz, which makes them require less ressoureces.
+%
+%
+% \subsection{Usage}
+% The package is loaded with |\usepackage|\oarg{options}|{luatodonotes}|.
+% Valid options are described in Section~\ref{subsecPackageOptions}.
+% Note that |todonotes| must \emph{not} be loaded.
+% You have to use |lualatex| to process your document, |pdflatex| will not
+% work.
+% The package depends on positions written to the aux-file, so you have to run
+% |lualatex| twice or even three times to get the labels and leaders for the
+% notes right.
+%
+% \DescribeMacro{\todo}
+% My \index{\todo}most common usage of the todonotes package, is to 
+% insert an todonotes somewhere in a latex document. 
+% An example of this usage is the command 
+%
+% |\todo{Make a cake \ldots}|, 
+% 
+% \noindent
+% which renders like\todo{Make a cake \ldots}.
+% The |\todo| command has this structure: 
+% |\todo|\oarg{options}\marg{todo text}.
+% The |todo text| is the text that will be shown in the todonote and
+% in the list of todos. The optional argument |options|, allows the
+% user to customize the appearance of the inserted todonotes.
+% For a description of all the options see section
+% \ref{subsecTodoOptions}.
+%
+% \DescribeMacro{\todoarea}
+% The |\todoarea| is similiar to |\todo|, but is able to highlight a specified
+% area in the text, to which the note is connected.
+% The command has this structure:
+% |\todoarea|\oarg{options}\marg{note text}\marg{highlighted text}.
+% This command was not tested extensively until now, so it should be used with
+% caution.
+%
+% \DescribeMacro{\missingfigure}
+% The |\missingfigure| command inserts an image containing an 
+% attention sign and the given text.
+% The command takes only one argument
+% |\missingfigure|\marg{text}, a text string that could
+% describe what the figure should consist of.
+% An example of its usage could be 
+%
+% |\missingfigure{Make a sketch of the structure of a trebuchet.}| 
+%
+% \noindent
+% which renders like.
+%
+% \missingfigure{Make a sketch of the structure of a trebuchet.}
+%
+%
+% \DescribeMacro{\listoftodos}
+% The |\listoftodos| command inserts a list of all the todos in the
+% current document. |\listoftodos| takes no arguments.
+% For this document the list of to--do's looks like.
+% \listoftodos
+% \vspace{0.5cm}
+%
+% \DescribeMacro{\todototoc}
+% The |\todototoc| command adds an entry to the table of contents for 
+% list of todos. The command should be placed right before the 
+% |\listoftodos| command.
+%
+% \subsection{Package options}
+% \label{subsecPackageOptions}
+% \DescribeMacro{disable}
+% If the option |disable| is passed to the package, the macros
+% usually defined by the package (|\todo|, |\todoarea|, |\listoftodos| and
+% |\missingfigure|) are defined as macros with no effect, and thus
+% all inserted notes are removed.
+%
+% \DescribeMacro{obeyDraft, obeyFinal}
+% When the option |obeyDraft| is given, the package checks
+% if the one of the options |draft|, |draftcls| or |draftclsnofoot| 
+% is given (this option is usually given to
+% the documentclass). If the |draft| option is given, the
+% functionality of the package is enabled and otherwise the effect
+% of the package is disabled.
+% The option |obeyFinal| does something similar, except that the 
+% todonotes package is only disabled if the |final| option given.
+%
+% \DescribeMacro{danish, german, ngerman, french, swedish}
+% \DescribeMacro{spanish, catalan, italian}
+% \DescribeMacro{portuguese, dutch}
+% Use translations of the text strings 
+% ''List of todos'' and ''Missing figure''.
+% The default is to use none of these options, which results in
+% english text strings.
+% Currently the following languages are supported: 
+% catalan,
+% danish,
+% dutch,
+% french,
+% german,
+% ngerman,
+% italian,
+% portuguese,
+% spanish and
+% swedish.
+% 
+% \DescribeMacro{colorinlistoftodos}
+% Adds a small colored square in front of all items in the Todo
+% list. The color of the square is the same as the fill color of the
+% inserted todonote.
+% This can be useful if there are different types of todos 
+% (insert reference, explain in detail, \ldots) where the color of
+% the inserted todonote marks the type of todo.
+%
+% \DescribeMacro{color}
+% \DescribeMacro{backgroundcolor}
+% \DescribeMacro{linecolor}
+% \DescribeMacro{bordercolor}
+% These options sets the default colors for the todo command.
+% There is three colors that can be specified. The border color
+% (default |bordercolor=black|) around the inserted text, the color
+% behind the inserted text (default |backgroundcolor=orange|) and
+% the color of the line connecting the inserted textbox with the
+% current location in the text (default |linecolor=black!30|). 
+% Setting the |color| option to |val| passes this value on to the 
+% background and line color options.
+% The specified colors must be valid according to the 
+% |xcolor| package.
+%
+% \DescribeMacro{textsize}
+% |textsize=value| sets the default text size of the inserted
+% todonotes to the given value.
+% Value is the ''name'' of the used font size, eg. if the desired
+% fontsize is |\tiny| use |textsize=tiny|. The default value is 
+% |textsize=normalsize|.
+%
+% \DescribeMacro{prependcaption}
+% The |prependcaption| option triggers a special behaviour of the
+% |caption=val| option for the todo command, where the given value
+% |val| is inserted in the inserted todonote.
+% 
+% \DescribeMacro{shadow}
+% If the |shadow| option is given, the inserted todonotes will be
+% displayed with a gray shadow.
+% I expect that the option will trigger problems with tikz versions
+% prior to 2.0.
+%
+% \DescribeMacro{figwidth}
+% \DescribeMacro{figheight}
+% The |figwidth=length| option and |figheight=length| option set the default
+% width and height of the figure
+% inserted by the |\missingfigure| command. 
+% The default value is |\columnwidth| for the width and |4cm| for the height.
+%
+% \DescribeMacro{leaderwidth}
+% The |leaderwidth=length| option specifies the width of the leader lines.
+% The argument is passed to the |line width| option in TikZ.
+% The default value is |1.6pt|.
+%
+% \DescribeMacro{leadertype}
+% The |leadertype=type| option specifies the shape of the leaders, which are
+% drawn between the labels in the margin and the corresponding sites in text.
+% We use the characterization of the leader types known from boundary labeling:
+% $p$ denotes a segment parallel to the left/right side of the text area, while
+% $o$ denotes a orthogonal segment.
+% $s$ is a straight-line segment.
+% The following types are available (|opo| is the default value):
+% \begin{itemize}
+%    \item |s|:
+%    Straight-line connection between site and label.
+%    \item |sBezier|:
+%    Uses the straight-line leaders but transforms them into B\'ezier curves,
+%    which are easier to follow for the reader.
+%    The generated curves don't cross each other when the straight-line leaders
+%    are crossing-free.
+%    \item |opo|:
+%    This is the style used in the original todonotes package.
+%    The leaders start with a horizontal segment at the site in the text,
+%    followed by a vertical segment in the margin beneath the text.
+%    The last segment is a vertical segment, which connects to the label.
+%    \item |os|:
+%    This is the style used in common word processing applications like
+%    LibreOffice.
+%    The leader also starts with a horizontal segment that leads to the margin
+%    and is connected to the label by a straight line.
+%    \item |po|:
+%    The leader starts with a vertical segment at the site in text and is then
+%    connected to the label by a horizontal segment.
+% \end{itemize}
+%
+% \DescribeMacro{positioning}
+% The |positioning=algorithm| option specifies, which algorithm is used to
+% determine the positions of the notes on the page.
+% You should choose the algorithm depending on the leader type you want to use.
+% The default value for this option is |inputOrderStacks|.
+% The following algorithms are available:
+% \begin{itemize}
+%    \item |inputOrder|:
+%    Place the labels in the order given by the
+%    y-coordinates of the corresponding sites in text.
+%    Intended for use with $opo$- or $os$-leaders.
+%    \item |inputOrderStacks|:
+%    Like the algorithm before, but the labels are
+%    clustered before they are placed.
+%    Thus the labels are placed nearer to their sites.
+%    Intended for use with $opo$- or $os$-leaders.
+%    \item |sLeaderNorthEast|:
+%    Places labels in a way that they can be connected to their sites by
+%    straight-line leaders without crossings.
+%    The leaders are attached to the upper right or upper left corner of the
+%    label (depending on which site of the text the label is placed).
+%    Intended for use with $s$-leaders or B\'ezier leaders.
+%    \item |sLeaderNorthEastBelow|:
+%    Like the algorithm before, but the leader is attached to a point that is a
+%    constant offset below the corner of the label.
+%    Intended for use with $s$-leaders or B\'ezier leaders.
+%    \item |sLeaderNorthEastBelowStacks|:
+%    Like the algorithm before, but the labels are cluster before they are
+%    placed.
+%    Thus the labels are placed nearer to their sites.
+%    Intended for use with $s$-leaders or B\'ezier leaders.
+%    \item |sLeaderEast|:
+%    Like the algorithms before, but the leader is attached to the center of the
+%    right or left boundary of the label.
+%    Intended for use with $s$-leaders or B\'ezier leaders.
+%    \item |poLeaders|:
+%    Calculates label positions that lead to $po$-leaders with minimum total
+%    length.
+%    This algorithm depends heavily on the number of notes, so the runtime and
+%    memory consumption can get very high.
+%    \item |poLeadersAvoidLines|:
+%    Like the algorithm before, but tries to avoid overlapping of horizontal
+%    leader segments with text.
+%    This algorithm depends heavily on advanced Lua\TeX\ features to manipulate
+%    the data structures of the page, so it possibly could give conflicts with
+%    other packages.
+% \end{itemize}
+%
+% \DescribeMacro{splitting}
+% The |splitting=algorithm| option can be used to place the labels on both sides
+% of the text.
+% The notes are only separated when there is enough space on both sides (see
+% |minNoteWidth|.
+% The default value for this option is |none|.
+% Available algorithms for this option are:
+% \begin{itemize}
+%    \item |none|:
+%    Labels are placed in the wider margin only.
+%    \item |middle|:
+%    The text area is split in the middle in a left and a right half.
+%    Labels, whose sites are in the left half of the text, are placed in the
+%    left margin, the others in the right margin.
+%    \item |median|:
+%    The notes are seperated at the median of the sites (sorted by
+%    x-coordinate).
+%    That is, the number of notes in the left and the right margin is equal
+%    (except for one note).
+%    \item |weightedMedian|:
+%    Considers the height of the labels for the median.
+%    So the total height of the labels in the left margin is approximately equal
+%    to that in the right margin.
+% \end{itemize}
+%
+% \DescribeMacro{interNoteSpace}
+% The |interNoteSpace=length| option specifies the minimum vertical distance
+% between two notes.
+% The default value is |5pt|.
+%
+% \DescribeMacro{noteInnerSep}
+% The |noteInnerSep=length| option specifies the |inner sep| used for the TikZ
+% nodes, i.\,e., the distance between the border of the note and the text inside
+% it.
+% The default value is |5pt|.
+%
+% \DescribeMacro{routingAreaWidth}
+% The |routingAreaWidth=length| option specifies the width of the so called
+% routing area.
+% This is the area, in which the vertical segment of $opo$-leaders are placed.
+% The area is also used for $os$-leaders.
+% The default value is |0.4cm|.
+%
+% \DescribeMacro{minNoteWidth}
+% The |minNoteWidth=length| option specifies the minimum width of the labels.
+% When there is fewer space in one of the margins, this margin is not considered
+% for label placement.
+% If both margins are narrower, no labels are placed and an error message is
+% printed to the console output.
+% The default value of this option is |2.0cm|.
+%
+% \DescribeMacro{distanceNotesPageBorder}
+% The |distanceNotesPageBorder=length| option specifies the horizontal distance
+% from the labels to the borders of the paper.
+% You can adjust this setting to your printer margins.
+% The default value of this option is |0.5cm|.
+%
+% \DescribeMacro{distanceNotesText}
+% The |distanceNotesPageBorder=length| option specifies the horizontal distance
+% between the labels and the text area.
+% With $opo$- or $os$-leaders the routing area is inserted additionally so the
+% distance between labels and text area increases.
+% The default value of this option is |0.2cm|.
+%
+% \DescribeMacro{rasterHeight}
+% The |rasterHeight=length| option is used only for the $po$-leader algorithm.
+% For this algorithm the page is rasterized and the labels are placed only on
+% the positions given by this raster.
+% Decreasing this value can yield better results (i.\,e., smaller total leader
+% length), but strongly increases the runtime and memory consumption.
+% The default value of this option is |1cm|.
+%
+% \DescribeMacro{debug}
+% When the |debug| option is activated the package is more verbose on
+% the commandline.
+% Additionally, some markers, which can be used to understand the algorithms,
+% are drawn on the page (depending on the chosen algorithm).
+%
+%
+%
+%
+% \subsection{Options for the todo command}
+% \label{subsecTodoOptions}
+% There are several options that can be given to the |\todo|
+% command. All the options are described here and often I have
+% included examples of the change in visual appearance.
+% Default values for these options can be set using the presetkeys 
+% command.
+% \begin{verbatim}
+% \presetkeys{todonotes}{fancyline, color=blue!30}{}
+% \end{verbatim}
+%
+% \DescribeMacro{disable}
+% The |disable| option can be given directly to the todo command.
+% If given the command has no effect.
+%
+% \DescribeMacro{color}
+% \DescribeMacro{backgroundcolor}
+% \DescribeMacro{linecolor}
+% \DescribeMacro{bordercolor}
+% These options set the color that is used in the current todo
+% command.
+% The color classes is the same as used in the color package
+% options, see section \ref{subsecPackageOptions}.
+% Default values can be set by the color
+% options when the todonotes package is loaded.
+% \todo[color=green!40]{And a green note}
+% The todo notes inserted in this paragraph is created with the
+% command
+% |\todo[color=green!40]{And a green note}|.
+% The color of the inserted note could be used to mark different
+% types of tasks (insert references, explain something in detail,
+% \ldots), this could be streamlined by defining new commands like
+% below.
+% \begin{verbatim}
+% \newcommand{\insertref}[1]{\todo[color=green!40]{#1}}
+% \newcommand{\explainindetail}[1]{\todo[color=red!40]{#1}}
+% \end{verbatim}
+% An example that uses all of the color options is given below
+% \todo[linecolor=green!70!white, backgroundcolor=blue!20!white,
+% bordercolor=red]{Anything but default colors}.
+% \begin{verbatim}
+% \todo[linecolor=green!70!white, backgroundcolor=blue!20!white,
+% bordercolor=red]{Anything but default colors}.
+% \end{verbatim}
+%
+%
+% \DescribeMacro{line / noline}
+% If you want to get rid of the line connecting the inserted note
+% with the place in the text where the note occurs in the latex
+% code, the option |noline| can be used.
+% \todo[noline]{A note with no line connecting it to the placement
+% in the original text.}
+% |\todo[noline]{A note with no line ...}|
+% \vspace{1.0cm}
+% 
+%
+% \DescribeMacro{inline / noinline}
+% It is possible to place a todonote inside the text instead of
+% placing it in the margin, this could be desirable if the text in
+% the note has a considerable length.
+% |\todo[inline]{A todonote placed in the text}|
+% \todo[inline]{A todonote placed in the text}
+
+% \begin{wrapfigure}[1]{r}[20mm]{40mm}
+% \begin{tikzpicture}
+% \draw[red] (0, 0) circle(0.45);
+% \draw[green] (1, 0) circle(0.45);
+% \draw[blue] (2, 0) circle(0.45);
+% \end{tikzpicture}
+% \caption{A text explaining the image.
+% \todo[inline]{Fill those circles \ldots}}
+% \end{wrapfigure}
+% Another usage for the inline option is when you want to add a
+% todonote to a figure caption.
+%
+% \begin{verbatim}
+% \begin{wrapfigure}{r}[20mm]{40mm}
+% \begin{tikzpicture}
+% \draw[red] (0, 0) circle(0.45);
+% \draw[green] (1, 0) circle(0.45);
+% \draw[blue] (2, 0) circle(0.45);
+% \end{tikzpicture}
+% \caption{A text explaining the image.
+% \todo[inline]{Fill those circles \ldots}}
+% \end{wrapfigure}
+% \end{verbatim}
+%
+% \DescribeMacro{size}
+% |size=val| changes the size of the text inside the todonote.
+% The commands used to create the notes below are \\ \noindent
+% |\todo[size=\Large]{A note with a large font size.}|
+% and \\ \noindent
+% |\todo[inline, size=\tiny]{Note with very small font size.}|.
+% \todo[size=\Large]{A note with a large font size.}
+% \todo[inline, size=\footnotesize]{Note with very small font size.}
+%
+% \DescribeMacro{list / nolist}
+% When the option |nolist| is given, the todo item will not appear in
+% the list of todos.
+%
+% \DescribeMacro{caption}
+% The |caption| option enables the user to specify a short
+% description of the todonote that are inserted in the list of
+% todos instead of the full todonote text.
+% \todo[caption={Short note}]{A very long and tedious note that
+% cannot be on one line in the list of todos.}
+% \begin{verbatim}
+% \todo[caption={Short note}]{A very long and tedious note that
+% cannot be on one line in the list of todos.}.
+% \end{verbatim}
+% The effect of this option is altered with the package option
+% |prependcaption| or the |prepend| / |noprepend| option for the
+% todo command.
+%
+% \DescribeMacro{prepend / noprepend}
+% The options |prepend| and |noprepend| can be used for setting
+% whether a given caption should be prepended to the todonote or
+% not.
+% Globally this can be set using the |prependcaption| option for the
+% package.~\todo[prepend, caption={Short note with prepend}]{A very
+% long and tedious note that cannot be on one line in the list of
+% todos.} Below is the effect of the option shown using the code:
+% \todo[noprepend, caption={Short note with noprepend}]{A very long
+% and tedious note that cannot be on one line in the list of
+% todos.}
+% \begin{verbatim}
+% \todo[prepend, caption={Short note with prepend}]{A very long and tedious 
+% note that cannot be on one line in the list of todos.}.
+% \todo[noprepend, caption={Short note with noprepend}]{A very long and 
+% tedious note that cannot be on one line in the list of todos.}.
+% \end{verbatim}
+%
+% \DescribeMacro{author}
+% The |author| option takes a parameter, the name of the author.
+% The given name is inserted in the todonote.
+% \todo[author=Xavier]{Testing author option.}
+% \todo[author=Xavier, inline]{Testing author option.}
+% \begin{verbatim}
+% \todo[author=Xavier]{Testing author option.}
+% \todo[author=Xavier, inline]{Testing author option.}
+% \end{verbatim}
+%
+% \subsection{Options for the missingfigure command}
+%
+% \DescribeMacro{figwidth}
+% The |figwidth=length| option sets the width of the figure inserted by the
+% |\missingfigure| command.
+% Length values below $6cm$ might trigger some problems with the
+% visual appearance.
+% Try to compare the default of the missing figure command, when the
+% option is given or not. 
+% \begin{verbatim}
+% \missingfigure[figwidth=6cm]{Testing a long text string}
+% \end{verbatim}
+% \missingfigure[figwidth=6cm]{Testing a long text string}
+% \begin{verbatim}
+% \missingfigure{Testing a long text string}
+% \end{verbatim}
+% \missingfigure{Testing a long text string}
+% \begin{wrapfigure}{r}[2cm]{6cm}
+% \missingfigure[figwidth=6cm]{Add a test image \ldots}
+% \end{wrapfigure}
+% Another usage of the option is when |\missingfigure| is used in
+% the wrapfigure environment.
+% \begin{verbatim}
+% \begin{wrapfigure}{r}[2cm]{6cm}
+% \missingfigure[figwidth=6cm]{Add a test image \ldots}
+% \end{wrapfigure}
+% \end{verbatim}
+% 
+% \DescribeMacro{figheight}
+% The |figheight=length| option changes the height of the inserted 
+% missing figure.
+% The default height is 4cm and using values lower than this might 
+% cause the warning sign to pop out of the gray area.
+% \begin{verbatim}
+% \missingfigure[figheight=6cm]{Testing a long text string}
+% \end{verbatim}
+% \missingfigure[figheight=6cm]{Testing}
+%
+%
+% \subsection{Options for the listoftodos command}
+% The |\listoftodos| command takes one optional argument, that
+% defines the name of the inserted list of todos.
+% \begin{verbatim}
+% \listoftodos[I can be called anything]
+% \end{verbatim}
+% 
+%
+%
+% \subsection{Known issues}
+% \subsubsection{Package loading order}
+% The luatodonotes package requires the following packages:
+% \begin{multicols}{2}
+% \begin{itemize}
+% \item ifthen
+% \item xkeyval
+% \item xcolor
+% \item tikz
+% \item graphicx (is loaded via the tikz package)
+% \item luacode
+% \item luatex
+% \item atbegshi
+% \item xstring
+% \item zref-abspage
+% \item ifoddpage
+% \item soul
+% \item soulpos
+% \end{itemize}
+% \end{multicols}
+% \noindent
+% When luatodonotes are loaded in the preamble, the package checks
+% if these packages all are loaded. If that is not the case it loads
+% the missing packages with no options given.
+% If you want to give some specific options to some of these
+% packages, you have to load them \emph{before} the luatodonotes
+% package, otherwise you will get an ''Option clash'' error when
+% latex works on the document.
+% 
+% If both the menukeys and the xcolor (with the option \verb!table!) 
+% package should be loaded, the following order must be used.
+% \begin{verbatim}
+%\usepackage[table]{xcolor}
+%\usepackage{todonotes}
+%\usepackage{menukeys}
+% \end{verbatim}
+%
+% \subsubsection{Spacing around inserted notes}
+% Inserted todo commands will eat the white space after the command.
+% \begin{verbatim}
+%Testing\todo{Does this eat the space?} testing
+% \end{verbatim}
+% 
+% Testing\todo{Does this eat the space?}testing
+%
+%
+% \subsubsection{Conflicts with the amsart documentclass}
+% The |amsart| document class redefines some internal commands that
+% is used by the todonotes package, this will cause an malfunctioning
+% |\listoftodos| command.
+% The following code to circumvent the problem was given by Dan
+% Luecking on comp.text.tex
+% \begin{verbatim}
+% \makeatletter
+%   \providecommand\@dotsep{5}
+% \makeatother
+% \listoftodos\relax 
+% \end{verbatim}
+%
+% NOT TESTED
+% NOT TESTED
+% NOT TESTED
+%
+% Dominique suggests the following workaround.
+% \begin{verbatim}
+% \makeatletter
+% \providecommand\@dotsep{5}
+% \def\listtodoname{List of Todos}
+% \def\listoftodos{\@starttoc{tdo}\listtodoname}
+% \makeatother
+% \end{verbatim}
+%
+%
+%
+% \subsubsection{Unknown option ''remember picture''}
+% If latex throws the error
+% \begin{verbatim}
+% Package tikz Error: I do not know what to do with the option ``remember picture''.
+% \end{verbatim}
+% It probably means that your latex installation is outdated, as
+% only newer versions of latex driver for tikz supports the
+% |remember picture| option.
+% For additional info consult 
+% ''Section 9.2.2 Producing PDF Output'' in the tikz manual. 
+% \url{http://www.ctan.org/tex-archive/graphics/pgf/base/doc/generic/pgf/pgfmanual.pdf}
+%
+%
+%
+% \subsubsection{List of todo heading is not correctly formatted}
+% If using natbib, the todonotes list title gets screwed up unless 
+% you do something like this:
+% \begin{verbatim}
+% \makeatletter\let\chapter\@undefined\makeatother 
+% \end{verbatim}
+% Suggestion by Richard Stanton.
+%
+%
+%
+% \subsubsection{Some commands not working inside notes}
+% Some commands will not work like expected, when used inside of a note.
+% They will cause errors when processing the document or have simply no effect.
+% This is caused by the mechanism used to layout the notes:
+% The content is written into a hbox when a |\todo| is encountered.
+% The contents of this box are then stored until the note is typeset.
+% By that time the contents are taken out of the hbox (by |\unhbox|) and put
+% into a |\parbox| with the width required for the note.
+% I don't have a solution for this problem yet.
+% 
+% 
+% 
+% 
+%
+% \iffalse
+% \StopEventually{\PrintChanges\PrintIndex}
+% \fi
+% \StopEventually{\PrintChanges}
+%
+% \newpage
+% \section{Implementation}
+%
+% Identifies the package and loads the packages dependences.
+%    \begin{macrocode}
+\ProvidesPackage{luatodonotes}[2014/06/08]
+\RequirePackage{ifthen}
+\RequirePackage{xkeyval}
+\RequirePackage{xcolor}
+\RequirePackage{tikz}
+\usetikzlibrary{positioning}
+\usetikzlibrary{intersections}
+\usetikzlibrary{decorations.pathmorphing}
+\RequirePackage{luacode}
+\RequirePackage{luatex}
+\RequirePackage{atbegshi}
+\RequirePackage{xstring}
+\RequirePackage{zref-abspage}
+\RequirePackage{ifoddpage}
+\RequirePackage{soul}
+\RequirePackage{soulpos}
+%    \end{macrocode}
+% Some default values are set
+%    \begin{macrocode}
+\newcommand{\@todonotes@text}{}%
+\newcommand{\@todonotes@backgroundcolor}{orange}
+\newcommand{\@todonotes@linecolor}{black!30}
+\newcommand{\@todonotes@bordercolor}{black}
+\newcommand{\@todonotes@leaderwidth}{1.6pt}
+\newcommand{\@todonotes@textsize}{\normalsize}
+\newcommand{\@todonotes@figwidth}{\columnwidth}
+\newcommand{\@todonotes@figheight}{4cm}
+%    \end{macrocode}
+% Default values for variables added by luatodonotes
+%    \begin{macrocode}
+\newcommand{\@todonotes@positioning}{inputOrderStacks}
+\newcommand{\@todonotes@splitting}{none}
+\newcommand{\@todonotes@leadertype}{opo}
+\newcommand{\@todonotes@interNoteSpace}{5pt}
+\newcommand{\@todonotes@noteInnerSep}{5pt}
+\newcommand{\@todonotes@routingAreaWidth}{0.4cm}
+\newcommand{\@todonotes@minNoteWidth}{2.0cm}
+\newcommand{\@todonotes@distanceNotesPageBorder}{0.5cm}
+\newcommand{\@todonotes@distanceNotesText}{0.2cm}
+\newcommand{\@todonotes@rasterHeight}{1cm}
+%    \end{macrocode}
+%    \begin{macrocode}
+\AtBeginDocument{
+\ifx\undefined\phantomsection
+\newcommand{\phantomsection}{}
+\fi
+}
+%    \end{macrocode}
+%
+% \subsection{Declaration of options for the package}
+% In this part the various options for
+% the package are defined.
+%
+% Define the default text strings and set localization options for
+% the danish and german languages.
+%    \begin{macrocode}
+\newcommand{\@todonotes@todolistname}{Todo list}
+\newcommand{\@todonotes@MissingFigureText}{Figure}
+\newcommand{\@todonotes@MissingFigureUp}{Missing}
+\newcommand{\@todonotes@MissingFigureDown}{figure}
+\newcommand{\@todonotes@SetTodoListName}[1]
+    {\renewcommand{\@todonotes@todolistname}{#1}}
+\newcommand{\@todonotes@SetMissingFigureText}[1]
+    {\renewcommand{\@todonotes@MissingFigureText}{#1}}
+\newcommand{\@todonotes@SetMissingFigureUp}[1]
+    {\renewcommand{\@todonotes@MissingFigureUp}{#1}}
+\newcommand{\@todonotes@SetMissingFigureDown}[1]
+    {\renewcommand{\@todonotes@MissingFigureDown}{#1}}
+\newif{\if@todonotes@reverseMissingFigureTriangle}
+\DeclareOptionX{catalan}{
+    \@todonotes@SetTodoListName{Llista de feines pendents}%
+    \@todonotes@SetMissingFigureText{Figura}%
+    \@todonotes@SetMissingFigureUp{Figura}%
+    \@todonotes@SetMissingFigureDown{pendent}%
+}
+\DeclareOptionX{danish}{%
+    \@todonotes@SetTodoListName{G\o{}rem\aa{}lsliste}%
+    \@todonotes@SetMissingFigureText{Figur}%
+    \@todonotes@SetMissingFigureUp{Manglende}%
+    \@todonotes@SetMissingFigureDown{figur}%
+}
+\DeclareOptionX{dutch}{%
+   \@todonotes@SetTodoListName{Lijst van onafgewerkte taken}%
+   \@todonotes@SetMissingFigureText{Figuur}%
+   \@todonotes@SetMissingFigureUp{Ontbrekende}%
+   \@todonotes@SetMissingFigureDown{figuur}%
+}
+\DeclareOptionX{english}{%
+   \@todonotes@SetTodoListName{Todo list}%
+   \@todonotes@SetMissingFigureText{Figure}%
+   \@todonotes@SetMissingFigureUp{Missing}%
+   \@todonotes@SetMissingFigureDown{figure}%
+}
+\DeclareOptionX{french}{%
+    \@todonotes@SetTodoListName{Liste des points \`a traiter}%
+    \@todonotes@SetMissingFigureText{Figure}%
+    \@todonotes@SetMissingFigureUp{Figure}%
+    \@todonotes@SetMissingFigureDown{manquante}%
+    \@todonotes@reverseMissingFigureTrianglefalse
+}
+\DeclareOptionX{german}{%
+    \@todonotes@SetTodoListName{Liste der noch zu erledigenden Punkte}%
+    \@todonotes@SetMissingFigureText{Abbildung}%
+    \@todonotes@SetMissingFigureUp{Fehlende}%
+    \@todonotes@SetMissingFigureDown{Abbildung}%
+}
+\DeclareOptionX{italian}{
+    \@todonotes@SetTodoListName{Elenco delle cose da fare}%
+    \@todonotes@SetMissingFigureText{Figura}%
+    \@todonotes@SetMissingFigureUp{Figura}%
+    \@todonotes@SetMissingFigureDown{mancante}%
+}
+\DeclareOptionX{ngerman}{%
+    \@todonotes@SetTodoListName{Liste der noch zu erledigenden Punkte}%
+    \@todonotes@SetMissingFigureText{Abbildung}%
+    \@todonotes@SetMissingFigureUp{Fehlende}%
+    \@todonotes@SetMissingFigureDown{Abbildung}%
+}
+\DeclareOptionX{portuguese}{
+    \@todonotes@SetTodoListName{Lista de tarefas pendentes}%
+    \@todonotes@SetMissingFigureText{Figura}%
+    \@todonotes@SetMissingFigureUp{Figura}%
+    \@todonotes@SetMissingFigureDown{pendente}%
+}
+\DeclareOptionX{spanish}{
+    \@todonotes@SetTodoListName{Lista de tareas pendientes}%
+    \@todonotes@SetMissingFigureText{Figura}%
+    \@todonotes@SetMissingFigureUp{Figura}%
+    \@todonotes@SetMissingFigureDown{pendiente}%
+}
+\DeclareOptionX{swedish}{%
+    \@todonotes@SetTodoListName{Att g\"{o}ra-lista}%
+    \@todonotes@SetMissingFigureText{Figur}%
+    \@todonotes@SetMissingFigureUp{Figur}%
+    \@todonotes@SetMissingFigureDown{saknas}%
+}
+%    \end{macrocode}
+% Create a counter, for storing the number of inserted todos.
+%    \begin{macrocode}
+\newcounter{@todonotes@numberoftodonotes}
+%    \end{macrocode}
+% Create a counter, for storing the number of lines in the current todoarea.
+%    \begin{macrocode}
+\newcounter{@todonotes@numberofLinesInArea}
+%    \end{macrocode}
+% Toggle whether the package should obey the global draft option.
+%    \begin{macrocode}
+\newif{\if@todonotes@obeyDraft}
+\DeclareOptionX{obeyDraft}{\@todonotes@obeyDrafttrue}
+\newif{\if@todonotes@isDraft}
+\DeclareOptionX{draft}{\@todonotes@isDrafttrue}
+\DeclareOptionX{draftcls}{\@todonotes@isDrafttrue}
+\DeclareOptionX{draftclsnofoot}{\@todonotes@isDrafttrue}
+\newif{\if@todonotes@obeyFinal}
+\DeclareOptionX{obeyFinal}{\@todonotes@obeyFinaltrue}
+\newif{\if@todonotes@isFinal}
+\DeclareOptionX{final}{\@todonotes@isFinaltrue}
+%    \end{macrocode}
+% Make it possible to disable the functionality
+% of the package. If this option is given, the
+% commands  |\todo{}| and |\listoftodos| are defined
+% as commands with no effect. (But you can still
+% compile you document with these commands).
+%    \begin{macrocode}
+\newif{\if@todonotes@disabled}
+\DeclareOptionX{disable}{\@todonotes@disabledtrue}
+%    \end{macrocode}
+% Show small boxes in the list of todos with the color of the
+% inserted todonotes.
+%    \begin{macrocode}
+\newif{\if@todonotes@colorinlistoftodos}
+\DeclareOptionX{colorinlistoftodos}{\@todonotes@colorinlistoftodostrue}
+%    \end{macrocode}
+% We only define dvistyle for compatibility with todonotes. 
+% The option was intented for use with \texttt{tex}, there should be no problems
+% using \texttt{luatex}.
+% So we ignore this option and issue a warning.
+%    \begin{macrocode}
+\DeclareOptionX{dvistyle}{\PackageWarningNoLine{luatodonotes}
+    {Parameter dvistyle is not supported by luatodonotes.
+    Ignoring this option}}
+%    \end{macrocode}
+% Create a color option.
+%    \begin{macrocode}
+\define@key{luatodonotes.sty}%
+    {color}{
+        \renewcommand{\@todonotes@backgroundcolor}{#1}
+        \renewcommand{\@todonotes@linecolor}{#1}}
+%    \end{macrocode}
+% Make the background color of the notes as
+% an option.
+%    \begin{macrocode}
+\define@key{luatodonotes.sty}%
+    {backgroundcolor}{\renewcommand{\@todonotes@backgroundcolor}{#1}}
+%    \end{macrocode}
+% Make the line color of the notes as
+% an option.
+%    \begin{macrocode}
+\define@key{luatodonotes.sty}%
+    {linecolor}{\renewcommand{\@todonotes@linecolor}{#1}}
+%    \end{macrocode}
+% Make the color of the notes box color as
+% an option.
+%    \begin{macrocode}
+\define@key{luatodonotes.sty}%
+    {bordercolor}{\renewcommand{\@todonotes@bordercolor}{#1}}
+%    \end{macrocode}
+% Make the width of the leader line as
+% an option.
+% It is later set as \texttt{line width} in TikZ.
+%    \begin{macrocode}
+\define@key{luatodonotes.sty}%
+    {leaderwidth}{\renewcommand{\@todonotes@leaderwidth}{#1}}
+%    \end{macrocode}
+% Set whether short captions given as arguments to the todo command
+% should be included in the inserted todonote.
+%    \begin{macrocode}
+\newif{\if@todonotes@prependcaptionglobal}
+\@todonotes@prependcaptionglobalfalse
+\DeclareOptionX{prependcaption}{\@todonotes@prependcaptionglobaltrue}
+%    \end{macrocode}
+% This option is only there for compatibility with todonotes.
+% We ignore it and issue a warning because the width of our labels is
+% determined dynamically based on the page layout.
+%    \begin{macrocode}
+\define@key{luatodonotes.sty}%
+    {textwidth}{\PackageWarningNoLine{luatodonotes}
+    {Parameter textwidth is not supported by luatodonotes}}
+%    \end{macrocode}
+% Make the text size as an option. It requires some magic with the 
+% |\csname| and |\endcsname| macros, as commands cannot be taken as
+% options for a package.
+%    \begin{macrocode}
+\define@key{luatodonotes.sty}%
+    {textsize}{\renewcommand{\@todonotes@textsize}{\csname #1\endcsname}}
+%    \end{macrocode}
+% Add option for shadows behind the inserted notes
+%    \begin{macrocode}
+\newif{\if@todonotes@shadowenabled}
+\@todonotes@shadowenabledfalse
+\DeclareOptionX{shadow}{\@todonotes@shadowenabledtrue
+\usetikzlibrary{shadows}}
+%    \end{macrocode}
+% Add option for the default width of the figure inserted with
+% |\missingfigure|.
+%    \begin{macrocode}
+\define@key{luatodonotes.sty}%
+    {figwidth}{\renewcommand{\@todonotes@figwidth}{#1}}
+\define@key{luatodonotes.sty}%
+    {figheight}{\renewcommand{\@todonotes@figheight}{#1}}
+%    \end{macrocode}
+% Specify the name of the algorithm used to specify the position of the labels.
+%    \begin{macrocode}
+\define@key{luatodonotes.sty}%
+    {positioning}{\renewcommand{\@todonotes@positioning}{#1}}
+%    \end{macrocode}
+% Specify the name of the algorithm used to split the notes for left and right side.
+%    \begin{macrocode}
+\define@key{luatodonotes.sty}%
+    {splitting}{\renewcommand{\@todonotes@splitting}{#1}}
+%    \end{macrocode}
+% Specify the type of leaders that are drawn.
+%    \begin{macrocode}
+\define@key{luatodonotes.sty}%
+    {leadertype}{\renewcommand{\@todonotes@leadertype}{#1}}
+%    \end{macrocode}
+% Specify the vertical distance between the notes.
+%    \begin{macrocode}
+\define@key{luatodonotes.sty}%
+    {interNoteSpace}{\renewcommand{\@todonotes@interNoteSpace}{#1}}
+%    \end{macrocode}
+% Specify the distance from the text inside the notes to the border.
+%    \begin{macrocode}
+\define@key{luatodonotes.sty}%
+    {noteInnerSep}{\renewcommand{\@todonotes@noteInnerSep}{#1}}
+%    \end{macrocode}
+% Specify the width of the routing area used for $opo$- and $os$-leaders.
+%    \begin{macrocode}
+\define@key{luatodonotes.sty}%
+    {routingAreaWidth}{\renewcommand{\@todonotes@routingAreaWidth}{#1}}
+%    \end{macrocode}
+% Minimum width of notes in one margin beside the text to be considered for
+% label placement.
+%    \begin{macrocode}
+\define@key{luatodonotes.sty}%
+    {minNoteWidth}{\renewcommand{\@todonotes@minNoteWidth}{#1}}
+%    \end{macrocode}
+% Specify horizontal distance from the notes to the borders of the page.
+%    \begin{macrocode}
+\define@key{luatodonotes.sty}%
+    {distanceNotesPageBorder}%
+    {\renewcommand{\@todonotes@distanceNotesPageBorder}{#1}}
+%    \end{macrocode}
+% Specify the horizontal distance between the notes and the text area.
+%    \begin{macrocode}
+\define@key{luatodonotes.sty}%
+    {distanceNotesText}{\renewcommand{\@todonotes@distanceNotesText}{#1}}
+%    \end{macrocode}
+% Specify the height of the raster used for the $po$-leader algorithm.
+%    \begin{macrocode}
+\define@key{luatodonotes.sty}%
+    {rasterHeight}{\renewcommand{\@todonotes@rasterHeight}{#1}}
+%    \end{macrocode}
+% This option is used to activate debug mode.
+% Luatex prints more verbose output to the commandline in this mode.
+% Furthermore, some of the algorithms also print debugging hints onto the
+% output page.
+%    \begin{macrocode}
+\newif{\if@todonotes@debugenabled}
+\@todonotes@debugenabledfalse
+\DeclareOptionX{debug}{\@todonotes@debugenabledtrue}
+%    \end{macrocode}
+% Finally process the given options.
+%    \begin{macrocode}
+\ProcessOptionsX*
+%    \end{macrocode}
+% If the |obeyDraft| is given, check whether one of the |draft|, 
+% |draftcls| or |draftclsnofoot|
+% options are given and enable or disable the functionality of this
+% package.
+% If the |obeyFinal| option is given together with the |final| option
+% the todonotes are disabled.
+% The |disable| option will overrule the effect of |obeyDraft|.
+%    \begin{macrocode}
+\if@todonotes@disabled
+\else
+    \if@todonotes@obeyDraft
+        \@todonotes@disabledtrue
+        \if@todonotes@isDraft
+            \@todonotes@disabledfalse
+        \fi
+    \fi
+    \if@todonotes@obeyFinal
+        \@todonotes@disabledfalse
+        \if@todonotes@isFinal
+            \@todonotes@disabledtrue
+        \fi
+    \fi
+\fi
+%    \end{macrocode}
+% \subsection{Initialisation of our Lua code}
+% In this part we define some of the variables used by Lua depending on the
+% package options and do some other initialisation tasks.
+%
+% We first need some temporary dimensions, which are written by \TeX\ and read
+% from Lua.
+% We use dimensions here because it is easier to access \TeX\ dimensions from
+% Lua than \LaTeX\ lengths.
+% We use |tex.dimen| in Lua to access dimensions.
+% The first dimensions are used when extracting the absolute coordinates of a
+% position on the page.
+%    \begin{macrocode}
+\newdimen\@todonotes@extractx
+\newdimen\@todonotes@extracty
+%    \end{macrocode}
+% The following savebox and dimensions are used to calculate the height of a
+% certain label.
+% The box and dimensions are filled by \TeX\ and then read from Lua.
+%    \begin{macrocode}
+\newsavebox\@todonotes@heightcalcbox
+\newdimen\@todonotes@heightcalcboxdepth
+\newdimen\@todonotes@heightcalcboxheight
+%    \end{macrocode}
+% The following savebox is used to store the contents of a note and is then
+% read from Lua.
+%    \begin{macrocode}
+\newsavebox\@todonotes@notetextbox
+%    \end{macrocode}
+% The following dimensions are used to read |\baselineskip| and
+% |\f@size| from Lua.
+% Dimension |\@todonotes@currentsidemargin| is set to the left margin,
+% i.\,e., to the value of length |\oddsidemargin| or
+% |\evensidemargin| depending on the type page.
+%    \begin{macrocode}
+\newdimen\@todonotes@baselineskip
+\newdimen\@todonotes@fontsize
+\newdimen\@todonotes@currentsidemargin
+%    \end{macrocode}
+% Loading our main Lua file.
+%    \begin{macrocode}
+\directlua{require("luatodonotes")}
+%    \end{macrocode}
+% Setting variables to values given by package options.
+%    \begin{macrocode}
+\directlua{noteInnerSep =
+    string.todimen("\luatexluaescapestring{\@todonotes@noteInnerSep}")}
+\directlua{noteInterSpace =
+    string.todimen("\luatexluaescapestring{\@todonotes@interNoteSpace}")}
+\directlua{routingAreaWidth =
+    string.todimen("\luatexluaescapestring{\@todonotes@routingAreaWidth}")}
+\directlua{minNoteWidth =
+    string.todimen("\luatexluaescapestring{\@todonotes@minNoteWidth}")}
+\directlua{distanceNotesPageBorder =
+    string.todimen("\luatexluaescapestring{\@todonotes@distanceNotesPageBorder}")}
+\directlua{distanceNotesText =
+    string.todimen("\luatexluaescapestring{\@todonotes@distanceNotesText}")}
+\directlua{rasterHeight =
+    string.todimen("\luatexluaescapestring{\@todonotes@rasterHeight}")}
+%    \end{macrocode}
+% Set the variable for the positioning algorithm depending on the corresponding
+% package option.
+%    \begin{macrocode}
+\IfStrEqCase{\@todonotes@positioning}{%
+    {inText}{\directlua{positioning = positioningAlgos["inText"]}}%
+    {inputOrder}{\directlua{positioning = positioningAlgos["inputOrder"]}}%
+    {inputOrderStacks}{\directlua{positioning =
+        positioningAlgos["inputOrderStacks"]}}%
+    {sLeaderNorthEast}{\directlua{positioning =
+        positioningAlgos["sLeaderNorthEast"]}}%
+    {sLeaderNorthEastBelow}{\directlua{positioning =
+        positioningAlgos["sLeaderNorthEastBelow"]}}%
+    {sLeaderEast}{\directlua{positioning =
+        positioningAlgos["sLeaderEast"]}}%
+    {poLeaders}{\directlua{positioning = positioningAlgos["poLeaders"]}}%
+    {poLeadersAvoidLines}{\directlua{positioning =
+        positioningAlgos["poLeadersAvoidLines"]}}%
+    {sLeaderNorthEastBelowStacks}{\directlua{positioning =
+        positioningAlgos["sLeaderNorthEastBelowStacks"]}}}%
+    [\directlua{positioning = positioningAlgos["inputOrderStacks"]}
+    \PackageWarningNoLine{luatodonotes}
+        {Invalid value for parameter positioning: \@todonotes@positioning}]
+%    \end{macrocode}
+% Set the variable for the splitting algorithm depending on the corresponding
+% package option.
+%    \begin{macrocode}
+\IfStrEqCase{\@todonotes@splitting}{%
+    {none}{\directlua{splitting = splittingAlgos["none"]}}%
+    {middle}{\directlua{splitting = splittingAlgos["middle"]}}%
+    {median}{\directlua{splitting = splittingAlgos["median"]}}%
+    {weightedMedian}{\directlua{splitting = splittingAlgos["weightedMedian"]}}}%
+    [\directlua{splitting = splittingAlgos["none"]}
+    \PackageWarningNoLine{luatodonotes}
+        {Invalid value for parameter split: \@todonotes@splitting}]
+%    \end{macrocode}
+% Specify the requested leader type.
+%    \begin{macrocode}
+\IfStrEqCase{\@todonotes@leadertype}{%
+    {s}{\directlua{leaderType = leaderTypes["s"]}}%
+    {opo}{\directlua{leaderType = leaderTypes["opo"]}}%
+    {po}{\directlua{leaderType = leaderTypes["po"]}}%
+    {sBezier}{\directlua{leaderType = leaderTypes["sBezier"]}}%
+    {os}{\directlua{leaderType = leaderTypes["os"]}}}%
+    [\directlua{leaderType = leaderTypes["opo"]}
+    \PackageWarningNoLine{luatodonotes}
+        {Invalid value for parameter leadertype: \@todonotes@leadertype}]
+%    \end{macrocode}
+% The following commands are used to detect the absolute positions of lines on
+% the page.
+%
+% We first need to define a command to be able to insert the position from
+% |\pdflastypos| into a write-whatsit in Lua.
+% We need this workaround because we cannot insert |\pdflastypos| directly into
+% the tokenlist in the Lua callback \texttt{callbackOutputLinePositions()}.
+%    \begin{macrocode}
+\def\@todonotes@pdflastypos{\the\pdflastypos}
+%    \end{macrocode}
+% The following commands are written to the temporary \texttt{lpo}-file.
+% When reading this file we call a Lua function for each line in the file and
+% thus can collect the line positions in a Lua table.
+%    \begin{macrocode}
+\newcommand{\@todonotes@lineposition}[3]{%
+    \directlua{linePositionsAddLine(#1,#2,#3)}%
+}
+\newcommand{\@todonotes@nextpage}{%
+    \directlua{linePositionsNextPage()}%
+}%
+%    \end{macrocode}
+% The following macro is used in \texttt{AtBeginShipout} to signal in the
+% \texttt{lpo}-file that a new page is started.
+%    \begin{macrocode}
+\newcommand{\@todonotes@writeNextpageToLpo}{%
+    \ifdefined\tf@lpo%
+        \immediate\write\tf@lpo{\@backslashchar @todonotes@nextpage}%
+    \fi
+}
+%    \end{macrocode}
+% Depending on the debug-option of the package we set the corresponding Lua
+% variable here.
+% Additionally, we prepare to print our notes and leaders in foreground when in
+% debug mode.
+%    \begin{macrocode}
+\if@todonotes@debugenabled
+    \directlua{todonotesDebug = true}
+    \newcommand{\@todonotes@AtBeginShipoutUpperLeft}
+        {\AtBeginShipoutUpperLeftForeground}
+\else
+    \directlua{todonotesDebug = false}
+    \newcommand{\@todonotes@AtBeginShipoutUpperLeft}
+        {\AtBeginShipoutUpperLeft}
+\fi
+%    \end{macrocode}
+% Initialise the script when all Lua variables are set according to the package
+% options.
+%    \begin{macrocode}
+\directlua{initTodonotes()}
+%    \end{macrocode}
+% Some definitions to highlight areas in text.
+% The first command is needed to accept control spaces (|\ |) in arguments for
+% soul commands.
+% After that we define the highlighting command used for todoareas.
+%    \begin{macrocode}
+\soulregister{\ }{0}
+\newlength{\todonotes@textmark@width}
+\newlength{\todonotes@textmark@fontsize}
+\newlength{\todonotes@textmark@linebelow}
+\newlength{\todonotes@textmark@lineabove}
+\ulposdef{\todonotes@textmark@highlight}{%
+    \setlength\todonotes@textmark@width\ulwidth%
+    \setlength\todonotes@textmark@fontsize{\f@size pt}%
+    \stepcounter{@todonotes@numberofLinesInArea}%
+    \ifulstarttype{0}%
+        {% begin of area
+        \def\todonotes@textmark@decoLeft{}%
+        \def\todonotes@textmark@shift{-2pt}%
+        \addtolength\todonotes@textmark@width{2pt}%
+        \setcounter{@todonotes@numberofLinesInArea}{1}}%
+        {\def\todonotes@textmark@decoLeft{@todonotes@todoarea}%
+        \def\todonotes@textmark@shift{-4pt}%
+        \addtolength\todonotes@textmark@width{4pt}}%
+    \ifulendtype{0}%
+        {% last line of area
+        \def\todonotes@textmark@decoRight{}%
+        \addtolength\todonotes@textmark@width{2pt}%
+        \directlua{processLastLineInTodoArea()}}%
+        {\def\todonotes@textmark@decoRight{@todonotes@todoarea}%
+        \addtolength\todonotes@textmark@width{4pt}}%
+    \newcommand{\@todonotes@nodeNamePrefix}%
+        {@todonotes@\arabic{@todonotes@numberoftodonotes}%
+         @\arabic{@todonotes@numberofLinesInArea} }%
+    \hspace*{\todonotes@textmark@shift}{\smash{%
+        \begin{tikzpicture}[overlay,remember picture,
+            deco/.style={}]%
+            \setlength\todonotes@textmark@linebelow%
+                {-0.95\dimexpr\baselineskip-\f@size pt\relax}%
+            \setlength\todonotes@textmark@lineabove%
+                {\dimexpr\f@size pt+\todonotes@textmark@linebelow\relax}%
+            \coordinate
+                (\@todonotes@nodeNamePrefix areaSW)
+                at (0,\todonotes@textmark@linebelow);
+            \coordinate
+                (\@todonotes@nodeNamePrefix areaSE)
+                at (\todonotes@textmark@width, \todonotes@textmark@linebelow);
+            \coordinate
+                (\@todonotes@nodeNamePrefix areaNE)
+                at (\todonotes@textmark@width,\todonotes@textmark@lineabove);
+            \coordinate
+                (\@todonotes@nodeNamePrefix areaNW)
+                at (0,\todonotes@textmark@lineabove);
+            \draw[draw=green!70,fill=green,fill opacity=.2]
+                (\@todonotes@nodeNamePrefix areaSW)
+                decorate[\todonotes@textmark@decoLeft] {
+                    -- (\@todonotes@nodeNamePrefix areaNW)
+                }
+                -- (\@todonotes@nodeNamePrefix areaNE)
+                decorate[\todonotes@textmark@decoRight] {
+                    -- (\@todonotes@nodeNamePrefix areaSE)
+                }
+                -- cycle;
+         \end{tikzpicture}%
+    }}%
+}%
+%    \end{macrocode}
+% \subsection{Options for the todo command}
+%
+% In this part the various options for 
+% commands in the package are defined.
+% Set an arbitrarily fill color
+%    \begin{macrocode}
+\newcommand{\@todonotes@currentlinecolor}{}%
+\newcommand{\@todonotes@currentbackgroundcolor}{}%
+\newcommand{\@todonotes@currentbordercolor}{}%
+\define@key{todonotes}{color}{%
+    \renewcommand{\@todonotes@currentlinecolor}{#1}%
+    \renewcommand{\@todonotes@currentbackgroundcolor}{#1}}%
+\define@key{todonotes}{linecolor}{%
+    \renewcommand{\@todonotes@currentlinecolor}{#1}}%
+\define@key{todonotes}{backgroundcolor}{%
+    \renewcommand{\@todonotes@currentbackgroundcolor}{#1}}%
+\define@key{todonotes}{bordercolor}{%
+    \renewcommand{\@todonotes@currentbordercolor}{#1}}%
+\newcommand{\@todonotes@currentleaderwidth}{}%
+\define@key{todonotes}{leaderwidth}{%
+    \renewcommand{\@todonotes@currentleaderwidth}{#1}}%
+%    \end{macrocode}
+% Set a relative font size
+%    \begin{macrocode}
+\newcommand{\@todonotes@sizecommand}{}%
+\define@key{todonotes}{size}{\renewcommand{\@todonotes@sizecommand}{#1}}%
+%    \end{macrocode}
+% Should the todo item be disabled?
+%    \begin{macrocode}
+\newif\if@todonotes@localdisable%
+\define@key{todonotes}{disable}[]{\@todonotes@localdisabletrue}%
+\define@key{todonotes}{nodisable}[]{\@todonotes@localdisablefalse}%
+%    \end{macrocode}
+% Should the todo item be included in the list of todos?
+%    \begin{macrocode}
+\newif\if@todonotes@appendtolistoftodos%
+\define@key{todonotes}{list}[]{\@todonotes@appendtolistoftodostrue}%
+\define@key{todonotes}{nolist}[]{\@todonotes@appendtolistoftodosfalse}%
+%    \end{macrocode}
+% Should the todo item be displayed inline?
+%    \begin{macrocode}
+\newif\if@todonotes@inlinenote%
+\define@key{todonotes}{inline}[]{\@todonotes@inlinenotetrue}%
+\define@key{todonotes}{noinline}[]{\@todonotes@inlinenotefalse}%
+%    \end{macrocode}
+%    \begin{macrocode}
+\newif\if@todonotes@prependcaption%
+\define@key{todonotes}{prepend}[]{\@todonotes@prependcaptiontrue}%
+\define@key{todonotes}{noprepend}[]{\@todonotes@prependcaptionfalse}%
+%    \end{macrocode}
+% Should the note in the margin be connected to the insertion point
+% in the text?
+%    \begin{macrocode}
+\newif\if@todonotes@line%
+\define@key{todonotes}{line}[]{\@todonotes@linetrue}%
+\define@key{todonotes}{noline}[]{\@todonotes@linefalse}%
+%    \end{macrocode}
+% Only here for compatibility with todonotes.
+% We don't need the fancy lines because we have more advanced drawing styles.
+% So we ignore this option and issue a warning.
+%    \begin{macrocode}
+\define@key{todonotes}{fancyline}[]{\PackageWarningNoLine{luatodonotes}
+    {Parameter fancyline is not supported by luatodonotes}}%
+\define@key{todonotes}{nofancyline}[]{}%
+%    \end{macrocode}
+% Author option.
+%    \begin{macrocode}
+\newcommand{\@todonotes@author}{}%
+\newif\if@todonotes@authorgiven%
+\define@key{todonotes}{author}{%
+    \renewcommand{\@todonotes@author}{#1}%
+    \@todonotes@authorgiventrue}%
+\define@key{todonotes}{noauthor}[]{\@todonotes@authorgivenfalse}%
+%    \end{macrocode}
+% Should the text in the list of todos be different from the text
+% in the todonote?
+%    \begin{macrocode}
+\newcommand{\@todonotes@caption}{}%
+\newif\if@todonotes@captiongiven%
+\define@key{todonotes}{caption}%
+    {\renewcommand{\@todonotes@caption}{#1}%
+    \@todonotes@captiongiventrue}%
+\define@key{todonotes}{nocaption}[]{\@todonotes@captiongivenfalse}%
+%    \end{macrocode}
+% Change the current figure width and height.
+%    \begin{macrocode}
+\newcommand{\@todonotes@currentfigwidth}{\@todonotes@figwidth}
+\define@key{todonotes}%
+    {figwidth}{\renewcommand{\@todonotes@currentfigwidth}{#1}}
+\newcommand{\@todonotes@currentfigheight}{\@todonotes@figheight}
+\define@key{todonotes}%
+    {figheight}{\renewcommand{\@todonotes@currentfigheight}{#1}}
+%    \end{macrocode}
+% Preset values of the options
+%    \begin{macrocode}
+\presetkeys%
+    {todonotes}%
+    {linecolor=\@todonotes@linecolor,%
+    backgroundcolor=\@todonotes@backgroundcolor,%
+    bordercolor=\@todonotes@bordercolor,%
+    leaderwidth=\@todonotes@leaderwidth,%
+    nodisable,%
+    noinline,%
+    nocaption,%
+    noauthor,%
+    figwidth=\@todonotes@figwidth,%
+    figheight=\@todonotes@figheight,%
+    line, list, size=\@todonotes@textsize}{}%
+%    \end{macrocode}
+% \subsection{The main code part}
+% Here are the actual macros defined.
+% The following boolean is used to remember if |\todo| or |\todoarea|
+% was called.
+%    \begin{macrocode}
+\newif\if@todonotes@areaselected%
+%    \end{macrocode}
+% The following token registers are used to access the data for a note (which
+% is stored in macros) from Lua.
+%    \begin{macrocode}
+\newtoks\@todonotes@toks@currentlinecolor%
+\newtoks\@todonotes@toks@currentbackgroundcolor%
+\newtoks\@todonotes@toks@currentbordercolor%
+\newtoks\@todonotes@toks@currentleaderwidth%
+\newtoks\@todonotes@toks@sizecommand%
+%    \end{macrocode}
+% If the option "disable" was passed to the package
+% define empty commands.
+%    \begin{macrocode}
+\if@todonotes@disabled%
+    \newcommand{\listoftodos}[1][]{}
+    \newcommand{\@todo}[2][]{}
+    \newcommand{\@todoarea}[3][]{}
+    \newcommand{\missingfigure}[2][]{}
+\else % \if@todonotes@disabled
+%    \end{macrocode}
+% Define the |\listoftodos| command and define the 
+% appearance of the list of todos.
+%    \begin{macrocode}
+\newcommand{\listoftodos}[1][\@todonotes@todolistname]
+    {\@ifundefined{chapter}{\section*{#1}}{\chapter*{#1}} \@starttoc{tdo}}
+\newcommand{\l@todo}
+    {\@dottedtocline{1}{0em}{2.3em}}
+%    \end{macrocode}
+% Define styles used by the todo command.
+% Colors are set directly when placing the notes.
+%    \begin{macrocode}
+\tikzset{@todonotes@todoarea/.style={
+    decoration={snake,amplitude=3.5pt,segment length=5pt}}}
+\tikzset{@todonotes@notestyleraw/.style={
+    line width=0.5pt,
+    inner sep = \@todonotes@noteInnerSep,
+    rounded corners=4pt}}
+%    \end{macrocode}
+% Add shadows and rounded corners to the inserted todonotes.
+%    \begin{macrocode}
+\if@todonotes@shadowenabled
+    \tikzset{@todonotes@notestyle/.style={@todonotes@notestyleraw,
+        general shadow={shadow xshift=.5ex, shadow yshift=-.5ex,
+        opacity=1,fill=black!50}}}
+\else
+    \tikzset{@todonotes@notestyle/.style={@todonotes@notestyleraw}}
+\fi
+\tikzset{@todonotes@leader/.style={}}
+\tikzset{@todonotes@textmark/.style={rounded corners}}
+\tikzset{@todonotes@inlinenote/.style={
+    @todonotes@notestyle,
+    draw=\@todonotes@currentbordercolor,
+    fill=\@todonotes@currentbackgroundcolor,
+    text width=\linewidth - 1.6 ex - 1 pt}}
+%    \end{macrocode}
+% \begin{macro}{\@todocommon}
+%   Common macro used from |\@todo| and |\@todoarea|.
+%   Used to actually draw/save the note.
+%    \begin{macrocode}
+\newcommand{\@todocommon}[2]{%
+%    \end{macrocode}
+% Use the global value for determining the default prepend behavior.
+%    \begin{macrocode}
+\if@todonotes@prependcaptionglobal%
+\@todonotes@prependcaptiontrue%
+\else%
+\@todonotes@prependcaptionfalse%
+\fi%
+%    \end{macrocode}
+% Store the original text for later usage and parse the given options.
+%    \begin{macrocode}
+\renewcommand{\@todonotes@text}{#2}%
+\renewcommand{\@todonotes@caption}{#2}%
+\setkeys{todonotes}{#1}%
+%    \end{macrocode}
+% If the option |disable| is given to the command, no output is generated.
+%    \begin{macrocode}
+\if@todonotes@localdisable%
+\else%
+%    \end{macrocode}
+% Add the item to the list of todos. When the option
+% |colorinlistoftodos| is given to the package a small colored 
+% square is added in front of the text.
+%    \begin{macrocode}
+\addtocounter{@todonotes@numberoftodonotes}{1}%
+\if@todonotes@appendtolistoftodos%
+    \phantomsection%
+    \if@todonotes@captiongiven%
+    \else%
+        \renewcommand{\@todonotes@caption}{#2}%
+    \fi%
+    \@todonotes@addElementToListOfTodos%
+\fi%
+%    \end{macrocode}
+% Prepend the short caption given if it is requested
+%    \begin{macrocode}
+\if@todonotes@captiongiven%
+    \if@todonotes@prependcaption%
+        \renewcommand{\@todonotes@text}{\@todonotes@caption: #2}%
+    \fi%
+\fi%
+%    \end{macrocode}
+% Place the todonote as indicated by the options (inline or in a
+% marginpar), below is the code for the inline placement.
+%    \begin{macrocode}
+\if@todonotes@inlinenote%
+    \@todonotes@drawInlineNote%
+\else%
+    \@todonotes@drawMarginNoteWithLine%
+\fi%\if@todonotes@inlinenote
+\fi%\if@todonotes@localdisable
+}%
+%    \end{macrocode}
+% \end{macro}
+% \begin{macro}{\@todo}
+%   Command that draws normal notes.
+%    \begin{macrocode}
+\newcommand{\@todo}[2][]{%
+    \@todonotes@areaselectedfalse%
+    \@todocommon{#1}{#2}%
+}%
+%    \end{macrocode}
+% \end{macro}
+% \begin{macro}{\@todoarea}
+%   Command that draws notes that highlight a certain area in text.
+%    \begin{macrocode}
+\newcommand{\@todoarea}[3][]{%
+    \@todonotes@areaselectedtrue%
+    \@todocommon{#1}{#2}%
+    \todonotes@textmark@highlight{#3}%
+%    \end{macrocode}
+% Mark the end of the highlighted area with a Tikz coordinate.
+% The begin is marked by |\@todocommon|.
+%    \begin{macrocode}
+    \begin{tikzpicture}[remember picture, overlay]%
+        \node [coordinate] (@todonotes@\arabic{@todonotes@numberoftodonotes} %
+            inTextEnd) {};%
+    \end{tikzpicture}%
+    \zref@label{@todonotes@\arabic{@todonotes@numberoftodonotes}@end}%
+}%
+%    \end{macrocode}
+% \end{macro}
+% \begin{macro}{drawMarginNoteWithLine}
+% Define helper function |drawMarginNoteWithLine|.
+%    \begin{macrocode}
+\newcommand{\@todonotes@drawMarginNoteWithLine}{%
+%    \end{macrocode}
+% When the todonote should be placed inside a marginpar, the code
+% below is applied.
+% First is the current location in the document stored, this enables
+% us later to connect this point with the inserted todonote.
+%    \begin{macrocode}
+    \begin{tikzpicture}[remember picture, overlay]%
+        \node [coordinate] (@todonotes@\arabic{@todonotes@numberoftodonotes} %
+            inText) {};%
+    \end{tikzpicture}%
+%    \end{macrocode}
+% Update the dimensions to be accessed by Lua.
+%    \begin{macrocode}
+    \@todonotes@baselineskip=\baselineskip%
+    \@todonotes@fontsize=\f@size pt%
+%    \end{macrocode}
+% Place a label at the site.
+% We use this to query the page number, on which the note was placed.
+%    \begin{macrocode}
+    \zref@label{@todonotes@\arabic{@todonotes@numberoftodonotes}}%
+%    \end{macrocode}
+% Append author before the note text if one is given.
+%    \begin{macrocode}
+    \if@todonotes@authorgiven%
+        \let\@todonotes@text@old=\@todonotes@text
+        \renewcommand{\@todonotes@text}{\@todonotes@author: \@todonotes@text@old}%
+    \fi%
+%    \end{macrocode}
+% We use edef here to get these macros fully expanded.
+% After that we write them to a toks register and read them from Lua.
+%    \begin{macrocode}
+    \edef\@todonotes@tmp{\@todonotes@currentlinecolor}%
+    \@todonotes@toks@currentlinecolor=\expandafter{\@todonotes@tmp}%
+    \edef\@todonotes@tmp{\@todonotes@currentbackgroundcolor}%
+    \@todonotes@toks@currentbackgroundcolor=\expandafter{\@todonotes@tmp}%
+    \edef\@todonotes@tmp{\@todonotes@currentbordercolor}%
+    \@todonotes@toks@currentbordercolor=\expandafter{\@todonotes@tmp}%
+    \edef\@todonotes@tmp{\@todonotes@currentleaderwidth}%
+    \@todonotes@toks@currentleaderwidth=\expandafter{\@todonotes@tmp}%
+%    \end{macrocode}
+% We cannot fully expand the size command (using |\edef| causes errors when
+% compiling).
+%    \begin{macrocode}
+    \@todonotes@toks@sizecommand=\expandafter{\@todonotes@sizecommand}%
+%    \end{macrocode}
+% We store the text that should be shown in this note into a box and copy this
+% box to a variable in Lua.
+%    \begin{macrocode}
+    \savebox\@todonotes@notetextbox{\@todonotes@sizecommand\@todonotes@text}%
+%    \end{macrocode}
+% Prepare parameters and add the note to the list in Lua.
+%    \begin{macrocode}
+    \if@todonotes@line%
+        \def\@todonotes@param@drawLeader{true}%
+    \else%
+        \def\@todonotes@param@drawLeader{false}%
+    \fi%
+    \if@todonotes@areaselected%
+        \def\@todonotes@param@noteType{area}%
+    \else%
+        \def\@todonotes@param@noteType{}%
+    \fi%
+    \directlua{addNoteToList(\arabic{@todonotes@numberoftodonotes},%
+        \@todonotes@param@drawLeader,\luastringO{\@todonotes@param@noteType})}%
+}%
+%    \end{macrocode}
+% \end{macro}
+% \begin{macro}{addElementToListOfTodos}
+% Define helper function |addElementToListOfTodos|.
+%    \begin{macrocode}
+\newcommand{\@todonotes@addElementToListOfTodos}{%
+    \if@todonotes@colorinlistoftodos%
+        \addcontentsline{tdo}{todo}{%
+            \fcolorbox{\@todonotes@currentbordercolor}%
+                {\@todonotes@currentbackgroundcolor}%
+                {\textcolor{\@todonotes@currentbackgroundcolor}{o}}%
+            \ \@todonotes@caption}%
+    \else%
+        \addcontentsline{tdo}{todo}{\@todonotes@caption}%
+    \fi}%
+%    \end{macrocode}
+% \end{macro}
+% \begin{macro}{drawInlineNote}
+% Define helper function |drawInlineNote|.
+%    \begin{macrocode}
+\newcommand{\@todonotes@drawInlineNote}{%
+    {\par\noindent\begin{tikzpicture}[remember picture]%
+        \draw node[@todonotes@inlinenote,font=\@todonotes@sizecommand]{%
+            \if@todonotes@authorgiven%
+                {\noindent \@todonotes@sizecommand %
+                    \@todonotes@author:\,\@todonotes@text}%
+            \else%
+                {\noindent \@todonotes@sizecommand \@todonotes@text}%
+            \fi};%
+        \end{tikzpicture}\par}%
+    }%
+%    \end{macrocode}
+% \end{macro}
+% \begin{macro}{\missingfigure}
+% Defines the |\missingfigure| macro.
+%    \begin{macrocode}
+\newcommand{\missingfigure}[2][]{%
+\setkeys{todonotes}{#1}%
+\addcontentsline{tdo}{todo}{\@todonotes@MissingFigureText: #2}%
+\par
+\noindent
+\begin{tikzpicture}
+\draw[fill=black!40, draw = white, line width=0pt] 
+    (-2, -2.5) rectangle +(\@todonotes@currentfigwidth, \@todonotes@currentfigheight);
+\draw (2, -0.3) node[right, text
+    width=\@todonotes@currentfigwidth-4.5cm] {#2};
+\draw[red, fill=white, rounded corners = 5pt, line width=10pt] 
+    (30:2cm) -- (150:2cm) -- (270:2cm) -- cycle;
+\draw (0, 0.3) node {\@todonotes@MissingFigureUp};
+\draw (0, -0.3) node {\@todonotes@MissingFigureDown};
+\end{tikzpicture}
+}% Ending \missingfigure command
+\fi % Ending \@todonotes@ifdisabled
+%    \end{macrocode}
+% \end{macro}
+% \begin{macro}{\todototoc}
+% Inserts a reference to the list of todos in the table of contents. If |chapter| is defined, 
+% |chapter| is used as level otherwise will |section| be used.
+% The |\todototoc| command respects the disable option.
+%    \begin{macrocode}
+\newcommand{\todototoc}
+{
+    \if@todonotes@disabled
+    \else
+    \addcontentsline{toc}{\@ifundefined{chapter}{section}{chapter}}{\@todonotes@todolistname}
+    \fi
+}
+%    \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\todo}
+% Define the |\todo| command as a redirection to |\@todo|.
+%    \begin{macrocode}
+\newcommand{\todo}[2][]{\@bsphack\@todo[#1]{#2}\@esphack\ignorespaces}%
+%    \end{macrocode}
+% \end{macro}
+% \begin{macro}{\todoarea}
+% Define the |\todoarea| command as a redirection to |\@todoarea|.
+% We don't want to ignore spaces after this command.
+%    \begin{macrocode}
+\newcommand{\todoarea}[3][]{\@bsphack\@todoarea[#1]{#2}{#3}\@esphack}%
+%    \end{macrocode}
+% \end{macro}
+% The following commands are executed when a page is complete and is written to
+% the output PDF (shipout in \TeX\ terms).
+% The |\AtBeginShipout| command is provided by package atbegshi.
+%    \begin{macrocode}
+\if@todonotes@disabled
+\else
+\AtBeginShipout{%
+%    \end{macrocode}
+% We draw to the foreground or background of the page (depending if debug option
+% is set for the package).
+%    \begin{macrocode}
+    \@todonotes@AtBeginShipoutUpperLeft{
+        \@todonotes@writeNextpageToLpo
+%    \end{macrocode}
+% Determine if we are on a left or on a right side (important for margins) and
+% set variables accordingly.
+% |\relax| seems to be needed at end to really write new value for
+% currentsidemargin.
+%    \begin{macrocode}
+        \checkoddpage%
+        \ifoddpageoroneside%
+            \@todonotes@currentsidemargin=\the\oddsidemargin%
+            \directlua{currentPageOdd = true}%
+        \else%
+            \@todonotes@currentsidemargin=\the\evensidemargin%
+            \directlua{currentPageOdd = false}%
+        \fi\relax%
+%    \end{macrocode}
+% We switch to the default catcodes of \LaTeX\ here.
+% This is important if catcodes are changed in the main text, e.\,g., by a
+% verbatim environment at the end of the page.
+%    \begin{macrocode}
+        \BeginCatcodeRegime\CatcodeTableLaTeX
+%    \end{macrocode}
+% Calculates the areas, in which the labels can be placed.
+% This calculation depends on currentsidemargin.
+% So this has to be done inside |\AtBeginShipoutUpperLeft| (otherwise odd/even
+% page detection won't work).
+%    \begin{macrocode}
+        \directlua{calcLabelAreaDimensions()}%
+%    \end{macrocode}
+% Calculates the needed height for every note.
+% This has to be outside of the tikzpicture because it uses a savebox to compute
+% the height.
+% This box does not work in the tikzpicture.
+%    \begin{macrocode}
+        \directlua{calcHeightsForNotes()}% has to be outside of tikzpicture
+        \begin{tikzpicture}[remember picture,overlay]
+%    \end{macrocode}
+% Reads the absolute coordinates of every note on the page and writes them to
+% the Lua objects.
+%    \begin{macrocode}
+            \directlua{getInputCoordinatesForNotes()}
+%    \end{macrocode}
+% Runs the positioning algorithm and actually draws the notes and leaders.
+%    \begin{macrocode}
+            \directlua{printNotes()}
+        \end{tikzpicture}%
+%    \end{macrocode}
+% Delete the drawn notes from the Lua lists and prepare for the next page.
+%    \begin{macrocode}
+        \directlua{clearNotes()}%
+        \EndCatcodeRegime
+    }%
+}
+\fi % Ending \@todonotes@ifdisabled
+%    \end{macrocode}
+%
+% \newpage
+% \Finale
+\endinput
+
diff --git a/Master/texmf-dist/source/lualatex/luatodonotes/luatodonotes.ins b/Master/texmf-dist/source/lualatex/luatodonotes/luatodonotes.ins
new file mode 100644
index 00000000000..779664abf56
--- /dev/null
+++ b/Master/texmf-dist/source/lualatex/luatodonotes/luatodonotes.ins
@@ -0,0 +1,65 @@
+%%
+%% Copyright (C) 2014 by Fabian Lipp <fabian.lipp@gmx.de>
+%% based on the todonotes package by
+%%   Henrik Skov Midtiby <henrikmidtiby@gmail.com>
+%%
+%% This file may be distributed and/or modified under the conditions of
+%% the LaTeX Project Public License, either version 1.2 of this license
+%% or (at your option) any later version.  The latest version of this
+%% license is in:
+%% 
+%%    http://www.latex-project.org/lppl.txt
+%% 
+%% and version 1.2 or later is part of all distributions of LaTeX version
+%% 1999/12/01 or later.
+%%
+
+\input docstrip.tex
+\keepsilent
+
+\usedir{tex/latex/luatodonotes}
+
+\preamble
+
+This is a generated file.
+
+Copyright (C) 2014 by Fabian Lipp <fabian.lipp@gmx.de>
+based on the todonotes package by
+  Henrik Skov Midtiby <henrikmidtiby@gmail.com>
+
+This file may be distributed and/or modified under the conditions of
+the LaTeX Project Public License, either version 1.2 of this license
+or (at your option) any later version.  The latest version of this
+license is in:
+
+   http://www.latex-project.org/lppl.txt
+
+and version 1.2 or later is part of all distributions of LaTeX version
+1999/12/01 or later.
+
+\endpreamble
+
+\generate{\file{luatodonotes.sty}{\from{luatodonotes.dtx}{package}}}
+
+\obeyspaces
+\Msg{*************************************************************}
+\Msg{*                                                           *}
+\Msg{* To finish the installation you have to move the following *}
+\Msg{* files into a directory searched by TeX:                   *}
+\Msg{*                                                           *}
+\Msg{*     luatodonotes.sty                                      *}
+\Msg{*     luatodonotes.lua                                      *}
+\Msg{*     path_line.lua                                         *}
+\Msg{*     path_point.lua                                        *}
+\Msg{*     inspect.lua                                           *}
+\Msg{*                                                           *}
+\Msg{* To produce the documentation run the file todonotes.dtx   *}
+\Msg{* through LaTeX.                                            *}
+\Msg{*                                                           *}
+\Msg{* Happy TeXing!                                             *}
+\Msg{*                                                           *}
+\Msg{*************************************************************}
+
+
+\endbatchfile
+