From bc97ea7e20f6794c2511d83772db826a4d9cb5d9 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 10 Jul 2015 22:39:17 +0000 Subject: todonotes (10jul15) git-svn-id: svn://tug.org/texlive/trunk@37829 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/todonotes/README | 55 ++++++++++++++++++ .../examples/alterAppearenceOfListOfTodos.pdf | Bin 0 -> 62871 bytes .../examples/alterAppearenceOfListOfTodos.tex | 38 +++++++++++++ .../doc/latex/todonotes/examples/externalize.pdf | Bin 0 -> 27659 bytes .../doc/latex/todonotes/examples/externalize.tex | 43 ++++++++++++++ .../todonotes/examples/saveColorByUsingLayers.pdf | Bin 0 -> 25180 bytes .../todonotes/examples/saveColorByUsingLayers.tex | 27 +++++++++ .../texmf-dist/doc/latex/todonotes/todonotes.pdf | Bin 315211 -> 313564 bytes .../source/latex/todonotes/todonotes.dtx | 62 ++++----------------- .../texmf-dist/tex/latex/todonotes/todonotes.sty | 2 +- 10 files changed, 174 insertions(+), 53 deletions(-) create mode 100644 Master/texmf-dist/doc/latex/todonotes/examples/alterAppearenceOfListOfTodos.pdf create mode 100644 Master/texmf-dist/doc/latex/todonotes/examples/alterAppearenceOfListOfTodos.tex create mode 100644 Master/texmf-dist/doc/latex/todonotes/examples/externalize.pdf create mode 100644 Master/texmf-dist/doc/latex/todonotes/examples/externalize.tex create mode 100644 Master/texmf-dist/doc/latex/todonotes/examples/saveColorByUsingLayers.pdf create mode 100644 Master/texmf-dist/doc/latex/todonotes/examples/saveColorByUsingLayers.tex 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 . +You can send any issue or comment to or . + + +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 Binary files /dev/null and b/Master/texmf-dist/doc/latex/todonotes/examples/alterAppearenceOfListOfTodos.pdf 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 Binary files /dev/null and b/Master/texmf-dist/doc/latex/todonotes/examples/externalize.pdf 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 Binary files /dev/null and b/Master/texmf-dist/doc/latex/todonotes/examples/saveColorByUsingLayers.pdf 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 Binary files a/Master/texmf-dist/doc/latex/todonotes/todonotes.pdf and b/Master/texmf-dist/doc/latex/todonotes/todonotes.pdf 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 +% Copyright (C) 2015 by Henrik Skov Midtiby % ------------------------------------------------------- % % This file may be distributed and/or modified under the @@ -22,14 +22,14 @@ %\NeedsTeXFormat{LaTeX2e}[1999/12/01] %\ProvidesPackage{todonotes} %<*package> - [2012/07/25 .dtx Todonotes source and documentation.] + [2015/07/09 .dtx Todonotes source and documentation.] % % %<*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} -- cgit v1.2.3