texlive[43962] Master/texmf-dist: handout (21apr17)

[commits+karl at tug.org]

Revision: 43962
          http://tug.org/svn/texlive?view=revision&revision=43962
Author:   karl
Date:     2017-04-22 00:17:42 +0200 (Sat, 22 Apr 2017)
Log Message:
-----------
handout (21apr17)

Modified Paths:
--------------
    trunk/Master/texmf-dist/doc/latex/handout/examples/example1-minimal.pdf
    trunk/Master/texmf-dist/doc/latex/handout/examples/example2-cancel-quotation.pdf
    trunk/Master/texmf-dist/doc/latex/handout/examples/example3-defined-path.pdf
    trunk/Master/texmf-dist/doc/latex/handout/examples/example4-sectioning.pdf
    trunk/Master/texmf-dist/doc/latex/handout/examples/example5-numbering.pdf
    trunk/Master/texmf-dist/doc/latex/handout/examples/example6-not-and-only.pdf
    trunk/Master/texmf-dist/doc/latex/handout/examples/example7-biblatex.pdf
    trunk/Master/texmf-dist/doc/latex/handout/handout.pdf
    trunk/Master/texmf-dist/doc/latex/handout/handout.tex
    trunk/Master/texmf-dist/tex/latex/handout/handout.sty

Modified: trunk/Master/texmf-dist/doc/latex/handout/examples/example1-minimal.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/handout/examples/example2-cancel-quotation.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/handout/examples/example3-defined-path.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/handout/examples/example4-sectioning.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/handout/examples/example5-numbering.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/handout/examples/example6-not-and-only.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/handout/examples/example7-biblatex.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/handout/handout.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/handout/handout.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/handout/handout.tex	2017-04-21 22:17:27 UTC (rev 43961)
+++ trunk/Master/texmf-dist/doc/latex/handout/handout.tex	2017-04-21 22:17:42 UTC (rev 43962)
@@ -16,8 +16,8 @@
   subtitle={to support your talk},
   email={maieul <at> maieul <dot> net},
   author={Maïeul Rouquette},
-  revision={1.5.0},
-  date={15/11/2016},
+  revision={1.6.0},
+  date={21/04/2017},
   url={https://github.com/maieul/handout}}
 
 
@@ -145,11 +145,12 @@
 The argument of a  \cmd{onlyhandout} command will be printed only in the handout. Conversely, the argument of a command \cmd{nothandout} will be printed only in the main text. See example~6.
 
 \subsection{Insert code in the handout}
-
+\subsubsection{\cmd{forhandout} and \cmd{forhandout*}}\label{forhandout}
 The argument of the  \cmd{forhandout} command will be added to the handout, even if used outside any included file.
 
-\emph{Be careful}: if the content of the argument starts with a command, this command won't be run before the handout.
+All the commands inside will be expanded, except the one which starts argument..
 
+
 The \cmd{forhandout} command is quite complex to manage, but can be useful if you want to insert bibliographic references automatically into your handout. If you use \emph{biblatex} to manage your bibliography, you can define a \cmd{citehandout} command with this code:
 
 
@@ -176,10 +177,24 @@
 
 Note that the citation tracker is automatically reset at the beginning of the handout.
 
+The starred version of \cmd{citehandout} command will not expand any macro inside the argument. For example, if you need to write instructions for readers:
+\begin{minted}{latex}
+\forhandout{Read the three following texts, looking for:
+\begin{itemize}
+	\item Places.
+	\item Topics.
+	\item Characters.
+\end{itemize}
+}
+\end{minted}
+\subsubsection{\cmd{AtEveryHandout}}\label{forhandout}
 You can also add define a \cs{AtEveryHandout} command to be executed in the handout, before each content added to the handout.
 \section{Change history}
 
 \begin{changelog}
+\begin{release}{1.6.0}{2017-04-21}
+\item Add starred version of \cs{forhandout} macro \see{forhandout}. 
+\end{release}
 
 \begin{release}{1.5.0}{2016-11-15}
 \item Reset automatically table and figure counters before typesetting handout.

Modified: trunk/Master/texmf-dist/tex/latex/handout/handout.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/handout/handout.sty	2017-04-21 22:17:27 UTC (rev 43961)
+++ trunk/Master/texmf-dist/tex/latex/handout/handout.sty	2017-04-21 22:17:42 UTC (rev 43962)
@@ -13,8 +13,8 @@
 % The Current Maintainer of this work is Maïeul Rouquette
 % This work consists of the files handout.sty and example and documentation files.
 
-\ProvidesPackage{handout}[2016/11/15 1.5.0 Handout package]
-\RequirePackage{kvoptions,etoolbox}
+\ProvidesPackage{handout}[2017/04/21 1.6.0 Handout package]
+\RequirePackage{kvoptions,etoolbox,suffix}
 
 % Options
 \DeclareBoolOption[false]{disabled}
@@ -64,6 +64,13 @@
 	  \fi%
 	\fi%
 }
+\WithSuffix\newcommand\forhandout*[1]{%
+	\ifhandout at disabled\else%
+	  \ifhandout at printing%
+	    \immediate\write\@handout{\unexpanded{#1}}%
+	  \fi%
+	\fi%
+}
 
 % The command written in the .handout file
 \newcommand{\handout at input}[1]{%