summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2015-07-10 22:39:17 +0000
committerKarl Berry <karl@freefriends.org>2015-07-10 22:39:17 +0000
commitbc97ea7e20f6794c2511d83772db826a4d9cb5d9 (patch)
treece8a465b33a24a12694bb422674beba236d8f225
parent8284b99c6fa05747925445552dcb2852f3b8201f (diff)
todonotes (10jul15)
git-svn-id: svn://tug.org/texlive/trunk@37829 c570f23f-e606-0410-a88d-b1316a301751
-rw-r--r--Master/texmf-dist/doc/latex/todonotes/README55
-rw-r--r--Master/texmf-dist/doc/latex/todonotes/examples/alterAppearenceOfListOfTodos.pdfbin0 -> 62871 bytes
-rw-r--r--Master/texmf-dist/doc/latex/todonotes/examples/alterAppearenceOfListOfTodos.tex38
-rw-r--r--Master/texmf-dist/doc/latex/todonotes/examples/externalize.pdfbin0 -> 27659 bytes
-rw-r--r--Master/texmf-dist/doc/latex/todonotes/examples/externalize.tex43
-rw-r--r--Master/texmf-dist/doc/latex/todonotes/examples/saveColorByUsingLayers.pdfbin0 -> 25180 bytes
-rw-r--r--Master/texmf-dist/doc/latex/todonotes/examples/saveColorByUsingLayers.tex27
-rw-r--r--Master/texmf-dist/doc/latex/todonotes/todonotes.pdfbin315211 -> 313564 bytes
-rw-r--r--Master/texmf-dist/source/latex/todonotes/todonotes.dtx62
-rw-r--r--Master/texmf-dist/tex/latex/todonotes/todonotes.sty2
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
Binary files differ
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
Binary files differ
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
Binary files differ
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
Binary files differ
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}