todonotes (10jul15)

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

10 files changed, 174 insertions, 53 deletions

diff --git a/Master/texmf-dist/doc/latex/todonotes/README b/Master/texmf-dist/doc/latex/todonotes/README
index c37019bb4db..be267bedff2 100644
--- a/Master/texmf-dist/doc/latex/todonotes/README
+++ b/Master/texmf-dist/doc/latex/todonotes/README
@@ -1,6 +1,61 @@
+todonotes
+=========
+
 The package lets the user mark things to do later, in a simple and
 and visually appealing way.  The package takes several options to
 enable customization / finetuning of the visual appearance.
 
 The package makes use of the tikz and xkeyval packages.
 
+
+Usage
+-----
+
+Include the package in the preamble
+
+    \usepackage{todonotes}
+
+In the document it is now possible to insert notes with the \todo command.
+
+    The package lets the user mark things to do later, in a simple and
+    and visually \todo{rephrase sentence} appealing way.  
+
+To show a list of the inserted notes, use
+
+    \listoftodos
+
+The list of todos will be shown like a table of content or a list of figures.
+
+
+Contact
+-------
+
+The homepage of `todonotes` is <https://github.com/henrikmidtiby/todonotes>.
+You can send any issue or comment to <https://github.com/henrikmidtiby/todonotes/issues> or <henrikmidtiby@gmail.com>.
+
+
+Authors
+-------
+
+* Henrik Skov Midtiby http://henrikmidtiby.github.io (initial author)
+
+
+License
+-------
+
+Copyright 2015-07-08 Henrik Skov Midtiby
+
+This work may be distributed and/or modified under the
+conditions of the LaTeX Project Public License, either version 1.3
+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.3 or later is part of all distributions of LaTeX
+version 2005/12/01 or later.
+
+This work has the LPPL maintenance status `maintained'.
+
+The Current Maintainer of this work is Henrik Skov Midtiby.
+
+This work consists of the files todonotes.dtx and todonotes.ins
+and the derived file todonotes.sty.
diff --git a/Master/texmf-dist/doc/latex/todonotes/examples/alterAppearenceOfListOfTodos.pdf b/Master/texmf-dist/doc/latex/todonotes/examples/alterAppearenceOfListOfTodos.pdf
new file mode 100644
index 00000000000..201460a83e0
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/todonotes/examples/alterAppearenceOfListOfTodos.pdf
diff --git a/Master/texmf-dist/doc/latex/todonotes/examples/alterAppearenceOfListOfTodos.tex b/Master/texmf-dist/doc/latex/todonotes/examples/alterAppearenceOfListOfTodos.tex
new file mode 100644
index 00000000000..df607835f85
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/todonotes/examples/alterAppearenceOfListOfTodos.tex
@@ -0,0 +1,38 @@
+\documentclass{book}
+
+\usepackage{todonotes}
+\usepackage{lipsum}
+\makeatletter
+\def\myaddcontentsline#1#2#3{%
+  \addtocontents{#1}{\protect\contentsline{#2}{#3}{see \thesection\ at p. \thepage}{}}}
+\renewcommand{\@todonotes@addElementToListOfTodos}{%
+    \if@todonotes@colorinlistoftodos%
+        \myaddcontentsline{tdo}{todo}{{%
+            \colorbox{\@todonotes@currentbackgroundcolor}%
+                {\textcolor{\@todonotes@currentbackgroundcolor}{o}}%
+            \ \@todonotes@caption}}%
+    \else%
+        \myaddcontentsline{tdo}{todo}{{\@todonotes@caption}}%
+    \fi}%
+\newcommand*\mylistoftodos{%
+  \begingroup
+       \setbox\@tempboxa\hbox{see 9.9 at p. 99}%
+       \renewcommand*\@tocrmarg{\the\wd\@tempboxa}%
+       \renewcommand*\@pnumwidth{\the\wd\@tempboxa}%
+       \listoftodos%
+  \endgroup
+}
+\makeatother
+
+\begin{document}
+\chapter{My first chapter}
+\section{A first section}
+\lipsum
+\todo{This is a note}
+\section{Another section}
+\lipsum
+\todo{This is another note}
+
+\tableofcontents
+\mylistoftodos
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/todonotes/examples/externalize.pdf b/Master/texmf-dist/doc/latex/todonotes/examples/externalize.pdf
new file mode 100644
index 00000000000..f9374bbedee
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/todonotes/examples/externalize.pdf
diff --git a/Master/texmf-dist/doc/latex/todonotes/examples/externalize.tex b/Master/texmf-dist/doc/latex/todonotes/examples/externalize.tex
new file mode 100644
index 00000000000..3d6776cb764
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/todonotes/examples/externalize.tex
@@ -0,0 +1,43 @@
+% comment out to define
+%\def\CompileTikZFigures{}
+
+\documentclass{article}
+\usepackage{xspace}
+\usepackage{tikz}
+\ifx\CompileTikZFigures\undefined
+	\usetikzlibrary{external}
+	\tikzexternalize[prefix=pics/tikz/]
+\fi
+
+\usepackage{todonotes}
+
+\ifx\CompileTikZFigures\undefined
+	\makeatletter
+	\renewcommand{\todo}[2][]{%
+		\tikzexternaldisable%
+		\@bsphack\@todo[#1]{#2}\@esphack\ignorespaces%
+		\tikzexternalenable%
+		\xspace%
+		}
+	\makeatother
+\else
+	\makeatletter
+	\renewcommand{\todo}[2][]{%
+		\@bsphack\@todo[#1]{#2}\@esphack\ignorespaces\xspace%
+	}
+	\makeatother
+\fi
+
+\begin{document}
+Example by Marek Rjelka.
+
+\verb+\CompileTikZFigures+ is
+\ifx\CompileTikZFigures\undefined%
+	un%
+\fi%
+defined.
+
+\bigskip
+Here goes some\todo{a comment} text.
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/todonotes/examples/saveColorByUsingLayers.pdf b/Master/texmf-dist/doc/latex/todonotes/examples/saveColorByUsingLayers.pdf
new file mode 100644
index 00000000000..7250a372280
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/todonotes/examples/saveColorByUsingLayers.pdf
diff --git a/Master/texmf-dist/doc/latex/todonotes/examples/saveColorByUsingLayers.tex b/Master/texmf-dist/doc/latex/todonotes/examples/saveColorByUsingLayers.tex
new file mode 100644
index 00000000000..86f7f970f89
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/todonotes/examples/saveColorByUsingLayers.tex
@@ -0,0 +1,27 @@
+\documentclass{article}
+\usepackage{todonotes}
+\usepackage{ocg-p}
+\newcommand{\TODO}[1]{
+\newsavebox\todoboxa
+\savebox\todoboxa{\begin{ocg}[printocg=never]{ToDo screen}{todo4screen}{1}
+\todo[inline]{#1}
+\end{ocg}}
+\newsavebox\todoboxb
+\savebox\todoboxb{\begin{ocg}[printocg=always]{ToDo print}{todo4print}{0}
+\todo[inline, color=white]{#1}
+\end{ocg}}
+\noindent\usebox\todoboxb\llap{\usebox\todoboxa}
+\global\let\todoboxa\relax
+\global\let\todoboxb\relax
+}
+
+\begin{document}
+
+\section{Hello world!}
+
+The todo inserted below is shown in color on the screen, but in black and white when sent to the printer.
+
+Example by Robert Rehner.
+
+\TODO{Example todo}
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/todonotes/todonotes.pdf b/Master/texmf-dist/doc/latex/todonotes/todonotes.pdf
index 519df61f4d9..bed37a7ef18 100644
--- a/Master/texmf-dist/doc/latex/todonotes/todonotes.pdf
+++ b/Master/texmf-dist/doc/latex/todonotes/todonotes.pdf
diff --git a/Master/texmf-dist/source/latex/todonotes/todonotes.dtx b/Master/texmf-dist/source/latex/todonotes/todonotes.dtx
index 718f89bebb0..7c4866551ad 100644
--- a/Master/texmf-dist/source/latex/todonotes/todonotes.dtx
+++ b/Master/texmf-dist/source/latex/todonotes/todonotes.dtx
@@ -1,6 +1,6 @@
 % \iffalse meta-comment
 %
-% Copyright (C) 2008 by Henrik Skov Midtiby <henrikmidtiby@gmail.com>
+% Copyright (C) 2015 by Henrik Skov Midtiby <henrikmidtiby@gmail.com>
 % -------------------------------------------------------
 % 
 % This file may be distributed and/or modified under the
@@ -22,14 +22,14 @@
 %<package>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
 %<package>\ProvidesPackage{todonotes}
 %<*package>
-    [2012/07/25 .dtx Todonotes source and documentation.]
+    [2015/07/09 .dtx Todonotes source and documentation.]
 %</package>
 %
 %<*driver>
 \documentclass{ltxdoc}
 \usepackage{wrapfig}
 \usepackage[colorlinks, linkcolor=black, urlcolor=blue]{hyperref}
-\usepackage[colorinlistoftodos, shadow]{todonotes}[2012/07/25]
+\usepackage[colorinlistoftodos, shadow]{todonotes}[2015/07/09]
 \usepackage{amsmath}
 \usepackage{setspace}
 \usepackage{soul}
@@ -182,6 +182,8 @@
 %             Added Croatian translation by Ican Kokan.
 %             Changed default with of missingfigure.
 %             Removed some underfull box warnings, solution by Ernst Blecha.} 
+% \changes{1.0.4}{2015/07/09}{Restructured documentation and placed some examples in the 
+%             doc/examples subdirectory.}
 % \GetFileInfo{todonotes.dtx}   
 %
 % \DoNotIndex{\newcommand,\newenvironment}
@@ -220,13 +222,13 @@
 % 
 % Some alternatives for the todonotes package are:
 % \begin{itemize}
-% \item \href{http://mirrors.ctan.org/tex-archive/macros/latex/contrib/easy-todo}{easy-todo}\\
+% \item \href{http://ctan.org/pkg/easy-todo}{easy-todo}\\
 % Depends on |color|, |tocloft| and |ifthen|, small feature set.
-% \item \href{http://mirrors.ctan.org/tex-archive/macros/latex/contrib/fixmetodonotes}{fixmetodonotes}\\
+% \item \href{http://ctan.org/pkg/fixmetodonotes}{fixmetodonotes}\\
 % Depends on |graphicx|, |color|, |transparent|, |watermark|,|fix-cm|, |ulem| and |tocloft|, small feature set.
-% \item \href{http://mirrors.ctan.org/tex-archive/macros/latex/contrib/todo}{todo}\\
+% \item \href{http://ctan.org/pkg/todo}{todo}\\
 % Depends on |amssymb|, medium feature set.
-% \item \href{http://mirrors.ctan.org/tex-archive/macros/latex/contrib/fixme}{fixme}\\
+% \item \href{http://ctan.org/pkg/fixme}{fixme}\\
 % Large package with a lot of features.
 % \end{itemize}
 % The main reason for considering other packages is that the todonotes 
@@ -1093,7 +1095,7 @@
 % The code is slightly modified from 
 % \url{http://tex.stackexchange.com/questions/18838/replacing-page-number-with-other-counter-in-listoftodos}.
 % An example of the modified list of todos is shown below, the complete 
-% code example is given in appendix \ref{appssecAlterAppearenceOfListoftodos}.\\
+% code example is given in the example directory.\\
 % \noindent
 % \begin{tikzpicture}
 % \draw node[shape=rectangle, fill=black!30, inner sep=1mm]{\includegraphics[width=\linewidth-2mm]{img/AlteredAppearenceOfListOfTodos.png}};
@@ -1818,50 +1820,6 @@
 %    \end{macrocode}
 % \end{macro}
 % \appendix
-% \section{Longer code examples}
-% \subsection{Alter appearence of the list of todos}
-% \label{appssecAlterAppearenceOfListoftodos}
-% \begin{verbatim}
-% \documentclass{book}
-% 
-% \usepackage{todonotes}
-% \usepackage{lipsum}
-% \makeatletter
-% \def\myaddcontentsline#1#2#3{%
-%   \addtocontents{#1}{\protect\contentsline{#2}{#3}{see \thesection\ at p. \thepage}{}}}
-% \renewcommand{\@todonotes@addElementToListOfTodos}{%
-%     \if@todonotes@colorinlistoftodos%
-%         \myaddcontentsline{tdo}{todo}{{%
-%             \colorbox{\@todonotes@currentbackgroundcolor}%
-%                 {\textcolor{\@todonotes@currentbackgroundcolor}{o}}%
-%             \ \@todonotes@caption}}%
-%     \else%
-%         \myaddcontentsline{tdo}{todo}{{\@todonotes@caption}}%
-%     \fi}%
-% \newcommand*\mylistoftodos{%
-%   \begingroup
-%        \setbox\@tempboxa\hbox{see 9.9 at p. 99}%
-%        \renewcommand*\@tocrmarg{\the\wd\@tempboxa}%
-%        \renewcommand*\@pnumwidth{\the\wd\@tempboxa}%
-%        \listoftodos%
-%   \endgroup
-% }
-% \makeatother
-% 
-% \begin{document}
-% \chapter{My first chapter}
-% \section{A first section}
-% \lipsum
-% \todo{This is a note}
-% \section{Another section}
-% \lipsum
-% \todo{This is another note}
-% 
-% \tableofcontents
-% \mylistoftodos
-% \end{document}
-% \end{verbatim}
-%
 % \newpage
 % \Finale
 \endinput
diff --git a/Master/texmf-dist/tex/latex/todonotes/todonotes.sty b/Master/texmf-dist/tex/latex/todonotes/todonotes.sty
index 6f8258a8a81..b05daa43bf6 100644
--- a/Master/texmf-dist/tex/latex/todonotes/todonotes.sty
+++ b/Master/texmf-dist/tex/latex/todonotes/todonotes.sty
@@ -22,7 +22,7 @@
 %% 
 \NeedsTeXFormat{LaTeX2e}[1999/12/01]
 \ProvidesPackage{todonotes}
-    [2012/07/25 .dtx Todonotes source and documentation.]
+    [2015/07/09 .dtx Todonotes source and documentation.]
 
 \ProvidesPackage{todonotes}[2012/07/25]
 \RequirePackage{ifthen}